Prueba cerrada de Google Play para juegos de Godot

Google Play necesita una firma que no sea de debug. Crea un keystore de release con keytool:

keytool -v -genkey -keystore mygame.keystore -alias mygame -keyalg RSA -validity 10000

En el preset de Android, en Keystore, rellena Release (la ruta del archivo), Release User (el alias) y Release Password. Por ahora Godot exige que la contraseña del keystore y la de la clave sean iguales, y lo más seguro es usar solo letras y números.

Este keystore es tu clave de subida. En la primera subida se configura la firma de aplicaciones de Play y Google guarda la clave de firma de la app. En CI, deja los secretos fuera de export_presets.cfg y pásalos como variables de entorno:

GODOT_ANDROID_KEYSTORE_RELEASE_PATH=/secrets/mygame.keystore
GODOT_ANDROID_KEYSTORE_RELEASE_USER=mygame
GODOT_ANDROID_KEYSTORE_RELEASE_PASSWORD=*****

En el preset, Version → Code es el entero que compara Google; súbelo en cada subida, porque Play Console rechaza los códigos repetidos. Version → Name es lo que ven los jugadores.

Desde el 31 de agosto de 2026, las apps nuevas y las actualizaciones deben apuntar a Android 16 (nivel de API 36). En Gradle Build, Target SDK fija targetSdkVersion; si se deja vacío, se aplica el valor predeterminado de la plantilla. Si el de tu versión de Godot es menor que 36, ponlo de forma explícita o actualiza Godot, y luego prueba la exportación en un dispositivo reciente.

• Plantillas que no coinciden. Las plantillas de exportación y la plantilla de build de Android deben coincidir con la versión del editor. Tras actualizar Godot, reinstala ambas.
• Export With Debug activado. El bundle se firma entonces con el keystore de debug y Play Console lo rechaza.
• Falta arm64-v8a. En Architectures, deja arm64-v8a activado; Google Play exige código nativo de 64 bits.
• Carpetas que empiezan por guion bajo. En los builds de Gradle no se incluyen los recursos de una carpeta cuyo nombre empieza por _. Los testers se encuentran con texturas o escenas que faltan.
• Caracteres especiales en las contraseñas. Pueden hacer fallar la exportación con errores poco claros. Usa letras y números.
• Proyectos en C#. La exportación a Android para C# existe desde Godot 4.2, pero sigue siendo experimental. Prueba pronto el bundle de release en dispositivos reales.

Una exportación de Godot ejecuta tus scripts sobre una biblioteca de motor precompilada, así que la mayoría de los informes de testers acaban siendo errores de script, recursos que faltan o problemas de renderizado de un dispositivo concreto, más que fallos del motor. La forma más rápida de verlos es en tu propio teléfono, con el editor conectado.

1. 1

   Despliega con un clic

   Activa el modo desarrollador y la depuración USB en un teléfono, conéctalo y comprueba que tu preset de Android está marcado como Runnable. Aparece entonces un botón de Android en la esquina superior derecha del editor que exporta e instala con un clic.

2. 2

   Activa la depuración remota

   Con Debug → Deploy with Remote Debug activado, el juego del teléfono se conecta de vuelta a tu ordenador, así que el depurador, los puntos de interrupción y la salida de errores del editor funcionan como en escritorio.

3. 3

   Pasa a inalámbrico si el USB falla

   Activa la depuración inalámbrica en el teléfono, vincúlalo con adb pair y el código que muestra, y compruébalo con adb devices. Si adb devices no muestra el teléfono, Godot tampoco lo verá.

4. 4

   Revisa Play Console tras cada subida

   Los fallos del motor aparecen en Supervisar y mejorar → Android vitals → Fallos y ANR. El informe previo al lanzamiento además instala automáticamente cada build subido en dispositivos de prueba y señala fallos y problemas de compatibilidad.

# Wireless debugging: pair once with the code shown on the phone
adb pair <ip address>:<port>
adb devices

# Watch the device log while you reproduce a tester's report
adb logcat

Un build exportado sin Export With Debug no se conecta al editor. Para ver por qué el build de release falla en un teléfono concreto, instálalo en él y sigue adb logcat mientras reproduces los pasos del tester.

En cuanto tu bundle de Godot esté compilado y firmado, el resto ocurre en Play Console y funciona igual con cualquier framework. Esta es la lista de comprobación; cada menú y cada pantalla están en la guía completa de Play Console.

• Termina la configuración de la app en el Panel: política de privacidad, acceso a la app, anuncios, clasificación de contenido, público objetivo, seguridad de los datos y ficha de Play Store.
• Crea una versión de prueba cerrada en Probar y publicar → Pruebas → Prueba cerrada: elige los países de tus testers, sube el .aab y envíalo a revisión.
• Añade testers con un Google Group en la pestaña Testers y comparte el enlace de opt-in. Funciona en cuanto el canal muestra Publicado.
• Mantén al menos 12 testers con opt-in durante 14 días seguidos. Las pruebas internas no cuentan, y quien sale y vuelve empieza sus 14 días de nuevo.
• Publica al menos una actualización durante la prueba y apunta qué encontraron los testers y qué cambiaste.
• Solicita acceso a producción desde el Panel y responde las tres secciones sobre tu prueba, tu app y tu preparación. La decisión es de Google; nadie puede garantizar la aprobación.

Cuenta con bajas: recluta más de 12 testers para que una baja no retrase tu calendario. Ver todos los pasos de Play Console.

Sube Version → Code en el preset, vuelve a exportar el .aab y súbelo al mismo canal cerrado.

Para tus propias pruebas, Debug → Small Deploy with Network Filesystem despliega un ejecutable mínimo por USB y sirve los archivos del proyecto desde el editor por la red, lo que ahorra mucho tiempo en juegos grandes. Es solo una función de desarrollo: los testers siempre necesitan un .aab completo exportado en el canal cerrado.

• De borde a borde. La opción Screen → Edge to Edge del preset permite al juego dibujar detrás de barras del sistema translúcidas. Si la activas, mantén la interfaz importante dentro del área que devuelve DisplayServer.get_display_safe_area() para que nada quede bajo una barra o un recorte de cámara.
• No comprimas las bibliotecas nativas. Gradle Build → Compress Native Libraries reduce el bundle pero ralentiza el arranque, porque las bibliotecas deben extraerse antes de usarse. Para Google Play, la documentación de Godot recomienda dejarla desactivada.
• Automatiza la exportación. Una exportación headless con el keystore en variables de entorno, como en la sección de firma, genera siempre el mismo bundle y convierte el aumento del código de versión en rutina.
• No actualices Godot a mitad de la prueba. Una versión nueva del editor implica nuevas plantillas de exportación, una nueva plantilla de build de Android y una nueva biblioteca de motor para los testers. Actualiza antes de la prueba o después del acceso a producción.