Configurar pruebas de sandbox de Android

La prueba de compras en la aplicación requiere una configuración adecuada en el Console de Google Play. Esta guía te guiará a través del proceso de configuración de pruebas de sandbox para tu aplicación de Android.

Usar el build adecuado para el trabajo

Antes de empezar, separa estos tres tipos de builds de Android:

• Build de depuración/local/dev: Bueno para verificar la interfaz de usuario y las integraciones nativas en tu dispositivo.
• Subido a la consola de Play el AAB de lanzamiento firmado: Necesario para pruebas de facturación de Google Play realistas.
• Edición de prueba instalada en Play: La edición que tus probadores instalan desde una pista interna o cerrada. Utiliza esto para la validación de compras.

Si solo cargas un APK desde Android Studio o adb, la facturación de Google Play Billing puede no comportarse de la misma manera que en producción. Para la validación de suscripciones y compras en la aplicación, siempre prueba con una edición instalada desde Google Play.

Requisitos previos

• Una cuenta de desarrollador de la consola de Play. Si aún no la has creado, comienza en Registro en la consola de Play.
• Un registro de aplicación creado en la consola de Play con tu nombre de paquete Android final
• Sus productos o suscripciones en la aplicación creados en el Console de Play
• Una cuenta de Gmail de prueba que puede agregar para la prueba de licencia
• Un paquete de lanzamiento firmado listo para subir

Antes de dedicar tiempo a la configuración de facturación, cree la aplicación en el Console de Play y decida si será gratuito o pagado. Google le permite mover una aplicación pagada a gratuita más tarde, pero una vez que una aplicación ha sido ofrecida de forma gratuita, no puede ser cambiada a pagada

Utilice un Android App Bundle (.aab) para nuevas aplicaciones del Tienda de Play:

bunx cap sync android
cd android
./gradlew bundleRelease

Asegúrese de que su configuración de firma de lanzamiento de Android esté configurada antes de ejecutar bundleRelease. Si su keystore, configuración de firma o contraseñas de lanzamiento no están configurados aún, cree el paquete firmado desde Android Studio con Generar > Generar paquete firmado de App Bundle / APK, lo que le solicita esos valores.

Proceso de configuración

1. Agregar cuenta de prueba

   En la consola de Play, abra Configuración > Licencia de prueba y agregue la cuenta de Google principal utilizada en su dispositivo de prueba de Android.

   Esto garantiza que las compras muestren el flujo de Play Sandbox en lugar de intentar una carga real.

   

2. Elige un itinerario de pruebas

   Ir a Prueba y publica > Pruebas y elige una de estas pistas:

   • Pruebas internas: El camino más rápido para las pruebas de QA y los tests de humo de facturación. Los nuevos conjuntos de paquetes suelen estar disponibles en minutos.
   • Pruebas cerradas: Mejor para pruebas más amplias, y necesarias antes de la producción para cuentas de desarrolladores personales creadas después del 13 de noviembre de 2023.

   Al publicar una aplicación por primera vez, Play puede mostrar un nombre de aplicación temporal y información de lista a los probadores internos durante hasta 48 horas.

   

3. Crear lista de probadores

   Después de abrir tu itinerario, crea una lista de probadores y agrega las cuentas de Google que deberían recibir la compilación.

   Si estás trabajando hacia el acceso a producción en una cuenta personal recién creada, asegúrate de utilizar pruebas cerradas y mantén al menos 12 probadores optados en 14 días consecutivos.

   

4. Subir una compilación de lanzamiento firmada

   Crear una nueva versión en la pista de pruebas seleccionada y subir tu compilación de .aab.

   Nuevos aplicativos de Google Play deben utilizar un paquete de aplicación de Android en lugar de un APK. Después de la carga, guarda la versión, corrige cualquier bloqueador de política o lista de presentación de tiendas de Play flags, luego publica la versión en la pista de pruebas.

   

5. Unirte al Programa de Pruebas

   Abre la URL de opt-in desde tu dispositivo de prueba y haz clic en el “Convertirte en un probador” botón para inscribirte.

   Instale la aplicación desde la lista de la Tienda de Juegos creada por ese flujo de opt-in, no desde un APK exportado localmente.

   

6. Construye y Prueba

   Lanzar la construcción de la Tienda de Juegos en el dispositivo de prueba y realice una compra. Debe ver un mensaje como:

   “This is a test order; you will not be charged.”

   

Notas importantes

• Antes de instalar la construcción de prueba de la Tienda de Juegos, desinstale cualquier copia cargada internamente de la aplicación.
• La prueba interna es genial para pruebas rápidas de humo, pero la prueba cerrada es el camino que importa para el acceso de producción de cuentas personales.
• Las cuentas de prueba no serán cobradas por compras
• Las compras de prueba utilizan el mismo flujo que las compras de producción
• Puede probar todas las características de suscripción, incluyendo pruebas y ofertas introductorias
• Las suscripciones de prueba tienen períodos de renovación acelerados para pruebas más rápidas
• Utilice la misma cuenta de Google en los tres lugares: la tienda de aplicaciones en el dispositivo, el flujo de opción para pruebas y la prueba de licencia

Solución de problemas

Los productos no se muestran en modo de prueba:

• Asegúrese de que su aplicación esté subida a un seguimiento de pruebas
• Verifique que la cuenta de prueba esté agregada a la prueba de licencia
• Verifique que los productos estén activos en el Console de Google Play
• Confirme que la compilación se instaló desde Google Play, no se cargó localmente

Error de "Item no disponible":

• Espere 2-3 horas después de crear productos para que se vuelvan disponibles
• Asegúrese de que el nombre de paquete de la aplicación coincida con el de la consola de Play
• Verifique que está conectado con una cuenta de prueba
• Confirme que subió el archivo de liberación firmado que apunta al mismo nombre de paquete y catálogo de productos

Pruebas de compras que se muestran como cargos reales:

• Revisar si la cuenta está agregada a la licencia de prueba
• Asegúrese de que esté utilizando la compilación del track de prueba
• Verifique que aparece el banner de prueba durante la compra

Recursos adicionales

• Pruebas de compras con Google Play Billing
• Configurar una prueba abierta, cerrada o interna
• Requisitos de prueba para nuevos desarrolladores personales