Создание ярлыков

При разработке и создании ярлыков для вашего приложения следуйте этим рекомендациям:

Следуйте рекомендациям по дизайну.

Чтобы ярлыки вашего приложения выглядели визуально согласованно с ярлыками, используемыми для системных приложений, следуйте рекомендациям по дизайну значков ярлыков приложений .

Опубликуйте только четыре различных ярлыка.

Хотя API поддерживает комбинацию до 15 статических и динамических ярлыков для вашего приложения, мы рекомендуем публиковать только четыре различных ярлыка, чтобы улучшить их визуальное отображение в панели запуска.

Помимо отображения ярлыков на панели запуска, используйте библиотеку интеграции Google Shortcuts для отображения ярлыков на таких платформах Google, как Google Assistant. Эта библиотека поддерживает добавление неограниченного количества динамических ярлыков. Если вы используете эту библиотеку для добавления большого количества ярлыков, мы рекомендуем установить rank ярлыков, которые должны отображаться на поддерживаемых панелях запуска, вызвав метод setRank() .

Ограничить длину описания сочетания клавиш

В меню, отображающем ярлыки ваших приложений в лаунчере, пространство ограничено. По возможности ограничьте длину «краткого описания» ярлыка 10 символами, а длину «подробного описания» — 25 символами.

Для получения дополнительной информации о метках для статических ярлыков см. раздел «Настройка значений атрибутов ». Для динамических и закрепленных ярлыков см. справочную документацию по setLongLabel() и setShortLabel() .

Сохраняйте историю использования сочетаний клавиш и действий.

Для каждого создаваемого вами ярлыка учитывайте различные способы, которыми пользователь может выполнить одну и ту же задачу непосредственно в вашем приложении. Вызывайте метод reportShortcutUsed() в каждой из этих ситуаций, чтобы средство запуска поддерживало точную историю того, как часто пользователь выполняет действия, представляющие ваши ярлыки.

Обновляйте ярлыки только тогда, когда их смысл сохраняется.

При изменении динамических и закрепленных ярлыков вызывайте метод updateShortcuts() только при изменении информации ярлыка, сохраняющего свое значение. В противном случае используйте один из следующих методов в зависимости от типа создаваемого ярлыка:

• Динамические сочетания клавиш: pushDynamicShortcut() .

• Закрепленные ярлыки: requestPinShortcut() .

  Например, если вы создаете ярлык для перехода к супермаркету, целесообразно обновлять его, если название супермаркета меняется, но его местоположение остается прежним. Однако если пользователь начинает покупки в другом супермаркете, лучше создать новый ярлык.

Проверяйте динамические ярлыки при каждом запуске приложения.

Динамические ярлыки не сохраняются при восстановлении данных пользователем на новом устройстве. Поэтому мы рекомендуем проверять количество объектов, возвращаемых функцией getDynamicShortcuts() каждый раз при запуске приложения и повторно публиковать динамические ярлыки по мере необходимости, как показано в фрагменте кода в разделе «Резервное копирование и восстановление» .