Qué es un AAB (Android App Bundle) y en qué se diferencia de un APK

Si vas a publicar en Google Play, tarde o temprano te preguntas qué es un AAB y por qué Play Console no te deja subir el APK de siempre. Un AAB (Android App Bundle) es el archivo .aab que subes a la tienda: trae todo el código y los recursos de tu app, pero no se instala en el teléfono. Google Play lo usa para generar los APK que descarga cada dispositivo. En esta guía verás la diferencia entre AAB y APK, cómo generarlo en Android Studio, Flutter o React Native, cómo probarlo antes de subirlo y los errores que más frenan a los desarrolladores indie.

Qué es un AAB (Android App Bundle)

Según la documentación oficial de Android, un Android App Bundle es un formato de publicación que incluye todos los recursos y el código compilado de tu app, pero delega la generación del APK y la firma a Google Play.

Algunos datos clave, todos de fuentes oficiales de Google:

• El formato se lanzó en 2018 y lo soportan Android Studio, Gradle, Unity, Unreal y otras herramientas de compilación (FAQ de Android App Bundle).
• Desde agosto de 2021, las apps nuevas se deben publicar en Google Play con Android App Bundle.
• Desde el 30 de junio de 2023, las actualizaciones de apps para TV también deben ir en AAB.
• Para usar paquetes de aplicación tienes que estar inscrito en la firma de apps de Play (ayuda de Play Console).

En otras palabras: el AAB es lo que tú subes; el APK es lo que el usuario instala. Google se encarga de convertir uno en otro.

AAB vs APK: diferencias que importan

	AAB (.aab)	APK (.apk)
Para qué sirve	Publicar en Google Play (y otras tiendas que lo admitan)	Instalar y ejecutar la app en Android
¿Se instala en el teléfono?	No	Sí
Quién genera los APK finales	Google Play, según cada dispositivo	Tú, al compilar
Firma de lo que instala el usuario	Google (Play App Signing)	Tú, con tu propia clave
Tamaño de la descarga	Solo el código y los recursos que necesita ese dispositivo	Todo lo que incluiste, lo use o no el teléfono
Archivos de expansión .obb	No compatibles	Compatibles

Lo que más cambia en el día a día:

1. Descargas más pequeñas. Play genera un APK base y APK de configuración (idioma, densidad de pantalla, arquitectura), así que cada teléfono descarga solo lo suyo. Cuánto se reduce depende de tu app: sin dato general.
2. Un solo archivo para todos los dispositivos. Ya no tienes que compilar y subir varios APK por arquitectura.
3. Funciones extra de distribución. Con AAB puedes usar Play Feature Delivery (módulos que se descargan bajo pedido o por condiciones) y Play Asset Delivery (recursos grandes, típico en juegos).
4. Límite de tamaño. Según Google, la descarga comprimida necesaria para instalar la app (APK base + APK de configuración) no debe superar los 4 GB. Si la superas, Play Console muestra un error.

El APK no desaparece: sigue siendo el formato instalable, y lo vas a necesitar si distribuyes fuera de Play o en tiendas que todavía no aceptan AAB.

Cómo generar un archivo AAB paso a paso

Para la mayoría de proyectos, generar un AAB cuesta lo mismo que generar un APK: solo eliges el otro formato al compilar. Antes de empezar, ten listo un keystore de carga (si no lo tienes, revisa primero la guía de firma de apps de Google Play).

En Android Studio

1. Abre tu proyecto y ve a Build → Generate Signed Bundle/APK.
2. Elige Android App Bundle y pulsa Next.
3. Selecciona tu keystore de carga, el alias y las contraseñas (o crea uno nuevo).
4. Elige la carpeta de destino y el tipo de compilación release, y finaliza.
5. El .aab queda en la carpeta de destino que elegiste en el asistente.

Desde la línea de comandos (Gradle)

Google indica que se ejecuta la tarea bundle<Variante> sobre el módulo base de la app. Si tu módulo se llama app, en la raíz del proyecto Android:

./gradlew :app:bundleRelease

El bundle suele quedar en app/build/outputs/bundle/release/. Si configuraste signingConfigs en Gradle con tu clave de carga, el archivo ya sale firmado. Ojo: Google aclara que no puedes firmar un AAB con apksigner; si firmas a mano, se usa jarsigner.

