🍤 👨🏽‍🏫 💡 Nível da API do Android, compatibilidade com versões anteriores e posteriores 🤒 👩🏼‍🤝‍👩🏻 🆕

Boa noite amigos. Preparamos uma tradução útil para futuros alunos do Desenvolvedor Android. Curso avançado . ” Estamos felizes em compartilhar este material com você.

Se você está lendo este artigo, significa que você pode estar interessado em coisas como:

O que significa o nível da API?
Como usar compileSdkVersion , minSdkVersion ou targetSdkVersion ?
Como posso garantir que o aplicativo funcione corretamente em dispositivos com diferentes versões do sistema operacional?

Todos esses conceitos estão relacionados entre si, e tentarei explicá-los neste artigo de uma maneira simples, mas eficaz.

Para fazer isso, você precisa entender a diferença entre o SDK e a API e saber qual é o nível da API no ecossistema do Android.

É verdade que no Android existe um relacionamento 1: 1 entre o SDK e a API, e geralmente esses dois termos são usados como sinônimos, mas é importante entender que isso não é a mesma coisa.

É mais correto dizer que, para cada versão do Android, existe um SDK e uma API equivalente, além do nível dessa API.

SDK

Significa Software Development Kit . Preste atenção à palavra "kit" (kit) ... consiste apenas em um conjunto de várias ferramentas, bibliotecas, documentação, exemplos que ajudam os desenvolvedores a criar, depurar e executar aplicativos Android. Uma API é fornecida com o SDK.

Se você abrir o SDK Manager no Android Studio, poderá ver mais claramente em que consiste o Android SDK.

A primeira guia do Platform SDK lista os SDKs de cada versão do Android.

Conforme mostrado na imagem abaixo, o Android 9.0 SDK (também conhecido como Pie) contém:

Plataforma Android SDK 28 (esta é a API da estrutura).
O código fonte do Android 28 (esta é uma implementação da API, como você pode ver, é opcional ... lembre-se disso).
e várias outras coisas ... por exemplo, várias imagens do sistema para o emulador do Android.

Visão geral do SDK no Android Studio SDK Manager.

A segunda guia das ferramentas do SDK mostra outras ferramentas que também fazem parte do SDK, mas são independentes da versão da plataforma. Isso significa que eles podem ser liberados ou atualizados separadamente.

API

Significa Application Programming Interface . É apenas uma interface, uma camada de abstração que fornece um link entre duas "partes" diferentes do software. Funciona como um contrato entre um provedor (por exemplo, uma biblioteca) e um consumidor (por exemplo, um aplicativo).

Este é um conjunto de definições formais, como classes, métodos, funções, módulos, constantes, que podem ser usadas por outros desenvolvedores para escrever seu código. No entanto, a API não inclui uma implementação.

Nível da API

O nível da API é um valor inteiro que identifica exclusivamente a versão da API da estrutura oferecida pela plataforma Android.

Normalmente, as atualizações da API da estrutura da plataforma são projetadas para que a nova versão da API permaneça compatível com as versões anteriores, para que a maioria das alterações na nova API seja aditiva e as partes antigas da API se tornem obsoletas, mas não excluídas.

E agora alguém pode se perguntar ...

se a API do Android não fornece uma implementação e o SDK Manager oferece um código-fonte opcional da API para download como parte do SDK, onde está a implementação correspondente?

A resposta é simples. No dispositivo

Vamos descobrir ...

Do código fonte para o arquivo APK

Normalmente, um projeto Android consiste em código escrito por desenvolvedores usando a API do Android (módulo de aplicativo), além de algumas outras bibliotecas / dependências (arquivos .jar, AAR, módulos etc.) e recursos.

O processo de compilação converte o código escrito em Java ou Kotlin, incluindo dependências (um dos motivos para reduzir seu código!), No bytecode do DEX e compacta tudo em um arquivo APK junto com os recursos. Nesta fase, a implementação da API não está incluída no APK final!

Processo de compilação - Desenvolvedores Android

Arquivos DEX e Android Runtime

Arquitetura Android - Desenvolvedores Android

O Android Runtime é o local em que todo o trabalho sujo é realizado e os arquivos DEX são executados. Consiste em dois componentes principais:

Uma máquina virtual para aproveitar a portabilidade de código e a independência da plataforma. A partir do Android 5.0 (Lollipop), o antigo tempo de execução, Dalvik Virtual Machine, foi completamente substituído pelo novo Android RunTime (ART). Dalvik usou o compilador JIT, enquanto o ART usa a compilação AOT (Ahead of time) mais JIT para criar o perfil do código em tempo de execução.
Bibliotecas base são bibliotecas Java e Android padrão. Simplificando, é aqui que a implementação da API está localizada.

A versão da API disponível neste nível corresponde à versão da plataforma Android na qual o aplicativo está sendo executado.

Por exemplo, se o Android 9 (Pie) estiver instalado no dispositivo real, todas as APIs até o nível 28 estarão disponíveis.

Se você entende os pontos principais do Android Runtime e qual é o papel da API, deve ser fácil entender a compatibilidade com versões anteriores e futuras , além do uso de compileSdkVersion , minSdkVersion e targetSdkVersion .

compileSdkVersion

Este valor é usado apenas para informar ao Gradle qual versão do SDK deve ser compilada. Isso permite que os desenvolvedores acessem todas as APIs disponíveis até o nível da API definido para compileSdkVersion .

