Processar a interrupção iniciada pelo usuário de apps que executam serviços em primeiro plano
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
No Android 13 (nível 33 da API) e versões mais recentes, os usuários podem concluir um fluxo de trabalho na
gaveta de notificações
para interromper um app que tem serviços em primeiro plano em andamento, independente da versão
do SDK de destino. Essa funcionalidade, chamada de
gerenciador de tarefas, mostra uma lista de apps que estão
executando um serviço em primeiro plano.
Figura 1. Fluxo de trabalho do gerenciador de tarefas em dispositivos com o
Android 13 ou versões mais recentes.
A lista tem o rótulo Apps ativos.
Ao lado de cada app há um botão Parar. A Figura 1 ilustra o
fluxo de trabalho do gerenciador de tarefas em um dispositivo com o
Android 13.
Quando o usuário pressiona o botão Parar ao lado do app no
gerenciador de tarefas, as seguintes ações ocorrem:
O sistema remove o app da memória. Portanto, todo o app é interrompido,
e não apenas o serviço em execução em primeiro plano.
O sistema remove a pilha de retorno de atividade do app.
A reprodução de mídia é interrompida.
A notificação associada ao serviço em primeiro plano é removida.
O app permanece no histórico.
Os jobs programados são executados no horário programado.
Os alarmes tocam no horário ou período programado.
Para testar se o app está se comportando conforme o esperado ao ser interrompido pelo usuário, execute o comando ADB abaixo em uma janela de terminal:
adbshellcmdactivitystop-appPACKAGE_NAME
O conteúdo e os exemplos de código nesta página estão sujeitos às licenças descritas na Licença de conteúdo. Java e OpenJDK são marcas registradas da Oracle e/ou suas afiliadas.
Última atualização 2025-08-21 UTC.
[null,null,["Última atualização 2025-08-21 UTC."],[],[],null,["# Handle user-initiated stopping of apps running foreground services\n\nStarting in Android 13 (API level 33), users can complete a workflow from the\n[notification drawer](/develop/ui/views/notifications#bar-and-drawer)\nto stop an app that has an ongoing foreground services, regardless of that app's\ntarget SDK version. This affordance, called the\n*Task Manager*, shows a list of apps that are\ncurrently running a foreground service. \n**Figure 1.** Task Manager workflow on devices that run Android 13 or higher.\n\nThis list is labeled **Active apps** .\nNext to each app is a **Stop** button. Figure 1 illustrates the\nTask Manager workflow on a device that runs\nAndroid 13.\n\nWhen the user presses the **Stop** button next to your app in the\nTask Manager, then the following actions occur:\n\n- The system removes your app from memory. Therefore, your **entire app stops**, not just the running foreground service.\n- The system removes your app's activity back stack.\n- Any media playback stops.\n- The notification associated with the foreground service is removed.\n- Your app remains in history.\n- Scheduled jobs execute at their scheduled time.\n- Alarms go off at their scheduled time or time window.\n\n| **Note:** The system doesn't send your app any callbacks when the user taps the **Stop** button. When your app starts back up, it's helpful to check for the [`REASON_USER_REQUESTED`](/reference/android/app/ApplicationExitInfo#REASON_USER_REQUESTED) reason that's part of the `ApplicationExitInfo` API.\n\nTo test that your app behaves as expected while and after a user stops your\napp, run the following ADB command in a terminal window: \n\n```bash\nadb shell cmd activity stop-app PACKAGE_NAME\n```"]]
