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

Циферблат — это первое, что видит пользователь, когда смотрит на свои часы, что делает его наиболее часто используемой поверхностью 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.

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

Как система 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.

Узнать больше

Подробнее о формате циферблата читайте в этих руководствах:

  • Доступные функции : изучите возможности циферблатов, поддерживаемые каждой версией формата циферблатов.
  • Рекомендации по дизайну : ознакомьтесь с рекомендациями по компоновке циферблата и пользовательскому опыту.
  • Настройка : настройте пакет приложений Android, поддерживающий формат циферблата.
  • Примеры GitHub : начните с создания примеров циферблатов и разверните их на эмуляторе Wear OS или на вашем физическом устройстве.
  • Оптимизируйте использование памяти : узнайте, как настроить циферблат часов так, чтобы система потребляла как можно меньше памяти при отрисовке циферблата.
  • Ссылка XML : Изучите отдельные элементы, которые являются частями файла формата циферблата часов. Корневым элементом всегда является WatchFace . Примечание: Чтобы просмотреть функции из определенной версии формата циферблата часов в справке XML, убедитесь, что выбрана соответствующая кнопка версии в верхней части страницы документации.
  • Руководство по публикации : узнайте, как опубликовать и монетизировать свой циферблат через Play Store и альтернативные методы.
  • WFF и валидатор памяти : используйте эти инструменты с открытым исходным кодом, чтобы проверить файл формата циферблата на наличие ошибок и подтвердить приемлемое использование памяти перед отправкой в ​​Google Play.