[Android] App Architecture - App Shortcuts (앱 바로가기)

 

 

 

사용자 경험을 개선하기 위해 개발자는 앱에서 특정 작업을 실행하는 바로가기를 정의할 수 있습니다.

각 바로가기는 하나 이상의 인텐트를 참조하며, 각 인텐트는 사용자가 바로가기를 선택할 때 앱에서 특정 작업을 실행합니다.

 

앱 바로가기는 3가지가 있습니다.

Shortcut Type	설명
Static Shortcuts	앱이 설치될 때 미리 정의된, 고정된 바로가기
Dynamuc Shortcuts	앱 실행 중에 동적으로 추가/삭제할 수 있는 바로가기
Pinned Shortcuts	사용자가 홈 화면에 추가할 수 있는 바로가기

 

이때 정적 바로가기와 동적 바로가기를 포함하여 한 번에 최대 4개의 바로가기를 표시합니다. 반면 사용자가 앱에 만들 수 있는 고정 바로가기의 수는 제한이 없습니다. 앱은 고정 바로가기를 삭제할 수 없지만 사용 중지할 수는 있습니다.

 

---

 

Static Shortcuts(정적 바로가기)

정적 바로가기는 앱이 설치되는 순간부터 존재하는 바로가기입니다. APK 또는 App Bundle로 패키징된 리소스 파일에 정의됩니다.

앱의 AndroidManifest.xml 파일에 메타데이터로 연결된 shortcuts 리소스를 정의하면, 안드로이드 런처가 앱을 설치할 때 이를 읽어들여 앱 아이콘을 길게 눌렀을 때 나타나는 메뉴로 보여줍니다.

 

즉, 앱이 업데이트되기 전까지는 개발자가 정의한 상태 그대로 유지되고, 실행 중에 코드로 바꾸거나 지울 수 없습니다.

<!-- res/xml/shortcuts.xml-->
<shortcuts xmlns:android="http://schemas.android.com/apk/res/android">
    <shortcut
        android:shortcutId="open_profile"
        android:enabled="true"
        android:icon="@drawable/ic_profile"
        android:shortcutShortLabel="@string/shortcut_label"
        android:shortcutLongLabel="@string/shortcut_label_long"
        android:shortcutDisabledMessage="@string/shortcut_disabled_message">
        <intent
            android:action="android.intent.action.MAIN"
            android:targetPackage="com.example.app"
            android:targetClass="com.example.app.ProfileActivity" />
    </shortcut>
</shortcuts>

 

android:enabled의 값을 true로 설정해야 바로가기가 추가됩니다. false로 설정하면 바로가기를 비활성화 할 수 있습니다.

비활성화된 이유를 설명하고자 한다면 android:shortcutDisabledMessage를 설정해야 합니다.

<!-- AndroidManifest.xml -->
<application ...>
    <activity ...>
        <intent-filter>
            <action android:name="android.intent.action.MAIN" />
            <category android:name="android.intent.category.LAUNCHER" />
        </intent-filter>
        <meta-data
            android:name="android.app.shortcut"
            android:resources="@xml/shortcuts" />
    </activity>
</application>

 

이때 메타데이터는 application 내부가 아닌, intent-filter가 있는 Main Activity에 작성해야 정상적으로 동작합니다.

 

실행 결과

 

이 방식의 장점은 간단하고 안정적이라는 것입니다. 코드를 전혀 건드리지 않고 리소스 파일만 작성하면 되ㅏ기 때문에 고정된 기능이나 누구에게나 제공되는 공통 기능을 넣기에 적합합니다.

예를 들면 은행 앱의 경우, "송금하기"나 "계좌조회"와 같은 고정 기능을 등록할 수 있습니다.

 

반면 단점은 동적으로 바꿀 수 없다는 것입니다. 로그인 여부나 개인화된 데이터에 따라 달라져야 하는 바로가기는 이 방식으로 구현할 수 없습니다.

 

 

 

Dynamic Shortcuts(동적 바로가기)

동적 바로가기는 런타임 환경에서 코드로 추가하거나 수정, 삭제할 수 있는 바로가기입니다.

앱에서 ShortManager API를 이용해 런타임 시점에 새 단축키를 등록할 수 있고, 앱 상태나 사용자 행동에 따라 유연하게 변경할 수 있습니다.

val intent = Intent(this, ProfileActivity::class.java).apply {
    action = Intent.ACTION_VIEW
}

val shortcut = ShortcutInfoCompat.Builder(this, "dynamic_profile")
    .setShortLabel("프로필2")
    .setIcon(Icon.createWithResource(this, R.drawable.ic_profile))
    .setIntent(intent)
    .build()

ShortcutManagerCompat.pushDynamicShortcut(context, shortcut)

 

pushDynamicShortcut() 메서드를 사용하면 동일한 ID의 바로가기를 업데이트하고, 동일한 ID가 없을 경우에는 새로운 바로가기를 추가합니다.

