Носить циферблат

Создание приложений для умных часов Wear OS by Google.

Примечание: Формат циферблата необходим для установки циферблатов на устройства с предустановленной Wear OS 5 или более поздней версии, а также для всех новых циферблатов, публикуемых в Google Play.

Начиная с января 2026 года для установки циферблатов на все устройства Wear OS потребуется формат Watch Face Format.

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

Последнее обновление Стабильный релиз Кандидат на релиз Бета-релиз Альфа-релиз
23 апреля 2025 г. 1.2.1 - - 1.3.0-альфа07

Объявление зависимостей

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

Добавьте зависимости для необходимых артефактов в файл build.gradle для вашего приложения или модуля:

классный 

dependencies {
    // Use to implement wear watchfaces
    implementation "androidx.wear.watchface:watchface:1.2.1"

    // Use to implement wear watchface complications
    implementation "androidx.wear.watchface:watchface-complications-data-source:1.2.1"
    // (Kotlin-specific extensions)
    implementation "androidx.wear.watchface:watchface-complications-data-source-ktx:1.2.1"

    // Use to implement a watchface style and complication editor
    implementation "androidx.wear.watchface:watchface-editor:1.2.1"

    // Can use to render complications.
    // This library is optional and watchfaces may have custom implementation for rendering
    // complications.
    implementation "androidx.wear.watchface:watchface-complications-rendering:1.2.1"
}

Котлин 

dependencies {
    // Use to implement wear watchfaces
    implementation("androidx.wear.watchface:watchface:1.2.1")

    // Use to implement wear watchface complications
    implementation "androidx.wear.watchface:watchface-complications-data-source:1.2.1"
    // (Kotlin-specific extensions)
    implementation "androidx.wear.watchface:watchface-complications-data-source-ktx:1.2.1"

    // Use to implement a watchface style and complication editor
    implementation("androidx.wear.watchface:watchface-editor:1.2.1")

    // Can use to render complications.
    // This library is optional and watchfaces may have custom implementation for rendering
    // complications.
    implementation "androidx.wear.watchface:watchface-complications-rendering:1.2.1"
}
,

классный 

dependencies {
    // Use to implement wear watchfaces
    implementation "androidx.wear.watchface:watchface:1.2.1"

    // Use to implement wear watchface complications
    implementation "androidx.wear.watchface:watchface-complications-data-source:1.2.1"
    // (Kotlin-specific extensions)
    implementation "androidx.wear.watchface:watchface-complications-data-source-ktx:1.2.1"

    // Use to implement a watchface style and complication editor
    implementation "androidx.wear.watchface:watchface-editor:1.2.1"

    // Can use to render complications.
    // This library is optional and watchfaces may have custom implementation for rendering
    // complications.
    implementation "androidx.wear.watchface:watchface-complications-rendering:1.2.1"
}

Котлин 

dependencies {
    // Use to implement wear watchfaces
    implementation("androidx.wear.watchface:watchface:1.2.1")

    // Use to implement wear watchface complications
    implementation "androidx.wear.watchface:watchface-complications-data-source:1.2.1"
    // (Kotlin-specific extensions)
    implementation "androidx.wear.watchface:watchface-complications-data-source-ktx:1.2.1"

    // Use to implement a watchface style and complication editor
    implementation("androidx.wear.watchface:watchface-editor:1.2.1")

    // Can use to render complications.
    // This library is optional and watchfaces may have custom implementation for rendering
    // complications.
    implementation "androidx.wear.watchface:watchface-complications-rendering:1.2.1"
}

Дополнительную информацию о зависимостях см. в разделе Добавление зависимостей сборки .

Обратная связь

Ваши отзывы помогают сделать Jetpack лучше. Сообщите нам, если вы обнаружите новые проблемы или у вас есть идеи по улучшению этой библиотеки. Пожалуйста, ознакомьтесь с существующими проблемами в этой библиотеке, прежде чем создавать новую. Вы можете добавить свой голос к существующей проблеме, нажав кнопку со звездочкой.

Создать новый выпуск

Более подробную информацию смотрите в документации Issue Tracker .

Версия 1.3

Версия 1.3.0-альфа07

23 апреля 2025 г.

Выпущен androidx.wear.watchface:watchface-*:1.3.0-alpha07 . Версия 1.3.0-alpha07 содержит эти коммиты .

Новые возможности

  • Уже некоторое время существует возможность определить схему UserStyle циферблата часов, а также можно определить ColorUserStyleSetting в XML.

Изменения API

  • Для проектов, выпущенных с использованием Kotlin 2.0, требуется использование KGP 2.0.0 или более поздней версии. ( Idb6b5 )
  • Добавлен API Watch Face Push, который позволяет приложению Wear OS программно устанавливать циферблат на часы.

Исправление ошибок

  • Поставщикам усложнений, использующим версию 1.3.0-alpha06, рекомендуется выполнить обновление, поскольку ошибка сбоя ComplicationDataSourceUpdateRequester в следующей версии WearOS была исправлена.

Версия 1.3.0-альфа06

26 марта 2025 г.

Выпущен androidx.wear.watchface:watchface-*:1.3.0-alpha06 . Версия 1.3.0-alpha06 содержит эти коммиты .

Новые возможности

  • API циферблатов Wear (watchface, watchface-client, watchface-client-guava, watchface-complications-rendering, watchface-data, watchface-editor, watchface-editor-guava и watchface-style) были упразднены в пользу формата Wear Watchface и в конечном итоге будут удалены из AndroidX. API complication не устарели и останутся. ( Ice960 )
  • API-интерфейсы дополнений теперь могут напрямую взаимодействовать с WearSDK , что повышает эффективность за счет меньшего количества межпроцессных соединений.

Версия 1.3.0-альфа05

15 января 2025 г.

Выпущен androidx.wear.watchface:watchface-*:1.3.0-alpha05 . Версия 1.3.0-alpha05 содержит эти коммиты .

Новые возможности

Обычно циферблаты позволяют пользователю выбирать цвета с помощью ListUserStyle . Хотя это работает, это влечет за собой отправку значков по Bluetooth в сопутствующий редактор, что неэффективно, поэтому мы ввели ColorUserStyleSetting , где полезная нагрузка представляет собой список из одного или нескольких цветов на стиль, который имеет значительно более компактный формат провода.

Мы добавили функцию OEM-циферблата, которая позволяет поставщикам OEM-усложнений добавлять дополнения в ComplicationData для использования в OEM-циферблатах часов.

Изменения API

  • Классы UserStyleSetting и UserStyleOption теперь имеют конструкторы, что является рекомендуемым способом их создания. ( Iacd03 )
  • Поддержка передачи дополнений в ComplicationData . Это предназначено для использования OEM-производителями, где они контролируют как поставщика дополнений, так и принимающий циферблат. Для установки дополнений требуется привилегированное разрешение com.google.android.wearable.permission.COMPLICATION_EXTRAS . ( I4e3b2 )
  • Циферблаты обычно позволяют пользователю выбирать цвета с помощью ListUserStyle , со значком для каждого ListOption . Поскольку схемы UserStyle отправляются по Bluetooth, важно сохранить небольшой размер схемы, что может стать проблемой, если из-за всех этих значков задано много десятков вариантов цвета. Чтобы помочь с этим, мы добавили ColorUserStyleSetting , где опция содержит список цветов вместо значка, что гораздо компактнее. ( Ib542e )
  • Для использования ColorUserStyleSetting и ColorOption требуется API 34. ( I8771d )

Исправление ошибок

  • Эта библиотека теперь использует аннотации nullness JSpecify , которые являются type-use. Разработчики Kotlin должны использовать следующий аргумент компилятора для обеспечения правильного использования: -Xjspecify-annotations=strict (это значение по умолчанию, начиная с версии 2.1.0 компилятора Kotlin). ( Ifd363 , b/326456246 )

Версия 1.3.0-альфа04

18 сентября 2024 г.

Выпущен androidx.wear.watchface:watchface-*:1.3.0-alpha04 . Версия 1.3.0-alpha04 содержит эти коммиты .

Новые возможности

  • Добавлена ​​поддержка отложенной загрузки иконок в UserStyleSettings и UserStyleOptions , что обеспечивает выигрыш в производительности при загрузке циферблатов. ( Iaf43d )
  • Добавлена ​​опция для обновления скриншота, который будет делаться всякий раз при изменении конфигурации системы (например, при изменении локали) через новый Watchface.setUpdateScreenshotOnConfigurationChange . По умолчанию эта настройка отключена. ( I765a1 )

Исправление ошибок

  • Удалено ручное описание доступа к новым API платформы, поскольку это происходит автоматически через моделирование API при использовании R8 с AGP 7.3 или более поздней версии (например, R8 версии 3.3) и для всех сборок при использовании AGP 8.1 или более поздней версии (например, D8 версии 8.1). Клиентам, не использующим AGP, рекомендуется обновиться до D8 версии 8.1 или более поздней версии. Подробнее см. в этой статье . ( Ia60e0 , b/345472586 )

