런처
최근에 재개된 모든 항목에 대한 라벨과 아이콘을 표시합니다.
할 일입니다. 앱 패키지에 별도의 런처 활동으로 여러 앱이 있는 경우 런처는 카드나 알림에서 실행된 활동 등 런처 외 활동에 표시할 라벨과 아이콘을 알 수 없습니다. 이로 인해
런처의 최근 목록에 앱이 표시되지 않거나
표시됩니다.
모든 활동에 라벨 지정
다음 단계와 같이 런처 외 활동을 비롯한 활동이 매니페스트 파일에서 제대로 라벨이 지정되었는지 확인합니다.
그림 1. 적절하게 라벨이 지정된 활동의 예
AndroidManifest.xml 파일의 모든 활동이 어떤 런처 활동에 속하는지 확인합니다.
상위 런처 활동의 아이콘, 둥근 아이콘, 라벨을 연결된 각 런처 외 활동에 복사합니다.
여러 런처 활동 간에 공유되는 활동의 경우 모든 활동을 나타내는 어떤 아이콘과 라벨을 표시할지 결정합니다.
RecentTasks 할당
런처에서 최근 섹션의 RecentTasks를 사용하려면 taskAffinity 요소가 AndroidManifest.xml 파일에 올바르게 정의되어 있고 작업과 백 스택을 일관되게 관리해야 합니다.
작업을 할당할 때는 다음 사항을 고려하세요.
앱에서 각 작업의 고유한 taskAffinity 이름을 선택합니다. 각 런처 활동과 하위 요소를 하나의 작업으로 간주할 수 있습니다. 매니페스트 파일의 모든 관련 활동에 해당 taskAffinity를 할당합니다.
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 OpenJDK는 Oracle 및 Oracle 계열사의 상표 또는 등록 상표입니다.
최종 업데이트: 2025-07-27(UTC)
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 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)"]]
그림 1. 적절하게 라벨이 지정된 활동의 예