Android 7.1 新特性之 Shortcuts 介绍

Android 7.1 允许 App 自定义 Shortcuts，类似 iOS 的 3D touch。通过在桌面长按 App 弹出 Shortcut 列表，点击某个 Shortcut 快速进入某项操作，同时 Shortcut 可以拖动到桌面进行固定，如下图系统日历 App：

由于 7.1 SDK 的 Sources 尚未开放，目前大部分内容还是根据官方 API 文档而来，还有些细节和可能的 Bug 还得等 Sources 开放。

Shortcuts 全面介绍分为两篇，本文是基础介绍，关于 Shortcuts 一些不错的实践和目前的问题可访问 trinea.cn 最新文章。

类似 BroadcastReceiver 可通过静态和动态方式注册，Shortcuts 也可以通过静态和动态方式添加。

meta-data name 为 android.app.shortcuts，如下：

必须在 Main Launcher 对应的 Activity 内设置，其中 android:resource 指向定义了 shortcuts 的资源文件。

res 目录下新建 xml 文件夹，并新建 shortcuts.xml 文件，内容如下：

以 shortcuts 元素为根，可以包含多个 shortcut 元素，每个 shortcut 元素表示一个 shortcut。其中属性分别表示：

(1) shortcutId 表示 shortcut 唯一标识符，相同的 shortcutId 会被覆盖。必须字段。

(2) shortcutShortLabel 为将 shortcut 拖动到桌面时显示的名字，官方建议不超过 10 个字符，必须字段。

(3) shortcutLongLabel 为 shortcut 列表中每个 shortcut 的名字，不宜过长，如果过长或未设置默认会显示 ShortLabel，官方建议不超过 25 个字符。可选字段。

(4) icon 为 shortcut 的 icon，在列表展示和拖动到桌面时显示需要，可选字段。

(5) enabled 表示 shortcut 是否可用，false 表示禁用。xml 中这个属性几乎没有被设置为 false 的实际场景，具体原因可见 6.7 如何更好的删除(废弃)老的 Shortcut中介绍。

(6) shortcutDisabledMessage 为已固定在桌面的 shortcut 被 Disabled 后点击时的 Toast 提示内容。可选字段。

(7) intent 为点击 shortcut 时响应的 intent，必须字段。

这里可以添加多个 intent，但点击时不会启动所有 intent，而是启动最后一个 intent，在这个 intent 回退时会启动它前面一个 intent，相当于自动将所有 intent 添加到了堆栈。

intent 可设置属性包括：

android:action、android:data、android:mimeType、android:targetClass、android:targetPackage，其中 android:action 为必须属性。

动态 ShortcutsDynamic Shortcuts 通过 ShortcutManager API 进行操作。可以动态添加、修改、删除。

指通过拖动固定到桌面的 Shortcuts，App 不可以添加、修改、删除这些 Shortcuts，只能禁用他们。即便 App 内删除了某个 Shorcut，对应的已固定到桌面的 Shortcuts 也不会被删除。

可以通过：

(1) getPinnedShortcuts() 得到所有固定的 Shortcuts 的信息。

(2) disableShortcuts(List) 或 disableShortcuts(List, CharSequence) 禁用动态的 Shortcuts。

对于静态的 Shortcuts 需要在资源文件中设置 android:enabled="false" 进行禁用，不过没有必要，静态 Shortcuts 可直接通过删除达到禁用的效果，具体原因可见 6.7 如何更好的删除(废弃)老的 Shortcut 中介绍。

静态 Shortcuts 和动态 Shortcuts 是有最大个数限制的，默认为 5，超过最大个数后添加会报异常。而固定的 Shortcuts 并没有个数限制，并且固定的 Shortcut 对应的 Shortcut 即便被动态删除了，依然可以通过 id 进行 Update 操作。