Restrições ao iniciar atividades a partir do segundo plano

O Android 10 (nível 29 da API) e versões mais recentes impõem restrições ao momento em que os apps podem iniciar atividades quando são executados em segundo plano. Essas restrições ajudam a minimizar as interrupções para o usuário e dão a ele mais controle sobre o que é exibido na tela.

Este guia apresenta as notificações como uma alternativa para iniciar atividades em segundo plano. Ela também lista os casos específicos em que a restrição não se aplica.

Exibir notificações

Em quase todos os casos, os apps em segundo plano precisam exibir notificações urgentes para fornecer informações urgentes ao usuário em vez de iniciar uma atividade diretamente. Essas notificações incluem o processamento de uma chamada telefônica recebida ou de um alarme ativo.

Esse sistema de alerta e lembrete baseado em notificações oferece diversas vantagens para os usuários:

  • Ao usar o dispositivo, o usuário recebe uma notificação de alerta que permite responder. O usuário mantém o contexto atual e tem controle sobre o conteúdo exibido na tela.
  • As notificações com limite de tempo respeitam as regras de Não perturbe do usuário. Por exemplo, quando a opção "Não perturbe" está ativada, os usuários podem permitir chamadas apenas de contatos específicos ou de chamadas repetidas.
  • Quando a tela do dispositivo está desligada, a intent de tela cheia é iniciada imediatamente.
  • Na tela Configurações do dispositivo, o usuário pode conferir quais apps enviaram notificações recentemente, inclusive de canais de notificação específicos. Nessa tela, ele pode controlar as preferências de notificação.

Quando os apps podem iniciar atividades

Os apps que executam o Android 10 ou mais recente podem iniciar atividades quando uma ou mais das condições a seguir for atendida:

  • O app tem uma janela visível, como uma atividade em primeiro plano.
  • O app tem uma atividade na backstack da tarefa em primeiro plano.

  • O app tem uma atividade na backstack de uma tarefa na tela Recentes.

  • O app tem uma atividade iniciada muito recentemente.

  • O app chamou finish() em uma atividade muito recentemente. Isso se aplica somente quando o app tem uma atividade em primeiro plano ou uma atividade na backstack da tarefa em primeiro plano no momento em que finish() é chamado.

  • O app tem um dos serviços a seguir que é vinculado pelo sistema. Esses serviços podem precisar iniciar uma interface.

  • O app tem um serviço vinculado por um app visível diferente. O app vinculado ao serviço precisa permanecer visível para que o app em segundo plano inicie as atividades.

  • O app recebe uma notificação PendingIntent do sistema. No caso de intents pendentes para serviços e broadcast receivers, o app pode iniciar atividades por alguns segundos após o envio do intent pendente.

  • O app recebe uma PendingIntent enviada por outro app visível.

  • O app recebe uma transmissão do sistema em que precisa iniciar uma interface. Os exemplos incluem ACTION_NEW_OUTGOING_CALL e SECRET_CODE_ACTION. O aplicativo pode iniciar atividades por alguns segundos após o envio da transmissão.

  • O app está associado a um dispositivo de hardware complementar pela API CompanionDeviceManager. Essa API permite que o app inicie atividades em resposta a ações que o usuário realiza em um dispositivo pareado.

  • O app é um controlador de política de dispositivo em execução no modo de proprietário do dispositivo. Exemplos de casos de uso incluem dispositivos corporativos totalmente gerenciados e dispositivos dedicados, como sinalização digital e quiosques.

  • O app recebeu a permissão SYSTEM_ALERT_WINDOW do usuário.

Ativação necessária ao iniciar atividades de PendingIntents

Para evitar inicializações acidentais da atividade com base nas condições listadas, a partir do Android 14, há APIs explícitas que permitem ativar ou desativar a concessão de permissões de um app para inicializações de atividades.

Os apps destinados ao Android 15 ou mais recente não vão mais conceder implicitamente privilégios de início de atividade em segundo plano (BAL) para PendingIntents criados. É necessário ativar a opção explicitamente. Para isso, estas são as opções, dependendo se o app está enviando ou criando PendingIntents.

Tabela de intents pendentes
Figura 1: fluxo de decisão para inicializações de atividade em segundo plano.

Pelo remetente da PendingIntent

Os apps destinados ao Android 14 ou mais recente que querem iniciar uma PendingIntent precisam

  • cumprir as condições listadas e
  • permitir o início de atividades em segundo plano com base nessas exceções.

Essa opção só vai acontecer se o desenvolvedor souber que o app vai iniciar uma atividade.

Para ativar o recurso, o app precisa transmitir um pacote ActivityOptions com setPendingIntentBackgroundActivityStartMode(ActivityOptions.MODE_BACKGROUND_ACTIVITY_START_ALLOWED) para o PendingIntent.send() ou métodos semelhantes.

Pelo criador da PendingIntent

Os apps destinados ao Android 15 ou mais recente que criam uma PendingIntent agora precisam explicitamente ativar a inicialização de atividades em segundo plano se quiserem que PendingIntents possa ser iniciada nas condições listadas.

Na maioria dos casos, o app que inicia a PendingIntent precisa ativar a opção. No entanto, se o app de criação precisar conceder esses privilégios:

  • O PendingIntent pode ser iniciado a qualquer momento que o app de criação estiver visível.
  • O PendingIntent pode ser iniciado a qualquer momento se o app de criação tiver privilégios especiais.

Para ativar o recurso, o app precisa transmitir um pacote ActivityOptions com setPendingIntentCreatorBackgroundActivityStartMode (ActivityOptions.MODE_BACKGROUND_ACTIVITY_START_ALLOWED) para o PendingIntent.getActivity() ou métodos semelhantes.

Leia a documentação de referência relevante para mais detalhes:

Modo restrito

A partir do Android 16, o desenvolvedor do app pode ativar o modo rígido para receber notificações quando uma inicialização de atividade é bloqueada (ou corre o risco de ser bloqueada quando o SDK de destino do app é gerado).

Exemplo de código para ativar no início do método Application.onCreate() do app, da atividade ou de outro componente do app:

 override fun onCreate(savedInstanceState: Bundle?) {
     super.onCreate(savedInstanceState)
     StrictMode.setVmPolicy(
         StrictMode.VmPolicy.Builder()
         .detectBlockedBackgroundActivityLaunch()
         .penaltyLog()
         .build());
     )
 }

Leia a documentação do Modo restrito para saber mais.