En este documento, se describe la migración desde la biblioteca de Google Play Billing 5 o 6 a la Biblioteca de Facturación Google Play 7 y a integrarla con el nuevo y capacidades de suscripción.
Para obtener una lista completa de los cambios de la versión 7.0.0, consulta la versión notas.
Descripción general
La biblioteca de Google Play Billing 7 mejora el manejo de los pagos para funciones de suscripción existentes. Estas mejoras opcionales agregar compatibilidad con el pago con planes de cuotas, así como compatibilidad con compras pendientes de suscripciones prepagadas.
Actualización retrocompatible de la biblioteca de Play Billing
Todas las nuevas APIs de la biblioteca de Google Play Billing 7 son opcionales. los desarrolladores no necesitan implementar cambios en las APIs para actualizarlas.
Para migrar, debes actualizar las referencias de la API y quitar ciertas APIs de tu app, como se describe en las notas de la versión y más adelante en este guía de migración.
Actualizar de PBL 5 a PBL 7
En las siguientes secciones, se describe cómo actualizar de PBL 5 a PBL 7.
Actualiza la Biblioteca de Facturación Google Play
Actualiza la versión de dependencia de la Biblioteca de Facturación Play en
el archivo build.gradle de tu app.
dependencies {
def billingVersion = 7.0.0
implementation "com.android.billingclient:billing:$billingVersion"
}
Luego, actualiza las referencias de la API como se describe en las siguientes secciones.
Cambia las compras de suscripción de un usuario
La Biblioteca de Facturación Play 5 y versiones anteriores usaban ProrationMode
para aplicar cambios en las compras de suscripciones de un usuario, como actualizaciones
o cambiar a una versión inferior. Se quitó esta API y se reemplazó por
ReplacementMode
Controla los cambios en el precio de las suscripciones
Se quitó la API de launchPriceConfirmationFlow que ya estaba obsoleta.
Para conocer otras alternativas, consulta la guía de cambios de precios.
Controla los cambios en la API relacionados con la suscripción
Las APIs que dejaron de estar disponibles, setOldSkuPurchaseToken,
Se quitaron setReplaceProrationMode y setReplaceSkusProrationMode.
- Actualiza
setOldSkuPurchaseTokenasetOldPurchaseToken. - Actualizar
setReplaceProrationModeasetSubscriptionReplacementMode - Actualizar
setReplaceSkusProrationModeasetSubscriptionReplacementMode
Controla los errores de la biblioteca de Play Billing
Un nuevo código NETWORK_ERROR indica que hay problemas con la conexión de red.
entre el dispositivo del usuario y el sistema de Google Play.
También se actualizaron los códigos SERVICE_TIMEOUT y SERVICE_UNAVAILABLE.
Para obtener más información, consulta Administra códigos de respuesta BillingResult.
Controla las transacciones pendientes
La Biblioteca de Facturación Play ya no crea un ID de pedido para las compras pendientes.
Para estas compras, el ID de pedido se completa después de que se traslada la compra
al estado PURCHASED. Asegúrate de que tu integración espere
un ID de pedido solo después de que la transacción se haya completado. Puedes seguir usando
el token de compra para tus registros.
Para obtener más información sobre cómo administrar las compras pendientes, consulta la La guía de integración de la Biblioteca de Facturación Play y la guía de administración del ciclo de vida de compras.
Cómo controlar las APIs de facturación alternativa quitadas
Se quitó BillingClient.Builder.enableAlternativeBilling,
AlternativeBillingListener,
y AlternativeChoiceDetails.
Los desarrolladores deben usar BillingClient.Builder.enableUserChoiceBilling() con UserChoiceBillingListener
y UserChoiceDetails
en la devolución de llamada del objeto de escucha.
Esta actualización implica el cambio de nombre de las APIs obsoletas sin cambios en el comportamiento.
Cambios opcionales
PBL 7 incluye dos APIs opcionales nuevas.
Compatibilidad con compras pendientes para planes prepagados
Consulta la guía Administra suscripciones y transacciones pendientes.
Suscripciones a cuotas virtuales
Consulta la guía Integración de suscripciones a cuotas.
Actualizar de PBL 6 a PBL 7
En las siguientes secciones, se describe cómo actualizar de PBL 6 a PBL 7.
Actualiza la Biblioteca de Facturación Google Play
Actualiza la versión de dependencia de la Biblioteca de Facturación Play en
el archivo build.gradle de tu app.
dependencies {
def billingVersion = 7.0.0
implementation "com.android.billingclient:billing:$billingVersion"
}
Luego, actualiza las referencias de la API como se describe en las siguientes secciones.
Controla los cambios en la API relacionados con la suscripción
Las APIs que dejaron de estar disponibles, setOldSkuPurchaseToken,
Se quitaron setReplaceProrationMode y setReplaceSkusProrationMode.
- Actualiza
setOldSkuPurchaseTokenasetOldPurchaseToken. - Actualizar
setReplaceProrationModeasetSubscriptionReplacementMode - Actualizar
setReplaceSkusProrationModeasetSubscriptionReplacementMode
Cómo controlar las APIs de facturación alternativa quitadas
Se quitó BillingClient.Builder.enableAlternativeBilling,
AlternativeBillingListener
y AlternativeChoiceDetails.
Los desarrolladores deben usar BillingClient.Builder.enableUserChoiceBilling() con UserChoiceBillingListener
y UserChoiceDetails
en la devolución de llamada del objeto de escucha.
Cambios opcionales
PBL 7 incluye dos APIs opcionales nuevas.
Compatibilidad con compras pendientes para planes prepagados
Consulta la guía Administra suscripciones y transacciones pendientes.
Suscripciones a cuotas virtuales
Consulta la guía Integración de suscripciones a cuotas para obtener información sobre cómo integrar estos cambios en tu aplicación.