在设计和创建应用的快捷方式时,请遵循以下准则:
- 遵循设计指南
- 为了使应用的快捷方式在视觉上与系统应用的快捷方式保持一致,请遵循应用快捷方式图标设计准则。
- 仅发布四个不同的快捷方式
虽然该 API 最多支持为应用提供 15 个静态和动态快捷方式的组合,但我们建议您仅发布 4 个不同的快捷方式,以改善它们在启动器中的视觉外观。
除了在启动器上显示快捷方式之外,您还可以使用 Google 快捷方式集成库在 Google 界面(例如 Google 助理)上显示快捷方式。此库支持推送无限数量的动态快捷方式。如果您使用此库推送大量快捷方式,我们建议您通过调用
setRank()方法,设置必须在受支持的启动器中显示的快捷方式的rank。- 限制快捷方式说明长度
启动器中用于显示应用快捷方式的菜单空间有限。尽可能将快捷方式的“简短说明”长度限制为 10 个字符,并将“详细说明”长度限制为 25 个字符。
如需详细了解静态快捷方式的标签,请参阅自定义属性值。对于动态快捷方式和固定快捷方式,请参阅
setLongLabel()和setShortLabel()的参考文档。- 维护快捷方式和操作使用记录
对于您创建的每个快捷方式,请考虑用户可以直接在应用内完成同一任务的不同方式。在每种情况下,请调用
reportShortcutUsed(),以便启动器准确记录用户执行代表快捷方式的操作的频率。- 仅在保留快捷方式含义的情况下更新快捷方式
更改动态快捷方式和固定快捷方式时,只有在更改保留其含义的快捷方式的信息时,才调用
updateShortcuts()。否则,请根据要重新创建的快捷方式类型,使用以下方法之一:
- 动态快捷方式:
pushDynamicShortcut()。 已固定的快捷方式:
requestPinShortcut()。例如,如果您创建了用于导航到某个超市的快捷方式,那么当该超市的名称发生变化但其位置保持不变时,更新该快捷方式是合适的。不过,如果用户开始在其他超市购物,则最好创建新的快捷方式。
- 每次启动应用时检查动态快捷方式
- 当用户将数据恢复到新设备上时,动态快捷方式不会保留。因此,我们建议您在每次启动应用时检查
getDynamicShortcuts()返回的对象数量,并根据需要重新发布动态快捷方式,如备份和恢复中的代码段所示。