Publicar juego HTML5 en Google Play con Capacitor, paso a paso

Para publicar un juego HTML5 en Google Play, empaquetas la carpeta del juego en un proyecto Android nativo con Capacitor, generas un Android App Bundle firmado en Android Studio, creas la app en Play Console, contestas sus formularios de contenido y subes el paquete a un canal de prueba antes de producción. Si tu cuenta de desarrollador es personal y se creó después del 13 de noviembre de 2023, Google además exige una prueba cerrada con al menos 12 testers durante 14 días antes de que puedas pedir el acceso a producción.

Ya lo hicimos con juegos propios. En octubre de 2026 empaquetamos Ricopop y Velvet Pool con Capacitor y enviamos los dos a la revisión de producción de Google Play, y también nuestro juego de acción Little Ninja Dash. Esta guía junta lo que dicen las páginas oficiales de Capacitor, Android y Play Console, consultadas el 30 de octubre de 2026, con lo que registran nuestras notas de lanzamiento. Las reglas y los requisitos cambian: revisa cada página antes de enviar.

Antes de empezar: cuenta, licencia y herramientas

• Una cuenta de desarrollador de Google Play. Google cobra una cuota única de registro de US$25 y pide a todos verificar su identidad. Las cuentas personales además deben comprobar que tienen acceso a un dispositivo Android con la app Play Console antes de publicar.
• Node.js y Android Studio. La documentación de Android de Capacitor dice que estas apps se configuran y administran desde Android Studio.
• Un juego que funcione sin conexión desde su propia carpeta, con un index.html en la raíz.
• Una licencia del juego. En nuestras plantillas, una licencia cubre un producto final, y puedes publicar ese juego donde quieras, Google Play y la App Store incluidas. No puedes revender la plantilla en sí. Pregúntanos antes de cobrar por la app o agregar compras dentro de ella, porque nuestros términos hablan de acceso gratis o con anuncios.

Nuestras ediciones de plantilla son juegos para navegador. La página de cada edición dice que no incluye versiones nativas de app, así que los pasos de abajo son trabajo tuyo o trabajo que nos encargas por cotización.

Ver Velvet Pool, la plantilla de billar que también empaquetamos para Android

Paso 1: empaquetar la carpeta del juego con Capacitor

Capacitor necesita un package.json, una carpeta con los archivos web listos y un index.html en la raíz de esa carpeta. Su guía de inicio advierte que el index.html debe tener la etiqueta head o los plugins no funcionan. Una plantilla HTML5 descargada suele traer esa carpeta: en las nuestras se llama game/.

1. En una carpeta de proyecto nueva, ejecuta npm i @capacitor/core y npm i -D @capacitor/cli.
2. Ejecuta npx cap init. Te pide el nombre de la app, el ID de la app (dominio al revés, por ejemplo com.tuestudio.tujuego) y la carpeta web. Apunta webDir a la carpeta del juego.
3. Ejecuta npm i @capacitor/android y luego npx cap add android. Eso crea el proyecto android/.
4. Ejecuta npx cap sync cada vez que cambies los archivos del juego. Los copia al proyecto nativo.
5. Ejecuta npx cap open android para abrir el proyecto en Android Studio.

La documentación de Capacitor dice que se soporta la API 24 en adelante, es decir, Android 7 o más reciente. Nuestros proyectos Android usan ese mínimo.

Lo que hacemos distinto: mantenemos el proyecto nativo en un espacio de trabajo aparte, mobile/, que copia el juego a su propia carpeta web. La versión del sitio queda intacta, y lo que es solo de la app, como los anuncios nativos, vive en ese espacio.

Paso 2: generar y firmar el paquete

Desde agosto de 2021 las apps nuevas en Google Play deben publicarse como Android App Bundle (AAB), no como APK. En Android Studio, usa Build y luego Generate Signed Bundle/APK, elige Android App Bundle y crea o selecciona un keystore.

Ese keystore guarda tu clave de subida. La página de firma de Android explica que con la Firma de apps de Google Play, obligatoria para apps nuevas en su primera publicación, Google guarda la clave de firma de la app y tú firmas cada subida con la clave de subida. Mantén esa clave en secreto, usa contraseñas fuertes y guarda el keystore en un lugar seguro. Si se pierde o se filtra, Play Console permite pedir el restablecimiento de la clave de subida.

• Nivel de API objetivo: desde el 31 de agosto de 2026, las apps nuevas y las actualizaciones deben apuntar a Android 16 (API 36) o superior. Revisa el objetivo en android/app/build.gradle.
• Código de versión: súbelo antes de cada envío. Cada paquete que subes consume su código de versión, por eso revisamos el número más alto en Play Console antes de cada build.
• Solo build de lanzamiento: nada de menús de depuración, IDs de anuncios de prueba ni atajos de desarrollador en el paquete que va a producción.

Lo que se rompe dentro del webview, y lo que hicimos

Un juego que corre bien en el navegador puede portarse distinto dentro de una app. Estos son los problemas que registraron nuestras notas de lanzamiento, con la solución documentada cuando existe.

El botón Atrás de Android

El plugin App de Capacitor tiene el evento backButton. Su documentación dice que al escucharlo se desactiva el comportamiento por defecto del botón Atrás, así que tú decides qué hace, y ofrece App.exitApp() para cerrar la app. En Velvet Pool, Atrás abre el menú de pausa en lugar de cerrar el juego.

Pausa y regreso

