Cómo migrar a la biblioteca de Google Play Billing 7 desde las versiones 5 o 6

En este documento, se describe cómo migrar desde la Biblioteca de Facturación Google Play 5 o 6 a la Biblioteca de Facturación Google Play 7 y cómo realizar la integración con las nuevas funciones de suscripción opcionales.

Para obtener una lista completa de los cambios de la versión 7.0.0, consulta las notas de la versión.

Descripción general

La Biblioteca de Facturación Google Play 7 mejora el manejo de pagos para las funciones de suscripción existentes. Estas mejoras opcionales agregan compatibilidad para pagar con planes de cuotas y para compras pendientes de suscripciones prepagadas.

Actualización retrocompatible de la Biblioteca de Facturación Play

Todas las nuevas APIs de la Biblioteca de Facturación Google Play 7 son opcionales, y los desarrolladores no necesitan implementar ningún cambio en la API para actualizar.

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 esta guía de migración.

Actualiza 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 usaba ProrationMode para aplicar cambios en las compras de suscripción de un usuario, por ejemplo, cambios a versiones anteriores o posteriores. Se quitó esta API y se reemplazó por ReplacementMode.

Controla los cambios en el precio de las suscripciones

Se quitó la API launchPriceConfirmationFlow que había dejado de estar disponible previamente. Para conocer otras alternativas, consulta la guía de cambios de precios.

Controla los cambios en la API relacionados con las suscripciones

Se quitaron las APIs setOldSkuPurchaseToken, setReplaceProrationMode y setReplaceSkusProrationMode que habían dejado de estar disponibles previamente.

Controla los errores de la Biblioteca de Facturación Play

Un nuevo código NETWORK_ERROR indica 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 Cómo administrar 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 propaga después de que la compra pasa al estado PURCHASED. Asegúrate de que tu integración espere un ID de pedido solo después de que se complete una transacción. Puedes seguir usando el token de compra para tus registros.

Si quieres obtener más información para controlar las compras pendientes, consulta 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 las compras.

Controla las APIs de facturación alternativa quitadas

Se quitaron BillingClient.Builder.enableAlternativeBilling, AlternativeBillingListener, y AlternativeChoiceDetails. En su lugar, los desarrolladores deben usar BillingClient.Builder.enableUserChoiceBilling() con UserChoiceBillingListener y UserChoiceDetails en la devolución de llamada del objeto de escucha.

Esta actualización es un cambio de nombre de las APIs obsoletas sin cambios de comportamiento.

Cambios opcionales

PBL 7 incluye dos nuevas APIs opcionales.

Compatibilidad con compras pendientes para planes prepagados

Consulta la guía Controla las suscripciones y las transacciones pendientes.

Suscripciones de cuotas virtuales

Consulta la guía de integración de suscripciones de cuotas .

Actualiza 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 las suscripciones

Se quitaron las APIs setOldSkuPurchaseToken, setReplaceProrationMode y setReplaceSkusProrationMode que habían dejado de estar disponibles previamente.

Controla las APIs de facturación alternativa quitadas

Se quitaron BillingClient.Builder.enableAlternativeBilling, AlternativeBillingListener y AlternativeChoiceDetails. En su lugar, 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 nuevas APIs opcionales.

Compatibilidad con compras pendientes para planes prepagados

Consulta la guía Controla las suscripciones y las transacciones pendientes.

Suscripciones de cuotas virtuales

Consulta la guía de integración de suscripciones de cuotas para obtener información sobre cómo integrar estos cambios en tu app.