Requisitos de versión de la biblioteca de facturación de Google Play
1. Google aplica un ciclo de obsolescencia de dos años a la Play Billing Library: cada versión principal es compatible durante dos años tras su lanzamiento, y después Play Console deja de aceptar compilaciones nuevas creadas con ella. La tabla publicada (https://developer.android.com/google/play/billing/deprecation-faq) indica: 5.x última fecha para apps nuevas y actualizaciones 2024-08-31 (fecha límite de solicitud de prórroga 2024-11-01), 6.x 2025-08-31 / 2025-11-01, 7.x 2026-08-31 / 2026-11-01, 8.x 2027-08-31 / 2027-11-01. En la práctica: desde el 31 de agosto de 2026, cualquier app nueva o actualización que use Play Billing debe compilarse con la Billing Library 8.0.0 o posterior.
2. La redacción exacta importa. Las preguntas frecuentes sobre obsolescencia de Google dicen que esta obsolescencia "solo impide que las apps nuevas y las actualizaciones usen versiones anteriores de la Play Billing Library. Las apps existentes que usan una versión obsoleta de la biblioteca seguirán funcionando como se espera". Es una barrera de publicación, no un interruptor que mate la app en ejecución: una compilación v7 ya publicada sigue procesando compras. Lo que pierdes es la capacidad de publicar cualquier cosa nueva, incluido un parche de seguridad o una recompilación, así que cualquier app que quieras seguir manteniendo debe migrarse.
3. La extensión es una solicitud, no un periodo de gracia automático. Para la línea 7.x, la fecha límite para solicitar la extensión es el 2026-11-01, y la solicitud debe presentarse antes de la fecha límite original. Play Console indica la elegibilidad mediante una advertencia en la página de la app y un mensaje en la bandeja de entrada de la página Estado de las políticas en cuanto una app está en una versión obsoleta; el formulario de extensión se encuentra en la página de detalles de esa advertencia o incidencia (https://developer.android.com/google/play/billing/release-notes).
4. Trampa de detección: Play Console lee la versión de tu biblioteca a partir de la entrada com.google.android.play.billingclient.version que la biblioteca inyecta en el manifiesto. La fusión de manifiestos en proyectos multimódulo puede eliminarla: si esa entrada falta en tu manifiesto fusionado final, Play Console no puede saber qué versión enviaste y puede que la advertencia nunca te llegue. Verifica el manifiesto fusionado en lugar de fiarte del silencio.
5. Qué se rompe en la v8 (cada elemento es un error de compilación hasta que se reemplaza): querySkuDetailsAsync() -> queryProductDetailsAsync(QueryProductDetailsParams, ProductDetailsResponseListener); enablePendingPurchases() sin argumentos -> enablePendingPurchases(PendingPurchasesParams); la sobrecarga queryPurchasesAsync(String skuType, PurchasesResponseListener) -> queryPurchasesAsync(QueryPurchasesParams, PurchasesResponseListener); queryPurchaseHistoryAsync() no tiene reemplazo del lado del cliente, así que el historial de compras debe rastrearse del lado del servidor; BillingClient.Builder.enableAlternativeBilling(), AlternativeBillingListener y AlternativeChoiceDetails -> enableUserChoiceBilling(UserChoiceBillingListener), UserChoiceBillingListener y UserChoiceDetails; y ProductDetailsResponseListener.onProductDetailsResponse() ahora devuelve un QueryProductDetailsResult que separa los productos obtenidos de los no obtenidos con códigos de estado por producto. La terminología también cambió: lo que la documentación llamaba «artículos dentro de la app» ahora son «productos de pago único», y en la v8 admiten múltiples opciones de compra y ofertas igual que ya lo hacían las suscripciones.
6. Lista de verificación práctica: fija el último parche de la línea 8.x en lugar de 8.0.0; vuelve a probar los flujos de compra, restauración y compra pendiente con testers de licencias antes del despliegue; sigue verificando los tokens de compra en el servidor; y trátalo como una tarea de mantenimiento anual y no como algo puntual: la propia línea 8.x queda retirada para nuevas subidas el 2027-08-31, con una prórroga de respaldo hasta el 2027-11-01. Programar cada migración con un trimestre de antelación respecto a su fecha límite es la única forma de que nunca bloquee un lanzamiento.