O Android 10 (nível 29 da API) e versões mais recentes impõem restrições sobre o momento em que os apps podem iniciar atividades quando são executados em segundo plano. Essas restrições ajudam a minimizar interrupções para o usuário e mantê-lo mais controle sobre o que é mostrado na tela.
Este guia apresenta as notificações como uma alternativa para iniciar atividades em segundo plano. Ele 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 ligação recebida ou um despertador ativo.
Esse sistema de alerta e lembrete baseado em notificações oferece várias 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 urgentes respeitam as regras Não perturbe do usuário. Por exemplo, os usuários podem permitir chamadas apenas de contatos específicos ou de autores de chamadas recorrentes quando o modo Não perturbe está ativado.
- Quando a tela do dispositivo está desligada, a intent de tela cheia é iniciada imediatamente.
- Na tela Configurações do dispositivo, o usuário pode ver 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
Apps executados no Android 10 ou versões mais recentes podem iniciar atividades quando uma ou mais das seguintes condições são atendidas:
- O aplicativo 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 apenas quando o app tinha uma atividade em primeiro plano ou uma atividade na backstack da tarefa em primeiro plano no momento em quefinish()
foi chamado.O app tem um dos serviços a seguir vinculado pelo sistema. Esses serviços podem precisar iniciar uma interface.
AccessibilityService
AutofillService
CallRedirectionService
HostApduService
InCallService
TileService
(não aplicável no Android 14 (nível 34 da API) e versões mais recentes)VoiceInteractionService
VrListenerService
.
O app tem um serviço vinculado por um app diferente e visível. Ele precisa permanecer visível para que o app em segundo plano possa iniciar 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 da intent pendente.O app recebe um
PendingIntent
enviado de um app visível diferente.O app recebe uma transmissão do sistema em que se espera que ele inicie uma interface. Os exemplos incluem
ACTION_NEW_OUTGOING_CALL
eSECRET_CODE_ACTION
. O aplicativo pode iniciar atividades por alguns segundos após o envio da transmissão.O app é 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. Os exemplos de casos de uso incluem dispositivos corporativos totalmente gerenciados e dispositivos dedicados, como quiosques e sinalização digital.
O app recebe a permissão
SYSTEM_ALERT_WINDOW
do usuário.
É necessário ativar o recurso ao iniciar atividades com PendingIntents
Para evitar o início acidental de atividades com base nas condições listadas, no Android 14 e versões mais recentes, existem APIs explícitas que permitem ativar ou desativar a concessão de permissões de apps para inícios de atividade.
Por padrão, os apps destinados ao Android 15 ou versões mais recentes não vão mais conceder implicitamente
privilégios de inicialização de atividades em segundo plano para as PendingIntents
criadas por eles.
A ativação explícita é necessária. Para isso, essas são as opções que dependem
do app enviar ou criar PendingIntents
.
Pelo remetente da PendingIntent
Os apps destinados ao Android 14 ou mais recente que quiserem iniciar uma PendingIntent
precisam
- atender às condições listadas e
- Ativar a inicialização de atividades em segundo plano com base nessas exceções
Essa ativação só vai acontecer se o desenvolvedor do app souber que o app iniciará uma atividade.
Para ativar, 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 versões mais recentes que criam uma PendingIntent
agora precisam
permitir a inicialização de atividades em segundo plano explicitamente se quiserem que as
PendingIntents
sejam iniciadas nas condições listadas.
Na maioria dos casos, o app que inicia a PendingIntent
precisa ser ativado.
No entanto, se o app de criação precisar conceder esses privilégios:
- A
PendingIntent
pode ser iniciada sempre 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 app precisa transmitir um pacote ActivityOptions
com
setPendingIntentCreatorBackgroundActivityStartMode
(ActivityOptions.MODE_BACKGROUND_ACTIVITY_START_ALLOWED)
ao
PendingIntent.getActivity()
ou métodos semelhantes.
Leia a documentação de referência relevante para mais detalhes:
ActivityOptions.setPendingIntentBackgroundActivityStartMode
ActivityOptions.setPendingIntentCreatorBackgroundActivityStartMode