html2apk

Convierte cualquier archivo HTML en un APK de Android instalable. Sin Gradle, sin Android Studio y sin conexión a internet.

De un .html a una app instalable en un comando

La herramienta envuelve tu HTML en un WebView nativo a pantalla completa y compila el APK usando solo las herramientas que ya vienen con el SDK de Android: aapt2, javac, d8, zipalign y apksigner. No descarga dependencias ni necesita un proyecto de Gradle.

Escribí el script porque publicar un juego HTML en Android normalmente obliga a instalar Android Studio, esperar minutos de compilación y cargar cientos de megas de herramientas para terminar empaquetando un archivo de 20 KB. Esto hace lo mismo en segundos y sin nada instalado de más.

PowerShellAndroid SDKaapt2d8apksignerWebView

Descargar desde GitHub Ver el código ↗

Cómo se usa

Con el nombre y el identificador deducidos del propio archivo:

.\html2apk.ps1 -Html .\mi_juego.html

Con nombre propio, identificador y la instalación directa en el celular por USB:

.\html2apk.ps1 -Html .\mi_juego.html `
  -Nombre "Mi Juego" `
  -Package com.yo.mijuego `
  -Instalar

Si el equipo tiene la política de ejecución restringida, se lanza así:

powershell -NoProfile -ExecutionPolicy Bypass `
  -File .\html2apk.ps1 -Html .\juego.html

Qué hace por dentro

Comprueba el HTML y deduce el nombre, el identificador y el slug del paquete.
Busca solo el SDK, las build-tools, la plataforma y el JDK en las rutas habituales.
Genera el proyecto Android completo: manifest, MainActivity.java, recursos y los 5 iconos.
Compila en cadena: aapt2 compile → aapt2 link → javac → d8.
Empaqueta el classes.dex dentro del APK.
Alinea con zipalign y firma con el keystore de desarrollo.
Verifica la firma y muestra el resumen del APK terminado.

Los proyectos generados quedan en _build\<slug>\, así que se pueden inspeccionar o abrir después con Android Studio.

Un caso real

Lo usé para llevar Snake 95 del navegador al celular. El juego completo, con sus menús y todo, pesa menos que una sola foto:

21 KBEl juego completo

17 KBUn hola mundo

0Dependencias

7Pasos de compilación

Firmado con un keystore de desarrollo, listo para instalar en cualquier Android 7 o superior.

Jugar Snake 95 en itch.io ↗

Parámetros

Parámetro	Por defecto	Para qué
-Html	—	El archivo .html que se va a convertir. Es el único obligatorio.
-Nombre	nombre del HTML	El nombre visible debajo del icono.
-Package	derivado del nombre	Identificador de la app, por ejemplo `com.yo.mijuego`.
-Icono	icono Win95 embebido	Un PNG propio para el icono de la app.
-Salida	.\dist	Carpeta donde dejar el APK terminado.
-Orientacion	portrait	`portrait`, `landscape`, `sensor` o `unspecified`.
-MinSdk / -TargetSdk	24 / 34	Versiones de Android que soporta la app.
-Instalar	—	Instala el APK en el celular conectado por USB al terminar.

Aviso sobre la firma. El script firma con una clave de desarrollo compartida, pensada para probar. Si vas a publicar en Google Play necesitas tu propio keystore, y hay que conservarlo: Android identifica cada app por su firma, así que si lo pierdes no podrás actualizar la app instalada, solo desinstalarla y volver a empezar.

Código abierto, y lo puedes comprobar

El script está en GitHub bajo licencia MIT. Eso significa que puedes leerlo entero antes de ejecutarlo, ver cada cambio que ha tenido y modificarlo a tu gusto. La descarga sale del apartado Releases del repositorio, no de un archivo suelto.

Y si quieres estar seguro de que el archivo que bajaste es exactamente el que publiqué, compara su huella:

Get-FileHash .\html2apk.ps1 -Algorithm SHA256
# f3b249d95296ff0917155a244b7d85e71cec388ed80f42ed01fc44fee85e5bcc

GitHubLicencia MITVerificable con SHA256

github.com/YeremiSB/html2apk ↗