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("已更新")
}
网友评论