En Flutter

flutter build appbundle

La documentación de Flutter indica que el bundle de release se crea en build/app/outputs/bundle/release/ y que, por defecto, incluye el código compilado para armeabi-v7a, arm64-v8a y x86-64.

En React Native

React Native usa el mismo proyecto Android con Gradle: entra a la carpeta android/ y ejecuta ./gradlew bundleRelease. El resultado suele quedar en android/app/build/outputs/bundle/release/. Recuerda configurar antes la firma de release con tu clave de carga.

Cómo probar un AAB antes de subirlo

Como un .aab no se instala directamente, tienes dos caminos para probarlo.

Opción 1: bundletool en tu computador

bundletool es la herramienta que usan Android Studio, Gradle y la propia Google Play para convertir el bundle en APK. Se descarga desde GitHub y necesita Java.

1. Genera el conjunto de APK (archivo .apks):

   bundletool build-apks --bundle=mi_app.aab --output=mi_app.apks
   

2. Conecta un teléfono con depuración USB e instala:

   bundletool install-apks --apks=mi_app.apks
   

3. Si necesitas un único APK para compartir con alguien del equipo, agrega --mode=universal. Es más pesado, pero funciona en cualquier configuración compatible.
4. Para estimar cuánto descargará el usuario: bundletool get-size total --apks=mi_app.apks.

Si no pasas tu keystore (--ks, --ks-key-alias, etc.), bundletool firma los APK con una clave de depuración. Sirve para probar, pero no podrás instalarlo encima de la versión de Play.

Opción 2: probarlo desde Google Play

Sube el .aab a un segmento de prueba interna o a la prueba cerrada de Google Play. Después, en Play Console, ve a Prueba y lanza → Versiones y paquetes más recientes. Desde ahí puedes:

• Copiar un vínculo de uso compartido interno de apps para instalar el APK que genera Play.
• Descargar los APK específicos de cada dispositivo.
• Descargar un APK universal firmado con la misma clave de Play App Signing, útil si también distribuyes en tu web u otra tienda.

Errores comunes con el AAB (y cómo evitarlos)

• Intentar instalar el .aab en el teléfono. No funciona: conviértelo con bundletool o usa los vínculos de Play Console.
• Pasar APK divididos a mano. Google advierte que las instalaciones parciales (cuando falta algún APK dividido) fallan en dispositivos certificados y en Android 10 o superior. Comparte el universal o el vínculo interno.
• Firmar con la clave equivocada. Si Play rechaza el bundle porque está firmado con otra clave, revisa que uses tu clave de carga registrada; si la perdiste, se puede restablecer (ver firma de apps de Google Play).
• Seguir usando archivos .obb. Los AAB no los admiten; migra a Play Asset Delivery.
• Olvidar el resto de la ficha. El bundle es solo una pieza: icono, capturas, política de privacidad y Data safety siguen siendo obligatorios. Repasa el checklist para publicar una app en Google Play.

Preguntas frecuentes sobre el AAB

¿Qué es un archivo AAB?

Es un Android App Bundle: el archivo .aab con el código y los recursos de una app Android, pensado para publicarse en Google Play. Play lo convierte en APK optimizados para cada dispositivo.

¿Cuál es la diferencia entre APK y AAB?

El APK se instala en el teléfono; el AAB solo se publica. Con AAB, Google genera y firma los APK que descarga cada usuario, por eso las descargas suelen ser más livianas.

¿Cómo instalo un archivo AAB en Android?

No se puede instalar directamente. Usa bundletool build-apks y luego install-apks, o genera un APK universal con --mode=universal.

¿Es obligatorio subir AAB a Google Play?

Para apps nuevas, sí: desde agosto de 2021 Google Play exige Android App Bundle. Las actualizaciones de apps para TV también lo requieren desde junio de 2023.

¿Puedo convertir un AAB a APK?

Sí, con bundletool (APK universal) o descargando el APK universal firmado en Play Console si la app ya está subida.

---

Siguiente paso: con tu .aab listo, lo que más retrasa la publicación suele ser la ficha. Crea el icono con el generador de iconos para Google Play y prepara capturas y política de privacidad gratis en AppConsol. Así subes tu primer AAB con todo lo demás en orden.