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

Циферблат — это первое, что видит пользователь, когда смотрит на свои часы, поэтому он является наиболее часто используемой поверхностью в Wear OS. Пользователи используют циферблаты для персонализации своих часов в соответствии со своим стилем и для быстрого получения информации.

Варианты создания циферблатов

Формат Watch Face (WFF) упрощает создание циферблатов как никогда раньше. Разработанный в сотрудничестве с Samsung, Watch Face Format представляет собой декларативный XML-формат для настройки внешнего вида и поведения циферблатов. В отличие от других API для циферблатов, где ваш APK-файл должен содержать код для отображения циферблата, Watch Face Format требует только ресурсов и декларативных инструкций. Платформа Wear OS обрабатывает логику, необходимую для отображения циферблата, поэтому вы можете сосредоточиться на своих творческих идеях, а не на оптимизации кода или производительности батареи.

Циферблаты, созданные в этом формате, требуют меньше обслуживания и обновлений, чем те, которые созданы с использованием устаревших библиотек Jetpack Watch Face. Например, вам не нужно обновлять циферблат, чтобы воспользоваться улучшениями производительности или энергопотребления, или получить последние исправления ошибок.

Мы предлагаем несколько способов создания циферблата:

• Если вы предпочитаете инструмент в стиле «что видишь, то и получаешь», позволяющий создавать циферблат напрямую, используйте Watch Face Studio , который мы поддерживаем в партнерстве с Samsung.
• Если вам удобно работать с Figma в качестве дизайнера, или если вы хотите ускорить первые шаги по созданию циферблата для часов в качестве разработчика, используйте Watch Face Designer , доступ к которому осуществляется через плагин внутри Figma.

• Если вы предпочитаете управлять конфигурацией своих часов вручную и публиковать их в собственном магазине приложений, вы можете определять циферблаты с помощью XML. Android Studio поддерживает создание циферблатов , использующих формат Watch Face Format. Затем вы можете визуализировать эти циферблаты, запустив их на устройстве.

После создания циферблата вы можете опубликовать его несколькими способами, например, через Google Play или с помощью функции Watch Face Push .

О формате

В основе циферблата Watch Face Format (WFF) лежит документ, определяющий его структуру и поведение. Этот документ написан на языке XML и соответствует спецификации WFF.

Система Wear OS включает в себя компонент для отображения циферблата. Этот компонент анализирует ваш XML-документ WFF и отображает на его основе циферблат. Другие ресурсы, такие как изображения и шрифты, подгружаются по мере необходимости.

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

Для развертывания циферблата Watch Face Format на устройстве необходимо упаковать XML-документ в стандартный пакет AAB или APK.

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

Версионирование в WFF

По мере развития WFF добавляются новые функции, представленные новыми элементами, атрибутами и источниками данных, которые все используют формат циферблата.

Например, в версии WFF 2 появилась поддержка данных о погоде в качестве источника информации, чего не было в версии WFF 1.

При разработке циферблата часов учитывайте, какие функции вы хотите использовать и в каких версиях они доступны. В справочном руководстве все функции отмечены с указанием их доступности.

Каждая версия WFF соответствует одному из релизов Wear OS:

Ознакомьтесь с этим руководством по правильной настройке файла AndroidManifest.xml и файла сборки Gradle.

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

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

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