Atender ao requisito de nível desejado da API do Google Play

Migrar de versões anteriores ao Android 11 (nível 30 da API)

Selecione a versão do Android da qual será feita a migração:

Migrar para o Android 5 (nível 21 da API)

Consulte a página "Mudanças de comportamento" de cada uma das versões abaixo para garantir que seu app tenha considerado as mudanças apresentadas:

• Android 5.0 (nível 21 da API)
• Android 4.4 (nível 19 da API)
• Android 4.1.x (nível 16 da API)

Continue seguindo as instruções na próxima seção.

Migrar para o Android 6 (nível 23 da API)

As seguintes considerações se aplicam a apps que segmentam o Android 6.0 e versões mais recentes da plataforma:

• Permissões de tempo de execução

  • Permissões perigosas são concedidas somente em tempo de execução. Os fluxos de interface do usuário precisam fornecer affordances para conceder essas permissões.

  • Sempre que possível, o app precisa estar preparado para lidar com a rejeição de solicitações de permissão. Por exemplo, se um usuário recusar uma solicitação para acessar o GPS do dispositivo, o app precisará ter outra maneira de prosseguir.

Para ver uma lista completa das mudanças aplicadas no Android 6.0 (nível 23 da API), consulte a página Mudanças de comportamento dessa versão da plataforma.

Continue seguindo as instruções na próxima seção.

Migrar para o Android 7 (nível 24 da API)

As seguintes considerações se aplicam a apps que segmentam o Android 7.0 e versões mais recentes da plataforma:

• Soneca e App em espera

  Projete para os comportamentos descritos no artigo Otimizar para o "Soneca" e "App em espera", que engloba outras mudanças introduzidas em várias versões de plataforma.

  Quando um dispositivo está nos modos Soneca e App em espera, o sistema se comporta da seguinte maneira:

  • Restringe o acesso à rede.
  • Adia alarmes, sincronizações e trabalhos.
  • Restringe as verificações de GPS e Wi-Fi.
  • Restringe mensagens do Firebase Cloud Messaging de prioridade normal.

• Mudanças de permissão

  • O sistema restringe o acesso aos diretórios privados do app.
  • A exposição de um URI file:// fora do app aciona uma FileUriExposedException. Caso você precise compartilhar arquivos fora do app, implemente o FileProvider.

• O sistema proíbe a vinculação a bibliotecas não NDK.

Para ver uma lista completa das mudanças aplicadas no Android 7.0 (nível 24 da API), consulte a página Mudanças de comportamento dessa versão da plataforma.

Continue seguindo as instruções na próxima seção.

Migrar para o Android 8 (nível 26 da API)

As seguintes considerações se aplicam a apps que segmentam o Android 8.0 e versões mais recentes da plataforma:

• Limites de execução em segundo plano
  • O sistema restringe serviços para apps que não estão sendo executados em primeiro plano.
    • startService() agora gera uma exceção quando um app tenta invocá-lo enquanto startService() está proibido.
    • Para iniciar serviços em primeiro plano, um app precisa usar startForeground() e startForegroundService().
    • Analise com atenção as alterações feitas na API JobScheduler, conforme documentado na página Mudanças de comportamento do Android 8.0 (nível 26 da API).
    • O Firebase Cloud Messaging requer a versão 10.2.1 do SDK do Google Play Services ou superior.
    • Ao usar o Firebase Cloud Messaging, a entrega de mensagens está sujeita a limites de execução em segundo plano. Quando o trabalho em segundo plano é necessário no recebimento da mensagem, como para executar a sincronização de dados em segundo plano, o app precisa agendar jobs usando o Firebase Job Dispatcher ou o JobIntentService. Para saber mais, consulte a documentação do Firebase Cloud Messaging.
  • Transmissões implícitas
    • Transmissões implícitas são restritas. Para saber mais sobre como lidar com eventos em segundo plano, consulte a documentação da API JobScheduler.
  • Limites da localização em segundo plano
    • Os apps executados em segundo plano têm acesso limitado aos dados de localização.
      • Em dispositivos com o Google Play Services, use o provedor de localização combinada para receber atualizações periódicas sobre a localização.
• Canais de notificação
  • É necessário definir as propriedades de interrupção de notificação por canal.
  • Atribua notificações a um canal para que elas apareçam.
  • Esta versão da plataforma tem suporte à classe NotificationCompat.Builder.
• Privacidade
  • O ANDROID_ID é delimitado por chave de assinatura do app.

Para ver uma lista completa das mudanças aplicadas no Android 8.0 (nível 26 da API), consulte a página Mudanças de comportamento dessa versão da plataforma.

Migrar do Android 8 (nível 26 da API) para o Android 9 (nível 28 da API)

