Acerca de Android App Bundles
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Android App Bundle es un formato de publicación que incluye todos los recursos y el código compilado de la app, y aplaza la generación del APK y la firma en Google Play.
Google Play usa tu paquete de aplicación a fin de generar y entregar APK optimizados para la configuración de cada dispositivo, por lo que solo se descargan el código y los recursos necesarios a fin de ejecutar tu app en un dispositivo específico. Ya no es necesario compilar, firmar y administrar varios APK para optimizar la compatibilidad con diferentes dispositivos, y los usuarios obtienen descargas más pequeñas y optimizadas.
La mayoría de los proyectos de apps no requieren mucho esfuerzo para compilar paquetes de aplicaciones que admitan la entrega de APKs optimizados. Si ya organizas el código y los recursos de la app según las convenciones establecidas, compilas Android App Bundles firmados con Android Studio o con la línea de comandos y los subes a Google Play, la entrega optimizada de APK se convierte en un beneficio automático.
Cuando usas el formato de paquete de aplicación para publicar tu app, también puedes aprovechar Play Feature Delivery, que te permite agregar módulos de funciones al proyecto de tu app.
Estos módulos contienen funciones y recursos que solo se incluyen en tu app según las condiciones que especificas o que están disponibles más adelante en el tiempo de ejecución para la descarga con la biblioteca de Play Core.
Los desarrolladores de juegos que publican sus apps con paquetes de aplicaciones pueden usar Play Asset Delivery, la solución de Google Play para entregar grandes cantidades de recursos de juego que les ofrece a los desarrolladores métodos de entrega flexibles y un alto rendimiento.
Mira el siguiente video a fin de obtener una descripción general de por qué deberías usar Android App Bundles para publicar tu app.
Restricción de tamaño de descarga comprimida
La publicación con Android App Bundles permite que los usuarios instalen tu app con la menor cantidad posible de descargas y aumenta el tamaño de descarga comprimido.
Es decir, cuando un usuario descarga tu app, el tamaño total de los APKs comprimidos necesarios para instalarla (por ejemplo, el APK base y los APKs de configuración) no debe superar los 4 GB. Cualquier descarga posterior, como la de un módulo de función (y sus APKs de configuración) a pedido, también debe cumplir con la restricción de tamaño de descarga comprimido. Los paquetes de elementos no tienen incidencia en este límite de tamaño, pero sí tienen otras restricciones de tamaño.
Si Play Console detecta que alguna de las descargas posibles de tu app o sus funciones a pedido superan los límites de tamaño máximo, se mostrará un error.
Ten en cuenta que los paquetes Android App Bundle no admiten archivos de expansión del APK (*.obb
). Por lo tanto, si encuentras este error cuando publicas un paquete de aplicación, usa uno de los siguientes recursos para reducir los tamaños de descarga del APK comprimido:
- Asegúrate de habilitar todos los APKs de configuración estableciendo
enableSplit = true
para cada tipo de APK de configuración. Así se garantiza que los usuarios descarguen solo el código y los recursos que necesitan para ejecutar la app en sus dispositivos.
- Asegúrate de quitar el código y los recursos no utilizados para reducir el tamaño de tu app.
- Sigue las prácticas recomendadas para reducir aún más el tamaño de la app.
- Procura convertir funciones que solo algunos usuarios utilizan en módulos de funciones que tu app pueda descargar a pedido más adelante. Ten en cuenta que para ello puede ser necesario refactorizar la app, así que asegúrate de probar primero las otras sugerencias descritas.
Otras consideraciones
Los siguientes son problemas conocidos que se presentan cuando compilas o entregas tu app con Android App Bundles. Si experimentas problemas que aún no se describen aquí, informa el error.
- Las instalaciones parciales de apps transferidas, es decir, las apps que no se instalaron mediante Google Play Store y no contienen uno o más APK divididos necesarios, fallan en todos los dispositivos certificados por Google y dispositivos que ejecutan Android 10 (API nivel 29) o versiones posteriores. Cuando se descarga tu app a través de Google Play Store, Google se asegura de que todos los componentes necesarios de la app estén instalados.
Si usas herramientas que modifican de manera dinámica las tablas de recursos, los APK generados desde paquetes de aplicaciones podrían tener un comportamiento inesperado. Por lo tanto, te recomendamos inhabilitar esas herramientas cuando compiles un paquete de aplicación.
Es posible establecer propiedades en la configuración de compilación de un módulo de funciones que entran en conflicto con las de los módulos base (o de otros módulos). Por ejemplo, puedes configurar buildTypes.release.debuggable =
true
en el módulo base y establecerlo en false
en un módulo de funciones.
Esos conflictos pueden causar problemas relacionados con la compilación y el tiempo de ejecución. Ten en cuenta que, de forma predeterminada, los módulos de funciones heredan algunas configuraciones de compilación del módulo base. Por lo tanto, asegúrate de comprender qué opciones debes mantener y cuáles debes omitir en la configuración de compilación del módulo de funciones.
Recursos adicionales
Para obtener más información sobre Android App Bundle, consulta los siguientes recursos.
Entradas de blog
Videos
El contenido y las muestras de código que aparecen en esta página están sujetas a las licencias que se describen en la Licencia de Contenido. Java y OpenJDK son marcas registradas de Oracle o sus afiliados.
Última actualización: 2025-07-27 (UTC)
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-07-27 (UTC)"],[],[],null,["# About Android App Bundles\n\n| **Important:** From August 2021, new apps are required to publish with the [Android App Bundle](/guide/app-bundle) on Google Play. New apps larger than 200 MB are now supported by either [Play Feature Delivery](/guide/app-bundle/dynamic-delivery) or [Play Asset Delivery](/guide/app-bundle/asset-delivery). From June 2023, new and existing [TV apps are required to\n| be published as App Bundles](/docs/quality-guidelines/tv-app-quality#SC-E1).\n\nAn *Android App Bundle* is a publishing format that includes all your app's\ncompiled code and resources, and defers APK generation and signing to Google\nPlay.\n\nGoogle Play uses your app bundle to generate and serve optimized APKs for each\ndevice configuration, so only the code and resources that are needed for a\nspecific device are downloaded to run your app. You no longer have to build,\nsign, and manage multiple APKs to optimize support for different devices, and\nusers get smaller, more-optimized downloads.\n\nMost app projects won't require much effort to build app bundles that support\nserving optimized APKs. If you already [organize your app's code and\nresources](/guide/topics/resources/providing-resources#AlternativeResources)\naccording to established conventions, [build signed Android App\nBundles](/studio/publish/app-signing#sign-apk) using Android Studio or by [using\nthe command line](/studio/build/building-cmdline), and [upload them to Google\nPlay](/studio/publish/upload-bundle), then optimized APK serving becomes an\nautomatic benefit.\n\nWhen you use the app bundle format to publish your app, you can also optionally\ntake advantage of [Play Feature Delivery](/guide/playcore/feature-delivery),\nwhich lets you add *feature modules* to your app project.\nThese modules contain features and resources that are only included with your\napp based on conditions that you specify, or are available later at runtime for\ndownload [Using the Play Core Library](/guide/playcore).\n\nGame developers who publish their apps with app bundles can use\n[Play Asset Delivery](/guide/playcore/asset-delivery): Google Play's solution\nfor delivering large amounts of game assets that offers developers flexible\ndelivery methods and high performance.\n\nWatch the following video for an overview of why you should publish your app\nusing Android App Bundles. \n\nCompressed download size restriction\n------------------------------------\n\nPublishing with Android App Bundles helps your users to install your app with\nthe smallest downloads possible and increases the **compressed download size** .\nThat is, when a user downloads your app, the total size of\nthe compressed APKs required to install your app (for example, the base APK +\nconfiguration APKs) must be no more than 4 GB. Any subsequent downloads,\nsuch as downloading a feature module (and its configuration APKs) on demand,\nmust also meet this compressed download size restriction. Asset packs don't\ncontribute to this size limit, but they do have other [size restrictions](/guide/app-bundle/asset-delivery#size-limits).\n\nIf the Play Console finds any of the possible downloads of your app or its on\ndemand features to be more than the [maximum size limits](https://support.google.com/googleplay/android-developer/answer/9859372#size_limits), you will get an error.\n\nKeep in mind, **Android App Bundles do not support APK expansion (`*.obb`)\nfiles**. So, if you encounter this error when publishing your app bundle, use\none of the following resources to reduce compressed APK download sizes:\n\n- Make sure you [enable all configuration APKs](/studio/projects/dynamic-delivery#disable_config_apks) by setting `enableSplit = true` for each type of configuration APK. This makes sure that users download only the code and resources they need to run your app on their device.\n- Make sure you [shrink your app](/studio/build/shrink-code) by removing unused code and resources.\n- Follow best practices to further [reduce app size](/topic/performance/reduce-apk-size).\n- Consider converting features that are used by only some of your users into [feature modules](/studio/projects/dynamic-delivery#dynamic_feature_modules) that your app can download later, on demand. Keep in mind, this may require some refactoring of your app, so make sure to first try the other suggestions described.\n\nOther considerations\n--------------------\n\nThe following are known issues when building or serving your app\nwith Android App Bundles. If you experience issues that are\nnot already described here, [report a bug](https://issuetracker.google.com/issues/new?component=398856&template=1084213).\n\n- Partial installs of sideloaded apps---that is, apps that are not installed using the Google Play Store and are missing one or more required split APKs---fail on all Google-certified devices and devices running Android 10 (API level 29) or higher. When downloading your app through the Google Play Store, Google ensures that all required components of the app are installed.\n- If you use tools that dynamically modify resource tables, APKs generated\n from app bundles might behave unexpectedly. So, when building an app bundle,\n it is recommended that you disable such tools.\n\n- It is possible to configure properties in a feature\n module's build configuration that conflict with those from the base (or\n other) modules. For example, you can set `buildTypes.release.debuggable =\n true` in the base module and set it to `false` in a feature module.\n Such conflicts might cause build and runtime issues. Keep in mind, by default,\n feature modules inherit some build configurations from the base\n module. So, make sure you understand which configurations you should keep,\n and which ones you should omit, in your [feature module build\n configuration](/guide/app-bundle/configure#feature_build_config).\n\nAdditional resources\n--------------------\n\nTo learn more about Android App Bundles, consult the following resources.\n\n### Blog posts\n\n- [Building your first App Bundle](https://medium.com/androiddevelopers/building-your-first-app-bundle-bbcd228bf631)\n- [What a new publishing format means for the future of Android](https://medium.com/googleplaydev/what-a-new-publishing-format-means-for-the-future-of-android-2e34981793a)\n- [New features to help you develop, release, and grow your business on Google Play](https://android-developers.googleblog.com/2019/05/whats-new-in-play.html)\n- [The latest Android App Bundle updates including the additional languages API](https://android-developers.googleblog.com/2019/03/the-latest-android-app-bundle-updates.html)\n- [Patchwork Plaid --- A modularization story](https://medium.com/androiddevelopers/a-patchwork-plaid-monolith-to-modularized-app-60235d9f212e)\n- [Google Santa Tracker --- Moving to an Android App Bundle](https://medium.com/androiddevelopers/google-santa-tracker-moving-to-an-android-app-bundle-dde180716096)\n- [Developer tools on Play Console](https://medium.com/androiddevelopers/developer-tools-on-play-store-85fb710ee33b)\n\n### Videos\n\n- [Everything to know about Play App Signing](https://www.youtube.com/watch?v=odv_1fxt9BI)\n- [Building your first App Bundle](https://www.youtube.com/watch?v=IPLhLu0kvYw)\n- [App Bundles: Testing with Bundletool and the Play Console](https://www.youtube.com/watch?v=vAEAZPU7w-I)\n- [Customizable Delivery with the App Bundle and Easy Sharing of Test Builds](https://www.youtube.com/watch?v=flhib2krW7U)\n- [New Tools to Optimize Your App's Size and Boost Installs on Google Play](https://www.youtube.com/watch?v=rEuwVWpYBOY)"]]