A documentação sobre serviços em primeiro plano descreve o comportamento atual dos serviços em primeiro plano do Android. A documentação oferece orientações sobre as práticas recomendadas para a maioria dos apps, com ou sem segmentação para a versão mais recente do Android.
Esta página descreve algumas das mudanças importantes mais recentes nos serviços em primeiro plano e as implicações para apps que não têm como destino a versão mais recente da plataforma Android. Em muitos casos, as práticas recomendadas que eram opcionais para apps destinados a níveis de API mais baixos se tornam obrigatórias para apps destinados a níveis de API mais altos.
Android 16 (nível 36 da API)
As mudanças a seguir se aplicam a apps executados no Android 16 ou em versões mais recentes, independente do nível de API a que eles são destinados:
Os jobs em segundo plano iniciados por um serviço em primeiro plano agora precisam obedecer às respectivas cotas de tempo de execução. Isso inclui jobs programados diretamente com
JobScheduler
, bem como jobs criados por outras bibliotecas, como WorkManager ouDownloadManager
.Para transferir dados em resposta a uma ação do usuário, considere usar um job de transferência de dados iniciada pelo usuário. Esses jobs estão isentos das cotas comuns.
Android 15 (nível 35 da API)
Os seguintes requisitos se aplicam a apps direcionados ao nível 35 da API ou mais recente:
- Há novas restrições sobre o tempo de execução de um serviço em primeiro plano
dataSync
. Essas restrições estão descritas em Comportamento de tempo limite do serviço em primeiro plano. Restrições semelhantes se aplicam ao tipo de serviço em primeiro planomediaProcessing
(novo no Android 15). - Os serviços em primeiro plano
BOOT_COMPLETED
não podem mais iniciar determinados serviços em primeiro plano. - Os apps que têm a permissão
SYSTEM_ALERT_WINDOW
só podem iniciar serviços em primeiro plano em segundo plano se tiverem uma janela de sobreposição visível (ou se atenderem a uma das outras isenções das restrições de início em segundo plano). Antes, a isenção para esses apps era mais ampla.
Android 14 (nível 34 da API)
Os seguintes requisitos se aplicam a apps que segmentam o nível 34 da API ou mais recente:
- É necessário declarar todos os serviços em primeiro plano com os respectivos tipos.
- Os apps precisam solicitar o tipo de permissão adequado para o tipo de trabalho que o
serviço em primeiro plano vai realizar. Cada tipo de serviço em primeiro plano tem um tipo de permissão correspondente. Por exemplo, se um app iniciar um
serviço em primeiro plano que usa a câmera, você precisará solicitar as permissões
FOREGROUND_SERVICE
eFOREGROUND_SERVICE_CAMERA
. Se um app for destinado ao nível 34 da API ou mais recente e não solicitar a permissão específica adequada, o sistema vai gerar umaSecurityException
.
Android 12 (nível 31 da API)
Os seguintes requisitos se aplicam a apps que segmentam o nível 31 da API ou mais recente:
- Os apps não podem iniciar serviços em primeiro plano enquanto estão em segundo plano, com algumas exceções específicas. Para mais informações e exceções a essa regra, consulte Restrições para iniciar um serviço em primeiro plano do segundo plano.
Android 11 (nível 30 da API)
Os requisitos a seguir se aplicam a apps direcionados ao nível 30 da API ou mais recente:
- Se os serviços em primeiro plano de um app usarem a câmera ou o microfone, o app precisará
declarar o serviço com o tipo
camera
oumicrophone
respectivamente.
Android 10 (nível 29 da API)
Os seguintes requisitos se aplicam a apps destinados ao nível 29 ou mais recente da API:
- Se os serviços em primeiro plano de um app usarem informações de local, o app precisará
declarar o serviço com o tipo
location
.
Android 9 (nível 28 da API)
O Android 9 introduz a permissão
FOREGROUND_SERVICE
. Os apps em execução no
Android 9 que usam serviços em primeiro plano precisam ter essa permissão.
Se um app destinado ao nível 28 da API ou a uma versão mais recente tentar
criar um serviço em primeiro plano sem solicitar a permissão FOREGROUND_SERVICE
, o sistema vai gerar uma SecurityException
.