Saltar al contenido

Configurar pruebas de sandbox en Android

GitHub

Probar compras in-app requiere una configuración correcta en Google Play Console. Esta guía te explica cómo configurar las pruebas en sandbox para tu app de Android.

Antes de empezar, distingue estos tres tipos de build de Android:

  • Build local de debug/dev: Ideal para verificar la UI y las integraciones nativas en tu dispositivo.
  • AAB de release firmado subido a Play Console: Necesario para pruebas realistas de facturación de Google Play.
  • Build de testing instalado desde Play: El build que tus testers instalan desde una pista interna o cerrada. Úsalo para QA de compras.

Si solo haces sideload de un APK desde Android Studio o adb, Google Play Billing puede no comportarse igual que en producción. Para validar suscripciones y compras in-app, prueba siempre con un build instalado desde Google Play.

  • Una cuenta de desarrollador de Google Play Console. Si aún no has creado una, empieza en el registro en Play Console.
  • Un registro de app creado en Play Console con tu nombre de paquete de Android definitivo
  • Tus productos in-app o suscripciones creados en Play Console
  • Una cuenta de Gmail de prueba que puedas añadir a las pruebas de licencia
  • Un build de release firmado y listo para subir

Antes de dedicar tiempo a configurar la facturación, crea la app en Play Console y decide si será gratis o de pago. Google te permite pasar una app de pago a gratuita más adelante, pero una vez que una app se ha ofrecido gratis, ya no se puede pasar a de pago.

Usa un Android App Bundle (.aab) para nuevas apps de Play Store:

Ventana de terminal
bunx cap sync android
cd android
./gradlew bundleRelease

Asegúrate de tener configurada la firma de release de Android antes de ejecutar bundleRelease. Si aún no has configurado el keystore, la signing config o las contraseñas de release, genera el bundle firmado desde Android Studio con Build > Generar App Bundle / APK firmado, que te pedirá esos valores.

  1. Añadir cuenta de prueba

    En Play Console, abre Configuración > Pruebas de licencia y añade la cuenta de Google principal que usas en tu dispositivo Android de prueba.

    Esto garantiza que las compras muestren el flujo de sandbox de Play en lugar de intentar un cargo real.

    Añadir cuenta de prueba

  2. Elegir una pista de pruebas

    Ve a Probar y publicar > Pruebas y elige una de estas pistas:

    • Pruebas internas: Ruta más rápida para QA y pruebas de humo de facturación. Los nuevos bundles suelen estar disponibles en minutos.
    • Pruebas cerradas: Mejor para pruebas más amplias y obligatorio antes de producción para cuentas de desarrollador personal creadas después del 13 de noviembre de 2023.

    Para un primer lanzamiento, Play puede mostrar a los probadores internos un nombre temporal de la app e información de la ficha durante un máximo de 48 horas.

    Crear canal de pruebas

  3. Crear lista de testers

    Tras abrir tu canal, crea una lista de testers y añade las cuentas de Google que recibirán el build.

    Si buscas acceso a producción con una cuenta personal recién creada, asegúrate de usar pruebas cerradas y mantén al menos 12 testers inscritos durante 14 días consecutivos.

    Crear lista de testers

  4. Subir un build de release firmado

    Crea un nuevo release en el canal de pruebas seleccionado y sube tu build firmado .aab.

    Las nuevas apps de Google Play deben usar Android App Bundle en vez de APK. Tras la subida, guarda el release, corrige los bloqueos de políticas o de la ficha de la tienda que Play señale y publica el release en el canal de pruebas.

    Subir build de release

  5. Unirse al programa de pruebas

    Abre la URL de registro en tu dispositivo de prueba y haz clic en el “Hazte tester” para inscribirte.

    Instala la app desde la ficha de Play Store creada por ese flujo de opt-in, no desde un APK exportado localmente.

    Unirse al testing

  6. Build y pruebas

    Ejecuta la build instalada desde Play en el dispositivo de prueba e intenta hacer una compra. Deberías ver un mensaje como:

    “Este es un pedido de prueba; no se te cobrará.”

    Compra de prueba

  • Para el QA de facturación, desinstala cualquier copia de la app instalada por sideload antes de instalar la build de pruebas de Play.
  • Las pruebas internas son ideales para pruebas rápidas, pero las pruebas cerradas son la vía clave para acceder a producción con cuentas personales nuevas.
  • Las cuentas de prueba no se cobrarán por las compras
  • Las compras de prueba usan el mismo flujo que las compras de producción
  • Puedes probar todas las funciones de suscripción, incluidas las pruebas y las ofertas introductorias
  • Las suscripciones de prueba tienen períodos de renovación acelerados para una prueba más rápida
  • Usa la misma cuenta de Google en los tres sitios: la Play Store en el dispositivo, el flujo de opt-in del tester y la prueba de licencias

Productos que no aparecen en modo de prueba:

  • Asegúrate de que tu app esté subida a una vía de pruebas
  • Verifica que la cuenta de prueba esté en License testing
  • Comprueba que los productos estén activos en Google Play Console
  • Confirma que el build se instaló desde Google Play y no mediante sideload local

Error “Item not available”:

  • Espera 2-3 horas tras crear los productos para que estén disponibles
  • Asegúrate de que el package name de tu app coincida con el de Play Console
  • Verifica que hayas iniciado sesión con una cuenta de prueba
  • Confirma que subiste el signed release build que apunta al mismo package name y catálogo de productos

Compras de prueba que aparecen como cargos reales:

  • Revisa que la cuenta esté añadida a License testing
  • Asegúrate de usar el build del track de pruebas
  • Verifica que aparezca el banner de prueba durante la compra

Continúa desde Configurar pruebas de sandbox de Android

Sección titulada “Continúa desde Configurar pruebas de sandbox en Android”

Si estás usando Configurar pruebas de sandbox en Android para planificar la aprobación y distribución en la tienda, conéctalo con Uso de @capgo/native-purchases para la capacidad nativa al usar @capgo/native-purchases, @capgo/capacitor-in-app-review para el detalle de implementación en @capgo/capacitor-in-app-review, Usando @capgo/capacitor-in-app-review para la capacidad nativa en «Usando @capgo/capacitor-in-app-review», @capgo/capacitor-native-market para el detalle de implementación en @capgo/capacitor-native-market, y Usando @capgo/capacitor-native-market para la capacidad nativa en «Usando @capgo/capacitor-native-market.»