Ta strona została przetłumaczona przez Cloud Translation API.

Zgłaszanie problemów z pakietem Android SDK

Gdy utworzysz kartę i zakodujesz ją w tokenie JWT, możesz ją wydać w aplikacji na Androida. Aby to zrobić, sprawdź, czy interfejs Google Wallet API jest dostępny na urządzeniu użytkownika, pokaż mu przycisk „Dodaj do Portfela Google”, a po kliknięciu tego przycisku zapisz kartę w Portfelu Google.

Wymagania wstępne

Zanim spróbujesz wystawić kartę, wykonaj te czynności:

wykonano wszystkie kroki opisane w przewodniku wprowadzającym.
Utwórz co najmniej jedną klasę kart.
Utwórz co najmniej 1 obiekt kart.
Zakodowany obiekt klasy i kart kart w tokenie JWT.

1. Zainstaluj pakiet SDK Portfela Google na Androida

Aby korzystać z pakietu SDK Portfela Google na Androida, dodaj com.google.android.gms:play-services-pay do sekcji dependencies pliku build.gradle na poziomie aplikacji:

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

2. Sprawdź dostępność interfejsu Google Wallet API

Zanim zapiszesz nowy obiekt, upewnij się, że interfejs Google Wallet API jest dostępny na urządzeniu docelowym, wywołując metodę getPayApiAvailabilityStatus w klasie PayClient.

Zacznij od dodania zmiennej członka do działania, w którym będziesz wyświetlać przycisk i utworzyć jego instancję, gdy zostanie ona utworzona:

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
}

Jeśli stosujesz inne wzorce projektowania, rozważ odpowiednie umieszczenie logiki biznesowej w konkretnej domenie. Jeśli np. używasz wzorca MVVM, umieść logikę biznesową związaną z interfejsem w aktywności lub fragmencie kodu (np. elementów interfejsu, wyniku działania) oraz logiki operacyjnej w modelu widoku (np. instancja klienta, aktywatory wywołania sieciowego).

Następnie użyj PayClient, aby sprawdzić, czy interfejs API jest dostępny:

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
    });
}

Aby określić dostępność interfejsu API, wywołaj przed chwilą metodę zdefiniowaną w aplikacji.

Obsługa, gdy interfejs API jest niedostępny

Interfejs API może być niedostępny między innymi przez nieaktualną wersję Androida lub Usług Google Play albo niedostępności Portfela Google w kraju użytkownika.

Jeśli interfejs API jest niedostępny, rozważ ukrycie przycisku i przejście do innej integracji (np. użycie linku JWT). Pamiętaj, że użytkownik może w przyszłości kwalifikować się do korzystania z tego interfejsu API.

3. Dodaj przycisk „Dodaj do Portfela Google”

Portfel Google oferuje znajomy przycisk, za pomocą którego możesz uruchomić procedurę Dodaj do Portfela Google w aplikacji. Informacje o zasobach wektorowych dla przycisku znajdziesz we wskazówkach dotyczących przycisku.

Zasoby wektorowe możesz importować w Android Studio w sekcji File > New > Vector Asset. Wybierz „Plik lokalny” w kreatorze, dodaj nazwę (np. add_to_google_wallet_button.xml) i znajdź plik na dysku lokalnym, aby go zaimportować.

Teraz możesz użyć zaimportowanego elementu rysowanego, by dodać przycisk do interfejsu:

    <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" />

Przycisk ma layout_height o wartości 48 dp, a szerokość musi wynosić co najmniej 200 dp.

4. Dodawanie karty do Portfela Google użytkownika

FlightObject można dodać, przekazując niepodpisany token JWT do metody savePasses. Operacja dodawania możesz rozpocząć, klikając przycisk Portfela Google.

Uwaga: jeśli przeprowadzasz integrację zarówno na Androidzie, jak i w internecie, możesz ponownie użyć podpisanego tokena JWT, który jest wymagany do integracji z internetem, wywołując savePassesJwt zamiast savePasses.

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
}

Obsługa wyników

Metoda savePasses aktywuje przepływ zapisywania i wywołuje metodę onActivityResult po zakończeniu procesu zapisywania. Implementacja onActivityResult powinna wyglądać mniej więcej tak:

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
      }
    }
  }
}

Po dodaniu karty resultCode będzie zawierać wartość Activity.RESULT_OK.