Una vez que hayas creado un pase y lo hayas codificado en un JWT, estarás listo para emitirlo en tu app para Android. Para ello, deberás verificar que la API de la Billetera de Google esté disponible en el dispositivo del usuario, así que muéstrale el mensaje “Agregar a la Billetera de Google” y, luego, guardará el pase en su Billetera de Google cuando lo presione.
Requisitos previos
Antes de intentar emitir un pase, asegúrate de haber completado lo siguiente:
- Haber completado todos los pasos de la Guía de integración
- Crea al menos una clase Pases.
- Crea al menos un objeto Passes.
- Se debe codificar la clase Passes y el objeto Passes en un JWT.
1. Instala el SDK de Android de la Billetera de Google
Para usar el SDK de Android de la Billetera de Google, agrega com.google.android.gms:play-services-pay
a la sección dependencies
del archivo build.gradle
a nivel de la app:
implementation "com.google.android.gms:play-services-pay:16.5.0"
2. Comprueba la disponibilidad de la API de la Billetera de Google
Antes de guardar el objeto nuevo, asegúrate de que la API de la Billetera de Google esté
disponible en el dispositivo de destino llamando al método getPayApiAvailabilityStatus
en la clase PayClient
.
Para comenzar, agrega una variable de miembro al en la que mostrarás el botón y crearás una instancia de este cuando la actividad esté fecha de creación:
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
}
Si usas otros patrones de diseño, considera ubicar la lógica empresarial específica del dominio de forma adecuada. Por ejemplo, si usas el patrón MVVM, Coloca la lógica empresarial relacionada con la IU en tu actividad o fragmento (p. ej.: elementos de la IU, resultado de la actividad) y la lógica operativa en tu modelo de vista (p. ej., cliente creación de instancias o activadores de llamadas de red).
A continuación, usa PayClient
para verificar si la API está disponible:
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
});
}
Por último, llama al método que acabas de definir en tu aplicación cuando necesites determinar la disponibilidad de la API.
Controla los casos en que la API no está disponible
Algunos motivos por los que la API podría no estar disponible incluyen la API de Versiones de Servicios de Play desactualizadas o que la Billetera de Google esté no disponible en el país del usuario.
Si la API no está disponible considera ocultar el botón y recurrir a una integración diferente (p.ej., mediante un vínculo JWT). Ten en cuenta que el usuario podría cumplir con los requisitos para usar la API en el futuro.
3. Agrega la tarjeta “Agregar a la Billetera de Google” botón
Google Wallet ofrece un botón conocido que puedes utilizar para activar la Agrega elementos al flujo de la Billetera de Google en tu aplicación. Los recursos vectoriales del botón disponibles en la Lineamientos de los botones
Puedes importar recursos vectoriales en Android Studio en File > New > Vector Asset
. Selecciona "Archivo local". del asistente, agrega un nombre (p. ej.:
add_to_google_wallet_button.xml
) y busca el archivo en tu unidad local para importarlo.
Ahora, puedes usar el elemento de diseño importado para agregar el botón a tu interfaz de usuario:
<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" />
El botón tiene una layout_height
de 48 dp y debe tener al menos 200 dp de ancho.
4. Agrega un pase a la Billetera de Google de un usuario
Se puede agregar GenericObject
pasando un JWT sin firma al método savePasses
.
Puedes iniciar la operación de agregar si haces clic en el botón de la Billetera de 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
}
Manejo de resultados
El método savePasses
activa el flujo de guardado y, luego, invoca la función
onActivityResult
después de completar el flujo de guardado. La implementación de onActivityResult
debe ser similar a la siguiente:
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
}
}
}
}
Cuando el pase se agrega de forma correcta, resultCode
contiene el valor de Activity.RESULT_OK
.