Версия 1.3.0-альфа03

17 апреля 2024 г.

Выпущен androidx.wear.watchface:watchface-*:1.3.0-alpha03 . Версия 1.3.0-alpha03 содержит эти коммиты .

Изменения API

  • Мы добавили EditorSession#setOverrideComplications , который временно устанавливает ComplicationData базового экземпляра циферблата во время редактирования. Если осложнения меняются нечасто, это более эффективно, чем передача переопределений через EditorSession#renderWatchFaceToBitmap . ( I19384 )

Исправление ошибок

  • Ранее selectComplicationDataForInstant вызывал toApiComplicationData для любых временных линий, что означало, что последующий тест на равенство ссылок === всегда терпел неудачу. Это означало, что усложнения перезагружались в каждом кадре, что приводило к разрядке батареи. ( 717406 )

Версия 1.3.0-альфа02

3 апреля 2024 г.

Выпущен androidx.wear.watchface:watchface-*:1.3.0-alpha02 . Версия 1.3.0-alpha02 содержит эти коммиты .

Новые возможности

  • Теперь мы используем ссылочное равенство для сравнения best и selectedData , поскольку оператор equals является затратным. ( 446b00 )

Изменения API

  • Мы добавили динамический API без отката для GoalProgressComplicationData . ( c33264 )

Версия 1.3.0-альфа01

7 февраля 2024 г.

Выпущен androidx.wear.watchface:watchface-*:1.3.0-alpha01 . Версия 1.3.0-alpha01 содержит эти коммиты.

Новые возможности

  • WatchFaceServices можно инициализировать одновременно, и поэтому они не должны иметь состояния. Для поддержки этого мы добавили StatefulWatchFaceService в котором определяемое пользователем дополнение, созданное с помощью createExtra() передается во все переопределения, вызываемые во время инициализации.
  • GlesRenderer2 теперь имеет перегрузку конструктора, которая позволяет указать список атрибутов для последовательного использования с помощью eglChooseConfig .

Изменения API

  • StatefulWatchFaceService теперь поддерживает переопределение getComplicationSlotInflationFactory , в которое передается определенное пользователем дополнение, созданное createExtra() . ( I82d9f )
  • Некоторые циферблаты должны делиться вспомогательными данными, созданными во время createUserStyleSchema , с другими методами инициализации. Поскольку не было лучшей альтернативы, разработчики обычно делали свои WatchFaceServices с сохранением состояния. Это опасно, поскольку одновременно может быть создано несколько экземпляров, что может привести к ошибкам. Чтобы решить эту проблему, мы ввели StatefulWatchFaceService и StatefulWatchFaceRuntimeService , где определенный пользователем тип создается с помощью createExtra() и передается различным методам create в качестве параметра. ( If8a99 )
  • Мы добавили getUserStyleFlavors в InteractiveWatchFaceClient , что представляет интерес в первую очередь для OEM-производителей. ( I0f5d8 )
  • GlesRenderer2 теперь имеет перегрузку конструктора, которая позволяет вам указать список атрибутов для проверки по очереди с помощью eglChooseConfig . Это, например, позволяет вам сначала попробовать конфигурацию со сглаживанием и вернуться к конфигурации без него, если это необходимо. ( I1ba74 )
  • Начиная с Android U, поддержка SystemDataSources.DATA_SOURCE_HEART_RATE будет добавлена ​​в WearOS. Это усложнение гарантированно поддерживает только усложнения SHORT_TEXT , но рекомендуется, чтобы ComplicationSlot принимал также SMALL_IMAGE , поскольку OEM-производители могут выбрать предоставление ярлыка для своего приложения для здоровья вместо текущего значения. ( I34223 )
  • Мы добавили METADATA_KEY_CONFIG_RESTORE_SUPPORTED , который, начиная с Android U, управляет тем, что происходит при восстановлении системы из резервной копии для источника данных усложнения с METADATA_KEY_DATA_SOURCE_CONFIG_ACTION . По умолчанию система предполагает, что служба источника данных усложнения поддерживает резервное копирование любых данных конфигурации, но если это не так, то она может добавить параметр метаданных METADATA_KEY_DATA_SOURCE_CONFIG_ACTION в значение false, что пометит слот усложнения как не настроенный. ( I6c505 )

Версия 1.2

Версия 1.2.1

24 января 2024 г.

Выпущен androidx.wear.watchface:watchface-*:1.2.1 . Версия 1.2.1 содержит эти коммиты.

Исправление ошибок

  • Исправлен сбой на Samsung Galaxy Watch 4, 5 и 6. ( 43f0b0 )

Версия 1.2.0

29 ноября 2023 г.

Выпущен androidx.wear.watchface:watchface-*:1.2.0 . Версия 1.2.0 содержит эти коммиты.

Важные изменения по сравнению с версией 1.1.0

  • Мы добавили поддержку некоторых новых типов расширений, которые доступны для использования в Android T:
    • GoalProgressComplicationData , аналогичный RangedValueComplicationData , за исключением того, что он предназначен для прогресса в достижении цели, где min неявно равен нулю, а значение может быть больше targetValue .
    • WeightedElementsComplicationData , который состоит из массива Elements (пар веса и цвета) вместе с необязательным текстом/заголовком/изображением. Они могут отображаться в виде круговой диаграммы, где цвета должны быть осмысленными с учетом контекста, поскольку в усложнении обычно нет места для отображения меток.
  • Мы добавили поддержку необязательных ColorRanges в RangedValueComplicationData . Обычно усложнения отображаются в цветах, выбранных циферблатом, но иногда ComplicationDataSource лучше всего подходит для установки цветов, например, когда они имеют определенное семантическое значение. Например, от красного к синему для температуры.
  • Почти каждый тип ComplicationData теперь поддерживает SmallImages .
  • Мы добавили ComplicationDisplayPolicy , где DO_NOT_SHOW_WHEN_DEVICE_LOCKED предписывает совместимому циферблату не отображать расширение, когда устройство заблокировано.
  • Начиная с Android T, OEM-производители смогут определить, исходит ли запрос на усложнение от циферблата из списка, определенного метаданными android.support.wearable.complications.SAFE_WATCH_FACES в манифесте своего поставщика с помощью ComplicationRequest#isForSafeWatchFace . Поставщику потребуется разрешение com.google.wear.permission.GET_IS_FOR_SAFE_WATCH_FACE для получения чего-либо, кроме TargetWatchFaceSafety.UNKNOWN`.
  • UserStyleFlavors стала неэкспериментальной функцией.

Версия 1.2.0-rc01

18 октября 2023 г.

Выпущен androidx.wear.watchface:watchface-*:1.2.0-rc01 . Версия 1.2.0-rc01 содержит эти коммиты.

Версия 1.2.0-beta02

6 сентября 2023 г.

Выпущен androidx.wear.watchface:watchface-*:1.2.0-beta02 . Версия 1.2.0-beta02 содержит эти коммиты.

Новые возможности

  • SuspendingComplicationDataSourceService#onDestroy теперь открыт. Обратите внимание, что поддержка системного погодного усложнения по умолчанию была удалена.

Изменения API

  • Отменить «Предоставить новый источник данных для погодных осложнений». ( I6f335 )

Версия 1.2.0-beta01

23 августа 2023 г.

Выпущен androidx.wear.watchface:watchface-*:1.2.0-beta01 . Версия 1.2.0-beta01 содержит эти коммиты.

Новые возможности

  • Начиная с Android T, WearOS теперь будет поддерживать расширение погодной системы по умолчанию.

Изменения API

  • Добавить резервную версию системы погоды по умолчанию для усложнений. ( Ia0994 )
  • Этот патч добавляет WatchFaceRuntimeService и WatchFaceControlClient.createWatchFaceRuntimeControlClient вместе с оболочками guava. Они добавляют поддержку сред выполнения циферблатов, которые являются особым видом циферблата, загружающим свое определение из другого пакета. В настоящее время WearOS поддерживает только среду выполнения для формата Android Watch Face . ( I2799f )
  • Этот патч является продолжением aosp/2636578 , в котором мы переименовываем int defs, поэтому любой код, зависящий от WatchFaceType , CanvasType , TapType или ComplicationsSlotBoundsType не требует изменений. ( I4098b )
  • Обновлены файлы API для аннотации подавления совместимости. ( I8e87a , b/287516207 )
  • Этот патч раскрывает константы WatchFaceType в WatchFaceTypes , константы CanvasType в CanvasTypes , константы TapType в TapTypes и константы ComplicationsSlotBoundsType в ComplicationsSlotBoundsType . ( I3b85a , b/288750666 )
  • WatchFace.OverlayStyle используется очень редко и не поддерживается OEM-производителями, поэтому мы отказываемся от него и собираемся удалить его позже. ( I7344a )

Версия 1.2.0-альфа09

21 июня 2023 г.

Выпущен androidx.wear.watchface:watchface-*:1.2.0-alpha09 . Версия 1.2.0-alpha09 содержит эти коммиты.

