Примечание: формат Watch Face Format требуется для установки циферблатов на устройства с предустановленной версией Wear OS 5 или более поздней версии, а также для всех новых циферблатов, публикуемых в Google Play.
Начиная с января 2026 года для установки циферблатов на все устройства Wear OS потребуется формат Watch Face.
Подробнее об изменениях, с которыми столкнутся пользователи, можно узнать в этой статье Справочного центра .
Циферблат — это первое, что видит пользователь, глядя на свои часы, поэтому он является наиболее часто используемым элементом Wear OS. Пользователи используют циферблаты, чтобы настроить часы в соответствии со своим стилем и быстро получить необходимую информацию.
Варианты создания циферблатов
Формат Watch Face (WFF) упрощает создание циферблата как никогда прежде. Разработанный совместно с Samsung, формат Watch Face представляет собой декларативный XML-формат для настройки внешнего вида и поведения циферблатов. В отличие от других API циферблатов, где ваш APK-файл должен включать код для отображения циферблата, для формата Watch Face требуются только ресурсы и декларативные инструкции. Платформа Wear OS обрабатывает логику, необходимую для отображения циферблата, чтобы вы могли сосредоточиться на своих творческих идеях, а не на оптимизации кода или расходе заряда батареи.
Мы предлагаем несколько способов создания циферблата:
- Если вы предпочитаете инструмент в стиле «что видишь, то и получаешь», позволяющий вам напрямую проектировать циферблат, используйте Watch Face Studio , который мы поддерживаем в партнерстве с Samsung.
- Если вы уверенно используете Figma в качестве дизайнера или хотите ускорить первые шаги по созданию циферблата часов в качестве разработчика, используйте Watch Face Designer , доступ к которому осуществляется с помощью плагина в Figma.
Если вы предпочитаете управлять конфигурацией часов вручную и публиковать их в собственном магазине приложений, вы можете определить циферблаты с помощью XML, а затем опубликовать их с помощью Watch Face Push .
Предварительная версия Android Studio включает поддержку создания и запуска циферблатов, использующих формат Watch Face.
Циферблаты, созданные в этом формате, требуют меньше обслуживания и обновлений, чем циферблаты, созданные с использованием устаревших библиотек Jetpack Watch Face. Например, вам не нужно обновлять циферблат, чтобы добиться улучшений производительности, экономии заряда батареи или получить последние исправления ошибок.
О формате
В основе циферблата формата WFF (Watch Face Format) лежит документ, определяющий его внешний вид и поведение. Этот документ написан на XML в соответствии со спецификацией WFF.
Система Wear OS включает компонент рендеринга циферблата. Этот компонент анализирует XML-документ WFF и рендерит на его основе циферблат. Другие ресурсы, такие как изображения и шрифты, подключаются по мере необходимости.
При таком подходе вам нужно будет только потратить время на описание того, как должен выглядеть циферблат часов, а Wear OS возьмет на себя весь код для отрисовки циферблата.
Чтобы развернуть циферблат в формате Watch Face на устройстве, упакуйте XML-документ в стандартный пакет AAB или APK.
На следующей диаграмме показан обзор подхода:
Версионирование в WFF
По мере развития WFF добавляются дополнительные функции, представленные большим количеством элементов, атрибутов и источников данных, которые все используют формат циферблата.
Например, в версии WFF 2 появилась поддержка погоды в качестве источника данных, которая отсутствует в версии WFF 1.
При разработке циферблата учитывайте, какие функции вы хотите использовать и какова их доступность в разных версиях. В справочном руководстве все функции отмечены с указанием их доступности.
Каждая версия WFF соответствует выпуску Wear OS:
| WFF-версия | Минимальная версия Wear OS | Минимальный уровень API |
|---|---|---|
| 1 | 4 | 33 |
| 2 | 5 | 34 |
| 3 | 5.1 | 35 |
| 4 | 6 | 36 |
Ознакомьтесь с этим руководством по правильной настройке файла сборки AndroidManifest.xml и Gradle.
Узнать больше
Подробнее о формате циферблата читайте в этих руководствах:
- Доступные функции : изучите возможности циферблатов, которые поддерживает каждая версия формата Watch Face.
- Рекомендации по дизайну : изучите лучшие практики по компоновке циферблата и пользовательскому опыту.
- Дизайнер циферблатов : узнайте, как использовать плагин Figma для создания циферблата.
- Настройка : настройте пакет приложений Android, поддерживающий формат циферблата.
- Примеры GitHub : начните с создания примеров циферблатов и их развертывания на эмуляторе Wear OS или на физическом устройстве.
- Оптимизируйте использование памяти : узнайте, как настроить циферблат часов так, чтобы система потребляла как можно меньше памяти при отображении циферблата.
- XML-справочник : изучите отдельные элементы, входящие в состав файла формата циферблата. Корневым элементом всегда является
WatchFace. Примечание: чтобы просмотреть функции конкретной версии формата циферблата в XML-справочнике, убедитесь, что выбрана кнопка соответствующей версии в верхней части страницы документации. - Руководство по публикации : узнайте, как опубликовать и монетизировать свой циферблат через Play Store и альтернативные методы.
- WFF и валидатор памяти : используйте эти инструменты с открытым исходным кодом, чтобы проверить файл формата циферблата на наличие ошибок и подтвердить приемлемое использование памяти перед отправкой в Google Play.