Os apps destinados ao Android 12 (nível 31 da API) ou versões mais recentes não podem iniciar serviços
em primeiro plano enquanto o app é executado em segundo plano, exceto em alguns casos
específicos. Se um app tentar iniciar um
serviço em primeiro plano enquanto estiver em segundo plano e o serviço em
primeiro plano não se enquadrar em um dos casos excepcionais, o sistema vai gerar uma
ForegroundServiceStartNotAllowedException
.
Além disso, se um app quiser iniciar um serviço em primeiro plano que precise de permissões durante o uso (por exemplo, sensor corporal, câmera, microfone ou localização permissões), ele não poderá criar o serviço enquanto o app estiver em segundo plano, mesmo que o app se enquadre em uma das isenções das restrições de início em segundo plano. O motivo disso é explicado na seção Restrições para iniciar serviços em primeiro plano que precisam de permissões de uso.
Isenções das restrições de inicialização em segundo plano
O app poderá iniciar serviços em primeiro plano enquanto estiver em segundo plano nas seguintes situações:
- O app estava em um estado visível para o usuário, como uma atividade.
- O app pode iniciar uma atividade do segundo plano, exceto quando o app tem uma atividade na backstack para uma tarefa existente.
O app recebe uma mensagem de alta prioridade usando o Firebase Cloud Messaging.
O usuário realiza uma ação em um elemento da IU relacionado ao app. Por exemplo, o usuário pode interagir com um balão, uma notificação, um widget ou uma atividade.
O app invoca um alarme exato para concluir uma ação solicitada pelo usuário.
O app é o método de entrada atual do dispositivo.
O app recebe um evento relacionado à fronteira geográfica virtual ou à transição de reconhecimento de atividade.
Após o dispositivo ser reiniciado e receber a ação da intent
ACTION_BOOT_COMPLETED
,ACTION_LOCKED_BOOT_COMPLETED
ouACTION_MY_PACKAGE_REPLACED
em um broadcast receiver.O app recebe a ação da intent
ACTION_TIMEZONE_CHANGED
,ACTION_TIME_CHANGED
ouACTION_LOCALE_CHANGED
em um broadcast receiver.Seu app recebe o evento
ACTION_TRANSACTION_DETECTED
deNfcService
.Apps com determinados papéis ou permissões do sistema, como proprietários de dispositivo e proprietários de perfil.
O app usa o gerenciador de dispositivo complementar e declara a permissão
REQUEST_COMPANION_START_FOREGROUND_SERVICES_FROM_BACKGROUND
ouREQUEST_COMPANION_RUN_IN_BACKGROUND
. Sempre que possível, useREQUEST_COMPANION_START_FOREGROUND_SERVICES_FROM_BACKGROUND
.O usuário desativa as otimizações de bateria do app.
O app tem a permissão
SYSTEM_ALERT_WINDOW
. Observação: se o app for destinado ao Android 15 ou versões mais recentes, ele precisará ter a permissãoSYSTEM_ALERT_WINDOW
e uma janela de sobreposição visível.
Restrições ao iniciar serviços em primeiro plano que precisam de permissões de uso durante o uso
No Android 14 (nível 34 da API) ou versões mais recentes, há situações especiais que precisam ser consideradas ao iniciar um serviço em primeiro plano que exige permissões de uso.
Se o app for destinado ao Android 14 ou a versões mais recentes, o sistema operacional
vai verificar quando você criar um serviço em primeiro plano para garantir que o app tenha todas as
permissões adequadas para esse tipo de serviço. Por exemplo, ao criar um
serviço em primeiro plano do tipo
microfone, o sistema
operacional verifica se o app tem a permissão
RECORD_AUDIO
. Se você não tiver essa permissão, o sistema vai gerar uma
SecurityException
.
Para permissões de uso, isso causa um problema em potencial. Se o app tiver uma
permissão de uso, ela só será válida enquanto o app estiver em
primeiro plano. Isso significa que, se o app estiver em segundo plano e tentar criar
um serviço em primeiro plano do tipo câmera, localização ou microfone, o sistema vai entender
que o app não tem as permissões necessárias no momento e vai gerar um
SecurityException
.
Da mesma forma, se o app estiver em segundo plano e criar um
serviço de saúde que precise da permissão BODY_SENSORS
, o app
não terá essa permissão no momento, e o sistema vai gerar uma exceção.
Isso não se aplica se for um serviço de saúde que precisa de permissões diferentes, como ACTIVITY_RECOGNITION
. Chamar PermissionChecker.checkSelfPermission()
não impede esse problema. Se o app tiver uma permissão de uso e
chamar checkSelfPermission()
para verificar se ele tem essa permissão, o método
vai retornar PERMISSION_GRANTED
mesmo que o app esteja em segundo plano. Quando o método retorna PERMISSION_GRANTED
, ele está dizendo "seu app tem essa permissão enquanto o app está em uso".
Por isso, se o serviço em primeiro plano precisar de uma permissão de uso durante o uso, você
precisará chamar Context.startForegroundService()
ou Context.bindService()
enquanto
o app tiver uma atividade visível, a menos que o serviço se enquadre em uma das
exceções definidas.
Exceções às restrições de permissões durante o uso
Em algumas situações, mesmo que um serviço em primeiro plano seja iniciado enquanto o app é executado em segundo plano, ele ainda poderá acessar informações de localização, câmera e microfone enquanto o app é executado em primeiro plano ("durante o uso").
Nessas mesmas situações, se o serviço declarar um tipo de serviço
em primeiro plano de location
e for iniciado por um app que
tenha a permissão ACCESS_BACKGROUND_LOCATION
, ele poderá acessar informações de localização o tempo todo, mesmo quando
o app estiver em segundo plano.
Confira a seguir uma lista com essas situações:
- Um componente do sistema inicia o serviço.
- O serviço é iniciado por uma interação com widgets de apps.
- O serviço é iniciado por uma interação com uma notificação.
- O serviço é iniciado como uma
PendingIntent
enviada por outro app visível. - O serviço é iniciado por um app que é um controlador de política de dispositivo em execução no modo de proprietário do dispositivo.
- O serviço é iniciado por um app que fornece o
VoiceInteractionService
. - O serviço é iniciado por um app com a
permissão privilegiada
START_ACTIVITIES_FROM_BACKGROUND
.
Determinar quais serviços são afetados no seu app
Ao testar seu app, inicie os serviços em primeiro plano. Se um serviço iniciado tiver acesso restrito à localização, ao microfone e à câmera, a seguinte mensagem será exibida no Logcat:
Foreground service started from background can not have \ location/camera/microphone access: service SERVICE_NAME