【Android】アプリ起動のショートカットを実装する

<!-- shortcut.xml -->
<?xml version="1.0" encoding="utf-8"?>
<shortcuts xmlns:android="http://schemas.android.com/apk/res/android">
    <shortcut android:shortcutId="shortcut_list" android:enabled="true" android:icon="@drawable/ic_list"
        android:shortcutShortLabel="@string/label_list" android:shortcutLongLabel="@string/label_list">
        <intent android:action="android.intent.action.VIEW" android:targetPackage="jp.co.appshortcutsample"
            android:targetClass="jp.co.appshortcutsample.MainActivity">
            <extra android:name="shortcut_id" android:value="shortcut_list" />
        </intent>
    </shortcut>
</shortcuts>

<!--AndroidManifest.xml(抜粋)-->
<application>
    <activity android:name="Main">
        <!-- 以下を既存のactivityスコープ内に追記する -->
        <meta-data android:name="android.app.shortcuts" android:resource="@xml/shortcuts" />
    </activity>
</application>

```kotlin
/**
 * AppShortcutからShortcutInfoCompatを作成
 */
private fun createShortcutInfo(context: Context, shortcut: AppShortcut): ShortcutInfoCompat {
    val intent = Intent(context, MainActivity::class.java).apply {
        action = Intent.ACTION_VIEW
        flags = Intent.FLAG_ACTIVITY_NEW_TASK or Intent.FLAG_ACTIVITY_CLEAR_TOP or Intent.FLAG_ACTIVITY_SINGLE_TOP
        // intentからshortcutIdが取得できないので明示的に渡す。特定できれば良いのでキーは何でも良い
       // 静的ショートカット同様にこちらでショートカットを判定できるようにする必要がある
        putExtra("shortcut_id", [対応するshortcutId])
        // 普通のintentなのでもちろん追加でパラメータを渡すことも可能(初期値の設定とか)
        putExtra("extra_data", "何かしらの値")
    }

    ShortcutInfoCompat.Builder(context, [対応するshortcutId])
        .setShortLabel("shortcutShortLabelにあたる値")
        .setLongLabel("shortcutLongLabelにあたる値")
        .setIcon("iconにあたるリソース")
        .setIntent(intent)
        .build()
}
```

// (UI抜粋)
TextButton(
    onClick = {
        // Pinned Shortcutを作成
        val success = AppShortcutsManager.requestPinEditShortcut(context)
        if (!success) {
            android.widget.Toast.makeText(
                context,
                "ショートカットの追加に失敗しました",
                android.widget.Toast.LENGTH_SHORT
            ).show()
        }
        showPinShortcutDialog = false
        onDismiss()
    }
) {
    Text(stringResource(id = R.string.app_shortcuts_pin_dialog_confirm))
}
...

fun requestPinEditShortcut(context: Context): Boolean {
    // Pinned Shortcutがサポートされているかチェック
    if (!ShortcutManagerCompat.isRequestPinShortcutSupported(context)) {
        return false
    }

    // 動的ショートカットと同じ作り方
    val shortcutInfo = createShortcutInfo(context, AppShortcut.Edit)
    return ShortcutManagerCompat.requestPinShortcut(context, shortcutInfo, null)
}
```

部分的に公式と異なる箇所はあったものの、簡単に実装することができました。
実際のところ、あまり目立たない機能なため、機能追加する機会も多くなさそうですが、地味ながら捗る機能だと思います。ぜひ対応してみてはいかがでしょうか？