Новые возможности

  • RangedValueComplicationData.Builder теперь принимает DynamicFloat , а новый DynamicComplicationText доступен как подкласс ComplicationText , оба из которых могут использовать динамические выражения, а также привязки платформы, которые обновляются с частотой 1 Гц на поддерживаемых устройствах Wear 4.

Изменения API

  • Добавлены динамические типы для ежедневной дистанции, ежедневных калорий и ежедневных этажей. Ключи для источников здоровья платформы теперь находятся под PlatformHealthSources.Keys ( Ib7637 )
  • Реализовать PlatformDataProvider для предоставления частоты сердечных сокращений и ежедневных шагов. Интерфейс SensorGateway удален из публичного API. ( I55b84 )
  • Переименуйте StateEntryValue в DynamicDataValue и обновите API состояния для использования DynamicDataKey . ( If1c01 )
  • Добавить AppDataKey для доступа к состоянию приложения; Добавить PlatformDataKey для доступа к данным платформы; Добавить поддержку пространства имен в StateStore . ( I7985e )
  • Методы enable / disablePlatformSource были удалены из DynamicTypeEvaluator . Вызывающий должен отвечать за обновления. ( I78c6d )
  • Разрешить ограничение размера связанных типов данных. ( Ie2966 )

Версия 1.2.0-альфа08

19 апреля 2023 г.

Выпущен androidx.wear.watchface:watchface-*:1.2.0-alpha08 . Версия 1.2.0-alpha08 содержит эти коммиты.

Новые возможности

  • Начиная с Android T, поставщики дополнений с привилегированным com.google.wear.permission.GET_IS_FOR_SAFE_WATCH_FACE могут регистрировать метаданные androidx.wear.watchface.complications.datasource.SAFE_WATCH_FACE_SUPPORTED_TYPES , которые переопределяют android.support.wearable.complications.SUPPORTED_TYPES для безопасных циферблатов. Это означает, что поставщик дополнений может выбрать обслуживание различных типов для доверенных и ненадежных циферблатов.

Изменения API

  • Распространение класса @Deprecated на свойство ( I882d1 , b/271441831 )
  • Имя параметра значения для Enum.valueOf изменено ( Ia9b89 )
  • Больше исключений из enum valueOf ( I818fe )
  • Мы удалили renderWatchFaceToSurface в пользу createRemoteWatchFaceView , который построен на основе SurfaceControlViewHost и позволяет вызывающему объекту встраивать вид с циферблата, который отображается, когда клиент вызывает RemoteWatchFaceViewHost#renderWatchFace . ( Ib311d )
  • Мы добавили renderWatchFaceToSurface в InteractiveWatchFaceClient , HeadlessWatchFaceClient и EditorSession . Обычно это будет более производительно, чем рендеринг в растровое изображение. ( Ieacad )
  • ObservableStateStore переименован в StateStore . ( Ieb0e2 )
  • Добавлен DynamicTypeEvaluator.Builder вместо аргументов конструктора, чтобы разрешить больше необязательных аргументов, включая ObservableStateStore , который теперь по умолчанию является пустым хранилищем. ( I6f832 )
  • Изменен порядок параметров в DynamicTypeEvaluator . ( Ic1ba4 )
  • Executor был добавлен в методы DynamicTypeEvaluator.bind . ( I346ab )
  • Мы добавили метод startEvaluation к BoundDynamicType , чтобы запустить оценку после привязки динамического типа. ( I19908 )
  • Поставщики дополнений с привилегированным разрешением com.google.wear.permission.GET_IS_FOR_SAFE_WATCH_FACE могут регистрировать метаданные androidx.wear.watchface.complications.datasource.SAFE_WATCH_FACE_SUPPORTED_TYPES , которые переопределяют android.support.wearable.complications.SUPPORTED_TYPES для безопасных циферблатов. ( Id1c73 )
  • Мы переименовали CustomValueUserStyleSettings2 в LargeCustomValueUserStyleSettings . ( Ic17ac )

Исправление ошибок

  • DynamicTypeValueReceiver#onPreUpdate был удален. ( I2dc35 )

Версия 1.2.0-альфа07

22 февраля 2023 г.

Выпущен androidx.wear.watchface:watchface-*:1.2.0-alpha07 . Версия 1.2.0-alpha07 содержит эти коммиты.

Новые возможности

  • Начиная с Android T, OEM-производители смогут определить, исходит ли запрос на усложнение от циферблата из списка, определенного метаданными android.support.wearable.complications.SAFE_WATCH_FACES в манифесте своего поставщика с помощью ComplicationRequest#isForSafeWatchFace . Поставщику потребуется разрешение com.google.wear.permission.GET_IS_FOR_SAFE_WATCH_FACE для получения чего-либо, кроме TargetWatchFaceSafety.UNKNOWN .

  • Также из Android T доступен CustomValueUserStyleSetting2 , который может содержать до 12,5 КБ. Предыдущий предел для CustomValueUserStyleSetting составлял 1 КБ. Несмотря на увеличенные ограничения по размеру, разработчикам циферблатов рекомендуется сохранять данные небольшими, поскольку настройки передаются по Bluetooth во время редактирования, а пропускная способность Bluetooth ограничена.

Изменения API

  • Мы добавили необязательный параметр eglContextAttribList в GlesRenderer и GlesRenderer2 , который позволяет вам задать EGL14.EGL_CONTEXT_CLIENT_VERSION , передаваемый в EGL14.eglCreateContext . ( I2a83e )
  • Мы перенесли библиотеки циферблатов в androidx.core.util.Consumer вместо java.util.function.Consumer . ( I273f5 )
  • Больше исключений, вызванных средствами доступа к свойствам KT ( Iff9d9 )
  • Мы добавили InteractiveWatchFaceClient.isComplicationDisplayPolicySupported , чтобы клиент мог определить, нужно ли ему эмулировать поддержку старых циферблатов или нет. ( I24c89 )
  • Мы решили, что isForSafeWatchFace должен быть IntDef с тремя состояниями. ( Ief2f7 )
  • Для Android T мы представили ComplicationRequest.isForSafeWatchFace , который предназначен для использования OEM и требует com.google.wear.permission.GET_IS_FOR_SAFE_WATCH_FACE . Для источников данных в системном образе это вернет true, если запрашиваемый циферблат находится в списке безопасных циферблатов, указанных источником данных в его манифесте. ( I0cbb6 )
  • Для Android T мы добавили CustomValueUserStyleSetting2 , который может содержать до 12,5 КБ. Предыдущий предел для CustomValueUserStyleSetting составлял 1 КБ. ( I0b100 )

Версия 1.2.0-альфа06

25 января 2023 г.

Выпущен androidx.wear.watchface:watchface-*:1.2.0-alpha06 . Версия 1.2.0-alpha06 содержит эти коммиты.

Новые возможности

  • Работа над добавлением поддержки привязок платформ усложнений продолжается, эта возможность пока не готова к использованию, но следите за обновлениями!
  • Мы добавили поддержку XML ComplicationSlot для новых типов усложнений: GOAL_PROGRESS и WEIGHTED_ELEMENTS.

Исправление ошибок

  • Устранена утечка, из-за которой редактор циферблатов не был корректно выпущен на устройствах Samsung. ( 3b5987 )
  • Исправлена ​​ошибка, из-за которой иногда некорректно отображались усложнения при переключении между циферблатами с несколькими избранными. ( b38ece )
  • Исправлена ​​ошибка сериализации с perOptionScreenReaderNames, приводившая к сбоям циферблата. ( e9f466 )

Версия 1.2.0-альфа05

7 декабря 2022 г.

Выпущен androidx.wear.watchface:watchface-*:1.2.0-alpha05 . Версия 1.2.0-alpha05 содержит эти коммиты.

Новые возможности

  • Некоторое время назад мы добавили поддержку иерархических UserStyleSettings , и с Android T теперь можно иметь более одного ComplicationSlotsUserStyleSetting в иерархии. Только один ComplicationSlotsUserStyleSetting будет активен, в зависимости от выбора стиля пользователем.

  • Мы улучшаем поддержку экранного диктора для ListOption и ComplicationSlotsOption , добавляя поле screenReaderName . Обратите внимание, что до версии Android T это поле будет игнорироваться редакторами-компаньонами.

Изменения API

  • Мы добавили новое необязательное поле screenReaderName в ListOption и ComplicationSlotsOption для использования редакторами — оно будет игнорироваться сопутствующими редакторами на устройствах до Android T. ( I75326 )
  • Из Android T несколько ComplicationSlotsUserStyleSettings теперь поддерживаются в иерархии стилей, пока только один из них может быть активен в любой момент времени. Мы добавили вспомогательную функцию findComplicationSlotsOptionForUserStyle в UserStyleSchema , чтобы помочь найти активный ComplicationSlotsOption если таковой имеется. ( Ic2b06 )
  • RangedValuesTypes были перенесены в сопутствующий объект RangedValueComplicationData и переименованы в TYPE_UNDEFINED , TYPE_RATING и добавлен новый TYPE_PERCENTAGE . ( I55d02 )
  • Мы переименовали экспериментальный DynamicFloat в FloatExpression и пометили его как @hide . ( Idf4f1 )
  • Добавление аннотации @JvmDefaultWithCompatibility ( I8f206 )

