Po utworzeniu karty i zakodowaniu jej w JWT możesz udostępnić ją w aplikacji na Androida. Aby to zrobić, musisz sprawdzić, czy interfejs API Portfela Google jest dostępny na urządzeniu użytkownika, pokazać mu przycisk „Dodaj do Portfela Google”, a następnie zapisać kartę w Portfelu Google, gdy użytkownik dotknie tego przycisku.
Wymagania wstępne
Przed próbą wydania karty wykonaj te czynności:
- Masz za sobą wszystkie kroki opisane w przewodniku dla nowych użytkowników.
- Utwórz co najmniej jedną klasę kart.
- Utwórz co najmniej 1 obiekt kart.
- Zakodowano obiekt klasy i karty kart w tokenie JWT.
1. Zainstaluj pakiet SDK Portfela Google na Androida
Aby używać pakietu SDK Portfela Google na Androida, dodaj com.google.android.gms:play-services-pay
do sekcji dependencies
w pliku build.gradle
na poziomie aplikacji:
implementation "com.google.android.gms:play-services-pay:16.5.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 do aktywności zmiennej członka, w której będzie wyświetlany przycisk, i utwórz jego instancję podczas tworzenia aktywności:
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 używasz innych wzorców projektowych, zastanów się, czy nie warto zastosować logiki biznesowej właściwej dla danej domeny. Jeśli na przykład używasz wzorca MVVM, umieść logikę biznesową związaną z interfejsem we fragmencie aktywności lub we fragmencie (np. elementy interfejsu, wynik aktywności) i logikę operacyjną w modelu widoku danych (np. inicjowanie klienta, aktywatory wywołań sieciowych).
Następnie użyj interfejsu 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
});
}
Gdy chcesz określić dostępność interfejsu API, na koniec wywołaj metodę zdefiniowaną w aplikacji.
Obsługuj, gdy interfejs API jest niedostępny
Może to być spowodowane 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 użycie 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.
3. Dodawanie przycisku „Dodaj do Portfela Google”
Portfel Google ma dobrze znany przycisk, którego możesz użyć do aktywowania procesu „Dodaj do Portfela Google” w swojej aplikacji. Zasoby wektorowe dla przycisku są dostępne w wytycznych dotyczących przycisku.
Zasoby wektorowe możesz importować w Android Studio pod File > New > Vector Asset
. W kreatorze wybierz „Plik lokalny” i dodaj nazwę (np.
add_to_google_wallet_button.xml
) i zlokalizuj plik na dysku lokalnym, aby go zaimportować.
Teraz możesz dodać przycisk do interfejsu, korzystając z zaimportowanego elementu rysowanego:
<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 rozmiar layout_height
o wartości 48 dp, a szerokość co najmniej 200 dp.
4. Dodawanie karty do Portfela Google użytkownika
FlightObject
można dodać, przekazując do metody savePasses
niepodpisany token JWT.
Klikając przycisk Portfela Google, możesz rozpocząć dodawanie.
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 proces zapisywania i wywołuje metodę onActivityResult
po zakończeniu procesu zapisywania. Implementacja onActivityResult
powinna wyglądać podobnie do tej:
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
zawiera wartość Activity.RESULT_OK
.