Exigência de nível de API de destino no Google Play: para onde aponta o seu bundle?

Última revisão: 24 de julho de 2026.

O piso atual e o calendário anual

A regra do Google é mecânica: seu app precisa apontar para um nível de API dentro de um ano do último lançamento maior do Android. Uma versão maior sai todo outono, então por volta de 31 de agosto de cada ano o piso exigido sobe um degrau. Vale para apps novos e para toda atualização de um app existente — não dá para publicar uma build que aponte abaixo do piso.

Apps existentes que você não atualiza ganham mais fôlego, mas em algum momento precisam se adequar para continuarem disponíveis em aparelhos mais novos. Este é o calendário como está:

targetSdkVersion vs minSdkVersion vs compileSdkVersion

Desenvolvedores confundem esses três com frequência, e só um deles é o que o Play cobra. Eles são definidos de forma independente no build.gradle:

Você pode (e costuma) manter um minSdkVersion baixo para alcance e ao mesmo tempo apontar para o último nível de API para atender ao Play — os dois não têm relação. Subir o targetSdkVersion significa que você precisa tratar as mudanças de comportamento da nova versão; não derruba o suporte a aparelhos antigos (isso é o minSdkVersion).

O erro exato do Play Console

Quando um .aab aponta abaixo do piso, o Play Console bloqueia a versão com uma mensagem nesta forma:

Your app currently targets API level 34 and must target at
least API level 35 to ensure it is built on the latest APIs
optimized for security and performance. To upload an app
bundle it must target API level 35 or higher.

É um erro que bloqueia a publicação, não um aviso: o bundle não sobe. Os dois números da mensagem são o seu destino atual e o piso exigido; a correção é subir o targetSdkVersion para o nível pedido no build.gradle e recompilar.

Como ler o targetSdkVersion de um .aab / .apk sem o Android Studio

Você não precisa de uma compilação completa no Android Studio para verificar para onde um bundle aponta. O valor está no manifesto — mas o manifesto dentro de um artefato compilado é codificado em binário (AXML no APK, protobuf no AAB), então `unzip` + `cat` não resolve. Use as ferramentas de linha de comando do SDK.

Para um .apk

# aapt (ou aapt2) decodifica o manifesto binario
aapt dump badging app.apk | grep -o "targetSdkVersion:'[0-9]*'"
#  -> targetSdkVersion:'35'

# ou apkanalyzer (vem com as cmdline-tools do SDK do Android)
apkanalyzer manifest target-sdk app.apk
#  -> 35

Para um .aab (App Bundle)

# bundletool le o manifesto protobuf via XPath
java -jar bundletool.jar dump manifest --bundle=app.aab \
  --xpath=/manifest/uses-sdk/@android:targetSdkVersion
#  -> 35

aapt, aapt2 e apkanalyzer ficam nas build-tools / cmdline-tools do SDK do Android; o bundletool é um jar avulso do Google. Nenhum deles compila nem executa o app — só decodificam o manifesto, então a checagem leva um segundo em qualquer máquina com JDK.

O caminho da prorrogação

Se você realmente não consegue cumprir o prazo de 31 de agosto, o Google oferece uma prorrogação única solicitada pelo Play Console — ela empurra o seu prazo para 1º de novembro do mesmo ano. Foi pensada para travas técnicas reais, não para atraso de rotina:

• Você solicita por app no Play Console antes de o prazo vencer — surge um fluxo dedicado quando seu app é marcado como não conforme.
• Ela dá cerca de dois meses a mais (até 1º de novembro), não outro ano.
• Serve para manter um app existente disponível; não permite publicar, nesse meio-tempo, atualizações que apontem abaixo do piso.
• É voltada a casos legítimos (uma dependência ainda incompatível, uma migração grande). O Google pode negar pedidos que pareçam enrolação.

A prorrogação é um adiamento, não uma correção — a única resposta duradoura é subir o targetSdkVersion e tratar as mudanças de comportamento da nova versão.

Perguntas frequentes

Veja também: Por que o Google Play recusa apps · Checklist de envio para Android

Fontes

• Ajuda do Play Console — Requisitos de nível de API de destino para apps do Google Play
• Android Developers — Atender à exigência de nível de API de destino do Google Play
• Android Developers — bundletool (leitura do manifesto)
• Android Developers — aapt2 / apkanalyzer