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
EventObject
można dodać, przekazując niepodpisany token JWT do metody savePasses
.
Operacja dodawania możesz rozpocząć, klikając przycisk Portfela Google.
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
.