Примечание: Формат циферблата необходим для установки циферблатов на устройства с предустановленной Wear OS 5 или более поздней версии, а также для всех новых циферблатов, публикуемых в Google Play.
Начиная с января 2026 года для установки циферблатов на все устройства Wear OS потребуется формат Watch Face Format.
Подробнее об изменениях, с которыми столкнутся пользователи, можно узнать в этой статье Справочного центра .
Циферблат — это первое, что видит пользователь, когда смотрит на свои часы, что делает его наиболее часто используемой поверхностью Wear OS. Пользователи полагаются на циферблаты, чтобы настраивать свои часы в соответствии со своим стилем и предоставлять быструю информацию с одного взгляда.
Аудитория
Наш новый формат циферблата (WFF) делает создание циферблата проще, чем когда-либо. В партнерстве с Samsung мы выпустили Watch Face Studio , инструмент в стиле «что видишь, то и получаешь», который позволяет вам напрямую проектировать циферблат.
Если вы предпочитаете управлять конфигурацией часов вручную, вы также можете определить циферблаты с помощью XML. Эти руководства предназначены для разработчиков, которые используют XML или создают пользовательские инструменты для создания циферблатов с использованием формата Watch Face. Android Studio также включает поддержку для создания и запуска циферблатов, которые используют формат Watch Face.
Созданный в партнерстве с Samsung, Watch Face Format представляет собой декларативный XML-формат для настройки внешнего вида и поведения циферблатов. В отличие от других API циферблатов, где ваш APK должен включать код для отображения циферблата, Watch Face Format требует только ресурсов и декларативных инструкций. Платформа Wear OS обрабатывает логику, необходимую для отображения циферблата, чтобы вы могли сосредоточиться на своих творческих идеях, а не на оптимизации кода или производительности батареи.
Циферблаты, созданные с использованием этого нового формата, требуют меньше обслуживания и обновлений, чем те, которые созданы с использованием устаревших библиотек Jetpack Watch Face. Например, вам не нужно обновлять циферблат, чтобы воспользоваться улучшениями в производительности или потреблении батареи или получить последние исправления ошибок.
О формате
В основе циферблата Watch Face Format (WFF) лежит документ, определяющий макет и поведение циферблата. Этот документ написан на XML, соответствующем спецификации WFF.
Система Wear OS включает компонент рендеринга циферблата. Этот компонент анализирует ваш WFF XML-документ и рендерит циферблат из него. Другие ресурсы, такие как изображения и шрифты, извлекаются по мере необходимости.
Такой подход означает, что вам нужно только потратить время на описание того, как должен выглядеть циферблат часов, а 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.
Узнать больше
Подробнее о формате циферблата читайте в этих руководствах:
- Доступные функции : изучите возможности циферблатов, поддерживаемые каждой версией формата циферблатов.
- Рекомендации по дизайну : ознакомьтесь с рекомендациями по компоновке циферблата и пользовательскому опыту.
- Настройка : настройте пакет приложений Android, поддерживающий формат циферблата.
- Примеры GitHub : начните с создания примеров циферблатов и разверните их на эмуляторе Wear OS или на вашем физическом устройстве.
- Оптимизируйте использование памяти : узнайте, как настроить циферблат часов так, чтобы система потребляла как можно меньше памяти при отрисовке циферблата.
- Ссылка XML : Изучите отдельные элементы, которые являются частями файла формата циферблата часов. Корневым элементом всегда является
WatchFace. Примечание: Чтобы просмотреть функции из определенной версии формата циферблата часов в справке XML, убедитесь, что выбрана соответствующая кнопка версии в верхней части страницы документации. - Руководство по публикации : узнайте, как опубликовать и монетизировать свой циферблат через Play Store и альтернативные методы.
- WFF и валидатор памяти : используйте эти инструменты с открытым исходным кодом, чтобы проверить файл формата циферблата на наличие ошибок и подтвердить приемлемое использование памяти перед отправкой в Google Play.