Problemübergänge mit dem Android SDK

Nachdem du eine Karte bzw. ein Ticket erstellt und in einem JWT codiert hast, kannst du sie in deiner Android-App ausstellen. Dazu musst du prüfen, ob die Google Wallet API auf dem Gerät des Nutzers verfügbar ist, und dem Nutzer die Schaltfläche „Zu Google Wallet hinzufügen“ anzeigen. und speichern Sie die Karte bzw. das Ticket in Google Wallet, sobald sie auf die Schaltfläche tippen.

Vorbereitung

Bevor Sie eine Karte bzw. ein Ticket ausstellen, müssen Sie Folgendes tun:

1. Google Wallet Android SDK installieren

Wenn du das Google Wallet Android SDK verwenden möchtest, füge com.google.android.gms:play-services-pay zum Abschnitt dependencies der Datei build.gradle auf App-Ebene hinzu:

  implementation "com.google.android.gms:play-services-pay:16.5.0"

2. Verfügbarkeit der Google Wallet API prüfen

Prüfe vor dem Speichern des neuen Objekts, ob die Google Wallet API auf dem Zielgerät verfügbar, indem die Methode getPayApiAvailabilityStatus in der Klasse PayClient aufgerufen wird.

Fügen Sie zunächst eine Member-Variable zum bei der die Schaltfläche angezeigt wird, und instanziieren Sie sie, wenn die Aktivität Erstellt:

Kotlin

import com.google.android.gms.pay.PayClient

private lateinit var walletClient: PayClient

override fun onCreate(savedInstanceState: Bundle?) {
  super.onCreate(savedInstanceState)

  walletClient = Pay.getClient(this)

  // Additional logic in your onCreate method
}

Java

import com.google.android.gms.pay.PayClient;

private final PayClient walletClient;

@Override
protected void onCreate(Bundle savedInstanceState) {
  super.onCreate(savedInstanceState);

  walletClient = Pay.getClient(application);

  // Additional logic in your onCreate method
}

Wenn Sie andere Designmuster verwenden, sollten Sie die domainspezifische Geschäftslogik entsprechend platzieren. Wenn Sie beispielsweise das MVVM-Muster verwenden, platziere die UI-bezogene Geschäftslogik in deiner Aktivität oder deinem Fragment (z. B. UI-Elementen Aktivitätsergebnis) und die operative Logik im Ansichtsmodell (z. B. Client Instanziierung, Netzwerkaufruf-Trigger).

Prüfen Sie als Nächstes mit PayClient, ob die API verfügbar ist:

Kotlin

import com.google.android.gms.pay.PayApiAvailabilityStatus

private fun fetchCanUseGoogleWalletApi() {
  walletClient
    .getPayApiAvailabilityStatus(PayClient.RequestType.SAVE_PASSES)
    .addOnSuccessListener { status ->
      if (status == PayApiAvailabilityStatus.AVAILABLE) {
        // The API is available, show the button in your UI
      } else {
        // The user or device is not eligible for using the Pay API
      }
    }
    .addOnFailureListener {
      // Hide the button and optionally show an error message
    }
}

Java

import com.google.android.gms.pay.PayApiAvailabilityStatus;

private void fetchCanAddPassesToGoogleWallet() {
  walletClient
    .getPayApiAvailabilityStatus(PayClient.RequestType.SAVE_PASSES)
    .addOnSuccessListener(status -> {
      if (status == PayApiAvailabilityStatus.AVAILABLE) {
        // The API is available, show the button in your UI
      } else {
        // The user or device is not eligible for using the Pay API
      };
    })
    .addOnFailureListener(exception -> {
      // Google Play Services is too old, or API availability not verified
      // Hide the button and optionally show an error message
    });
}

Rufen Sie schließlich die eben in Ihrer Anwendung definierte Methode auf, wenn Sie die Verfügbarkeit der API ermitteln möchten.

Verarbeiten, wenn die API nicht verfügbar ist

Mögliche Gründe, warum die API möglicherweise nicht verfügbar ist, sind das Android- oder Google dass die Versionen der Play-Dienste veraltet sind oder dass Google Wallet im Land des Nutzers nicht verfügbar.

Wenn die API nicht verfügbar ist Sie sollten die Schaltfläche ausblenden und auf eine andere Integration zurückgreifen (z.B. über einen JWT-Link). Hinweis: Der Nutzer kann die API möglicherweise in Zukunft verwenden.

3. „Zu Google Wallet hinzufügen“ hinzufügen Schaltfläche

In Google Wallet gibt es eine vertraute Schaltfläche zum Auslösen des Ablauf „Zu Google Wallet hinzufügen“ in deiner App. Vektor-Assets für die Schaltfläche sind in der Richtlinien für Schaltflächen:

