Compatibilidade de APK por versão do Android (guia completo 2026)

A compatibilidade de APK por versão do Android se resume a dois números no manifest do app. minSdkVersion é o piso: a sua versão do Android precisa estar nele ou acima, senão a instalação falha. targetSdkVersion é a versão contra a qual o desenvolvedor testou, e ela muda o comportamento em vez de bloquear instalações. Android 10 é API 29, Android 15 é API 35, Android 17 é API 37, e todo APK declara o número de que ele precisa.

Como funciona a compatibilidade de versão do Android

O Android confere o manifest antes de copiar qualquer arquivo, e a verificação olha dois campos. minSdkVersion nomeia a versão mais antiga do Android que o app suporta. targetSdkVersion nomeia a versão contra a qual ele foi compilado e testado. O nível de API do aparelho é comparado com o primeiro, e o segundo só afeta quais comportamentos da plataforma ficam ligados.

Três resultados decorrem dessa comparação:

1. API do aparelho igual ou acima de minSdkVersion. A instalação segue para as verificações de assinatura e de arquitetura.
2. API do aparelho abaixo de minSdkVersion. O instalador aborta. Pelo ADB você vê INSTALL_FAILED_OLDER_SDK; pela Play Store você vê “This app isn’t compatible with your device.”
3. API do aparelho muito acima de targetSdkVersion. O app instala, mas o Android pode aplicar comportamentos de compatibilidade que o desenvolvedor nunca testou. É daí que vêm os travamentos em celulares modernos.

O Google documenta os dois elementos na referência do elemento uses-sdk, e os números de API aparecem na tabela abaixo.

Por que um APK se recusa a instalar na sua versão do Android

A mensagem que você vê diz qual das três verificações falhou. Combine o seu erro com a linha dele:

Essa quinta linha é a mais nova. O Android 14 bloqueia instalações que miram a API 22 ou inferior, o Android 15 sobe o piso para 23 e cada versão continua empurrando isso para cima. A flag do ADB acima é um escape proposital para cópias sideloaded. O guia de solução de problemas de instalação passa por cada código com capturas de tela.

Histórico de versões do Android e níveis de API

Os apps declaram níveis de API em vez de nomes de marketing, porque os números nunca mudam. Este é o mapeamento que você vai ver citado nas páginas de download:

Três detalhes valem a pena no final dessa tabela. O Android 16 saiu em 10 de junho de 2025 e o Android 17 em 16 de junho de 2026, então “o Android mais novo” muda de resposta a cada verão. O Fire OS segue a mesma numeração: Fire OS 16 corresponde à API 36. E o Play Store agora amarra as suas regras a esses inteiros em vez de nomes de versão.

Como Fire OS, Wear OS, TV e Automotive numeram o Android

Todo fork do Android reporta os mesmos inteiros de API que o Google atribui a cada versão, então Fire OS 16 significa API 36, as builds do Android TV batem número a número com as dos celulares, e Wear OS e Android Automotive declaram os mesmos valores de minSdkVersion e targetSdkVersion nos manifests deles. O rótulo muda. O número não.

O Fire OS é o exemplo mais claro, porque a versão 16 mapeia direto para a API 36 e o Android 16. Wear OS e Android Automotive rodam trilhas separadas do Play Store, então um app pode existir para celulares e faltar no relógio. Um app de espelhamento que falha num Galaxy Watch normalmente está batendo nessa divisão. Isso é um problema de catálogo.

Compatibilidade para trás e para frente explicada

O Android roda apps antigos em sistemas novos com muito mais confiabilidade do que o contrário. As duas direções falham de jeitos diferentes.

Android novo, APK antigo

Apps antigos normalmente instalam e rodam. Mudanças de comportamento ficam atrás do targetSdkVersion, então um app compilado para o Android 9 ainda se comporta como um app do Android 9 no Android 17. As falhas que as pessoas encontram são APIs removidas e limites de segundo plano endurecidos, que aparecem como travamentos ou notificações que nunca chegam. Exceções de emergência existem para alvos muito antigos, cobertas na tabela de erros acima.

