Android 长按APP图标弹出快捷方式(shortcuts)

今天给大家分享一份关于Android 7.1版本的一个新特性 Shortcut
它是谷歌在Api Level 25提出来的类似苹果3D touch 但是没有压力感应.在安卓中完全就是长按
某些APP图标就会弹出菜单，如下表：

相信大家在使用7.1版本以及7.1版本以上的android手机的时候，在不小心长按的时候，都会触发如上表中的功能。查阅完系统更新的文档才知道该功能叫做App Shortcuts。

其实这个长按桌面图标展示快捷方式已经普及很多App了，一是Android很早的版本就已经支持，二是大部分的应用也已经实现，像微信，支付宝，头条等，所以我们也要赶紧跟紧迭代的脚步，等自己遇到的时候，也能快速解决！

App Shortcuts该如何实现？

其实查阅系统文档，可知有两种方式可以实现shortcuts：

静态形式：在APK中包含一个资源文件来描述Shortcut。这种注册方法将导致：如果你要更新Shortcut，你必须更新整个应用程序
目前，每个应用最多可以注册5个Shortcuts，无论是动态形式还是静态形式。
动态形式：在运行时，通过ShortcutManager
API来进行注册。通过这种方式，你可以在运行时，动态的发布，更新和删除Shortcut。

静态写法：

静态写法?说白了和BroadcastReceiver(广播接受者)一样 .可以在清单文件中注册

静态运行效果如下：

（1）首先, 我们需要在res/xml目录下创建一个新的xml文件, 这里我们命名为shortcuts.xml

<?xml version="1.0" encoding="utf-8"?>
<shortcuts xmlns:android="http://schemas.android.com/apk/res/android"><!--android:enabled  shortcut是否可用android:icon  快捷图标android:shortcutId  快捷方式唯一的idandroid:shortcutShortLabel  短名称android:shortcutLongLabel  这里是配置的长名称, launcher会优先选择长名称显示，显示不下会选择短名称android:action    android.intent.action.VIEWandroid:targetClass  要跳转到哪个目标类android:targetPackage  指定一个目标应用的包名categories  android.shortcut.conversation--><shortcutandroid:enabled="true"android:icon="@drawable/mine_img"android:shortcutId="MyMine"android:shortcutShortLabel="@string/mine"><intentandroid:action="android.intent.action.VIEW"android:targetClass="com.harry.shortcuts.MineActivity"android:targetPackage="com.harry.shortcuts" /><categories android:name="android.shortcut.conversation" /><capability-binding android:key="actions.intent.CREATE_MESSAGE" /></shortcut><shortcutandroid:enabled="true"android:icon="@drawable/collection_img"android:shortcutId="MyCollection"android:shortcutShortLabel="@string/collection"><intentandroid:action="android.intent.action.VIEW"android:targetClass="com.harry.shortcuts.CollectionActivity"android:targetPackage="com.harry.shortcuts" /><categories android:name="android.shortcut.conversation" /><capability-binding android:key="actions.intent.CREATE_MESSAGE" /></shortcut>
</shortcuts>

（2）清单文件AndroidManifest里进行配置，这个需要注意一下：只能在有action是android.intent.action.MAIN和category是android.intent.category.LAUNCHER的Activity中配置才有效，说简单点，也就是应用的主入口。

     <meta-data android:name="android.app.shortcuts"android:resource="@xml/shortcuts"/>

动态写法：

动态快捷键应提供指向您应用程序中特定的上下文相关操作的链接。这些操作可以在您的应用程序使用之间更改，即使应用程序正在运行，它们也可以更改。动态快捷方式的好候选包括调用特定人员，导航到特定位置，以及查看特定游戏的当前分数。

该ShortcutManager API允许你完成动态快捷键下面的操作：

动态添加：使用setDynamicShortcuts()重新定义的动态快捷键的完整列表，或者使用addDynamicShortcuts()以增加动态快捷键的现有列表。
动态移除：删除使用一组动态的快捷键removeDynamicShortcuts()或使用删除所有动态快捷键removeAllDynamicShortcuts()
动态更新：使用updateShortcuts()方法。

动态运行效果如下：

//获取ShortcutManager对象
ShortcutManager shortcutManager = getSystemService(ShortcutManager.class);

动态添加：

     if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N_MR1){//ShortcutInfo.Builder构建快捷方式ShortcutInfo shortcut = new ShortcutInfo.Builder(this, "test_add").setShortLabel(getString(R.string.app_test_add)).setIcon(Icon.createWithResource(this, R.drawable.add_img))//设置快捷图标//跳转到百度网页
//                       .setIntent(new Intent(Intent.ACTION_VIEW,
//                       Uri.parse("https://www.baidu.com/")))//跳转的目标，定义Activity.setIntent(new Intent(Intent.ACTION_MAIN, null, this, MainActivity.class)).build();//setDynamicShortcuts()方法来设置快捷方式shortcutManager.setDynamicShortcuts(Arrays.asList(shortcut));Toast.makeText(MainActivity.this, "已添加", Toast.LENGTH_SHORT).show();}

动态更新：

 if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N_MR1) {Intent intent2 = new Intent();intent2.setAction("android.intent.action.MAIN");intent2.setClassName(getPackageName(),getPackageName()+".MainActivity.java");/*** 构建ShortcutInfo时指定相同的id，根据id去找到要更新的快捷方式** 注意：唯一的id标识不可传入一个静态快捷方式的id* 否则会抛出异常 应用会抛出错误：Manifest shortcut ID=XX may not be manipulated via APIs*/ShortcutInfo info = new ShortcutInfo.Builder(this,"test_add").setIntent(intent2).setLongLabel("动态更新的长名").setShortLabel("动态更新的短名").build();shortcutManager = getSystemService(ShortcutManager.class);List<ShortcutInfo> dynamicShortcuts = shortcutManager.getDynamicShortcuts();//updateShortcuts(List<ShortcutInfo> shortcutInfoList)方法更新现有的快捷方式shortcutManager.updateShortcuts(Arrays.asList(info));Toast.makeText(MainActivity.this, "已更新", Toast.LENGTH_SHORT).show();}

动态移除：

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N_MR1) {/*** removeDynamicShortcuts(List<String> shortcutIds)方法可以删除动态快捷方式** 同理，在唯一标识id和动态更新处理一样，需传入动态快捷方式的id，要不然会报同样的错误*/shortcutManager.removeDynamicShortcuts(Arrays.asList("test_add"));//唯一的id标识Toast.makeText(MainActivity.this, "已移除", Toast.LENGTH_SHORT).show();
}

总结

希望通过这篇文章大家能够了解，并且能合理应用App Shortcuts，欢迎大家共同留言探讨！

项目地址：AndroidShortcuts