Версия 1.2.0-альфа04

9 ноября 2022 г.

Выпущен androidx.wear.watchface:watchface-*:1.2.0-alpha04 . Версия 1.2.0-alpha04 содержит эти коммиты.

Новые возможности

  • Для Android T мы добавили поддержку двух новых типов усложнений: GoalProgressComplicationData и WeightedElementsComplicationData .
  • GoalProgressComplicationData похож на RangedValueComplicationData , но его значение может выходить за пределы целевого значения (для RangedValueComplicationData значение ограничивается диапазоном [мин.. макс.]), что имеет последствия для визуального дизайна и может не подойти для всех циферблатов.
  • GoalProgressComplicationData добавляет поддержку круговых диаграмм и аналогичных разбивок простых данных.
  • Мы добавили дополнительную поддержку ColorRamps в RangedValueComplicationData .
  • Для Android T мы добавили ComplicationPersistencePolicy и setCachePolicy в ComplicationData , что в настоящее время позволяет поставщику контролировать, сохраняется ли усложнение или нет (т. е. кэшируется ли оно после перезагрузки). Большинству усложнений не нужно устанавливать управление кэшем, но это может исправить пограничные случаи с устаревшими данными для некоторых усложнений, которые часто обновляются (например, усложнения данных о здоровье). Мы также добавили ComplicationDisplayPolicy , где DO_NOT_SHOW_WHEN_DEVICE_LOCKED предписывает совместимому циферблату не отображать усложнение, когда устройство заблокировано. ( Ic9574 )

Изменения API

  • GoalProgressComplicationData , WeightedElementsComplicationData и ColorRamp больше не являются экспериментальными. ( Ica9e2 )
  • ComplicationPersistencePolicy и ComplicationDisplayPolicy теперь правильно отмечены как T API. ( I31d88 )
  • Устаревший конструктор ComplicationSlotOverlay теперь имеет DeprecationLevel.WARNING , что позволяет снова вызывать его из Java. ( Ib308c )
  • Мы исправили некоторые проблемы совместимости с Java с ComplicationRequestListener , CanvasComplication , ComplicationTapFilter и InteractiveWatchFaceClient , аннотировав их с помощью @JvmDefaultWithCompatibility ( Id94fc )
  • Мы удалили экспериментальные ProtoLayoutComplicationData и ListComplicationData . История разработчиков для них неясна, мы надеемся вернуться к этому в будущем. ( I9df05 )
  • Мы добавили ValueType обратно в RangedValueComplicationData . WeightedElementsComplicationData теперь поддерживает цвет фона. Мы удалили DiscreteRangedValueComplicationData , поскольку его функциональность является подмножеством WeightedElementsComplicationData . ( I6446c )

Исправление ошибок

  • Включите isForScreenShot в equals и хэш-код. Убедитесь, что onRenderParametersChanged получает правильное значение isForScreenshot ( I04a41 )
  • Исправлены утечки WatchFaceControlService из headless-клиентов. ( e90e00 )

Версия 1.2.0-альфа03

5 октября 2022 г.

Выпущен androidx.wear.watchface:watchface-*:1.2.0-alpha03 . Версия 1.2.0-alpha03 содержит эти коммиты.

Новые возможности

  • Новых функций нет, но мы исправили несколько ошибок редактора циферблатов.

Изменения API

  • Устаревший UserStyleSchema.userStyleSettings , поскольку rootUserStyleSettings становится неэкспериментальным ( Ie96e3 )
  • Переместить rootUserStyleSettings из экспериментального ( I8d6b3 )
  • Мы отметили WatchFaceColors как экспериментальный, поскольку он поддерживается не всеми системами ( I6d75d )
  • Предоставьте DisconnectReasons в общедоступном API, чтобы он работал с IntDef . ( I791f8 )