Du kannst Vektor-Assets in Android Studio unter File > New > Vector Asset importieren. Wählen Sie „Lokale Datei“ aus. Geben Sie im Assistenten einen Namen ein (z. B. add_to_google_wallet_button.xml) und suchen Sie die Datei auf Ihrem lokalen Laufwerk, um sie zu importieren.

  • Schaltfläche „Zu Google Wallet hinzufügen“
  • Schaltfläche „Zu Google Wallet hinzufügen“ zusammengefasst

Jetzt kannst du das importierte Drawable verwenden, um die Schaltfläche deiner Benutzeroberfläche hinzuzufügen:

    <ImageButton
        android:id="@+id/addToGoogleWalletButton"
        android:layout_width="match_parent"
        android:layout_height="48dp"
        android:minWidth="200dp"
        android:clickable="true"
        android:src="@drawable/add_to_google_wallet_button" />

Die Schaltfläche hat eine layout_height von 48 dp und muss mindestens 200 dp breit sein.

4. Karte/Ticket zu Google Wallet eines Nutzers hinzufügen

LoyaltyObject kann hinzugefügt werden, indem ein unsigniertes JWT an die Methode savePasses übergeben wird. Sie können den Vorgang starten, indem Sie auf das Google Wallet-Konto klicken Schaltfläche.

Kotlin

import android.os.Bundle
import android.view.View
import com.google.android.gms.samples.wallet.databinding.ActivityCheckoutBinding

private val addToGoogleWalletRequestCode = 1000

private lateinit var layout: ActivityCheckoutBinding
private lateinit var addToGoogleWalletButton: View

override fun onCreate(savedInstanceState: Bundle?) {
  super.onCreate(savedInstanceState)

  // Use view binding to access the UI elements
  layout = ActivityCheckoutBinding.inflate(layoutInflater)
  setContentView(layout.root)

  addToGoogleWalletButton = layout.addToGoogleWalletButton
  addToGoogleWalletButton.setOnClickListener {
    walletClient.savePasses(newObjectJson, this, addToGoogleWalletRequestCode)
  }

  // Additional logic in your onCreate method
}

Java

import android.os.Bundle;
import android.view.View;
import com.google.android.gms.samples.wallet.databinding.ActivityCheckoutBinding;

private static final int ADD_TO_GOOGLE_WALLET_REQUEST_CODE = 999;

private ActivityCheckoutBinding layout:
private View addToGoogleWalletButton;

@Override
protected void onCreate(Bundle savedInstanceState) {
  super.onCreate(savedInstanceState);

  // Use view binding to access the UI elements
  layout = ActivityCheckoutBinding.inflate(getLayoutInflater());
  setContentView(layout.getRoot());

  addToGoogleWalletButton = layout.addToGoogleWalletButton;
  addToGoogleWalletButton.setOnClickListener(v -> {
    walletClient.savePasses(newObjectJson, this, ADD_TO_GOOGLE_WALLET_REQUEST_CODE);
  });

  // Additional logic in your onCreate method
}

Ergebnisverarbeitung

Die Methode savePasses löst den Speichervorgang aus und ruft die Methode onActivityResult nach Abschluss des Speichervorgangs. Die Implementierung von onActivityResult sollte in etwa so aussehen:

Kotlin

import android.content.Intent

override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
  super.onActivityResult(requestCode, resultCode, data)

  if (requestCode == addToGoogleWalletRequestCode) {
    when (resultCode) {
      RESULT_OK -> {
        // Pass saved successfully
      }

      RESULT_CANCELED -> {
        // Save operation canceled
      }

      PayClient.SavePassesResult.SAVE_ERROR -> data?.let { intentData ->
        val errorMessage = intentData.getStringExtra(PayClient.EXTRA_API_ERROR_MESSAGE)
        // Handle error
      }

      else -> {
          // Handle unexpected (non-API) exception
      }
    }
  }
}

Java

import android.content.Intent;

@Override
protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) {
  super.onActivityResult(requestCode, resultCode, data);

  if (requestCode == ADD_TO_GOOGLE_WALLET_REQUEST_CODE) {
    switch (resultCode) {
      case RESULT_OK: {
        // Pass saved successfully
        break;
      }

      case RESULT_CANCELED: {
        // Save operation canceled
        break;
      }

      case PayClient.SavePassesResult.SAVE_ERROR: {
        if (data != null) {
          String apiErrorMessage = data.getStringExtra(PayClient.EXTRA_API_ERROR_MESSAGE);
          // Handle error
        }
        break;
      }

      default: {
        // Handle unexpected (non-API) exception
      }
    }
  }
}

Wenn die Karte bzw. das Ticket erfolgreich hinzugefügt wurde, enthält resultCode den Wert Activity.RESULT_OK.