Android API当中给出了两种实现方式，一种是静态，一种是动态。
静态方式：
静态的方式，需要xml资源，以shortcuts标签的形式引入，字面意思我们显而易见，就是捷径标签。
简单两步就可以实现，第一步，在res目录下，新建xml目录，然后创建对应的xml资源。
<?xml version="1.0" encoding="utf-8"?>
<shortcuts xmlns:android="http://schemas.android.com/apk/res/android">
<shortcut
android:enabled="true"
android:icon="@mipmap/ic_launcher"
android:shortcutId="test_0"
android:shortcutShortLabel="@string/app_test_0">
<intent
android:action="android.intent.action.VIEW"
android:targetClass="com.abner.widget.Test0Activity"
android:targetPackage="com.abner.widget" />
<categories android:name="android.shortcut.conversation" />
<capability-binding android:key="actions.intent.CREATE_MESSAGE" />
</shortcut>
<shortcut
android:enabled="true"
android:icon="@mipmap/ic_launcher"
android:shortcutId="test_1"
android:shortcutShortLabel="@string/app_test_1">
<intent
android:action="android.intent.action.VIEW"
android:targetClass="com.abner.widget.Test1Activity"
android:targetPackage="com.abner.widget" />
<categories android:name="android.shortcut.conversation" />
<capability-binding android:key="actions.intent.CREATE_MESSAGE" />
</shortcut>
</shortcuts>
外层首先一个shortcuts标签, 里面就是包裹着一个一个快捷方式shortcut，你需要几个，就创建几个，上面代码中我是创建了两个，可以发现这些属性和我们清单文件里的Activity里的属性类似，这里简单概述一下：
enabled, 表示这个shortcut是否可用
icon 为快捷图标
shortcutId, 快捷方式唯一的id
shortcutShortLabel, 短名称
shortcutLongLabel, 这里是配置的长名称, launcher会优先选择长名称显示，显示不下会选择短名称
categories 为应用程序的快捷方式执行的操作类型提供分组，例如创建新的聊天消息
capability-binding 可选 声明与此快捷方式关联的功能。CREATE_MESSAGE 声明的功能，是与应用有关的 Action 内置 intent。用户可以结合使用语音指令与 Google 助理来调用此快捷方式。
在shortcut标签下,还有一个intent标签，不用说，想必大家也知道了它的作用，就是点击快捷方式，跳转的目标。
intent, 这里表示我们点击shortcut时要干嘛,
targetPackage是指定一个目标应用的包名,
targetClass是我们要跳转的目标类, 这里要注意的是android:action一定要配置, 否则会崩溃
categories, 这个东西目前位置官方只给提供了android.shortcut.conversation
第二步，清单文件AndroidManifest里进行配置，这个需要注意一下：只能在有action是android.intent.action.MAIN和category是android.intent.category.LAUNCHER的Activity中配置才有效，说简单点，也就是应用的主入口。
<!--引入shortcuts资源-->
<meta-data
android:name="android.app.shortcuts"
android:resource="@xml/shortcuts" />
以上两步完成之后，我们就可以运行程序
动态方式：
上述的过程，我们实现了静态的快捷方式，但常见的需求情况下，有很多是需要动态配置的，那么如何实现呢？其实也非常简单，目前动态的方式创建其中，也有两种代码方式，一种是通过ShortcutManagerCompat来实现，一种是ShortcutManager，两种方式大同小异，我们一起来看下：
ShortcutManagerCompat方式实现：
添加：
//动态方式添加一
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N_MR1) {
val shortScan = ShortcutInfoCompat.Builder(this, "test_2")//唯一标识id
.setShortLabel(getString(R.string.app_test_2))//短标签
.setIcon(IconCompat.createWithResource(this, R.mipmap.ic_launcher))//图标
//跳转的目标，定义Activity
.setIntent(Intent(Intent.ACTION_MAIN, null, this, MainActivity::class.java))
.build()
//执行添加操作
ShortcutManagerCompat.addDynamicShortcuts(this, mutableListOf(shortScan))
toast("已添加")
}
效果对比：
更新：
//动态更新方式一
val shortScan = ShortcutInfoCompat.Builder(this, "test_2")//唯一标识id
.setShortLabel(getString(R.string.app_test_2_updata))//更新一个短标签
.setIcon(IconCompat.createWithResource(this, R.mipmap.ic_launcher))//图标
//要跳转的目标
.setIntent(Intent(Intent.ACTION_MAIN, null, this, MainActivity::class.java))
.build()
//执行更新操作
ShortcutManagerCompat.updateShortcuts(this, mutableListOf(shortScan))
toast("已更新")
更新前后效果对比
删除：
//动态移除方式一
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N_MR1) {
ShortcutManagerCompat.removeDynamicShortcuts(
this@MainActivity,
Collections.singletonList("test_2")//唯一标识id
)
toast("已移除")
}
删除后效果
ShortcutManager方式实现：
添加：
//动态方式添加二
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N_MR1) {
val info = ShortcutInfo.Builder(this, "test_3")//唯一标识id
.setShortLabel(getString(R.string.app_test_3))//短的标签
.setLongLabel(getString(R.string.app_test_3_long))//长的标签
.setIcon(Icon.createWithResource(this, R.mipmap.ic_launcher))//图标
.setIntent(intent)//跳转的目标，这里我设置的是当前
.build()
//执行添加操作
getSystemService(ShortcutManager::class.java)
.dynamicShortcuts = mutableListOf(info)
toast("已添加")
}
删除：
//动态移除方式二
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N_MR1) {
getSystemService(ShortcutManager::class.java)
.removeDynamicShortcuts(listOf("test_3"))//唯一的id标识
toast("已移除")
}
更新：
//动态更新方式二
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N_MR1) {
val info = ShortcutInfo.Builder(this, "test_3")//唯一标识id
.setShortLabel(getString(R.string.app_test_3_updata))//更新一个短标签
.setLongLabel(getString(R.string.app_test_3_long))//长标签
.setIcon(Icon.createWithResource(this, R.mipmap.ic_launcher))//图标
.setIntent(intent)//跳转的目标，这里我设置的是当前
.build()
//执行更新操作
getSystemService(ShortcutManager::class.java).updateShortcuts(listOf(info))
toast("已更新")
}
网友评论