创建快捷方式

在设计和创建应用的快捷方式时,请遵循以下准则:

遵循设计指南
为了使应用的快捷方式在视觉上与系统应用的快捷方式保持一致,请遵循应用快捷方式图标设计准则。
仅发布四个不同的快捷方式

虽然该 API 最多支持为应用提供 15 个静态和动态快捷方式的组合,但我们建议您仅发布 4 个不同的快捷方式,以改善它们在启动器中的视觉外观。

除了在启动器上显示快捷方式之外,您还可以使用 Google 快捷方式集成库在 Google 界面(例如 Google 助理)上显示快捷方式。此库支持推送无限数量的动态快捷方式。如果您使用此库推送大量快捷方式,我们建议您通过调用 setRank() 方法,设置必须在受支持的启动器中显示的快捷方式的 rank。

限制快捷方式说明长度

启动器中用于显示应用快捷方式的菜单空间有限。尽可能将快捷方式的“简短说明”长度限制为 10 个字符,并将“详细说明”长度限制为 25 个字符。

如需详细了解静态快捷方式的标签,请参阅自定义属性值。对于动态快捷方式和固定快捷方式,请参阅 setLongLabel() 和 setShortLabel() 的参考文档。

维护快捷方式和操作使用记录

对于您创建的每个快捷方式,请考虑用户可以直接在应用内完成同一任务的不同方式。在每种情况下,请调用 reportShortcutUsed(),以便启动器准确记录用户执行代表快捷方式的操作的频率。

仅在保留快捷方式含义的情况下更新快捷方式

更改动态快捷方式和固定快捷方式时,只有在更改保留其含义的快捷方式的信息时,才调用 updateShortcuts()。否则,请根据要重新创建的快捷方式类型,使用以下方法之一:

  • 动态快捷方式:pushDynamicShortcut()。
  • 已固定的快捷方式:requestPinShortcut()。

    例如,如果您创建了用于导航到某个超市的快捷方式,那么当该超市的名称发生变化但其位置保持不变时,更新该快捷方式是合适的。不过,如果用户开始在其他超市购物,则最好创建新的快捷方式。

每次启动应用时检查动态快捷方式
当用户将数据恢复到新设备上时,动态快捷方式不会保留。因此,我们建议您在每次启动应用时检查 getDynamicShortcuts() 返回的对象数量,并根据需要重新发布动态快捷方式,如备份和恢复中的代码段所示。