실행 결과

 

추가한 바로가기는 아래의 메서드를 호출하여 삭제할 수 있습니다.

// id를 사용해 특정 바로가기 삭제
ShortcutManagerCompat.removeDynamicShortcuts(context, "dynamic_profile")

// 모든 바로가기 삭제
ShortcutManagerCompat.removeAllDynamicShortcuts(context)

 

 

이 방식의 장점은 유연함으로, 사용자의 행동에 맞춰 개인화된 경험을 제공할 수 있습니다. 하지만 앱이 종료되거나 캐시가 지워지면 등록된 동적 바로가기가 사라질 수 있고, 기본적으로는 앱 실행 중에만 의미가 있는 기능이라는 점이 단점입니다.

 

 

 

Pinned Shortcuts(고정 바로가기)

고정 바로가기는 홈 화면에 독립적인 아이콘처럼 추가되는 바로가기입니다. 사용자가 권한을 부여하면 런타임 시 지원되는 런처에 추가할 수 있습니다.

앱 내부에서 ShortcutManager의 requestPinShortcut() 메서드를 호출하면 시스템이 사용자에게 홈 화면에 바로가기를 추가할 것인지에 대한 팝업을 띄워주고, 사용자가 동의하면 해당 아이콘이 홈 화면에 고정됩니다.

val shortcutManager = getSystemService(ShortcutManager::class.java)

if (shortcutManager.isRequestPinShortcutSupported) {
    val intent = Intent(this, ProfileActivity::class.java).apply {
        action = Intent.ACTION_VIEW
    }

    val shortcut = ShortcutInfo.Builder(this, "pinned_profile")
        .setShortLabel("프로필3")
        .setIcon(Icon.createWithResource(this, R.drawable.ic_profile))
        .setIntent(intent)
        .build()

    val pinIntent = shortcutManager.createShortcutResultIntent(shortcut)
    val callbackIntent = PendingIntent.getBroadcast(this, 0, pinIntent, PendingIntent.PLAG_IMMUTABLE)

    shortcutManager.requestPinShortcut(shortcut, callbackIntent.intentSender)
}

 

바로가기 추가 허용 여부를 묻는 팝업

바로가기 추가 허용 결과

 

이 방식의 장점은 홈 화면 접근성이 극대화된다는 점입니다. 사용자가 자주 이용하는 특정 기능을 아이콘처럼 배치할 수 있어서 사용자 경험이 개선됩니다.

 

 

 

Built-in Intents(내장 인텐트)

이때 바로가기에 Capability 요소를 추가하면 Google 어시스턴트를 활용해 사용자가 기능을 제어할 수 있습니다.

이를 내장 인텐트(Built-in Intents)라고 합니다.

 

사용자가 앱을 길게 누르거나 런처에서 shortcut를 직접 눌러 intent를 실행하는 것이 아니라, 음성 명령과 같이 어시스턴트가 BII를 호출하여 해당 shortcut과 연결된 Intent를 실행하는 방식입니다.

 

 

아래의 예는 사용자가 음성 명령으로 어시스턴트를 사용해 피트니스 앱에서 운동을 시작하도록 지원하는 방법입니다.

<shortcuts xmlns:android="http://schemas.android.com/apk/res/android">
    <capability android:name="actions.intent.START_EXERCISE">
    <intent
        android:action="android.intent.action.VIEW"
        android:targetPackage="com.example.sampleApp"
        android:targetClass="com.example.sampleApp.ExerciseActivity">
        <parameter
            android:name="exercise.name"
            android:key="exerciseType"/>
        </intent>
    </capability>
</shortcuts>

 

<capability>의 name 속성은 지원할 작업 음성 명령어에 대한 BII Action ID를 정의합니다.

어시스턴트가 "Hey Google, 운동을 시작해줘." 같은 명령어를 이 앱에 매핑하려고 할 때 START_EXERCISE BII를 사용합니다.

 

<parameter>에는 기능과 연결된 매개변수를 명시합니다.

예를 들어 사용자가 "앱에서 달리기 시작해줘." 라고 했을 때 '달리기'라는 매개변수가 필요합니다. 이러한 값을 parameter 요소에 정의합니다.

 

 

동적 바로가기나 고정 바로가기의 경우 아래와 같이 capability를 설정합니다.

val shortcut = ShortcutInfoCompat.Builder(context, "shortcut_id")
    .setShortLabel("달리기 시작")
    .setIcon(IconCompat.createWithResource(context, R.drawable.ic_run))
    .setIntent(intent)
    .addCapabilityBinding(
        "actions.intent.START_EXERCISE",
        "exercise.name",
        listOf("running")
    )
    .build()

 

 

여러 명령어와 매개변수에 관한 정보는 App Actions built-in intents에서 확인할 수 있습니다.

---

 

안드로이드 개발자 로드맵을 따라 정리한 내용입니다.