Android antigo, APK novo

A instalação simplesmente não acontece. minSdkVersion é aplicada antes de qualquer outra coisa, e não existe contorno oculto. As suas escolhas reais são:

1. Atualizar o Android. A solução permanente, assumindo que o seu aparelho ainda recebe atualizações.
2. Instalar uma versão mais antiga do app. Arquivos de arquivo guardam versões anteriores, e releases mais antigos costumam declarar um mínimo menor. O guia de atualização de APKs cobre como fazer downgrade com segurança, incluindo por que a assinatura ainda precisa corresponder.
3. Rodar em outro lugar. Uma imagem de emulador, um segundo aparelho ou uma sessão de Android na nuvem.

O próprio prazo do Play Store

O Google Play acrescenta uma terceira regra por cima da técnica. Apps novos e atualizações devem mirar a API 36 a partir de 31 de agosto de 2026 (com extensões até 1º de novembro de 2026). Apps ainda abaixo da API 35 deixam de ser oferecidos a novos usuários em aparelhos com um Android mais novo. Instalações existentes continuam funcionando; o que muda é a descoberta. O Google publica as datas exatas nos seus requisitos de nível de API alvo.

Linha do tempo do prazo de API alvo do Google Play

O Google Play exige que todo app novo e toda atualização mire um nível de API específico, e o piso atual é a API 36 a partir de 31 de agosto de 2026, com uma janela curta de extensão até 1º de novembro de 2026 para desenvolvedores que pedirem mais tempo. Dois prazos importam agora.

Instalações existentes nunca são removidas. O Google publica as duas datas nos seus requisitos de nível de API alvo, e a referência correspondente da plataforma é a documentação de targetSdkVersion. Um app que ignora o prazo continua funcionando para quem já o instalou.

Mudanças de comportamento condicionadas ao targetSdkVersion

O targetSdkVersion decide quais comportamentos da plataforma o Android aplica a um app, então um pacote compilado para a API 29 instala no Android 16 e ainda assim mantém as regras de armazenamento, as regras de notificação e os limites de segundo plano da própria época em vez das regras mais novas da plataforma. É por isso que um app antigo pode falhar em um celular de ponta.

Nenhuma dessas linhas bloqueia a instalação. O app chega, abre e depois falha no momento em que toca uma API restrita. Só o desenvolvedor pode aumentar o targetSdkVersion, então a atualização é a correção.

Como verificar a versão mínima do Android de um APK

Quatro métodos, ordenados pelo esforço que custam.

Leia a página da loja ou de download

O Google Play lista Requer Android em toda página de app. Arquivos e espelhos imprimem o mesmo valor nas suas páginas de download. Isso responde a pergunta em cinco segundos para qualquer coisa que você ainda não baixou.

Use o APK Analyzer do Android Studio

Abra o Android Studio, escolha File e depois Profile or Debug APK, e leia o minSdkVersion no resumo do manifest. Isso funciona em qualquer arquivo local, inclusive em um que você recebeu por um app de mensagens.

Leia o manifest com o ADB

Instale o app em um aparelho e depois execute:

adb shell dumpsys package com.example.app | grep -E "minSdk|targetSdk|versionName"

Ele imprime os valores que o Android realmente está aplicando para aquela cópia instalada.

Confira a arquitetura ao mesmo tempo

A mesma inspeção deve dizer quais bibliotecas nativas vêm dentro do pacote, o que importa em Chromebooks e PCs. Arquitetura, nomes de ABI e pacotes divididos são cobertos em tamanho de arquivo e arquitetura de APK.

APKs divididos, arquivos XAPK e adb install-multiple

O Google Play transforma um Android App Bundle em vários APKs pequenos em vez de um arquivo só, e um comando adb install comum aceita apenas um arquivo por vez, então um bundle precisa do comando install-multiple para chegar completo ao aparelho. Um arquivo nunca é o app inteiro.

