Convertir APK a AAB

Google Play requiere Android App Bundles para las nuevas cargas de aplicaciones, por lo que un desarrollador puede necesitar un AAB cuando una compilación anterior solo existe como APK. Un APK se puede instalar directamente, pero normalmente un AAB debe reconstruirse desde el proyecto original de Android o reconstruirse localmente a partir del APK.

Qué es el formato APK

Un APK es un paquete de aplicación de Android que los teléfonos, tablets, dispositivos Android TV y emuladores instalan directamente. Es un archivo basado en ZIP que contiene código compilado, recursos, el manifiesto, assets, bibliotecas nativas e información de firma del APK.

Android Studio y Android Gradle Plugin generan APK mediante tareas de Gradle como ./gradlew assembleRelease. Los desarrolladores también reciben APK de servidores de compilación, servicios de pruebas, extracción desde dispositivos y distribución fuera de Google Play. Un APK es un formato de instalación; un dispositivo Android no instala un AAB directamente.

Qué es el formato AAB

Un AAB, o Android App Bundle, es un paquete de publicación que contiene los módulos y recursos compilados de una aplicación. Google Play lo procesa para convertirlo en APK específicos para cada dispositivo, seleccionando la densidad de pantalla, los recursos de idioma, la arquitectura de CPU y las dynamic features necesarias en lugar de entregar todo en un único APK universal.

Esto puede reducir el tamaño de la descarga y habilita Google Play Feature Delivery y Play Asset Delivery. Normalmente, un AAB se produce desde un proyecto de Android Studio o Gradle con ./gradlew bundleRelease, que normalmente crea app/build/outputs/bundle/release/app-release.aab. La compilación release debe tener una configuración de firma válida antes de poder cargarse.

Cómo crear un AAB desde el proyecto original

1. Abre el proyecto en una versión compatible de Android Studio y sincroniza sus versiones de Gradle y Android Gradle Plugin. Usa las versiones requeridas por el proyecto en lugar de actualizarlas indiscriminadamente.
2. Comprueba el ID de aplicación, el código de versión, las dependencias release, las variantes de producto, las bibliotecas nativas, las declaraciones del manifiesto y la configuración de firma.
3. En Android Studio, selecciona Build → Generate Signed Bundle / APK, elige Android App Bundle, selecciona la variante release y proporciona las credenciales del keystore y la clave. Como alternativa, ejecuta ./gradlew bundleRelease desde el directorio del proyecto.
4. Recupera el resultado de app/build/outputs/bundle/release/. Un proyecto con varios módulos puede colocar el bundle en el directorio de salida del módulo correspondiente.
5. Valida y prueba el bundle con el bundletool oficial de Google. Por ejemplo, bundletool validate --bundle=app-release.aab comprueba su estructura. Para crear APK instalables en un dispositivo conectado, ejecuta bundletool build-apks --bundle=app-release.aab --output=app.apks --connected-device, proporcionando las opciones de keystore requeridas si bundletool necesita firmar los APK generados; después, ejecuta bundletool install-apks --apks=app.apks.

Android Studio es la opción de escritorio adecuada porque conserva la configuración de Gradle, el procesamiento de recursos, la firma, las variantes de compilación y los módulos dynamic-feature. bundletool es la utilidad de línea de comandos de Google para validar, inspeccionar, crear e instalar conjuntos de APK a partir de un AAB; no convierte un APK terminado arbitrario en un proyecto de código fuente ni en un bundle equivalente.

Si solo está disponible el APK

No existe una conversión fiable mediante un solo comando de un APK terminado a un AAB equivalente. La compilación, el procesamiento de recursos, la reducción de código, la resolución de dependencias y la firma ya se han realizado, y el APK no contiene el proyecto completo de Gradle necesario para reproducir esos pasos.

Para una aplicación de tu propiedad, la reconstrucción es posible, pero se trata de una nueva compilación y no de una conversión de formato de archivo:

1. Decodifica los recursos y el manifiesto con apktool d app.apk -o decoded-app.
2. Inspecciona el código Java o similar a Kotlin decompilado con jadx-gui app.apk. El resultado de la decompilación sirve como referencia y normalmente necesita correcciones importantes antes de poder compilarse.
3. Crea un proyecto de Android Studio y restaura la estructura de paquetes, los recursos, los assets, las declaraciones del manifiesto, las bibliotecas nativas, las dependencias, la configuración de Gradle y cualquier módulo dynamic-feature necesario.
4. Resuelve las diferencias de compilación y ejecución, configura el ID de aplicación y el código de versión correctos, y después genera y firma el bundle release con ./gradlew bundleRelease.

Los convertidores genéricos de APK a AAB en línea no son un sustituto adecuado para este proceso. Ningún servicio en línea acreditado puede recuperar de forma fiable el código fuente y la configuración de compilación que faltan a partir de un APK, y cargar un APK puede exponer código propietario, credenciales integradas, certificados o datos de la aplicación. Mantén la reconstrucción local; usa Google Play Console únicamente para cargar y probar el AAB resultante.

Limitaciones de compatibilidad y publicación

• Un bundle reconstruido puede comportarse de forma diferente porque la ofuscación, los recursos eliminados, el código generado, la configuración de compilación nativa y las versiones de las dependencias pueden no ser recuperables a partir del APK.
• Una actualización debe usar el mismo ID de aplicación y una identidad de firma aceptada para la aplicación existente. Con Google Play App Signing, la carga debe utilizar la clave de carga registrada; disponer de un APK no proporciona permiso para publicar una actualización.
• Un APK extraído de un dispositivo puede ser solo un split de una aplicación instalada. Una instalación completa puede contener APK split base, de configuración y de funcionalidades, por lo que un único split extraído no puede recrear el bundle original.
• Un AAB es un formato de publicación, no un formato normal de sideloading. Para la instalación directa, crea un APK o usa bundletool para generar el conjunto de APK adecuado a partir del bundle.
• Prueba el resultado release en versiones representativas de Android, densidades de pantalla y arquitecturas de CPU, especialmente después de reconstruir bibliotecas nativas o dynamic features.