作为开发者,您可以定义快捷方式,以便在您的应用中执行特定操作。您可以在受支持的启动器或助理(如 Google 助理)中显示这些快捷方式,并帮助用户快速启动应用中的常见或推荐任务。
本文档介绍了如何创建和管理应用快捷方式。您还可以了解一些改进快捷方式的最佳实践。
快捷方式类型
![应用快捷方式](https://developer.android.google.cn/static/images/guide/topics/ui/shortcuts_2023.png?authuser=0000&hl=ro)
每个快捷方式都会引用一个或多个 intent,每个 intent 都会在用户选择快捷方式时在应用中启动特定操作。您为应用创建的快捷方式类型取决于应用的用例。 下面列出了一些可表示为快捷方式的操作示例:
- 在电子邮件应用中撰写新电子邮件
- 在地图应用中将用户导航到特定位置
- 在通信应用中向用户联系人发送消息。
- 在媒体应用中播放下一集电视节目
- 在游戏应用中加载上一个存档点
- 让用户能够在外卖应用中使用语音指令订购饮料。
您可以为应用发布以下类型的快捷方式:
- 静态快捷方式在封装到 APK 或 app bundle 的资源文件中定义。
- 动态快捷方式只能在运行时由应用推送、更新和移除。
- 如果用户授予权限,可在运行时将固定快捷方式添加到支持的启动器。
使用功能 (capability) 在 Google 助理中显示快捷方式
借助 shortcuts.xml
中的功能,您可以声明用户启动应用时可以执行的操作类型,并直接跳转到执行特定任务的位置。例如,您可以通过声明 capability
元素,将您的应用内功能扩展到 Google 助理与应用有关的 Action,从而让用户能够通过 Google 助理对您的应用进行语音控制。如需了解详情,请参阅有关添加 capability 的文档。
快捷方式限制
大多数受支持的启动器一次最多可以显示四个快捷方式,包括静态快捷方式和动态快捷方式。推送要在 Google 界面(例如 Google 助理)上显示的动态快捷方式时,请使用 Google 快捷方式集成库,以免受到快捷方式限制的约束。
如果您选择不使用 Google 快捷方式集成库,您的应用将受设备同时支持的快捷方式数量限制的约束。以这种方式发布的快捷方式只会在 Android 启动器中显示,无法显示在 Google 助理等 Google 平台上。
用户可以为应用创建的固定快捷方式数量没有限制。您的应用无法移除固定快捷方式,但可以停用固定快捷方式。
如需开始为应用创建快捷方式,请参阅以下文档:
如需详细了解可对快捷方式执行的操作,请参阅 ShortcutManager
API 参考文档。