Convertir ZIP a APK

Un instalador de Android requiere un .apk cuando la descarga de una aplicación llega como .zip, o cuando un proyecto de Android debe empaquetarse para realizar pruebas o instalarse mediante sideloading. El resultado correcto depende de si el archivo contiene un APK existente, un proyecto compilable, archivos de APK decodificados o únicamente archivos no relacionados.

Qué es el formato ZIP

ZIP es un archivo comprimido de uso general que agrupa archivos y carpetas para descargas, uso compartido, copias de seguridad y almacenamiento. Windows File Explorer, macOS Archive Utility, 7-Zip, WinRAR, Android Studio y los sistemas de compilación pueden crear archivos ZIP.

Un ZIP suministrado con software de Android puede contener un proyecto de Android Studio, código fuente, imágenes, bibliotecas, una aplicación descompilada o un APK almacenado dentro de otro archivo. Los archivos de proyecto conservan la estructura de carpetas necesaria durante la transferencia; no son aplicaciones hasta que se compila su código fuente.

Qué es el formato APK

APK es el formato de paquete de aplicaciones de Android. Utiliza contenedores ZIP internamente, pero un paquete instalable normalmente contiene un AndroidManifest.xml compilado, recursos compilados como resources.arsc, bytecode DEX como classes.dex y, cuando es necesario, bibliotecas nativas en lib/.

Los paquetes de Android deben estar firmados. Los APK de depuración suelen utilizar la clave de depuración de Android Studio; los APK de lanzamiento utilizan una clave de firma controlada por el desarrollador. Los APK están destinados a la instalación, las pruebas, la instalación mediante sideloading y la distribución fuera de Google Play. Google Play suele recibir Android App Bundles (.aab), que no son APK instalables directamente.

Cómo compilar un APK a partir de un ZIP

Si el ZIP contiene un proyecto de Android Studio

1. Extrae el archivo con 7-Zip o la utilidad de archivos del sistema operativo. No cambies primero la extensión.
2. Abre Android Studio y selecciona File → Open. Selecciona el directorio extraído que contiene settings.gradle, settings.gradle.kts o el módulo de la aplicación.
3. Permite que Gradle se sincronice. Instala la plataforma de Android SDK, las herramientas de compilación y las demás versiones requeridas por el proyecto.
4. Para un paquete de prueba, selecciona Build → Generate App Bundles or APKs → Generate APKs. Para su distribución, selecciona Build → Generate Signed App Bundle or APK, elige APK y proporciona una clave de firma.
5. Comprueba una ruta como app/build/outputs/apk/debug/app-debug.apk o app/build/outputs/apk/release/app-release.apk.

Desde el directorio del proyecto, ejecuta ./gradlew assembleDebug en macOS o Linux, o gradlew.bat assembleDebug en Windows. Una compilación de lanzamiento normalmente requiere una configuración de firma; utiliza assembleRelease únicamente después de configurar el almacén de claves y los ajustes de firma.

Si el ZIP contiene un APK existente

Extrae el archivo y localiza el archivo cuyo nombre termine en .apk. Comprueba su origen y firma antes de instalarlo. Si el APK original se renombró como .zip, vuelve a cambiar la extensión a .apk; no extraigas, vuelvas a comprimir ni modifiques su contenido.

Si el ZIP contiene archivos de APK decodificados

Un archivo producido por APKTool se puede volver a compilar con APKTool, pero no un ZIP arbitrario. Después de instalar APKTool, ejecuta apktool b extracted-app -o rebuilt.apk. Alinea y firma el resultado con Android SDK Build Tools:

1. zipalign -v -p 4 rebuilt.apk aligned.apk
2. apksigner sign --ks release-key.jks --out signed.apk aligned.apk
3. apksigner verify signed.apk

Utiliza la misma clave de firma que la aplicación original para producir una actualización; un paquete firmado con una clave diferente no puede reemplazar una instalación existente. Volver a compilar la aplicación de otro desarrollador puede infringir su licencia o las reglas de protección contra manipulaciones.

Si el ZIP contiene únicamente archivos de código fuente o recursos

No existe una conversión de formato. Crea o abre un proyecto de Android, coloca los recursos permitidos en los directorios app/src/main correspondientes, añade el código de la aplicación y un manifiesto válido, configura las dependencias y los permisos, y después compila y firma el proyecto con Android Studio o Gradle.

Herramientas en línea y de escritorio

Ningún convertidor en línea fiable de un solo clic puede convertir un ZIP arbitrario en un APK funcional: no puede inventar el código de Android que falta, compilar de forma fiable un proyecto desconocido ni firmar el resultado con tu clave privada. Android Studio de escritorio con Gradle es la herramienta adecuada para proyectos de código fuente; APKTool es adecuado únicamente para volver a compilar APK decodificados por APKTool; zipalign y apksigner completan el proceso de lanzamiento.

Para un proyecto que se pueda compilar sin interacción, una opción en línea fiable es un flujo de trabajo privado de GitHub Actions que ejecute la tarea de Gradle del proyecto. Almacena las credenciales de firma como secretos cifrados del repositorio, restringe el acceso al flujo de trabajo y evita cargar código fuente propietario, almacenes de claves o APK privados en sitios de conversión genéricos. Los servicios de archivos en línea pueden extraer un ZIP, pero la extracción no genera un APK.

Límites de compatibilidad y calidad

Renombrar .zip como .apk no compila el código fuente, crea un manifiesto, genera archivos DEX, empaqueta recursos, alinea archivos ni firma el paquete. Un ZIP genérico puede tener una estructura de contenedor similar y, aun así, no ser utilizable por Android.

La compilación debe utilizar versiones del SDK y de las herramientas de compilación compatibles con el proyecto. La instalación también puede depender del nivel de API de Android del dispositivo, la arquitectura de la CPU, el nombre del paquete, los permisos y el esquema de firma. Un APK que contenga únicamente arquitecturas nativas seleccionadas puede fallar en dispositivos con otra arquitectura, mientras que un APK destinado a una plataforma incompatible puede rechazar la instalación o funcionar incorrectamente.