É altamente recomendável compilar com o SDK mais recente:

Um alto nível de API permite que os desenvolvedores aproveitem a API mais recente e as oportunidades oferecidas pelas novas plataformas.
Para usar a versão mais recente do compileSdkVersion , compileSdkVersion deve corresponder à versão do SupportLibrary .

Por exemplo, para usar SupportLibrary-28.xx , compileSdkVersion também deve ser 28.

Para alternar para o AndroidX ou usá-lo, compileSdkVersion deve estar definido como pelo menos 28.
estar pronto para atender aos requisitos do nível da API de destino do Google Play . O Google anunciou que a cada ano definirá um nível mínimo de meta de API para novos aplicativos e atualizações para espalhar as novas versões do Android para o mercado do Google mais rapidamente. Você pode encontrar mais informações aqui e aqui .

Os aplicativos Android são compatíveis com as novas versões da plataforma Android, pois as alterações na API geralmente são aditivas e a API antiga pode se tornar obsoleta, mas não removida.

Isso significa que a compatibilidade direta é garantida principalmente pela plataforma e, quando você executa o aplicativo em um dispositivo com um nível de API mais alto do que o especificado em compileSdkVersion , não há problemas no tempo de execução, o aplicativo funcionará conforme o esperado em versões mais recentes da plataforma.

Por exemplo:

O aplicativo + compileSdkVersion = 26 e o método API xyz() introduzido no nível da API 26 podem funcionar em um dispositivo com Android 8 Oreo (API nível 26).

O mesmo aplicativo pode funcionar em um dispositivo com Android 9 Pie (API nível 28), pois o método API xyz() ainda está disponível no nível 28 da API.

minSdkVersion

Este valor indica o nível mínimo da API no qual o aplicativo pode ser executado. Este é um requisito mínimo. Se não especificado, o valor padrão é 1 .

Os desenvolvedores precisam definir o valor correto e garantir a operação correta do aplicativo até esse nível da API. Isso é chamado de compatibilidade com versões anteriores .

Durante o desenvolvimento, o Lint também avisa os desenvolvedores quando eles tentam usar qualquer API abaixo da especificada em minSdkVersion . É muito importante não ignorar os avisos e corrigi-los!

Para garantir compatibilidade com versões anteriores , os desenvolvedores podem verificar a versão da plataforma em tempo de execução e usar a nova API em versões mais recentes da plataforma e a API antiga em versões mais antigas ou, dependendo do caso, usar algumas bibliotecas estáticas que fornecem compatibilidade com versões anteriores.

Também é importante mencionar que a Google Play Store usa esse valor para determinar se o aplicativo pode ser instalado em um dispositivo específico, comparando a versão da plataforma do dispositivo com o aplicativo minSdkVersion .

Os desenvolvedores devem ter muito cuidado ao escolher esse valor, pois a compatibilidade com versões anteriores não é garantida pela plataforma.

Escolher o valor "certo" para um projeto também é uma decisão de negócios, pois afeta o tamanho do público-alvo do aplicativo. Veja a distribuição de plataformas .

Por exemplo:

O aplicativo + compileSdkVersion = 26 + minSdkVersion = 22 e o método API xyz() introduzido no nível da API 26 podem funcionar em um dispositivo com Android 8 Oreo (API nível 26).

O mesmo aplicativo pode ser instalado e executado em um dispositivo mais antigo com Android 5.1 Lollipop (API nível 22), em que o método da API xyz() não existe. Se os desenvolvedores não fornecerem compatibilidade com versões anteriores por meio de verificações de tempo de execução ou de qualquer biblioteca, o aplicativo falhará assim que tentar acessar o método da API xyz() .

targetSdkVersion

Este valor indica o nível da API em que o aplicativo foi desenvolvido.

Não confunda com compileSdkVersion . O último é usado apenas em tempo de compilação e disponibiliza novas APIs para os desenvolvedores. O primeiro, por outro lado, faz parte do APK (assim como minSdkVersion ) e altera o comportamento do tempo de execução. É assim que os desenvolvedores podem controlar a compatibilidade direta .

Às vezes, pode haver algumas alterações de API no sistema base que podem afetar o comportamento do aplicativo ao trabalhar em um novo ambiente de tempo de execução.

O nível do aplicativo de destino inclui um comportamento de tempo de execução específico da versão da plataforma. Se o aplicativo não estiver pronto para suportar essas alterações no comportamento do tempo de execução, é provável que falhe.

Um exemplo simples é a permissão de tempo de execução , que foi introduzida no Android 6 Marshmallow (nível 23 da API).

Um aplicativo pode ser compilado usando uma API de nível 23, mas possui uma API de nível 22 de destino, se ainda não estiver pronto para suportar o novo modelo de permissão de tempo de execução.

Portanto, um aplicativo ainda pode ser compatível sem incluir um novo comportamento em tempo de execução.

De qualquer forma, como já mencionado, o Google exige que os aplicativos atendam aos novos requisitos do nível da API de destino; portanto, você sempre deve ter alta prioridade para atualizar esse valor.

Agora, juntando tudo, vemos um relacionamento claro

minSdkVersion ≤ targetSdkVersion ≤ compileSdkVersion

Lembre-se de que é altamente recomendável que você compile com o nível mais recente da API e tente usar targetSdkVersion == compileSdkVersion .

Nível da API do Android, compatibilidade com versões anteriores e posteriores

SDK

API