El mismo plugin dispara los eventos appStateChange, pause y resume. Úsalos para pausar el juego, los temporizadores y cualquier anuncio en curso cuando el jugador sale de la app, y para volver sin tropiezos.

Atajos de depuración en localhost

Dentro de la app, Capacitor sirve el juego desde una dirección local. Si tu juego enciende herramientas de depuración cuando corre en localhost, también se encienden en la app. Nuestros scripts de build fuerzan esas opciones a apagado y se niegan a generar el paquete si no lo logran.

Anuncios

El código de anuncios del sitio web no es lo que usamos en nuestras apps. En Android usamos el SDK nativo de AdMob mediante un plugin de Capacitor, con los bloques de demostración de Google durante las pruebas y los bloques propios de la app solo en el build de producción.

Diseño y progreso guardado

En el emulador encontramos botones cortados en horizontal y palabras largas mal partidas, cosas que la versión de navegador no mostraba. Prueba todas las pantallas en las dos orientaciones y revisa que el progreso siga ahí después de cerrar y abrir la app.

Ver Ricopop, otra plantilla que empaquetamos para Google Play

Paso 3: configurar Play Console y la ficha de la tienda

Crea la app en Play Console y después recorre la sección de contenido de la app. Los formularios que llenamos en cada juego fueron política de privacidad, acceso a la app, anuncios, clasificación de contenido, público objetivo, seguridad de los datos, ID de publicidad y las declaraciones de gobierno, finanzas y salud.

• Clasificación de contenido: Google dice que toda app necesita una clasificación de la IARC, y las apps sin clasificación se eliminan. Se obtiene contestando el cuestionario con honestidad.
• Seguridad de los datos: toda app debe llenarla, incluso las que no recogen datos. Tiene que reflejar los datos que recogen los SDK de terceros, como uno de anuncios, y pide el enlace a la política de privacidad.
• Público objetivo: contesta según los jugadores a los que de verdad apuntas. La clasificación y el público son respuestas separadas.

Gráficos y textos de la ficha

• Ícono: 512 por 512 píxeles, PNG de 32 bits, hasta 1024 KB.
• Gráfico de funciones: 1024 por 500 píxeles, JPEG o PNG de 24 bits sin transparencia.
• Capturas: al menos dos y hasta ocho por tipo de dispositivo. Para juegos, Google recomienda al menos tres capturas 16:9 en horizontal (mínimo 1920 por 1080) o 9:16 en vertical (mínimo 1080 por 1920) que muestren el juego real.
• Descripción breve: hasta 80 caracteres.

Paso 4: pruebas y después producción

Nuestra guía interna pone primero la prueba interna: instalar la app desde Play con una cuenta real y jugarla antes que nada. Después la versión se promueve a producción, donde pasa por la revisión de Google.

La regla para cuentas personales nuevas

El Centro de ayuda de Play Console dice que las cuentas personales de desarrollador creadas después del 13 de noviembre de 2023 deben hacer una prueba cerrada con un mínimo de 12 testers inscritos sin interrupción durante al menos 14 días. Después pides el acceso a producción desde el Panel y contestas preguntas sobre la prueba cerrada, la app y si está lista para producción. Mete esas dos semanas en tu calendario de lanzamiento.

Separa los estados cuando le reportes a un cliente: subida a un canal de prueba, enviada a revisión, aprobada y pública en Google Play son cuatro momentos distintos. Nuestras notas de lanzamiento registran fechas de envío, no de aprobación, y esta guía también.

Lo que incluyen nuestras plantillas, y la parte que podemos hacer

Cada plantilla trae la carpeta del juego lista para alojar, código legible, manual y 6 meses de soporte, o 12 con la extensión. El soporte cubre instalar y usar los archivos entregados y corregir defectos que se puedan reproducir. Empaquetar para Android, anuncios nativos, integración de SDK y publicación en la tienda son servicios aparte.

Si prefieres no meterte con Android Studio, mándanos la plantilla, cómo será la cuenta de la tienda y el plazo. Te respondemos con alcance, precio y tiempos antes de cualquier trabajo. No publicamos lista de precios para trabajo a medida.

Pedir una cotización para empaquetar tu juego para Google Play

Preguntas frecuentes sobre publicar un juego HTML5 en Google Play

¿Cuánto cuesta publicar un juego HTML5 en Google Play?

Google cobra una cuota única de US$25 por la cuenta de desarrollador. Tus otros costos son la licencia del juego, el arte de la tienda y tu tiempo, o un servicio cotizado si alguien más hace el empaquetado.

¿Necesito 12 testers para publicar en Google Play?

Solo si tu cuenta es personal y se creó después del 13 de noviembre de 2023. Esas cuentas deben hacer una prueba cerrada con al menos 12 testers inscritos durante al menos 14 días antes de pedir acceso a producción.

¿APK o AAB?

AAB. Las apps nuevas en Google Play deben usar Android App Bundle desde agosto de 2021. El APK sigue sirviendo para instalar un build directo en tu teléfono de pruebas.

¿La app puede solo abrir el juego desde mi sitio web?

Nosotros no lo hacemos así. Metemos los archivos del juego dentro de la app para que funcione sin conexión y no dependa de un sitio. La política de spam de Google además apunta a las apps cuyo fin principal es mostrar un sitio en un webview sin permiso del dueño.

¿Sus plantillas vienen listas para Google Play?

No. Son juegos para navegador listos para alojar, y las páginas de cada artículo dicen que no incluyen versiones nativas de app. Puedes empaquetarlas con los pasos de arriba o encargarnos el trabajo por cotización.