widget 和快捷方式

借助 Android 8.0 中新增的用于添加快捷方式和 widget 的流程 API,应用开发者可以从应用内添加快捷方式和 widget,而不需要依靠 widget 面板。出于安全考虑,Android 8.0 还废弃了用于添加快捷方式的旧方法(发送广播)。

启动器需要支持这种新的实现,以便应用开发者可以依靠系统来添加其快捷方式或微件。

示例和源代码

有关于各种系统类的文档可供参考。参考资料包括:

  • ShortcutManager.java
    在标题中发布已固定的快捷方式部分。
  • Intent.java
    关于 ACTION_CREATE_SHORTCUT 的 Javadoc。
  • AppWidgetManager.java
    关于 requestPinAppWidget 的 Javadoc。

实现

设备实现者需要通过 intent 过滤器操作在其启动器中添加一个 Aactivity:

  • android.content.pm.action.CONFIRM_PIN_SHORTCUT
  • android.content.pm.action.CONFIRM_PIN_APPWIDGET

如需更多详细信息,请参阅 API 文档

该 activity 应向用户显示关于添加请求的 widget/快捷方式的确认提示,并在用户接受后,在主屏幕上添加相应的 widget/快捷方式。

对于 widget,accept() 调用应包含新添加 widget 的 ID。

实现系统界面

合作伙伴需要参考 Launcher3 实现 (packages/apps/Launcher3) 来更新其启动器应用。

在 Android 开源项目 (AOSP) 中查找相关的 Launcher3 更改:

验证

如需验证该功能,请尝试从 Chrome 或通讯录应用添加快捷方式,并验证系统是否会显示正确的确认提示。在接受提示后,图标应已添加到主屏幕上,并且 Chrome 应显示一个提示添加成功的消息框。