사용자가 권한을 부여하면 런타임 시 지원되는 런처에 고정된 바로가기를 추가할 수 있습니다.
기능을 사용하여 어시스턴트에 바로가기 표시하기
shortcuts.xml의 기능을 사용하면 사용자가 앱을 실행하고 특정 작업을 바로 실행하기 위해 취할 수 있는 작업 유형을 선언할 수 있습니다. 예를 들어 인앱 기능을 어시스턴트 앱 작업으로 확장하는 capability 요소를 선언하여 사용자가 Google 어시스턴트를 통해 앱을 음성으로 제어하도록 할 수 있습니다. 자세한 내용은 기능 추가 문서를 참고하세요.
바로가기 제한사항
지원되는 런처 대부분은 정적 바로가기와 동적 바로가기를 포함하여 한 번에 최대 4개의 바로가기를 표시합니다. Google 어시스턴트와 같은 Google 표시 경로에 표시할 동적 바로가기를 푸시할 때 바로가기 제한을 피하려면 Google 바로가기 통합 라이브러리를 사용하세요.
Google 바로가기 통합 라이브러리를 사용하지 않도록 선택하면 앱에서 한 번에 지원하는 바로가기 수에 관한 기기의 한도가 적용됩니다. 이 방식으로 게시된 바로가기는 Android 런처 내에서만 표시되며 어시스턴트와 같은 Google 표시 경로에서 검색할 수 없습니다.
사용자가 앱에 만들 수 있는 고정된 바로가기의 수에는 제한이 없습니다. 앱은 고정된 바로가기를 삭제할 수 없지만 사용 중지할 수 있습니다.
바로가기에서 실행할 수 있는 작업에 관한 자세한 내용은 ShortcutManager API 참조 문서를 확인하세요.
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 OpenJDK는 Oracle 및 Oracle 계열사의 상표 또는 등록 상표입니다.
최종 업데이트: 2025-07-26(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-26(UTC)"],[],[],null,["# App shortcuts overview\n\nAs a developer, you can define *shortcuts* to perform specific actions\nin your app. You can display these shortcuts in a supported launcher or\nassistant---like Google Assistant---and help your users quickly start\ncommon or recommended tasks within your app.\n\nThis documentation shows you how to\n[create](/guide/topics/ui/shortcuts/creating-shortcuts) and\n[manage](/guide/topics/ui/shortcuts/managing-shortcuts) app\nshortcuts. You can also learn some\n[best practices](/guide/topics/ui/shortcuts/best-practices) to\nimprove your shortcuts.\n\nShortcut types\n--------------\n\n**Figure 1.** Using app shortcuts, you can surface key actions and instantly take users deep into your app.\n\nEach shortcut references one or more\n[intents](/guide/components/intents-filters), each of which\nlaunches a specific action in your app when users select the shortcut. The\ntypes of shortcuts you create for your app depend on the app's use case.\nExamples of actions you can express as shortcuts include the following:\n\n- Composing a new email in an email app.\n- Navigating users to a particular location in a mapping app.\n- Sending messages to a user's contact in a communication app.\n- Playing the next episode of a TV show in a media app.\n- Loading the last save point in a gaming app.\n- Letting the user order a drink in a delivery app using spoken commands.\n\n| **Note:** Only main activities---activities that handle the [Intent.ACTION_MAIN](/reference/android/content/Intent#ACTION_MAIN) action and the [Intent.CATEGORY_LAUNCHER](/reference/android/content/Intent#CATEGORY_LAUNCHER) category---can have shortcuts. If an app has multiple main activities, define the set of shortcuts for each activity.\n\nYou can publish the following types of shortcuts for your app:\n\n- *Static shortcuts* are defined in a resource file that is packaged into an APK or [app bundle](/guide/app-bundle/build).\n- *Dynamic shortcuts* can be pushed, updated, and removed by your app only at runtime.\n- *Pinned shortcuts* can be added to supported launchers at runtime if the user grants permission. **Note:** Users can also create pinned shortcuts by copying your app's static and dynamic shortcuts onto the launcher.\n\nDisplay shortcuts in assistants using capabilities\n--------------------------------------------------\n\n*Capabilities* in `shortcuts.xml` let you declare the types\nof actions users can take to launch your app and jump directly to performing a\nspecific task. For example, you can give users voice control of your app through\nGoogle Assistant by declaring `capability` elements that extend your\nin-app functionality to Assistant\n[App\nActions](https://developer.android.com/guide/app-actions/overview#app_actions). For more details, see the documentation about\n[adding\ncapabilities](/guide/topics/ui/shortcuts/adding-capabilities).\n\nShortcut limitations\n--------------------\n\nMost supported launchers display up to four shortcuts at a time, including\nboth static and dynamic shortcuts. When pushing dynamic shortcuts for display on\nGoogle's surfaces, such as Google Assistant, use the\n[Google\nShortcuts Integration Library](/guide/topics/ui/shortcuts/creating-shortcuts#gsi-library) to avoid being subject to the shortcut\nlimit.\n\nIf you choose not to use the Google Shortcuts Integration Library, your app\nis subject to the device's limit for the number of shortcuts it supports at a\ntime. Shortcuts published this way only appear within the Android launchers and\naren't discoverable on Google surfaces such as Assistant.\n| **Note:** The maximum number of shortcuts a device supports varies. Use the [`getMaxShortcutCountPerActivity()`](//developer.android.com/reference/androidx/core/content/pm/ShortcutManagerCompat#getMaxShortcutCountPerActivity(android.content.Context)) method to determine how many shortcuts a particular device supports.\n\nThere is no limit to the number of pinned shortcuts users can create to your\napp. Your app can't remove pinned shortcuts, but it can\n[disable](/guide/topics/ui/shortcuts/managing-shortcuts#disable-shortcuts)\nthem.\n| **Note:** Although other apps can't access the metadata within your shortcuts, the launcher itself can access this data. Therefore, conceal sensitive user information in this metadata.\n\nTo start creating shortcuts for your app, refer to the following\ndocumentation:\n\n- [Create shortcuts](/guide/topics/ui/shortcuts/creating-shortcuts)\n- [Manage shortcuts](/guide/topics/ui/shortcuts/managing-shortcuts)\n- [Best practices for\n shortcuts](/guide/topics/ui/shortcuts/best-practices)\n\nFor more details about operations you can perform on shortcuts, see the\n[ShortcutManager](/reference/android/content/pm/ShortcutManager)\nAPI reference documentation."]]
