Migração para o Android 8.0

O Android 8.0 (nível 26 da API) apresenta mudanças de comportamento, além de novos recursos e APIs que você pode aproveitar nos seus apps. Este documento apresenta uma visão geral das etapas para migrar seus apps para o Android 8.0 em duas fases principais:

  1. Garantir a compatibilidade com o Android 8.0

    Verifique se o app funciona perfeitamente na nova versão da plataforma. Nesta etapa, você não usa novas APIs nem muda o targetSdkVersion do app, mas pequenas mudanças podem ser necessárias.

  2. Atualizar a versão de destino e usar os recursos do Android 8.0

    Quando estiver tudo pronto para aproveitar os novos recursos da plataforma, atualize o targetSdkVersion para 26, verifique se o app continua funcionando como esperado e comece a usar as novas APIs.

Garantir a compatibilidade com o Android 8.0

O objetivo aqui é garantir que o app funcione como está no Android 8.0 (nível da API 26). Como algumas mudanças na plataforma podem afetar o comportamento do app, talvez seja necessário fazer alguns ajustes, mas não é preciso usar novas APIs ou mudar o targetSdkVersion.

Como garantir a compatibilidade com o Android 8.0 passo a passo

Preparar um dispositivo com o Android 8.0

  • Se você tiver um dispositivo compatível (Pixel, Pixel XL, Pixel C, Nexus 5X, Nexus 6P ou Nexus Player), siga as instruções para atualizar o dispositivo.
  • Ou faça o download da imagem do sistema Android 8.0 para o Android Emulator. Ela está listada no SDK Manager em Android 8.0 como Google APIs Intel x86 Atom System Image.

    Observação: a imagem do sistema do Android 8.0 está disponível para download no Android Studio 3.0 e versões mais recentes. Para mais informações, consulte a seção abaixo para receber o SDK do Android 8.0.

Realizar testes de compatibilidade

Na maioria dos casos, testar a compatibilidade com o Android 8.0 (nível 26 da API) envolve o mesmo tipo de teste que você realiza ao se preparar para lançar o app. Esse é um bom momento para analisar as principais diretrizes de qualidade do app e as práticas recomendadas para testes.

No entanto, há outro aspecto do teste: o Android 8.0 introduz mudanças na plataforma Android que podem afetar o comportamento do seu app ou até mesmo interromper o funcionamento dele, mesmo que você não mude a targetSdkVersion. Por esse motivo, é importante que você analise as principais mudanças na tabela 1 e teste as correções que implementar para acomodá-las.

Tabela 1. Principais mudanças que afetam todos os apps em execução em dispositivos Android 8.0.

Alterar Resumo Outras referências
Atualizações de localização em segundo plano menos frequentes Se o app recebe atualizações de local de um serviço em segundo plano, elas são menos frequentes no Android 8.0 (nível 26 da API) em comparação com versões mais antigas do Android. Especificamente, um serviço em segundo plano não pode receber atualizações de local mais do que algumas vezes por hora. No entanto, enquanto o app estiver em primeiro plano, a taxa de atualizações do local não vai mudar. Limites da localização em segundo plano
net.hostname não são mais compatíveis A consulta da propriedade do sistema net.hostname produz um resultado nulo. Nenhum
Nova exceção de send(DatagramPacket) O método send(DatagramPacket) gera um SocketException se o método connect(InetAddress, int) executado anteriormente falhar. Mudanças de comportamento: conectividade de rede e HTTP(S)
NullPointerException adequado dos métodos AbstractCollection AbstractCollection.removeAll(null) e AbstractCollection.retainAll(null) agora sempre geram uma NullPointerException. Anteriormente, a NullPointerException não era gerada quando a coleção estava vazia. Essa mudança torna o comportamento consistente com a documentação. Mudanças de comportamento: processamento de coleções
NullPointerException adequado de Currency.getDisplayName(null) Chamar Currency.getDisplayName(null) gera um NullPointerException. Mudanças de comportamento: localidades e internacionalização

Para uma lista mais extensa de mudanças de comportamento no Android 8.0 (nível 26 da API), consulte também Mudanças de comportamento do Android 8.0.

Atualizar a versão de destino e usar os recursos do Android 8.0

Nesta seção, explicamos como ativar o suporte total ao Android 8.0 (nível 26 da API) atualizando o targetSdkVersion para 26 e adicionando novos recursos disponíveis no Android 8.0.

Além de oferecer novas APIs, o Android 8.0 apresenta algumas mudanças de comportamento quando você atualiza o targetSdkVersion para 26. Como algumas mudanças de comportamento podem exigir alterações no código para evitar falhas, primeiro você precisa entender como o app pode ser afetado ao mudar o targetSdkVersion. Para isso, revise todas as mudanças de comportamento para apps destinados ao Android 8.0.

Observação: as etapas descritas acima para garantir a compatibilidade com a plataforma são pré-requisitos para segmentar o app para o Android 8.0. Portanto, conclua essas etapas primeiro.

Atualizar a versão de destino e usar os recursos do Android 8.0 passo a passo

Instalar o SDK do Android 8.0

