对Shortcut使用的理解
最近在使用Android版Chrome的时候发现长按应用图标会出现如下图所示的快捷键：
这种新特性被我发现之后，我又找了几个出名的应用尝试了一下，又发现支付宝、UC浏览器这些APP也接入了这一新特性。接着我又去找了度娘，从度娘的搜索结果中我才知道这一新特性在Android7.0的时候就被提出来了，只是在国内的APP中应用的不广泛罢了。经过阅读网上大牛的技术博客以及自己的尝试，我自己对此新特性有了一定的认识。这个新特性的使用方式有点类似于广播，一个是静态使用，一个是动态使用。
一、静态使用shortcuts
1.1 创建资源文件
在res目录下创建xml文件夹，创建成功之后继续在该文件夹下shortcuts的资源文件。Shortcuts.xml的源代码如下所示：
<shortcuts xmlns:android="http://schemas.android.com/apk/res/android">
<shortcut
android:enabled="true"
android:icon="@drawable/ic_first"
android:shortcutDisabledMessage="@string/first_disable_message"
android:shortcutId="first"
android:shortcutLongLabel="@string/first_long_label"
android:shortcutShortLabel="@string/first_short_label">
<intent
android:action="android.intent.action.VIEW"
android:targetClass="com.study.yang.staticshortcutsdemo.static_short.FirstStaticActivity"
android:targetPackage="com.study.yang.staticshortcutsdemo" />
<categories android:name="android.shortcut.conversation"/>
shortcut>
<shortcut
android:enabled="true"
android:icon="@drawable/ic_second"
android:shortcutDisabledMessage="@string/second_disable_message"
android:shortcutId="second"
android:shortcutLongLabel="@string/second_long_label"
android:shortcutShortLabel="@string/second_short_label">
<intent
android:action="android.intent.action.VIEW"
android:targetClass="com.study.yang.staticshortcutsdemo.static_short.SecondStaticActivity"
android:targetPackage="com.study.yang.staticshortcutsdemo" />
<intent
android:action="android.intent.action.VIEW"
android:targetClass="com.study.yang.staticshortcutsdemo.MainActivity"
android:targetPackage="com.study.yang.staticshortcutsdemo" />
shortcut>
<shortcut
android:enabled="true"
android:icon="@drawable/ic_third"
android:shortcutDisabledMessage="@string/third_disable_message"
android:shortcutId="third"
android:shortcutLongLabel="@string/third_long_label"
android:shortcutShortLabel="@string/third_short_label">
<intent
android:action="android.intent.action.VIEW"
android:targetClass="com.study.yang.staticshortcutsdemo.static_short.ThirdStaticActivity"
android:targetPackage="com.study.yang.staticshortcutsdemo" />
shortcut>
<shortcut
android:enabled="true"
android:icon="@drawable/ic_forth"
android:shortcutDisabledMessage="@string/forth_disable_message"
android:shortcutId="forth"
android:shortcutLongLabel="@string/forth_long_label"
android:shortcutShortLabel="@string/forth_short_label">
<intent
android:action="android.intent.action.VIEW"
android:targetClass="com.study.yang.staticshortcutsdemo.static_short.ForthStaticActivity"
android:targetPackage="com.study.yang.staticshortcutsdemo" />
shortcut>
<shortcut
android:enabled="true"
android:icon="@drawable/ic_fifth"
android:shortcutDisabledMessage="@string/fifth_disable_message"
android:shortcutId="fifth"
android:shortcutLongLabel="@string/fifth_long_label"
android:shortcutShortLabel="@string/fifth_short_label">
<intent
android:action="android.intent.action.VIEW"
android:targetClass="com.study.yang.staticshortcutsdemo.static_short.FifthStaticActivity"
android:targetPackage="com.study.yang.staticshortcutsdemo" />
shortcut>
<shortcut
android:enabled="true"
android:icon="@drawable/ic_sixth"
android:shortcutDisabledMessage="@string/sixth_disable_message"
android:shortcutId="sixth"
android:shortcutLongLabel="@string/sixth_long_label"
android:shortcutShortLabel="@string/sixth_short_label">
<intent
android:action="android.intent.action.VIEW"
android:targetClass="com.study.yang.staticshortcutsdemo.static_short.SixthStaticActivity"
android:targetPackage="com.study.yang.staticshortcutsdemo" />
shortcut>
shortcuts>1.2 在清单文件中使用shortcuts.xml文件
Shortcuts.xml文件必须在带有如下标签的内容的activity标签中使用，具体使用如下所示：
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.study.yang.staticshortcutsdemo">
<application
android:allowBackup="true"
android:icon="@mipmap/ic_launcher"
android:label="@string/app_name"
android:roundIcon="@mipmap/ic_launcher_round"
android:supportsRtl="true"
android:theme="@style/AppTheme">
<activity android:name=".MainActivity">
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
intent-filter>
<meta-data
android:name="android.app.shortcuts"
android:resource="@xml/shortcuts"/>
activity>
<activity android:name=".static_short.FirstStaticActivity" />
<activity android:name=".static_short.SecondStaticActivity" />
<activity android:name=".static_short.ThirdStaticActivity" />
<activity android:name=".static_short.ForthStaticActivity" />
<activity android:name=".static_short.FifthStaticActivity" />
<activity android:name=".static_short.SixthStaticActivity">activity>
application>
manifest>二、动态使用shortcuts
在正式的使用中我们还是用动态比较好，因为其可配置。动态使用shortcuts的核心类就是ShortcutManager，由其进行shortcuts的添加、修改、删除的操作。
2.1 添加shortcuts
此处的代码实现如下所示：
/**
* 动态添加Shortcuts应用
*/
private void addDynamicShortcuts() {
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N_MR1) {
mShortcutManager = (ShortcutManager) getSystemService(SHORTCUT_SERVICE);
//返回至是4
int maxShortcutCountPerActivity = mShortcutManager.getMaxShortcutCountPerActivity();
List infos = new ArrayList<>();
for (int i = 0; i < maxShortcutCountPerActivity; i++) {
Intent intent = new Intent(this, MessageActivity.class);
intent.setAction(Intent.ACTION_VIEW);
intent.putExtra("message", "我和好汉" + mAdapter.getItem(i) + "的切磋");
ShortcutInfo info = new ShortcutInfo
//添加shortcuts条目的唯一id
.Builder(this, "id" + i)
//给条目添加短标签
.setShortLabel(mAdapter.getItem(i))
//给条目添加长标签
.setLongLabel("水浒好汉:" + mAdapter.getItem(i))
//给条目设置图标
.setIcon(Icon.createWithResource(this, R.drawable.ic_first))
//设置点击条目之后要触发的intent
.setIntent(intent)
.build();
infos.add(info);
}
mShortcutManager.addDynamicShortcuts(infos);
}
} 2.2 修改shortcuts
此处的代码实现如下所示：
//给ListView添加单击事件进行修改shortcut
lv.setOnItemClickListener(new AdapterView.OnItemClickListener() {
@Override
public void onItemClick(AdapterView parent, View view, int position, long id) {
data.add(0, "刘备、张飞、关羽");
mAdapter.notifyDataSetChanged();
updateShortcut(position);
}
});
/**
* 更新Shortcut
* @param index
*/
@TargetApi(Build.VERSION_CODES.N_MR1)
private void updateShortcut(int index) {
Intent intent = new Intent(this, MessageActivity.class);
intent.setAction(Intent.ACTION_VIEW);
intent.putExtra("message", "我和好汉" + mAdapter.getItem(index) + "的切磋");
ShortcutInfo info = new ShortcutInfo
//给指定的id重新赋值内容
.Builder(this, "id" + index)
.setShortLabel(mAdapter.getItem(index))
.setLongLabel("水浒好汉:" + mAdapter.getItem(index))
.setIcon(Icon.createWithResource(this, R.drawable.ic_first))
//此处可以添加多个intent
.setIntents(new Intent[]{intent, new Intent("android.intent.action.MAIN", null, this, MainActivity.class)})
.setDisabledMessage("好汉失效了")
.build();
//更新
mShortcutManager.updateShortcuts(Arrays.asList(info));
}
2.3 删除shortcuts
此处的代码实现如下所示：
//给ListView添加长按事件进行删除shortcut
lv.setOnItemLongClickListener(new AdapterView.OnItemLongClickListener() {
@Override
public boolean onItemLongClick(AdapterView adapterView, View view, int position, long id) {
Toast.makeText(MainActivity.this, data.get(position) + "陨落了", Toast.LENGTH_SHORT).show();
removeShortcut(position);
return false;
}
});
/**
* 移除Shortcut
*
* @param
*/
@TargetApi(Build.VERSION_CODES.N_MR1)
private void removeShortcut(int index) {
//获取已有快捷条目
List infos = mShortcutManager.getPinnedShortcuts();
for (ShortcutInfo info : infos) {
if (info.getId().equals("id" + index)) {
//使得标签失效
mShortcutManager.disableShortcuts(Arrays.asList(info.getId()), "好汉陨落了");
}
}
//通过标签id移除指定标签
mShortcutManager.removeDynamicShortcuts(Arrays.asList("id" + index));
} shortcut被设置为不可用之后，其移植在桌面上的快捷方式将会变成灰色。