Исправление ошибок

  • Закройте любой открытый редактор часов, если SysUI умирает. Если SysUI умирает, а редактор циферблата часов не закрывается, циферблат часов может остаться в несогласованном состоянии, поскольку система полагается на SysUI для сохранения любых изменений пользовательского стиля.( ba762a
  • Исправлена ​​утечка памяти в ComplicationDataSourceInfoRetriever , где продолжение сопрограммы Kotlin действовало как корень gc и сохраняло активность редактора. ( 33ee06 )

Версия 1.2.0-альфа02

21 сентября 2022 г.

Выпущен androidx.wear.watchface:watchface-*:1.2.0-alpha02 . Версия 1.2.0-alpha02 содержит эти коммиты.

Новые возможности

  • Некоторые циферблаты имеют конфигурацию вне UserStyle , которая влияет на них визуально (например, выбор фонового фото). Мы добавили Renderer.sendPreviewImageNeedsUpdateRequest , который позволяет циферблату запрашивать обновленное изображение предварительного просмотра. Обратите внимание, что для работы требуется соответствующее обновление системы.

  • Мы также добавили API для циферблатов, чтобы предоставить их цвета системе, которая может выбрать свою цветовую палитру на основе этого. Обратите внимание , что это было сделано экспериментально в следующем патче.

  • Почти каждый тип ComplicationData теперь поддерживает SmallImages .

Изменения API

  • Менеджер обоев иногда может отсоединиться от движка и сделать другой. Мы добавили DisconnectReason int def и расширили ClientDisconnectListener новым методом, который включает DisconnectReason , позволяя слушателю наблюдать отсоединения движка. ( I45cce )
  • Добавлены два необязательных параметра nameResourceId и screenReaderResourceId в конструктор ComplicationSlotOverlay ( I157e8 ).
  • Мы добавили оболочку guava для новой перегрузки getOrCreateInteractiveWatchFaceClient с PreviewImageUpdateRequestedListener . ( Ic31f0 )
  • Мы добавили Renderer.sendPreviewImageNeedsUpdateRequest , который полезен для циферблатов, имеющих состояние вне UserStyleSchema , которое влияет на их внешний вид (например, циферблат с выбираемым фоновым изображением). На стороне клиента мы добавили PreviewImageUpdateRequestedListener в качестве необязательного параметра для getOrCreateInteractiveWatchFaceClient для наблюдения за этими запросами. ( Iff44a )
  • Мы упростили API для отображения WatchFaceColors , теперь есть простое свойство watchFaceColors на Renderer, которое может устанавливать циферблат, его следует обновлять по мере необходимости в ответ на любые изменения стиля. Вместо того, чтобы использовать WallpaperManager для наблюдения за изменениями цвета, мы добавили OnWatchFaceColorsListener в InteractiveWatchFaceClient . ( I490bc )
  • Мы добавили класс WatchFaceColors , который содержит три самых важных цвета циферблата, и добавили открытые методы watchfaceColors и notifyWatchFaceColorsChanged в Renderer, которые позволяют системе получать цвета циферблата через WallpaperManager.getWallpaperColors . ( I3d611 )
  • ShortTextComplicationData , RangedValueComplicationData , NoPermissionComplicationData (и экспериментальные DiscreteRangedValueComplicationData , GoalProgressComplicationData и WeightedElementsComplicationData ) теперь поддерживают SmallImages . Если циферблат часов выбирает отображение усложнения с несколькими цветами, теперь у него есть возможность использовать многоцветное SmallImage там, где раньше приходилось использовать монохромное изображение. ( I257df )
  • Реорганизуйте PreviewImageUpdateRequestedListener , чтобы он был Consumer<> ( Ia875d )
  • Заменить пользовательский тип Single Abstract Method (SAM) OnWatchfaceColorsListener на универсальный тип Java SAM (Consumer) ( I0c489 )
  • Мы объявили устаревшими старые методы getOrCreateInteractiveWatchFaceClient и listenableGetOrCreateInteractiveWatchFaceClient , в которых не указан PreviewImageUpdateRequestedListener . ( Iec502 )

Исправление ошибок

  • DisconnectReason.BINDER_DIED переименован в DisconnectReason.ENGINE_DIED . ( I4eb0e )

Версия 1.2.0-альфа01

10 августа 2022 г.

Выпущен androidx.wear.watchface:watchface-*:1.2.0-alpha01 . Версия 1.2.0-alpha01 содержит эти коммиты.

Новые возможности

  • Мы добавили экспериментальную поддержку для различных новых форматов усложнений. Это область активной разработки; эти новые форматы могут быть изменены без уведомления, и в настоящее время нет поддержки рендерера от CanvasComplicationDrawable .
  • Мы также добавили дополнительные поля в слоты усложнений, что упрощает нажатие на небольшие усложнения.

Изменения API

  • Экспериментальный класс BoundingArc теперь неизменяем. ( If624a )
  • Небольшие усложнения могут быть сложными для нажатия. Чтобы помочь смягчить это, мы ввели поддержку полей, которые увеличивают область нажатия, не влияя на рендеринг. Если не указано иное (в коде или через XML), ComplciationSlots имеют поля нулевого размера. ( I14089 )
  • Изменена сигнатура getComplicationSlotInflationFactory(CurrentUserStyleRepository) для возврата ненулевого экземпляра фабрики. Раньше возвращать null было ошибкой, так что это просто делает контракт API более понятным. ( I0fcc0 )
  • Мы добавили аргумент currentUserStyleRepository в метод WatchFaceService.getComplicationSlotInflationFactory для соответствия createComplicationSlotsManager . ( I2ddd2 )
  • UserStyleFlavors стали неэкспериментальной функцией. ( I69cdc )
  • Мы удалили экспериментальный ValueType из RangedValueComplicationData и вместо этого ввели экспериментальный DiscreteRangedValueComplicationData , который похож на RangedValueComplicationData , за исключением целочисленного диапазона и значения. Мы также ввели экспериментальный GoalProgressComplicationData , который похож на RangedValueComplicationData , за исключением того, что он предназначен для прогресса в достижении цели, где min неявно равен нулю, а значение может быть больше targetValue . Обратите внимание, что для всех вариантов RangedValue необходимо указать по крайней мере одно из следующих значений: monochromeImage, text или title. ( I9590c )
  • Мы удалили boundsWithMargins из ComplicationSlotState , поскольку системное программное обеспечение не имеет для него варианта использования. ( I42e26 )
  • Мы добавили экспериментальную поддержку WeightedElementsComplicationData , которая состоит из массива Elements (пар веса и цвета) вместе с необязательным текстом/заголовком/изображением. Они могут отображаться в виде круговой диаграммы, где цвета должны быть осмысленными с учетом контекста, поскольку в усложнении обычно нет места для отображения меток. ( I87eea )
  • Экспериментальные ColorRamps опционально используемые RangedValueComplicationData и GoalProgressComplicationData теперь позволяют вам указать последовательность из семи цветов и флаг, указывающий, должны ли цвета плавно меняться или должны отображаться сплошные шаги цвета одинакового размера. ( I9f5bf )
  • RangedValueComplicationData.drawSegmented был изменен на valueType , который представляет собой int с соответствующим ValueType IntDef который обеспечивает семантическое значение для ранжированного значения и может использоваться средством визуализации усложнения для влияния на стиль. ( I0616b )
  • Мы добавили экспериментальную поддержку для необязательных ColorRanges в RangedValueComplicationData . Обычно усложнения отображаются в цветах, выбранных циферблатом, но иногда ComplicationDataSource лучше всего подходит для установки цветов, например, когда они имеют определенное семантическое значение. Например, от красного к синему для температуры. ( I5153a )
  • Мы добавили экспериментальную подсказку drawSegmented в RangedValueComplicationData . Это сигнализирует рендерерам о необходимости отрисовки индикатора ранжированного значения с сегментами, где 1 сегмент = 1 единица. ( I7d7c1 )

Исправление ошибок

  • Мы добавили возможность определять ComplicationSlotBounds относительно предопределенной системы координат экрана. ( I0985d )

Версия 1.1

Версия 1.1.1

10 августа 2022 г.

Выпущен androidx.wear.watchface:watchface-*:1.1.1 . Версия 1.1.1 содержит эти коммиты.

  • Это релиз, исправляющий ошибки, и пользователям версии 1.1.0 настоятельно рекомендуется выполнить обновление.

Исправление ошибок

  • Смотреть инициализацию лица асинхронно, и если осложнение получено до того, как лицо будет готово, оно будет помещено в список pendingInitialComplications и применяется позже. К сожалению, применялись применение pendingInitialComplications слишком рано, что означало, что во время инициализации лица с инициализацией часов было время, где осложнения все еще будут подвергаться pendingInitialComplications и игнорируются. Это было исправлено. Кроме того, этот патч исправляет ошибку, в которой ComplicationRenderer не ошибался, пытаясь загрузить заполнители асинхронно, что не удалось, что привело к тому, что компиляционная графика никогда не обновляется. Наконец, этот патч исправит надежду теоретической ошибкой, в которой необходимо объединить множественные pendingInitialComplications . ( 0d03ba3 )

  • Исправить потенциальный тупик в InteractiveInstanceManager , где getExistingInstanceOrSetPendingWallpaperInteractiveWatchFaceInstance держал замок дольше, чем необходимо. Обычно мы ожидаем, что engine.setUserStyle будет быстрым, но если по какой -то причине это не так, то мы могли бы получить тупик/ANR. Этот патч выходит из замка ненужной работы, удаляя потенциал для тупика. ( 5A2ADCA )

  • Исправьте несколько проблем, которые сохранили WatchFaceService . Wakelock иногда может сохранить WatchFaceService , добавляя это исправление release() . Кроме того, StateFlows могут сохранить WatchFaceService , отменив базовые CoroutineScopes которые исправляют это. ( FD48138 )

  • Добавьте тайм -ауты, чтобы awaitDeferredWatchFace * и исправить watchfaceOverlayStyle NullPointerException . В обычных обстоятельствах это не должно тайм -аут, в том числе после свежей установки и сценариев DirectBoot , где загрузка процессора высока. Мы также исправили NPE, если getWatchfaceOverlayStyle называется после close() . ( A4C3A5A )

Версия 1.1.0

15 июня 2022 года

androidx.wear.watchface:watchface-*:1.1.0 выпускается. Версия 1.1.0 содержит эти коммиты.

Важные изменения с 1.0.0

Улучшено редактирование:

  • Мы добавили поддержку иерархических схем, которые позволяют писать иерархию стилей редактором UIS. Теперь вы можете указать отдельные значки для использования на стороне и редакторах компаньонов.
  • Существует поддержка для нескольких случаев часового лица, каждый экземпляр имеет уникальный идентификатор, доступный на всех поверхностях API.
  • Теперь вы можете указать человеческие читаемые имена для ComplicationSlots для использования в редакторах.
  • Экспериментальная поддержка стиля «аромата», курируемого выбора стилей, которые будут видны от редактора компаньона.
  • При редактировании двух экземпляров watchface загружены, теперь это возможно для обмена ресурсами, сохраняя память
  • При выборе осложнений в редакторе ON Watch Face, нынешний поставщик теперь предварительно избран.

Улучшенные осложнения:

  • Теперь вы можете указать ComplicationType для первичных и вторичных источников данных, предоставляя разработчикам большую гибкость для опыта вне коробки.
  • Мы добавили ComplicationDataTimeline , которая предоставляет последовательность данных, затрачиваемых на время, которые должны быть доставлены на лицо часов, которые можно автоматически кэшировать и обновлять. Например, сегодняшний прогноз погоды в разное время или несколько предстоящих календарных мероприятий.
  • ComponentName поставщика осложнений является частью ComplicationData .
  • Сложность теперь кэшируется, что обеспечивает лучший опыт при переключении между лицами для часов.

Другие изменения:

  • UserStyleSchema и ComplicationSlots теперь могут быть определены в XML. Это упрощает конструкцию лица и позволяет более быстрые запросы метаданных из системы.
  • Часым лица теперь могут влиять на цвета, используемые для рендеринга наложения системы.

Версия 1.1.0-RC01

18 мая 2022 года

androidx.wear.watchface:watchface-*:1.1.0-rc01 выпускается. Версия 1.1.0-RC01 содержит эти коммиты.

Новые возможности

  • Мы внесли несколько настроек использования для поддержки xml WatchFace, что облегчает указание ComplicationSlotBounds и поддерживающих ссылок. Экспериментирование с краевым осложнением BoundingArc продолжается, сгибая его до drawHighlight хотя в то время это не рекомендуется для использования.

API меняется

  • Мы добавили экспериментальную перегрузку drawHighlight , которая принимает параметр BoundingArc . ( I705f8 )
  • Смотреть лицо XML теперь поддерживает ссылки на ресурсы. Он позволяет использовать одну и ту же константу как в XML, так и в вашем коде. ( I3ef61 )
  • Мы добавили способность определять ComplicationSlotBounds в center_x , center_y , size_x , size_y FORM. Теперь также возможно использовать различные единицы (т.е. DP), используя ссылки на ресурсы. ( IACE98 )

Исправления ошибок

  • Исправлена runBlockingWithTracing , которая выполняла задачи в неправильном контексте. ( 4F595FE )
  • Сделайте BaseEditorSession.close Synchronous. Проблема с BaseEditorSession.close . Клоуз асинхронна заключается в том, что мы выпускаем ComplicationDataSourceInfoRetriever слишком поздно, что приводит к предупреждению спама в LogCat. Это было, вероятно, безвредно, но спам Logcat отвлекает и следует избегать. ( 35A5308 )

Версия 1.1.0-бета02

11 мая 2022 г.

androidx.wear.watchface:watchface-*:1.1.0-beta02 выпускается. Версия 1.1.0-beta02 содержит эти коммиты.

Новые возможности

  • Мы добавили экспериментальную поддержку для новых типов ComplicationData , они еще не готовы к использованию, но смотрите это пространство.

API меняется

  • Мы добавили BoundingArc , экспериментальный класс, который описывает геометрию слота с осложнением края. Это было добавлено к ComplicationSlot и складывалось WatchFaceMetadataClient ComplicationSlotState ( I61a40 )
  • Мы добавили возможность наследовать настройки в UserStyleSetting XML. Это позволяет уменьшить многословие и разделить настройку между сторожевыми площадками. ( IEF841 )
  • Мы добавили два новых экспериментальных типа ComplicationData . В настоящее время нет никакой поддержки ListComplicationData для любого из этих типов, и WoroS в настоящее время не распознает эти типы ComplicationDataSource's ProtoLayoutComplicationData ( I1811c )

Исправления ошибок

  • Исправлена ​​сериализация типа TimeLineEntry . Мы не сериализовали тип TimeLineEntry , который означал, что кэшированные TimeLineEntries типа Nodata были бы неправильно интерпретированы как наличие типа родительского осложнения, ведущего к NPE, когда доступ к не существующим полям. ( 55ffdf5 )
  • Исправить ошибку, где setComplicationData сбросил поля временной шкалы ( FB392F5 )
  • Исправляет ошибку, в которой очень время runBlockingWithTracing приведет к NPE ( 12CA62E )
  • Исправляет ошибку, в которой мы иногда получаем ClassNotFoundException: android.support.wearable.complications.ComplicationText при получении осложнения. ( 217942d9 )
  • Исправляет ошибку в GlesRenderer.backgroundThreadInitInternal , где она называлась только onBackgroundThreadGlContextCreated , если был вызван EGL14.eglCreateContext . Исправляет еще одну ошибку, в которой был визуальный сбой на скриншоте, вызванном verticalFlip . ( C674AD2 )
  • Исправить проверку версии xml WatchFaceService , он загружался из неправильного пакета. ( DFA06F3 )
  • Формат заполнителя теперь использует внутренний пакет. Мы не хотим, чтобы заполнители разбивали существующие часовые места, которые могут использовать скрытую внутреннюю AswccomplicationData. Ранее формат провода данных NoDataComplication , хранящихся за заполнителем в обычных полях (проблематично, потому что старые лиц с часами будут делать строку заполнителя, которая не предназначена), вместо этого мы теперь используем внутренний пакет для полного изолята. ( D5E7BD2 ).

Версия 1.1.0-бета01

20 апреля 2022 года

androidx.wear.watchface:watchface-*:1.1.0-beta01 выпускается. Версия 1.1.0-beta01 содержит эти коммиты.

API меняется

  • Теперь методы WatchFaceMetadataClient ( getUserStyleSchema , getComplicationSlotMetadataMap , getUserStyleFlavors ) и HeadlessWatchFaceClient.getUserStyleFlavors бросают без контроля RuntimeException вместо WatchFaceException . ( I0718a )
  • WatchFaceMetadataClient.WatchFaceException был выведен из класса, чтобы позволить его повторно использовать. ( I4e869 )

Исправления ошибок

  • WatchFaceMetadataClient больше не будет разбиться , когда отправляют частичные ComplicationSlotBounds .

Версия 1.1.0-Alpha05

6 апреля 2022 года

androidx.wear.watchface:watchface-*:1.1.0-alpha05 выпускается. Версия 1.1.0-Alpha05 содержит эти коммиты.

Новые возможности

  • Теперь вы можете сказать, какой источник данных послал ComplicationData , осмотрев ComplicationData.dataSource , некоторые часы могут использовать это для настройки дисплея осложнений. ( I44a73 )

API меняется

  • Renderer.CanvasRenderer и Renderer.GlesRenderer были устарели в пользу Renderer.CanvasRenderer2 Для Java Interop мы ListenableGlesRenderer2 ListenableCanvasRenderer2 и Renderer.GlesRenderer2 . ( I31ffa SharedAssets
  • Добавлено @WatchFaceFlavorsExperimental способность определять ароматы - предварительно сконфигурированный список стилизированных часов ( I04DD0 )
  • Renderer.sharedAssets в настоящее время является Stateflow, и мы удалили неиспользованный Renderer.SharedAssetsFactory ( i12ac5 )
  • UserStyleSchema.userStyleSettings больше не устарел ( IBA7E3 )
  • Мы добавили HeadlessWatchFaceClient.getUserStyleSchemaDigestHash , который позволяет HeadlessWatchFaceClient Wwatchfaceclient избегать относительно низких накладных расходов прохождения схемы по AIDL перед вычислением хэша дигеста. ( I33597 )
  • Мы добавили isUserStyleSchemaStatic в WatchFaceMetadataClient , что является правдой, если и только тогда, на что можно полагаться UserStyleSchema , чтобы не измениться, если не обновляется APK для часов. ( I45a3f )
  • Мы добавили getDigestHash в UserStyleSchema , который вычисляет хэш схемы. Это может быть использовано для эффективного определения, изменилась ли UserStyleSchema . ( I2063d )
  • METADATA_KEY_DATA_SOURCE_DEFAULT_CONFIGURATION_SUPPORTED переименован в METADATA_KEY_DATA_SOURCE_DEFAULT_CONFIG_SUPPORTED ( i9ba5d )
  • UserStyleSetting.OnWatchEditorData была переименована в UserStyleSetting.WatchFaceEditorData сборник. ( If3afb )

Версия 1.1.0-Alpha04

9 марта 2022 года

androidx.wear.watchface:watchface-*:1.1.0-alpha04 выпускается. Версия 1.1.0-Alpha04 содержит эти коммиты.

API меняется

  • В настоящее время ComplicationData не всегда может быть доступно (например, кэшированное осложнение), поэтому мы расширили NoDataComplication с дополнительным заполнителем осложнением и добавленным ComplicationText.PLACEHOLDER Держатель, MonochromaticImage.PLACEHOLDER . Местоположение, SmallImage.PLACEHOLDER , PhotoImage.PLACEHOLDER , который разрешается использовать только в контексте NoDataComplicationData -EplectionAt.PloctionAt.PloctionAt.PloctionAta. Если выбраны эти заполнители, предполагается отображаться с серыми коробками/дугами. ( I6285d )
  • Мы добавили ComplicationData.getNextChangeInstant , который сообщает вам следующий момент после эталонного момента, в котором может измениться любое поле осложнений. Это используется внутренне для планирования кадров для обновлений осложнений. Например, если лицо часов обычно обновляет один раз в минуту, установление осложнения Stop Watch приведет к обновлению его обновления один раз в секунду. ( I7ceb2 )
  • EditorSession.watchFaceId теперь может использоваться на всех уровнях API. Кроме того, его значение теперь всегда будет соответствовать WatchState.watchFaceInstanceId . ( I323b9 )
  • API getPendingIntentForTouchEvent больше не является необходимым, поскольку основная проблема была исправлена ​​в рамках, поэтому все связанные API были удалены. Часы не нужно делать что -то особенное для PendingIntents , даже если кнопка «Домой» недавно была нажата. ( I1f2e8 )
  • Мы добавили RendererParameters.isForScreenShot , что будет правдой, если рендерин для снимка экрана. Некоторые смотрят лица с анимацией, чтобы знать это, чтобы внести коррективы, чтобы обеспечить наилучшие результаты. ( I96d99 )
  • Мы добавили WatchFaceExceptionReason в WatchFaceException , чтобы дать некоторый контекст тому, что пошло не так. ( I01d15 )
  • ComplicationDataSourceService.onImmediateComplicationRequest был удален, вместо этого было добавлено, ComplicationRequest.immediateResponseRequired для сигнала добавлено, что поставщик должен быстро реагировать (в идеале реагировать на <100 мс). Примечание. Эта функциональность охраняется за привилегированным com.google.android.wearable.permission.USE_IMMEDIATE_COMPLICATION_UPDATE разрешение. ( IE6B23 )
  • Обновленная нулясь в Core и AppCompat в соответствии с тирамису DP2 ( I0CB7 )

Исправления ошибок

  • Теперь приложение Watchface срабатывает исключение, если проверка схемы не удается ( IA400F )

Версия 1.1.0-Alpha03

9 февраля 2022 года

androidx.wear.watchface:watchface-*:1.1.0-alpha03 выпускается. Версия 1.1.0-Alpha03 содержит эти коммиты.

API меняется

  • Мы добавили экспериментальную поддержку для иерархических схем стиля. Мы добавили новое свойство в androidx.wear.watchface.style.UserStyleSetting.Option , ChildSettings, которые изначально используются только в ListOption . Это позволяет описать иерархию стилей для использования редактором UIS, базовый пользовательский тип не изменился и до сих пор остается Map<String, ByteArray> . ( IAF6F4 )
  • Мы добавили WatchFace.OverlayStyle , который позволяет сторожевой поверхности настраивать рендеринг наложения состояния системы. ( 18520d )
  • Мы представили clearWithBackgroundTintBeforeRenderingHighlightLayer Новый необязательный параметр конструктора для CanvasRenderer (по умолчанию неверно), если установить True, то холст будет очищен с помощью фонового цвета оттенка. ( IE01E5 )
  • Добавлено androidx.watchface.complications.datasource.DEFAULT_CONFIGURATION_SUPPORTED Metadata, что позволяет источникам осложнений данных указать, что они могут обеспечить значение по умолчанию без какой -либо конфигурации ( ICC0D4 )
  • Это часто при редактировании часового лица, чтобы быть как интерактивным, так и безголовым экземпляром. Чтобы помочь сохранить память, мы ввели Renderer.SharedAssets , который позволяет рендерингу с лицами по обмену обменными данными (например, текстурами и шейдерами) между экземплярами. GlesRenderer.setEglConfig и GlesRenderer.setEglDisplay устарели, для этого никогда не было предназначено для установки, и это привело бы к неопределенному поведению. ( I0d9e7 )
  • Мы добавили setNameResourceId & setScreenReaderNameResourceId (какие эталонные строковые ресурсы androidx.wear.watchface.client.ComplicationSlotState к ComplicationSlot.Builder . Это позволяет системе извлекать имена сложностей для использования в редакторах и считывателях экрана. ( If6c6a )
  • WatchfaceMetadataClient.getUserStyleSchema и getComplicationSlotMetadataMap теперь бросают WatchFaceException вместо RemoteException . ( I86f11 )
  • onSynchronousComplicationRequest и связанные с ним функции в ComplicationDataSourceService были переименованы в onImmediateComplicationRequest и т. Д. ( I87BA0 )
  • Наблюдая за редакторами лица гораздо меньше экрана, чем редакторы компаньонов, поэтому имеет смысл поддерживать различные значки для Entry Face Editors. Этот патч добавляет OnWatchEditorData (в настоящее время содержит только значок) ко всем пользователям и при необходимости их классов опций. ( IF1886 )
  • Мы добавили @JvmOverloads в конструктор прослушиваемого glesrenderer для лучшего java interop. ( I2974a )

Исправления ошибок

  • Конструктор ListenableGlesRenderer теперь правильно обозначен как @Throws(GlesException::class) , и теперь можно расширить этот класс в Java. ( IAC6D0 )
  • Исправляет ошибку с помощью PhotoImageComplicationData Tapaction неправильно обрабатывается ( I1CC30 )

Версия 1.1.0-Alpha02

12 января 2022 года

androidx.wear.watchface:watchface-*:1.1.0-alpha02 выпускается. Версия 1.1.0-Alpha02 содержит эти коммиты.

Новые возможности

  • Чтобы помочь отладке и тестированию, ComplicationData и соответствующие подклассы теперь имеют переоцененные методы хешкода, равные и товарные, облегчающие их работу.

API меняется

  • WatchfaceMetadataClient Методы еще раз бросают RemoteExceptions , где это уместно, облегчая для клиента код, чтобы улавливать ошибки с часового лица. ( I78785 )
  • ComplicationData и подклассные классы теперь имеют хэшкод, равные и тослинг. ( I24bc6 )

Версия 1.1.0-Alpha01

15 декабря 2021 года

androidx.wear.watchface:watchface-*:1.1.0-alpha01 выпускается. Версия 1.1.0-Alpha01 содержит эти коммиты.

Новые возможности

  • UserStyleSchema и ComplicationSlots теперь могут быть определены в XML. Это упрощает строительство лица. Кроме того, запросы WatchFaceMetadataClient быстрее, потому что ему не нужно связывать службу, чтобы получить метаданные. WatchFaceMetadataClient и ListenableWatchFaceMetadataClient больше не экспериментальны и станут частью стабильного API. Система сможет необязательно поддерживать несколько экземпляров часового лица, каждая из которых с различными пользовательскими параметрами. Они будут видны в сборщике лица. Чтобы выбрать это, часы должны включать в себя следующую мета -данных в его манифесте.

        <meta-data
        android:name="androidx.wear.watchface.MULTIPLE_INSTANCES_ALLOWED"
        android:value="true" />

  • Некоторые часы имеют состояние, которое не отражено в UserStyle , для поддержки этого и нескольких случаев, идентификатор экземпляра лица Watch Face теперь доступен через WatchState.watchFaceInstanceId .

  • ComplicationData , в настоящее время кэшируется, чтобы осложнения были отображаются сразу после загрузки. Иногда ComplicationData к кэшируется в памяти системой, а иногда он сериализуется библиотеками лиц. Когда сериализуется какое-либо связанное сопутствующее плату, если это произойдет, ComplicationData.tapActionLostDueToSerialization . Система отправит true ComplicationData с помощью tapAction как можно скорее.

  • Некоторые ComplicationData не следует кэшировать в течение длительного времени, чтобы поддержать это, мы добавили более общее ComplicationDataTimeline функции. Это может быть использовано для обеспечения последовательности ComplicationData затрачиваемого по времени, для доставки на лицо часов, которую можно автоматически кэшировать и обновлять. Например, сегодняшний прогноз погоды в разное время или несколько предстоящих календарных мероприятий. ComplicationRequestListener был расширен с помощью нового метода onComplicationDataTimeline , который вы можете использовать для возврата этих данных.

  • DefaultComplicationDataSourcePolicy был расширен, поэтому вы можете указать ComplicationType для первичных и вторичных источников данных.

  • Мы добавили поддержку поставщиков синхронных осложнений, где осложнение обновляется с более высокой частотой, чем обычно, до одного раза в секунду, когда видно и не амбиционное лицо. Примечание. Поставщики синхронных осложнений могут иметь ограниченное использование из -за проблем с давлением памяти.

  • Изменения PendingIntentTapListener , вероятно, будут возвращены, потому что мы решили основную проблему (часы невозможно запустить мероприятия в течение 5 секунд после нажатия кнопки «Домой») в фреймворке.

API меняется

  • ComplicationData.isCached был изменен на tapActionLostDueToSerialization , которая более полезна при определении того, следует ли по -разному отображаться слот осложнений, чтобы сигнализировать о том, что его нельзя нажать. ( I6de2f )
  • Добавлено ComplicationDataTimeline . Это может быть использовано для обеспечения последовательности ComplicationData затрачиваемого по времени wear-complication-data-source для доставки на лицо часов, которую можно автоматически кэшировать и обновлять. Например, сегодняшний прогноз погоды в разное время или несколько предстоящих календарных мероприятий. ComplicationRequestListener был расширен с помощью нового метода onComplicationDataTimeline , который вы можете использовать для возврата этих данных. Есть новая обертка Kotlin, SuspendingTimelineComplicationDataSourceService для приостановки услуг источника данных. ( IDECDC )
  • Добавлены PendingIntentTapListener и WatchFaceControlClient.getPendingIntentForTouchEvent . Это может помочь наблюдать за лицами, которые необходимо запустить намерения в ответ на Taps, чтобы обойти проблему, когда фреймворки блокируют новые действия в течение 5 секунд после нажатия кнопки «Домой». ( I98074 )
  • Введен кэш ComplicationData на просмотр. Цель этого состоит в том, чтобы позволить часовой поверхности отображать последние известные значения данных осложнений при загрузке до тех пор, пока у системы не будет возможности их обновить. Существует новый метод API WatchFaceControlClient.hasComplicationCache , предназначенный для OEM -производителей. Это может повлиять на стратегию системы посылать осложнения на лицо. Кроме того, ComplicationData обладает isCached свойством, и рекомендуется, чтобы кэшированные осложнения были представлены по -разному, потому что tapAction не может быть кэширована и будет null в кэшированном осложнении. ( I404b0 )
  • Идентификатор экземпляра часового лица теперь доступен через WatchState.watchFaceInstanceId . Большинству часов для часов не нужно использовать это, но если есть состояние лица, которое не хранится в схеме, то это ключ для идентификации экземпляра лица. Чтобы поддержать это, теперь вы можете предоставить идентификатор при вызове WatchFaceControlClient.createHeadlessWatchFaceClient . ( I1ff98 )
  • Расширенная DefaultComplicationDataSourcePolicy с возможностью установить ComplicationTypes по умолчанию для первичного, вторичного поставщика и поставщика запасной системы. ComplicationSlot.defaultDataSourceType . ( If0ce3 )
  • ComplicationSlot.configExtras . EditorSession.openComplicationDataSourceChooser() I6f852 )
  • Добавлен WatchFace.setComplicationDeniedDialogIntent и setComplicationRationaleDialogIntent . Эти намерения запускаются, чтобы показать диалог обоснования, прежде чем запросить разрешения на осложнения, и еще один диалог, объясняющий, что разрешение на осложнение необходимо при попытке отредактировать осложнение, когда были отказаны в разрешениях (выбор поставщика не может открыться, поэтому диалог необходим). ( I3a29c )
  • UserStyleSchema и ComplicationSlots теперь могут быть определены в XML. Это упрощает строительство лица и делает запросы WatchFaceMetadataClient быстрее, поскольку им не нужно связывать службу, чтобы получить метаданные. ( I85BFA )
  • Добавлен InteractiveWatchFaceClient.supportsPendingIntentForTouchEvent , чтобы клиент мог определить, поддерживает ли часы getPendingIntentForTouchEvent . ( I0b917 )
  • WatchFaceMetadataClient и ListenableWatchFaceMetadataClient больше не экспериментальны. Они могут быть использованы для эффективного получения метаданных лица, где это возможно, не открывая переплет на лицо. ( IBB827 )
  • Добавлена ​​поддержка поставщиков синхронных осложнений, где осложнение обновляется на более высокой частоте, чем обычно, до одного раза в секунду, когда лицо часового лица видно и не амбициозно. Чтобы использовать это, поставщик должен включить новый androidx.wear.watchface.complications.data.source.SYNCHRONOUS_UPDATE_PERIOD_SECONDS Metadata Metadata в его манифесте и переоценивает onSynchronousComplicationRequest . В зависимости от характера источника данных, ему также может потребоваться переопределить onStartSynchronousComplicationRequests и onStopInteractiveComplicationRequests , чтобы получить уведомления о том, когда осложнение входит и выходит из интерактивного режима. ( I8fe9d )

Версия 1.0

Версия 1.0.1

9 февраля 2022 года

androidx.wear.watchface:watchface-*:1.0.1 выпускается. Версия 1.0.1 содержит эти коммиты.

Исправления ошибок

  • Исправляет ошибку с помощью PhotoImageComplicationData Tapaction неправильно обрабатывается ( I1CC30 )

Версия 1.0.0

1 декабря 2021 года

androidx.wear.watchface:watchface-*:1.0.0 выпускается. Версия 1.0.0 содержит эти коммиты.

Основные особенности 1.0.0

Пакет androidx.wear.watchface - это новая рекомендуемая библиотека для разработки лиц Wearos Watch. Он имеет ряд новых функций над старой носимой библиотекой поддержки.

  • Стиль пользователя (например, чтобы изменить цветовую палитру, стиль рук часов, внешний вид часовых отметок и т. Д.) Прямо поддерживается библиотекой (см. androidx.wear.watchface.style ). Теперь гораздо проще разработать редактор ON Watch Face с использованием Androidx.wear.watchface.editor, и ваше лицо для часов можно отредактировать из приложения Companion System без необходимости написать дополнительный код.
  • Лучшие практики запекаются. Библиотека автоматически сгенерировала метки контента считывателя экрана для осложнений (вы также можете добавить свои собственные), и кадрирование автоматически падает, когда батарея низкая и не заряжается для улучшения времени батареи.
  • Для разработки часового лица требуется меньше кода, особенно для осложнений, когда большая часть шаблона перешла в библиотеку.

Исправления ошибок

  • Fix EditorSession.userStyle.compareAndSet ( i6f676 )
  • Исправьте очень короткие задержки для лица ( IFFB97 )
  • Dispatch InteractiveWatchFaceImpl.onDestroy в потоке пользовательского интерфейса ( I83340 )
  • Исправьте несколько проблем с приемниками вещания ( i7d25f )

Версия 1.0.0-RC01

3 ноября 2021 года

androidx.wear.watchface:watchface-*:1.0.0-rc01 выпускается. Версия 1.0.0-RC01 содержит эти коммиты.

Исправления ошибок

  • Fix Dump () (называется ADB Shell Dampsys), которые были разбиты миграциями потока. ( 087cf9e )

  • Убедитесь, что надлежащий заказ wriedirectbootprefs. Мы хотим, чтобы wriTedirectbootprefs всегда работали после initstylaindcomplications или мы рискуем задержать поток пользовательского интерфейса ( 37650AC )

  • Убедитесь, что renderer.ondestroy называется. В сценарии, в котором был создан рендерера, но WF init не завершен и двигатель. ( F9952DC )

  • Оптимизация/исправление на iSbatterylowandNot зарядку. Этот патч перемещает первоначальную настройку IsbatterylowandNoTcaring ранее, что означает, что его можно сделать параллельно с CreateWatchface. Кроме того, теперь мы слушаем action_power_disconnected. ( DDFFD80

  • InteractiveWatchfaceClientImpl.isconnectionalive быть ложным после закрытия ( AB9774E )

Версия 1.0.0-бета01

27 октября 2021 года

androidx.wear.watchface:watchface-*:1.0.0-beta01 выпускается. Версия 1.0.0-BETA01 содержит эти коммиты.

Версия 1.0.0-Alpha24

13 октября 2021 года

androidx.wear.watchface:watchface-*:1.0.0-alpha24 выпускается. Версия 1.0.0-Alpha24 содержит эти коммиты.

API меняется

  • Занятия в пакете androidx.wear.watchface.complications были перемещены в новый проект wear:watchface:watchface-complications . Примечание это означает, что вы не можете включить эту библиотеку, а также любую предыдущую альфа-версию wear:watchface:watchface-complications-data потому что вы получите ошибки в дублирующих классах. ( I97195 )
  • Renderer.dump был переименован в рендерер. Andump и был аннотирован с @uithread. ( I44845 )
  • InteractiveWatchFaceClient.addWatchFaceReadyListener был переименован в addOnWatchFaceReadyListener , и removeWatchFaceReadyListener был переименован в removeOnWatchFaceReadyListener . ( I48fea )
  • Editorsessession getComplicationsPreviewData и getComplicationsDataSourceInfo больше не приостанавливают функции, вместо этого они являются свойствами StateFlow<> значение которого изначально является нулевым. В прослушивании getListenableComplicationPreviewData и getListenableComplicationsProviderInfo были удалены в пользу новых объектов StateFlow<> из базового класса. Если вам нужно прослушать изменения в коде Java, рассмотрите возможность использования androidx.lifecycle.FlowLiveDataConversions.asLiveData для преобразования в LiveData<> . ( IC5483 )

Версия 1.0.0-Alpha23

29 сентября 2021 года

androidx.wear.watchface:watchface-*:1.0.0-alpha23 выпускается. Версия 1.0.0-Alpha23 содержит эти коммиты.

Новые возможности

Библиотека Watchface теперь является отдельной библиотечной группой, и в результате библиотеки переместились, и вам нужно будет обновить свой импорт Gradle следующим образом:

Старый Новый
androidx.wear:wear-complications-data androidx.wear.watchface:watchface-complications-data
androidx.wear:wear-complications-data-source androidx.wear.watchface:watchface-complications-data-source
androidx.wear:wear-watchface androidx.wear.watchface:watchface
androidx.wear:wear-watchface-complications-rendering androidx.wear.watchface:watchface-complications-rendering
androidx.wear:wear-watchface-client androidx.wear.watchface:watchface-client
androidx.wear:wear-watchface-client-guava androidx.wear.watchface:watchface-client-guava
androidx.wear:wear-watchface-data androidx.wear.watchface:watchface-data
androidx.wear:wear-watchface-editor androidx.wear.watchface:watchface-editor
androidx.wear:wear-watchface-editor-guava androidx.wear.watchface:watchface-editor-guava
androidx.wear:wear-watchface-guava androidx.wear.watchface:watchface-guava
androidx.wear:wear-watchface-style androidx.wear.watchface:watchface-style

API меняется

  • Перенесите отдельные библиотеки androidx.wear Watchface и осложнений в группу библиотеки androidx.wear.watchface . ( B25F3C0 )
  • Добавлен EditorRequest.CanWatchfacesUpporTheadlessEditing, чтобы клиент знал, поддерживает ли редактор Watchface редактирование без головы. Обратите внимание, что с этим будут некоторые ложные негативы, потому что поддержка была добавлена ​​в ASOP/1756809, однако она вернет правильное значение для всех будущих часов. ( CA55590 )
  • У Renderer теперь есть метод дампа (), который может быть переопределен, чтобы добавить пользовательские данные в информацию, генерируемую ABD Shell Dampsys Service Service Service Service. ( 95235F9 )
  • InteractiveWatchfaceclient.AddwatchfaCeReadeDyListener теперь сначала указывает исполнителя. ( 563AC2F )
  • StateFlowCompathelper был удален. Asilivedata (androidx.lifecycle.aslivedata) следует использовать вместо этого. ( BD35D3 )
  • CurrentUserStyLeRePository.UsersTyle больше не изменяется. ( I44889 )
  • WatchfacereadyListener был переименован в OnwatchfacereadyListener. ( IC12A9 )

Исправления ошибок

  • InteractiveInstanceManager.DeleteInstance для вызова Ondestroy Это необходимо для обеспечения того, чтобы InteractiveWatchfaceImpl собрал мусор. ( FCE4AF8 , B/199485839 )