快捷方式的最佳实践

设计和创建应用快捷方式时，请遵循以下指南

遵循设计指南

为了使您的应用快捷方式在视觉上与系统应用使用的快捷方式保持一致，请遵循应用快捷方式图标设计指南。

仅发布四个不同的快捷方式

尽管 API 支持最多组合 15 个静态和动态快捷方式用于您的应用，但我们建议您仅发布四个不同的快捷方式，以改善其在启动器中的视觉外观。

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

限制快捷方式描述长度

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

有关静态快捷方式标签的更多信息，请阅读自定义属性值。对于动态和固定快捷方式，请阅读有关setLongLabel()和setShortLabel()的参考文档。

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

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

仅在保留其含义时更新快捷方式

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

• 动态快捷方式：pushDynamicShortcut()。
• 固定快捷方式：requestPinShortcut()。

例如，如果您创建了用于导航到超市的快捷方式，则如果超市名称发生更改但位置保持不变，则更新快捷方式是合适的。但是，如果用户开始在不同的超市位置购物，最好创建一个新的快捷方式。

每当启动应用时检查动态快捷方式

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