개발자는 앱의 특정 작업을 실행하는 바로가기를 정의할 수 있습니다. 이러한 바로가기는 지원되는 런처나 어시스턴트(Google 어시스턴트 등)에 표시될 수 있으며 사용자가 앱 내에서 일반 또는 추천 작업을 빠르게 시작할 수 있도록 도와줍니다.
이 가이드 세트에서는 앱 바로가기를 만들고 관리하는 방법을 보여줍니다. 바로가기의 효율성을 개선하는 권장사항도 알 수 있습니다.
바로가기 유형
각 바로가기는 하나 이상의 인텐트를 참조하고 각 인텐트는 사용자가 바로가기를 선택할 때 앱에서 특정 작업을 실행합니다. 개발자가 만든 앱 바로가기 유형은 앱의 주요 사용 사례에 따라 다릅니다. 바로가기로 표시할 수 있는 작업의 예는 다음과 같습니다.
- 이메일 앱에서 새로운 이메일 작성하기
- 매핑 앱에서 사용자를 특정 위치로 이동하기
- 커뮤니케이션 앱에서 친구에게 메시지 전송하기
- 미디어 앱에서 TV 프로그램의 다음 에피소드 재생하기
- 게임 앱에서 마지막 저장 지점 로드하기
- 음성 명령을 사용하여 음성으로 배달 앱에 음료 주문하기
참고: Intent.ACTION_MAIN 작업과 Intent.CATEGORY_LAUNCHER 카테고리를 처리하는 활동인 기본 활동에만 바로가기를 적용할 수 있습니다. 앱에 기본 활동이 여러 개 있다면 각 활동에 바로가기 세트를 정의해야 합니다.
앱에 다음 유형의 바로가기를 게시할 수 있습니다.
- APK 또는 App Bundle로 패키징된 리소스 파일에 정의되는 정적 바로가기
- 런타임 시에만 앱에서 푸시, 업데이트, 삭제할 수 있는 동적 바로가기
-
사용자가 권한을 부여하면 런타임 시 지원되는 런처에 추가할 수 있는 고정된 바로가기
참고: 사용자는 앱의 정적 및 동적 바로가기를 런처에 복사하여 고정된 바로가기를 직접 만들 수도 있습니다.
기능을 사용하여 어시스턴트에 바로가기 표시하기
shortcuts.xml의 기능을 사용하면 사용자가 앱을 실행하고 특정 작업을 곧바로 수행하기 위해 실행할 수 있는 작업 유형을 선언할 수 있습니다. 예를 들어, 앱 내 기능을 어시스턴트 앱 작업으로 확장하는 capability 요소를 선언하면 사용자가 Google 어시스턴트를 통해 앱을 음성으로 제어하도록 할 수 있습니다. 자세한 내용은 기능 추가를 참고하세요.
바로가기 제한사항
지원되는 런처 대부분은 정적 바로가기와 동적 바로가기를 포함하여 한 번에 최대 4개의 바로가기를 표시합니다. Google 어시스턴트와 같은 Google 표시 경로에 표시할 동적 바로가기를 푸시할 때 바로가기 제한을 적용받지 않으려면 Google 바로가기 통합 라이브러리를 사용하세요.
Google 바로가기 통합 라이브러리를 사용하지 않을 경우 앱에서 푸시하는 바로가기 수는 기기에서 한 번에 지원하는 최대 바로가기 수로 제한됩니다. 이 방식으로 게시된 바로가기는 Android 런처에만 표시되며 어시스턴트와 같은 Google 표시 경로에는 표시되지 않습니다.
참고: 하나의 기기에서 지원하는 최대 바로가기 개수는 다를 수 있습니다. 특정 기기에서 지원되는 바로가기 개수를 확인하려면 getMaxShortcutCountPerActivity() 메서드를 사용하세요.
사용자가 만들 수 있는 앱의 고정된 바로가기 개수에는 제한이 없습니다. 앱에서 고정된 바로가기를 삭제할 수 없어도 여전히 사용 중지할 수는 있습니다.
참고: 다른 앱에서는 바로가기 내의 메타데이터에 액세스할 수 없지만 런처 자체가 이 데이터에 액세스할 수 있습니다. 따라서 이러한 메타데이터는 민감한 사용자 정보를 숨겨야 합니다.
앱에 바로가기를 만들려면 다음 페이지를 참조하세요.
바로가기에서 실행할 수 있는 작업에 관한 자세한 내용은 ShortcutManager API 참조를 읽어보세요.