快捷方式最佳实践

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

遵循设计指南

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

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

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

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

限制快捷方式描述长度

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

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

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

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

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

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

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

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

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

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