• Gerenciamento de energia
  • Os intervalos do App em espera trazem novas restrições para segundo plano com base no engajamento do app, como tarefas adiadas, alarmes e cotas em mensagens de alta prioridade
  • Os aprimoramentos da Economia de bateria aumentam as limitações do recurso App em espera.
• Permissão de serviço de primeiro plano
  • É preciso solicitar a permissão normal FOREGROUND_SERVICE, e não a de execução.
• Mudanças de privacidade
  • Acesso limitado a sensores em segundo plano
  • Acesso restrito a registros de chamadas, agora no grupo de permissões CALL_LOG
  • Acesso restrito a números de telefone, exigindo a permissão READ_CALL_LOG.
  • Acesso restrito a informações de Wi-Fi

Para ver uma lista completa de alterações introduzidas no Android 9.0 (nível 28 da API), consulte as Mudanças de comportamento.

Migrar do Android 9 (nível 28 da API) para o Android 10 (nível 29 da API)

• Notificações com uma intent de tela cheia
  • É preciso solicitar a permissão normal USE_FULL_SCREEN_INTENT (não a permissão de execução).
• Compatibilidade com dispositivos dobráveis e de tela grande
  • Agora várias atividades podem ser colocadas no estado "retomada" ao mesmo tempo, mas somente uma delas receberá destaque.
    • Essa mudança afeta o comportamento de onResume() e onPause().
    • Novo conceito de ciclo de vida de "principal atividade retomada", que pode ser detectado ao se inscrever em onTopResumedActivityChanged().
      • É possível marcar apenas um item como "principal atividade retomada".
  • Quando resizeableActivity é definido como false, os apps também poderão especificar um minAspectRatio que coloca automaticamente o app com efeito letterbox em proporções mais estreitas.
• Mudanças de privacidade
  • Armazenamento com escopo
    • O acesso ao armazenamento externo é limitado somente a um diretório específico do app e a tipos específicos de mídia criados por ele.
  • O acesso ao local fica restrito enquanto o app estiver em segundo plano, o que exige a permissão ACCESS_BACKGROUND_LOCATION.
  • O acesso a identificadores não redefiníveis, como IMEI e número de série, fica restrito.
  • O acesso a informações de atividades físicas, como a contagem de passos do usuário, fica restrito, exigindo a permissão ACTIVITY_RECOGNITION.
  • O acesso fica restrito a algumas APIs de telefonia, Bluetooth e Wi-Fi, exigindo a permissão ACCESS_FINE_LOCATION.
  • O acesso a configurações de Wi-Fi fica restrito.
    • Os apps não podem mais ativar ou desativar o Wi-Fi diretamente e precisam fazer isso com painéis de configurações.
    • Há restrições para iniciar uma conexão a uma rede Wi-Fi, o que exige o uso de WifiNetworkSpecifier ou WifiNetworkSuggestion.

Migrar do Android 10 (nível 29 da API) para o Android 11 (nível 30 da API)

• Privacidade
  • Aplicação do armazenamento com escopo: os apps precisam adotar o modelo de armazenamento com escopo. Nele, mídia e outros tipos de arquivo específicos do app são salvos e acessados por locais exclusivos.
  • Redefinição automática de permissões: se os usuários não interagirem com um app por alguns meses, o sistema redefinirá automaticamente as permissões sensíveis dele. Isso não afeta a maioria dos apps. Caso o app funcione principalmente em segundo plano, sem interações com o usuário, considere solicitar que os usuários desativem a redefinição automática.
  • Acesso à localização em segundo plano: os apps precisam solicitar a permissão de localização em primeiro e segundo plano separadamente. A concessão da permissão de localização em segundo plano só pode ser feita nas configurações do app, e não em caixas de diálogo de permissão de execução.
  • Visibilidade do pacote: quando um app consulta a lista de apps e serviços instalados no dispositivo, a lista retornada é filtrada.
    • Se você usar os serviços de conversão de texto em voz ou reconhecimento de fala, será necessário adicionar elementos de consulta para serviços ao arquivo de manifesto.
• Segurança
  • Arquivos "resource.arsc" compactados não são mais compatíveis
  • O Esquema de assinatura do APK v2 agora é obrigatório. Por motivos de compatibilidade com versões anteriores, os desenvolvedores também precisam continuar assinando com o Esquema de assinatura do APK v1.
  • Restrição da interface não SDK. Não é recomendável usar interfaces não SDK para apps destinados ao nível 30 da API, porque algumas delas foram bloqueadas. Consulte Interfaces não SDK que agora estão bloqueadas no Android 11 para conferir a lista completa.

Para uma lista completa das mudanças introduzidas no Android 11 (nível 30 da API), consulte a página Mudanças de comportamento.

Atualize para o nível 31 da API seguindo as instruções da seção anterior.