Google Play App Bundles em 2026: AAB, splits e limites de tamanho
Um Android App Bundle (AAB) é o formato de publicação que o Google Play exige para novos apps desde agosto de 2021 — e é o motivo pelo qual duas pessoas podem instalar o mesmo app e terminar com tamanhos de download bem diferentes. Você não entrega mais ao Google Play um APK pronto. Você entrega um bundle que carrega todo o seu código compilado e recursos, além das instruções para montá-los, e o Google Play gera os APKs divididos que são de fato instalados em cada dispositivo.
Essa única mudança tira muitas decisões do seu script de build e as leva para o Play: qual arquitetura de CPU recebe quais bibliotecas nativas, qual densidade de tela recebe quais drawables, qual idioma recebe quais strings. Ela também introduz uma série de limites rígidos de tamanho — e os limites mudaram. O teto do módulo base não é mais 200 MB. Equipes que ainda planejam com base nos números antigos ou superdimensionam a estratégia de entrega ou perdem um upload por um erro de tamanho que parece inexplicável.
Este guia cobre o cenário de 2026 na ordem em que você o encontra: o que o bundle contém, os limites de tamanho atuais, como os APKs divididos são montados, Play Feature Delivery e Play Asset Delivery, as regras de código de versão para APKs gerados, testes com bundletool e o checklist para rodar antes do upload.
1. O que um bundle do app realmente contém
Um app bundle é o artefato .aab que você envia em vez de um APK. A formulação do próprio Google é precisa: ele inclui todo o código compilado e os recursos do seu app, e o delega a geração e a assinatura do APK ao Google Play. Dentro dele você encontra:
- O módulo base — o código, os recursos e o manifesto de que todo dispositivo precisa. Ele carrega o código de versão e o nome da versão do app, o que é mais importante do que parece.
- Módulos de recursos — código e recursos que podem ser entregues no momento da instalação, sob demanda ou condicionalmente, dependendo do dispositivo ou do país.
- Pacotes de ativos — arquivos grandes (ativos de jogos, mídia, modelos de ML) entregues pelo Play Asset Delivery em vez do sistema de módulos.
- Metadados de segmentação por dispositivo — as configurações do manifesto que permitem ao Play decidir quais partes vão para qual dispositivo: ABI, densidade de tela, idioma e a segmentação mais recente por compressão de textura para pacotes de assets.
O bundle em si nunca é instalado em um dispositivo. É uma fonte de distribuição, não um pacote.
2. O que "dividir" significa para o usuário
Quando o usuário toca em Instalar, o Play monta um conjunto de APKs para aquela configuração específica de dispositivo, assina e entrega. As divisões clássicas são:
- Divisões de ABI — arm64-v8a, armeabi-v7a, x86_64. Um celular moderno baixa uma arquitetura em vez de quatro.
- Divisões por densidade de tela — um celular de 420 dpi não paga por ativos raster de 640 dpi.
- Divisões por idioma — strings de locales que o dispositivo nunca solicitou ficam no servidor.
- Divisões de recursos dinâmicos e pacotes de ativos — tudo o que você marcou para entrega sob demanda.
Então o "tamanho do download" no Play Console não é um número único, é uma faixa entre configurações, e a página Tamanho do app informa tanto o valor do dispositivo de referência quanto essa faixa. Avaliar um lançamento por um único APK que você compilou localmente é como as equipes acabam surpresas com a conversão de instalação.
3. Os limites de tamanho de 2026
Esses números vêm da Ajuda do Play Console e são a base para o seu planejamento. Observe o quanto o limite do módulo base se afastou dos 200 MB que ainda aparecem em guias mais antigos.
- Módulo base: limite de download de 500 MB.
- Cada módulo de recurso individual: 500 MB.
- Cada pacote de ativos individual: 1,5 GB.
- Total acumulado de todos os módulos mais os pacotes de ativos de instalação: 4 GB.
- Total acumulado para pacotes de assets sob demanda e fast-follow: 30 GB.
- Tamanho máximo total de download compactado: 34 GB.
Quatro restrições adicionais acompanham esses números:
- Apps maiores que 1 GB devem ter como destino o SDK mínimo Android 5.0 Lollipop (nível de API 21) ou superior.
- O máximo recomendado é 100 módulos de recursos quando o app tem como destino a API 26 ou superior; quando o destino é inferior, o limite é 50.
- O número máximo de pacotes de recursos em um bundle é 100.
- Se o app passar de 200 MB, usuários em conexão de dados móveis veem um diálogo não bloqueante avisando sobre o tamanho ao instalar. Ele não bloqueia a instalação, mas custa conversões.
Uma armadilha legada: apps ainda entregues como APKs simples não são cobertos por nenhum dos limites acima. Eles continuam sujeitos às regras antigas de APK, cujo teto é um APK de 100 MB. Se um upload for rejeitado com um erro de tamanho que parece uma mensagem de 2019, verifique se o artefato que você enviou é realmente um bundle.
4. Qual mecanismo você precisa?
Três mecanismos resolvem três problemas diferentes, e confundi-los custa semanas.
- Play Feature Delivery — módulos de código e recursos. Use quando quiser funcionalidades que nem todo dispositivo ou mercado deve instalar.
- Play Asset Delivery — ativos binários grandes. Use para conteúdo de jogos, vídeo, áudio, modelos de ML e grandes conjuntos de dados em que o tamanho da instalação importa.
- Play App Signing — adjacente, mas central: com bundles, o Play assina os APKs gerados, e é por isso que o gerenciamento de chaves e códigos de versão mudou.
5. Play Feature Delivery: no momento da instalação, sob demanda, condicional
Um módulo de recurso declara um dos três modos de entrega no seu manifesto:
- no momento da instalação — o módulo faz parte da instalação inicial. Os usuários não podem ignorá-lo, e ele conta para o tamanho que o usuário vê.
- sob demanda — o módulo não é instalado até que o app o solicite. Seu código precisa tratar os estados pendente, baixando, concluído e com falha.
- condicional — o módulo é instalado no momento da instalação apenas onde o dispositivo atende a uma condição que você declara, como recursos do dispositivo, país do usuário ou versão mínima do SDK.
A entrega condicional é o recurso que as equipes menos usam. Um módulo de recurso exclusivo para tablet, ou que só faz sentido onde um determinado provedor de pagamento atua, não precisa estar em todos os dispositivos.
6. Play Asset Delivery: no momento da instalação, fast-follow, sob demanda
- Os pacotes de instalação chegam junto com o app. Eles contam para o tamanho de instalação do app — e para o limite cumulativo de 4 GB. Conveniente, mas ainda fazem parte do número que os usuários veem na ficha do app na loja.
- Os pacotes de acompanhamento rápido começam a baixar automaticamente assim que a instalação termina, em segundo plano. O usuário pode abrir o app imediatamente; os ativos chegam logo depois.
- pacotes sob demanda são baixados apenas quando o app os solicita. É aqui que estão os grandes números: pacotes sob demanda e fast-follow têm um limite cumulativo de 30 GB justamente porque não competem com a conversão de instalação.
Os pacotes de ativos também suportam segmentação por compressão de textura, o que permite ao Play entregar o formato de compressão que a GPU do dispositivo realmente suporta em vez de empacotar todos os formatos. Para jogos, essa costuma ser a maior redução de tamanho disponível.
7. Códigos de versão quando o Play gera os APKs
Com bundles, você deixa de gerenciar códigos de versão por APK. Você define um código de versão no módulo base e, após o upload, o Google Play atribui esse mesmo código de versão a cada APK gerado a partir desse bundle. Todos os APKs divididos de uma instalação compartilham o código de versão.
A consequência é disciplina, não complexidade: para publicar uma atualização, você incrementa o código de versão do módulo base e gera um bundle novo e completo. Quando o usuário atualiza, o Play entrega versões atualizadas de cada APK instalado naquele dispositivo. Duas regras práticas se seguem:
- Não mantenha o antigo esquema de código de versão por ABI (o clássico truque
abiCodes * 1000 + versionCode). É um padrão legado de divisão de APK e entra em conflito com uploads de bundle. - Se um sistema de build embaralha os códigos de versão entre faixas, os uploads falham com "version code already used" ou "lower than the existing version". O módulo base é a única fonte da verdade.
8. Assinatura: a chave de upload, não a chave de assinatura do app
Com o Play App Signing, o artefato que você envia é assinado com uma chave de upload, e o Play reassina os APKs gerados com a chave de assinatura do app. A configuração de assinatura pertence apenas ao módulo base. Duas coisas costumam pegar as pessoas de surpresa:
- Se a chave de upload for perdida, ela pode ser redefinida pelo Play Console — é recuperável. A chave de assinatura do app não é algo com que você precise se preocupar.
- Se um bundle é assinado com a chave errada, o Play rejeita o upload antes mesmo de a revisão começar. É um problema de configuração de build com correção de uma linha, não um problema de política.
9. Testar APKs divididos antes do lançamento com o bundletool
O plugin Gradle do Android gera o bundle; o bundletool é o que você usa para transformá-lo de volta em APKs específicos por dispositivo e para emular localmente a distribuição do Play. O próprio Play usa a mesma ferramenta para gerar APKs, então o comportamento local acompanha de perto a produção.
# Build an APK set covering every supported device configuration bundletool build-apks \ --bundle=app-release.aab \ --output=app.apks \ --ks=upload-key.jks --ks-key-alias=upload # Deploy only the splits that match the connected device bundletool install-apks --apks=app.apks # Produce a universal APK for a quick sanity check bundletool build-apks --bundle=app-release.aab --output=app.apks --mode=universal # Enable local testing of on-demand modules and asset packs bundletool build-apks --bundle=app-release.aab --output=app.apks --local-testing
A flag --local-testing grava metadados nos manifestos do APK que instruem as bibliotecas do Play Core a usar os splits locais em vez de contatar o Play. Sem ela, o código de download sob demanda não pode ser exercitado fora da loja. Para uma especificação específica de dispositivo, use bundletool get-device-spec.
Antes de um lançamento em produção, a faixa de teste interno ainda é a forma mais barata de confirmar que instalações reais resolvem os splits corretos — inclusive nos dispositivos mais modestos que importam para sua análise de falhas.
10. Leia a página de tamanho do app antes de otimizar qualquer coisa
Depois que um app tem uma versão de produção, o Play Console informa o tamanho do download em Monitorar e melhorar, depois vitais do Android, depois Tamanho do app. Ele mostra o tamanho do download do app num dispositivo de referência e a variação entre configurações, uma comparação com pares de um grupo que você define, a tendência ao longo do tempo e duas métricas que valem mais do que o próprio número de tamanho:
- Dispositivos ativos com menos de 2 GB livres — quanto da sua base instalada está sob pressão de armazenamento.
- Desinstalações em dispositivos com menos de 2 GB livres — a proporção de desinstalações nesses dispositivos em relação ao total de desinstalações. Um valor alto é um problema de tamanho disfarçado de retenção.
11. Checklist de pré-upload
- O artefato é um
.aab, não um APK universal. - O código de versão do módulo base é incrementado em exatamente um lugar.
- A chave de upload é configurada apenas no módulo base, e o keystore é copiado para um local que não seja um único notebook.
- O tamanho compactado de download do módulo base fica dentro de 500 MB — e abaixo de 200 MB se você quiser evitar o aviso de dados móveis na instalação.
- Cada módulo de recurso tem menos de 500 MB, e todos os módulos mais os pacotes de instalação ficam abaixo do limite cumulativo de 4 GB.
- Cada pacote de ativos tem menos de 1,5 GB, e os pacotes sob demanda e fast-follow ficam abaixo de 30 GB.
- No máximo 100 asset packs, e dentro da orientação de 100 ou 50 feature modules para o seu SDK mínimo.
- O SDK mínimo é a API 21 ou superior se o app passar de 1 GB.
- Os recursos sob demanda são implementados por meio das bibliotecas do Play Core, com os estados pendente, em download e com falha tratados explicitamente.
- O direcionamento por compressão de textura fica habilitado para asset packs onde mais de um formato de GPU está em jogo.
- O bundle foi testado com
bundletool install-apksem pelo menos um dispositivo de entrada e um arm64, além de--local-testingpara cada caminho sob demanda. - A página Tamanho do app é revisada depois que a versão entra no ar, incluindo as métricas de menos de 2 GB livres.
- O formulário de segurança dos dados e as declarações de conteúdo ainda correspondem ao que os novos módulos realmente coletam.
- O texto da ficha do app na loja e as capturas de tela ainda descrevem o app que o usuário agora baixa, não a compilação universal com a qual você testou.
12. Falhas que só aparecem após o lançamento
- Um módulo sob demanda nunca baixa porque a integração com o Play Core assume sucesso e não tem caminho de nova tentativa para uma solicitação com falha ou cancelada.
- Um pacote de ativos de instalação infla o tamanho da ficha após uma atualização de conteúdo, e a conversão de instalação cai sem nenhuma mudança no código.
- Módulos condicionais são instalados em dispositivos que não atendem à condição porque foram declarados no manifesto errado.
- Colisões de código de versão quando a CI carimba o bundle enquanto um esquema legado por ABI ainda está ativo nos arquivos de build.
- Uma assinatura com chave errada após uma rotação de keystore que nunca foi espelhada na configuração do módulo base.
- Falhas na primeira execução em conexões lentas quando a primeira tela do app depende de um pacote de carregamento posterior que ainda não chegou.
- Uma divergência na Segurança dos dados depois que um novo SDK entra em um módulo recém-dividido que ninguém redeclarou.
13. Onde o KappS se encaixa
O tamanho do app e os modos de entrega fazem parte da mesma cadeia operacional que a conta de desenvolvedor, o perfil de pagamentos e as informações fiscais: qualquer um deles pode segurar um lançamento sem alarde. O KappS ajuda os desenvolvedores a preparar e enviar material em conformidade em toda essa cadeia — incluindo revisões de configuração de bundle e entrega, em que a diferença entre um pacote de instalação e um pacote de carregamento posterior se mede em conversão de instalação, não em megabytes.
O que não fazemos é contornar a loja. Limites de tamanho, declarações de entrega e respostas de Segurança dos dados são verificados pelo Google com base no artefato que você realmente publicou; uma ficha que promete algo que o bundle não faz é um caminho rápido para uma versão rejeitada ou uma conta suspensa, e não é um serviço que oferecemos. O truque todo é o descrito acima: criar o bundle com honestidade, declarar o que ele realmente contém e respeitar os limites.
Fontes (Google documentação oficial): Sobre os Android App Bundles (developer.android.com/guide/app-bundle); Ajuda do Play Console — Otimize o tamanho do seu app e fique dentro dos limites de tamanho de app do Google Play (support.google.com/googleplay/android-developer/answer/9859372); Configurar o módulo base; Play Asset Delivery; Play Feature Delivery; bundletool (developer.android.com/tools/bundletool).
Gerencia contas de desenvolvedor em escala? Cuidamos do lado operacional.
Recebemos sua mensagem e responderemos em até 24 horas.
← Voltar para editar