Формат циферблата

Примечание: формат 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.

На следующей диаграмме показан обзор подхода:

Как система Wear OS отображает циферблат часов из XML-документа формата циферблата.

Версионирование в 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.