Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
A tela de início
exibe um rótulo e um ícone de qualquer criativo retomado recentemente
tarefas. Se o pacote do app
tiver vários apps como atividades diferentes, a tela de início não vai saber
qual rótulo e ícone mostrar para atividades que não estão na tela de início, como
aquelas iniciadas em um bloco ou uma notificação. Isso pode
fazer com que seu app não apareça na lista Recentes no acesso rápido ou mostrar
não está funcionando corretamente.
Identificar todas as atividades
As atividades do app, incluindo aquelas que não são listadas na tela de início, precisam ser identificadas corretamente
no arquivo de manifesto, conforme mostrado nas etapas abaixo.
Figura 1. Exemplos de atividades identificadas corretamente.
Indique a que atividade da tela de início pertence
cada atividade no arquivo AndroidManifest.xml.
Copie o ícone, o ícone redondo e o rótulo da atividade mãe da tela de início
para cada atividade não associada à tela de início.
Para aquelas que são compartilhadas entre várias atividades da tela de início, escolha
qual ícone e rótulo serão mostrados.
Atribuir RecentTasks
Para usar RecentTasks na seção Recentes da tela de início, confira se os
elementos taskAffinity estão definidos corretamente no arquivo AndroidManifest.xml e
se as tarefas e a backstack são gerenciadas de forma consistente.
Não se esqueça destas considerações ao atribuir tarefas:
Escolha um nome taskAffinity
exclusivo para cada tarefa no app. Considere cada atividade da tela de início
e as filhas dela como uma tarefa. Atribua essa taskAffinity a cada atividade relacionada
no arquivo de manifesto.
Evite criar atividades trampolim, que servem apenas para iniciar
outras atividades. Crie telas de apresentação usando a
API SplashScreen.
Use as flags android:excludeFromRecents="true" e android:noHistory="true"
quando não quiser que a atividade apareça na seção Recentes.
Determine o melhor modo de inicialização
para as atividades e desenvolva o app considerando esse modo.
Dicas de depuração
Ao depurar, tome cuidado com os detalhes abaixo:
Se houver duas entradas na seção Recentes de um único app,
verifique se você está usando a sinalização NEW_TASK de forma inadequada.
Se o ícone ou rótulo errado for mostrado, verifique se cada atividade
não relacionada à tela de início associada tem o mesmo ícone, ícone redondo e rótulo da atividade
mãe.
Se o sistema não iniciar nenhuma atividade ao tocar na tela de início,
consulte se há erros no Logcat dessa tela, porque esse problema pode
ser causado por uma atividade trampolim.
Recomendados para você
Observação: o texto do link aparece quando o JavaScript está desativado.
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-07-27 UTC.
[null,null,["Última atualização 2025-07-27 UTC."],[],[],null,["# Appear in recents and app resume\n\nThe [launcher](/training/wearables/user-interfaces#app_launcher_entries)\ndisplays a label and icon for any recently resumed\n[tasks](/guide/components/activities/tasks-and-back-stack). If your app package\nhas multiple apps as separate launcher activities, the launcher doesn't know\nwhich label and icon to show for non-launcher activities, such as\nactivities launched from a tile or a notification. This might\ncause your app to not show up in the **Recents** list in the launcher or to show\nup incorrectly.\n\nLabel all activities\n--------------------\n\nEnsure that your activities, including non-launcher activities, are properly\nlabelled in your manifest file, as shown in the following steps.\n\n\n**Figure 1.** Examples of properly labeled activities.\n\n1. For every activity in your `AndroidManifest.xml` file, determine which launcher activity it belongs to.\n2. Copy the icon, round icon, and label from the parent launcher activity into each associated non-launcher activity.\n3. For activities that are shared among multiple launcher activities, decide\n which icon and label to display that represents all of them.\n\n | **Note:** If the launcher is unable to determine the correct icon and label, it defaults to the icon and label of your application tag.\n\nAssign RecentTasks\n------------------\n\nTo use `RecentTasks` for the **Recents** section in the launcher, ensure that your\n`taskAffinity` elements are correctly defined in your `AndroidManifest.xml` file and\nthat you manage your tasks and back stack consistently.\n\nKeep the following considerations in mind as you assign tasks:\n\n- Choose a unique [`taskAffinity`](/guide/topics/manifest/activity-element#aff) name for each task in your app. You can consider each launcher activity and its children as one task. Assign that `taskAffinity` to every related activity in your manifest file.\n- Avoid calling `startActivity()` with [`FLAG_ACTIVITY_NEW_TASK`](/reference/android/content/Intent#FLAG_ACTIVITY_NEW_TASK) or [`FLAG_ACTIVITY_CLEAR_TOP`](/reference/android/content/Intent#FLAG_ACTIVITY_CLEAR_TOP).\n- Avoid creating *trampoline activities* , which are activities that only launch other activities. Create splash screens using the [SplashScreen API](/reference/android/R.attr#windowSplashscreenContent).\n- Use `android:excludeFromRecents=\"true\"` and `android:noHistory=\"true\"` flags when you don't want your activity to show up in the **Recents** section.\n- Determine the best [launch mode](/guide/components/activities/tasks-and-back-stack#TaskLaunchModes) for your activities and develop with that in mind.\n\nDebugging tips\n--------------\n\nLook out for the following things when debugging:\n\n- If there are double entries in the **Recents** section for a single app, check whether you are using the `NEW_TASK` flag inappropriately.\n- If the wrong icon or label displays, ensure that each associated non-launcher activity has the same icon, round icon, and label as its parent activity.\n- If the system doesn't launch anything after tapping the entry in the launcher, check Logcat (filtered on \"launcher\") for errors, as this issue can be caused by a trampoline activity.\n\nRecommended for you\n-------------------\n\n- Note: link text is displayed when JavaScript is off\n- [Tasks and the back stack](/guide/components/activities/tasks-and-back-stack)\n- [Create custom Quick Settings tiles for your app](/develop/ui/views/quicksettings-tiles)\n- [Learn Jetpack Navigation](/codelabs/android-navigation)"]]