O install-multiple aceita todos os caminhos em uma única chamada e os trata como um pacote só, então os arquivos precisam corresponder entre si. Mande apenas um split x86 para um celular arm64 e o ADB retorna INSTALL_FAILED_NO_MATCHING_ABIS. Exemplos de comando estão em tamanho de arquivo e arquitetura de APK.

Como verificar a sua versão do Android

Abra Configurações, role até Sobre o telefone ou Sobre o tablet e leia Versão do Android. Toque no número da versão se quiser o Easter egg, mas é o número que você precisa. Mapeie-o com a tabela acima.

Em uma TV o caminho difere um pouco: Configurações e depois Preferências do dispositivo ou Sistema e depois Sobre. No Wear OS: Configurações, depois Sistema, depois Sobre. O mesmo número vale em toda parte, porque ele vem da mesma base do Android.

Se a tela de configurações mostra apenas um número de build, você está olhando uma linha baixa demais. Compatibilidade lê a versão do Android, não a data do patch de segurança.

O que fazer se um APK precisar de um Android mais novo

Três opções, em ordem de frequência com que funcionam:

1. Atualizar o aparelho. Configurações, Sistema, Atualização do sistema. Aparelhos lançados nos últimos três anos costumam receber de dois a três anos de atualizações, então um celular de 2022 pode já estar no teto.
2. Fazer downgrade para uma versão mais antiga do app. O release anterior costumava declarar um mínimo menor. Instale-o a partir de um arquivo, mantendo a assinatura consistente com a cópia que já está no aparelho, ou desinstale primeiro.
3. Usar um emulador. Em um computador, uma imagem de emulador roda qualquer nível de API atual, o que a torna a resposta quando o celular está preso. Veja o guia para PC para a configuração.

Não tente modificar o minSdkVersion remontando o manifest. Um APK reempacotado falha na verificação de assinatura e é rejeitado com INSTALL_FAILED_UPDATE_INCOMPATIBLE.

Como fazer downgrade para uma versão anterior do app

Para voltar um app, você remove a cópia mais nova primeiro e depois instala um release mais antigo assinado com a mesma chave, porque o Android se recusa a colocar um version code menor por cima de um maior e retorna o erro INSTALL_FAILED_VERSION_DOWNGRADE quando você tenta. Desinstalar primeiro limpa tanto a verificação de versão quanto os dados salvos.

1. Desinstale o app. Configurações, depois Apps, depois o app, depois Desinstalar. Para um app de sistema, escolha Desinstalar atualizações, que restaura a versão de fábrica.
2. Confirme a chave de assinatura. Um release mais antigo assinado com outra chave falha com INSTALL_FAILED_UPDATE_INCOMPATIBLE, que é o que acontece depois que um desenvolvedor ativa o Play App Signing.
3. Instale o pacote mais antigo. Execute adb install old-app.apk ou abra o arquivo em um gerenciador de arquivos no celular.
4. Espere perda de dados. A desinstalação remove logins e saves, então exporte o que puder antes do passo 1.

Builds depuráveis também aceitam a flag adb install -d, que afrouxa a verificação de versão para pacotes que a permitem. Builds de release raramente permitem, então desinstalar continua sendo a rota confiável. Versões anteriores vivem nos arquivos, e como atualizar arquivos APK lista a ordem segura.

O que fazer se um APK precisar de um Android mais antigo

Quase nunca é um problema. Apps que declaram um piso abaixo da sua versão rodam bem, porque o Android roda apps novos em comportamento antigo pelo condicionamento do targetSdkVersion. As raras falhas são recursos de hardware que o app declara como obrigatórios, como uma câmera ou um sensor específicos, o que é um desalinhamento de aparelho e não de versão. A lista de conferência de permissões em como verificar permissões de APK cobre essa inspeção.

Teste o seu aparelho contra a lista completa de suporte de aparelhos e depois rode a verificação de versão acima no app que você realmente quer.