Você pode receber os pacotes do SDK para criar seu app com o Android 8.0 (nível 26 da API) usando a versão mais recente do Android Studio (recomendamos o Android Studio 3.0 ou mais recente). O Android Studio 3.0+ inclui ferramentas para ajudar você com os recursos do Android 8.0, como ícones adaptativos e fontes para download. Se você ainda não precisa desses recursos, use a versão estável do Android Studio 2.3.3 para criar seu app com o Android 8.0 e usar as novas APIs.

Para configurar qualquer uma das versões do Android Studio, siga estas etapas:

  1. Inicie o Android Studio e abra o SDK Manager clicando em Tools > SDK Manager.
  2. Na guia SDK Platforms, marque Show Package Details. Abaixo da prévia do Android 8.0, verifique o seguinte:
    • Android SDK Platform 26
    • Imagem do sistema Google APIs Intel x86 Atom (necessária apenas para o emulador)
  3. Acesse a guia Ferramentas do SDK e marque todos os itens que têm atualizações disponíveis (clique em cada caixa de seleção que mostra um traço ). Isso inclui as versões mais recentes dos seguintes itens obrigatórios:
    • Android SDK Build-Tools 26.0.0
    • Android SDK Platform-Tools 26.0.0
    • Android Emulator 26.0.0
  4. Clique em OK para instalar todos os pacotes do SDK selecionados.

Agora você já pode começar a criar com o Android 8.0.

Atualizar a configuração da compilação

Atualize compileSdkVersion, targetSdkVersion e a versão da Biblioteca de Suporte para as revisões mais recentes disponíveis, por exemplo:

android {
  compileSdkVersion 26

  defaultConfig {
    targetSdkVersion 26
  }
  ...
}

dependencies {
  compile 'com.android.support:appcompat-v7:26.0.0'
}

// REQUIRED: Google's new Maven repo is required for the latest
// support library that is compatible with Android 8.0
repositories {
    google()

    // If you're using a version of Gradle lower than 4.1, you must instead use:
    // maven {
    //     url 'https://maven.google.com'
    // }
}

Remover broadcast receivers do arquivo de manifesto

Como o Android 8.0 (nível 26 da API) apresenta novas limitações para broadcast receivers, remova todos os broadcast receivers registrados para intents de transmissão implícitas. Deixá-los no lugar não interrompe o app no momento da criação ou da execução, mas eles não têm efeito quando o app é executado no Android 8.0.

As transmissões que só o seu app pode responder, como intents de transmissão explícitas e transmissões enviadas especificamente para o nome do pacote do seu app, continuam funcionando da mesma forma no Android 8.0.

Há exceções a essa nova restrição. Para ver uma lista de transmissões implícitas que ainda funcionam em apps destinados ao Android 8.0, consulte Exceções de transmissão implícita.

Testar o app para Android 8.0

Depois de concluir as preparações anteriores, você pode criar o app e testá-lo mais para garantir que ele funcione corretamente ao segmentar o Android 8.0 (nível da API 26). Esse é outro bom momento para analisar as diretrizes de qualidade principais de apps e as práticas recomendadas para testes.

Ao criar seu app com o targetSdkVersion definido como 26, é preciso estar ciente de algumas mudanças específicas na plataforma. Algumas dessas mudanças podem afetar significativamente o comportamento do app ou até mesmo interromper o funcionamento dele, mesmo que você não implemente novos recursos no Android 8.0.

A Tabela 2 mostra uma lista dessas mudanças com links para mais informações.

Tabela 2. Principais mudanças que afetam os apps quando targetSdkVersion é definido como 26.

Alterar Resumo Outras referências
Privacidade O Android 8.0 (nível 26 da API) não oferece suporte ao uso das propriedades do sistema net.dns1, net.dns2, net.dns3 ou net.dns4. Mudanças de comportamento: privacidade
Segmentos graváveis e executáveis aplicados Para bibliotecas nativas, o Android 8.0 (nível 26 da API) aplica a regra de que os dados não podem ser executáveis e o código não pode ser gravável. Mudanças de comportamento: bibliotecas nativas
Validação de cabeçalho e seção ELF O vinculador dinâmico verifica mais valores no cabeçalho ELF e nos cabeçalhos de seção e falha se eles forem inválidos. Mudanças de comportamento: bibliotecas nativas
Notificações Os apps destinados à versão do SDK do Android 8.0 (nível 26 da API) precisam implementar um ou mais canais de notificação para postar notificações aos usuários. Visão geral da API: notificações
O método List.sort() As implementações desse método não podem mais chamar Collections.sort(), ou o app vai gerar uma exceção devido ao estouro de pilha. Mudanças de comportamento: processamento de coleções
O método Collections.sort() Nas implementações de lista, Collections.sort() agora gera uma ConcurrentModificationException. Mudanças de comportamento: processamento de coleções

Para ver uma lista mais extensa de mudanças de comportamento no Android 8.0 (nível 26 da API), consulte Mudanças de comportamento do Android 8.0.

Para conhecer os novos recursos e APIs disponíveis no Android 8.0 (nível 26 da API), consulte Recursos e APIs do Android 8.0.