快捷方式最佳实践

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

遵循设计准则

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

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

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

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

限制快捷方式说明的长度

在启动器中显示应用快捷方式的菜单中是有限的。请尽可能将快捷方式的“简短说明”的长度限制在 10 个字符以内，并将“详细说明”的长度限制在 25 个字符以内。

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

保留快捷方式和操作的使用记录

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

仅对含义未变的快捷方式执行更新

更改动态和固定快捷方式时，只有在更改的信息保持不变时，才能调用 updateShortcuts()。否则，请使用以下方法之一，具体取决于您要重新创建的快捷方式的类型：

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

发布应用时即检查动态快捷方式

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