[轉(zhuǎn)載文章]
長(zhǎng)按桌面圖標(biāo)展示快捷方式,今時(shí)看來(lái)温兼,早已司空見慣秸滴,一是Android很早的版本就已經(jīng)支持,二是大部分的應(yīng)用也已經(jīng)實(shí)現(xiàn)募判,像微信荡含,支付寶,頭條等届垫,所以無(wú)論功能還是實(shí)現(xiàn)方式释液,都已經(jīng)踴躍出了大量的技術(shù)博文,但細(xì)細(xì)看去装处,卻很少有一個(gè)統(tǒng)一的流程及具體的實(shí)現(xiàn)方案误债,本文針對(duì)此功能做了細(xì)致的總結(jié),一是妄迁,便于日后開發(fā)的需要寝蹈,二是,希望可以幫助到有類似需求的小伙伴登淘。
這個(gè)特性躺盛,可以追溯到Android 7.1,也就是在7.1之后的系統(tǒng)形帮,如果app支持槽惫,可以通過長(zhǎng)按app圖標(biāo)展示一些快捷操作,如下圖:
相信上圖中的功能辩撑,大家都見過界斜,那么如何實(shí)現(xiàn)呢?Android API當(dāng)中給出了兩種實(shí)現(xiàn)方式合冀,一種是靜態(tài)各薇,一種是動(dòng)態(tài)。
靜態(tài)方式:
靜態(tài)的方式君躺,需要xml資源峭判,以shortcuts標(biāo)簽的形式引入,字面意思我們顯而易見棕叫,就是捷徑標(biāo)簽林螃。
簡(jiǎn)單兩步就可以實(shí)現(xiàn),第一步俺泣,在res目錄下疗认,新建xml目錄完残,然后創(chuàng)建對(duì)應(yīng)的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>
外層首先一個(gè)shortcuts標(biāo)簽, 里面就是包裹著一個(gè)一個(gè)快捷方式shortcut横漏,你需要幾個(gè)谨设,就創(chuàng)建幾個(gè),上面代碼中我是創(chuàng)建了兩個(gè)缎浇,可以發(fā)現(xiàn)這些屬性和我們清單文件里的Activity里的屬性類似扎拣,這里簡(jiǎn)單概述一下:
enabled, 表示這個(gè)shortcut是否可用
icon 為快捷圖標(biāo)
shortcutId, 快捷方式唯一的id
shortcutShortLabel, 短名稱
shortcutLongLabel, 這里是配置的長(zhǎng)名稱, launcher會(huì)優(yōu)先選擇長(zhǎng)名稱顯示,顯示不下會(huì)選擇短名稱
categories 為應(yīng)用程序的快捷方式執(zhí)行的操作類型提供分組素跺,例如創(chuàng)建新的聊天消息
capability-binding 可選 聲明與此快捷方式關(guān)聯(lián)的功能鹏秋。CREATE_MESSAGE 聲明的功能,是與應(yīng)用有關(guān)的 Action 內(nèi)置 intent亡笑。用戶可以結(jié)合使用語(yǔ)音指令與 Google 助理來(lái)調(diào)用此快捷方式侣夷。
在shortcut標(biāo)簽下,還有一個(gè)intent標(biāo)簽,不用說(shuō)仑乌,想必大家也知道了它的作用百拓,就是點(diǎn)擊快捷方式,跳轉(zhuǎn)的目標(biāo)晰甚。
intent, 這里表示我們點(diǎn)擊shortcut時(shí)要干嘛,
targetPackage是指定一個(gè)目標(biāo)應(yīng)用的包名,
targetClass是我們要跳轉(zhuǎn)的目標(biāo)類, 這里要注意的是android:action一定要配置, 否則會(huì)崩潰
categories, 這個(gè)東西目前位置官方只給提供了android.shortcut.conversation
第二步衙传,清單文件AndroidManifest里進(jìn)行配置,這個(gè)需要注意一下:只能在有action是android.intent.action.MAIN和category是android.intent.category.LAUNCHER的Activity中配置才有效厕九,說(shuō)簡(jiǎn)單點(diǎn)蓖捶,也就是應(yīng)用的主入口。
<!--引入shortcuts資源-->
<meta-data
android:name="android.app.shortcuts"
android:resource="@xml/shortcuts" />
以上兩步完成之后扁远,我們就可以運(yùn)行程序俊鱼,效果如下:
動(dòng)態(tài)方式:
上述的過程,我們實(shí)現(xiàn)了靜態(tài)的快捷方式畅买,但常見的需求情況下并闲,有很多是需要?jiǎng)討B(tài)配置的,那么如何實(shí)現(xiàn)呢谷羞?其實(shí)也非常簡(jiǎn)單帝火,目前動(dòng)態(tài)的方式創(chuàng)建其中,也有兩種代碼方式湃缎,一種是通過ShortcutManagerCompat來(lái)實(shí)現(xiàn)犀填,一種是ShortcutManager,兩種方式大同小異嗓违,我們一起來(lái)看下:
ShortcutManagerCompat方式實(shí)現(xiàn):
添加:
//動(dòng)態(tài)方式添加一
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N_MR1) {
val shortScan = ShortcutInfoCompat.Builder(this, "test_2")//唯一標(biāo)識(shí)id
.setShortLabel(getString(R.string.app_test_2))//短標(biāo)簽
.setIcon(IconCompat.createWithResource(this, R.mipmap.ic_launcher))//圖標(biāo)
//跳轉(zhuǎn)的目標(biāo)九巡,定義Activity
.setIntent(Intent(Intent.ACTION_MAIN, null, this, MainActivity::class.java))
.build()
//執(zhí)行添加操作
ShortcutManagerCompat.addDynamicShortcuts(this, mutableListOf(shortScan))
toast("已添加")
}
添加后效果對(duì)比
更新:
//動(dòng)態(tài)更新方式一
val shortScan = ShortcutInfoCompat.Builder(this, "test_2")//唯一標(biāo)識(shí)id
.setShortLabel(getString(R.string.app_test_2_updata))//更新一個(gè)短標(biāo)簽
.setIcon(IconCompat.createWithResource(this, R.mipmap.ic_launcher))//圖標(biāo)
//要跳轉(zhuǎn)的目標(biāo)
.setIntent(Intent(Intent.ACTION_MAIN, null, this, MainActivity::class.java))
.build()
//執(zhí)行更新操作
ShortcutManagerCompat.updateShortcuts(this, mutableListOf(shortScan))
toast("已更新")
更新前后效果對(duì)比
刪除:
//動(dòng)態(tài)移除方式一
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N_MR1) {
ShortcutManagerCompat.removeDynamicShortcuts(
this@MainActivity,
Collections.singletonList("test_2")//唯一標(biāo)識(shí)id
)
toast("已移除")
}
刪除后效果
ShortcutManager方式實(shí)現(xiàn):
添加:
//動(dòng)態(tài)方式添加二
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N_MR1) {
val info = ShortcutInfo.Builder(this, "test_3")//唯一標(biāo)識(shí)id
.setShortLabel(getString(R.string.app_test_3))//短的標(biāo)簽
.setLongLabel(getString(R.string.app_test_3_long))//長(zhǎng)的標(biāo)簽
.setIcon(Icon.createWithResource(this, R.mipmap.ic_launcher))//圖標(biāo)
.setIntent(intent)//跳轉(zhuǎn)的目標(biāo),這里我設(shè)置的是當(dāng)前
.build()
//執(zhí)行添加操作
getSystemService(ShortcutManager::class.java)
.dynamicShortcuts = mutableListOf(info)
toast("已添加")
}
刪除:
//動(dòng)態(tài)移除方式二
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N_MR1) {
getSystemService(ShortcutManager::class.java)
.removeDynamicShortcuts(listOf("test_3"))//唯一的id標(biāo)識(shí)
toast("已移除")
}
更新:
//動(dòng)態(tài)更新方式二
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N_MR1) {
val info = ShortcutInfo.Builder(this, "test_3")//唯一標(biāo)識(shí)id
.setShortLabel(getString(R.string.app_test_3_updata))//更新一個(gè)短標(biāo)簽
.setLongLabel(getString(R.string.app_test_3_long))//長(zhǎng)標(biāo)簽
.setIcon(Icon.createWithResource(this, R.mipmap.ic_launcher))//圖標(biāo)
.setIntent(intent)//跳轉(zhuǎn)的目標(biāo)靠瞎,這里我設(shè)置的是當(dāng)前
.build()
//執(zhí)行更新操作
getSystemService(ShortcutManager::class.java).updateShortcuts(listOf(info))
toast("已更新")
}
上述的代碼中比庄,注釋已經(jīng)很清楚了求妹,這里就不細(xì)講乏盐,效果呢和第一種方式類似佳窑,這里就不貼效果了,大家感興趣的話父能,可以直接看源碼神凑,地址是:
https://github.com/AbnerMing888/AndroidWidget