一、背景
长按桌面图标实现快捷方式最早是iOS提供的功能，而Android最早在Android 7.1版本也提供了对这方面的支持，于是在短时间内，像微信，支付宝，头条等流量级应用都提供了这方面的支持，如下图。
现在，长按桌面图标快捷方式已经是很成熟的功能，实现上也比较简单，主要用到的Api就是ShortcutManager。而在具体实现方案上，Android 又给出了两种实现方式，一种是静态，一种是动态。
二、静态方式
静态方式需要使用xml资源，以shortcuts标签的形式引入。对于静态方式，我们首先需要在res目录的xml目录下创建一个xml资源文件，如下所示。
... //省略其他代码
其中，使用静态方式常见的配置属性如下：
- enabled：表示这个shortcut是否可用；
- icon：为快捷图标；
- shortcutId：快捷方式唯一的id；
- shortcutShortLabel：短名称；
- shortcutLongLabel：配置的长名称, launcher会优先选择长名称显示，显示不下会选择短名称；
-
- categories：为应用程序的快捷方式执行的操作类型提供分组
- capability-binding：声明与此快捷方式关联的功能。
除此之外，在shortcut标签下也有几个属性需要注意：
- intent：点击shortcut时的目标页；
- targetPackage：指定一个目标应用的包名；
- targetClass：要跳转的目标类, 需要注意的是，android:action一定要配置，否则可能出现崩溃；
- categories：目前官方只给提供了android.shortcut.conversation；
完成上述操作后，接下来就是在清单文件AndroidManifest.xml里进行配置。具体来说，就是在AndroidManifest.xml的入口Activity中引入shortcuts资源。
完成上述操作后，我们就可以允许工程代码了，效果如下。
三、动态方式
静态快捷方式适合毕竟固定的场景，如果快捷方式需要动态配置，那么就需要用到ShortcutManagerCompat或ShortcutManager来实现。
3.1 ShortcutManagerCompat
下面是使用ShortcutManagerCompat实现动态快捷方式的示例代码。
private fun initShortCut() {
//动态方式添加
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N_MR1) {
val shortScan = ShortcutInfoCompat.Builder(this, "scan")
.setShortLabel(getString(R.string.short_cut_scan))
.setIcon(IconCompat.createWithResource(this, R.mipmap.ic_shortcut_scan))
.setIntent(Intent(Intent.ACTION_MAIN, null, this, ScanActivity::class.java))
.build()
ShortcutManagerCompat.addDynamicShortcuts(this, mutableListOf(shortScan))
}
}如果需要更新快捷方式，可以使用updateShortcuts方法，参考代码如下。
private fun updateShortCut() {
val shortScan = ShortcutInfoCompat.Builder(this, "scan")
.setShortLabel(getString(R.string.short_cut_scan))
.setIcon(IconCompat.createWithResource(this, R.mipmap.ic_shortcut_scan))
.setIntent(Intent(Intent.ACTION_MAIN, null, this, MainActivity::class.java))
.build()
ShortcutManagerCompat.updateShortcuts(this, mutableListOf(shortScan))
}如果要删除快捷方式，需要用到ShortcutManagerCompat的removeDynamicShortcuts删除方法，并且需要使用创建时的唯一id，参考代码如下。
//动态移除
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N_MR1) {
ShortcutManagerCompat.removeDynamicShortcuts(
this@MainActivity,
Collections.singletonList("scan")//唯一标识id
)
}
3.2 ShortcutManager
除了ShortcutManagerCompat方式外，我们还可以使用ShortcutManager来创建快捷方式，如下所示。
private fun initShortCut() {
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N_MR1) {
val info = ShortcutInfo.Builder(this, "scan")
.setShortLabel(getString(R.string.short_cut_scan))
.setIcon(Icon.createWithResource(this, R.mipmap.ic_shortcut_scan))
.setIntent(intent)
.build()
getSystemService(ShortcutManager::class.java)
.dynamicShortcuts = mutableListOf(info)
}
}如果需要更新快捷方式，可以使用updateShortcuts方法，如下所示。
private fun updateShortCut() {
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N_MR1) {
val info = ShortcutInfo.Builder(this, "scan")
.setShortLabel(getString(R.string.short_cut_scan))
.setIcon(Icon.createWithResource(this, R.mipmap.ic_shortcut_scan))
.setIntent(intent)
.build()
getSystemService(ShortcutManager::class.java).updateShortcuts(listOf(info))
}
}如果要删除快捷方式，可以使用removeDynamicShortcuts方法，如下所示。
private fun delShortCut() {
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N_MR1) {
getSystemService(ShortcutManager::class.java)
.removeDynamicShortcuts(listOf("scan"))
}
}下面是ShortcutManager的常见方法：
- setDynamicShortcuts()：可以添加或替换所有的shortcut；
- addDynamicShortcuts()：来添加新的shortcut到列表中，超过最大个数会报异常
- updateShortcuts(List shortcutInfoList)：更新已有的动态快捷方式；
- removeDynamicShortcuts(List shortcutIds)：根据动态快捷方式的ID，删除已有的动态快捷方式；
- removeAllDynamicShortcuts()：删除掉app中所有的动态快捷方式；
- getDynamicShortcuts()：得到所有的动态shortcuts；
到此，快捷方式的静态和动态添加方式就介绍完成了。