Glance Wear

  
Glance Wear – это библиотека для создания виджетов для Wear OS
Последнее обновление Основная версия Release Candidate Бета-версия Альфа-версия
7 октября 2026 г. - - - 1.0.0-alpha20

Как объявлять зависимости

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

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

Яркий

dependencies {
    implementation "androidx.glance.wear:wear:1.0.0-alpha20"

    implementation "androidx.glance.wear:wear-core:1.0.0-alpha20"
}

Kotlin

dependencies {
    implementation("androidx.glance.wear:wear:1.0.0-alpha20")

    implementation("androidx.glance.wear:wear-core:1.0.0-alpha20")
}

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

Отзыв

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

Как создать новую проблему

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

Glance Wear версии 1.0

Версия 1.0.0-alpha20

7 октября 2026 г.

androidx.glance.wear:wear:1.0.0-alpha20, androidx.glance.wear:wear-core:1.0.0-alpha20 и androidx.glance.wear:wear-tooling-preview:1.0.0-alpha20. Версия 1.0.0-alpha20 содержит эти коммиты.

Изменения в API

  • В класс GlanceWearWidget добавлены константы CATEGORY_PROVIDER_CONFIG, EXTRA_CONFIG_WIDGET_ID и EXTRA_CONFIG_PROVIDER_COMPONENT для обработки намерений конфигурации поставщика виджетов. (I32fa4)
  • Параметр useSafeFallbackRendererVersion в WearWidgetPreview переименован в useBaselineHostVersion. (I07bca)

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

  • Исправлены обновления виджетов в эмуляторе панели виджетов при вызове triggerUpdateAll в отладочных сборках. (I22d3f)
  • Изменено значение по умолчанию для useSafeFallbackRendererVersion в WearWidgetPreview с true на false, чтобы при предварительном просмотре по умолчанию использовалась последняя версия средства визуализации. (Ied6b9)

Версия 1.0.0-alpha19

23 сентября 2026 г.

androidx.glance.wear:wear:1.0.0-alpha19, androidx.glance.wear:wear-core:1.0.0-alpha19 и androidx.glance.wear:wear-tooling-preview:1.0.0-alpha19. Версия 1.0.0-alpha19 содержит эти коммиты.

Изменения только для внутреннего тестирования.

Версия 1.0.0-alpha18

9 сентября 2026 г.

androidx.glance.wear:wear:1.0.0-alpha18, androidx.glance.wear:wear-core:1.0.0-alpha18 и androidx.glance.wear:wear-tooling-preview:1.0.0-alpha18. Версия 1.0.0-alpha18 содержит эти коммиты.

Изменения в API

  • В параметр WearWidgetPreview добавлен параметр useSafeFallbackRendererVersion, чтобы можно было просматривать виджеты с безопасным резервным набором поддерживаемых операций для более старых хостов. (I9c324)

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

  • compileSdk для библиотек Compose обновлены до версии 37.1. Это потребует транзитивного обновления compileSdk для всех приложений и библиотек, использующих Compose. (I05b0f)
  • Добавлена проверка lint, которая предупреждает о лишнем использовании параметра fontFamily в виджетах Wear. (I7730c)

Версия 1.0.0-alpha17

26 августа 2026 г.

androidx.glance.wear:wear:1.0.0-alpha17, androidx.glance.wear:wear-core:1.0.0-alpha17 и androidx.glance.wear:wear-tooling-preview:1.0.0-alpha17. Версия 1.0.0-alpha17 содержит эти коммиты.

Новые функции

  • В Glance Wear добавлены проверки lint, чтобы убедиться, что каждый элемент <container> в файле <wearwidget-provider> XML для метаданных виджета явно указывает поддерживаемый атрибут типа и не определяет дублирующиеся типы. (I52c9a, b/464458215)

Версия 1.0.0-alpha16

12 августа 2026 г.

androidx.glance.wear:wear:1.0.0-alpha16, androidx.glance.wear:wear-core:1.0.0-alpha16 и androidx.glance.wear:wear-tooling-preview:1.0.0-alpha16. Версия 1.0.0-alpha16 содержит эти коммиты.

Новые функции

  • Добавлена проверка Lint для метаданных XML <wearwidget-provider>, чтобы убедиться в наличии необходимых элементов конфигурации (например, container и previewImage). (Ia9983, b/464458215)
  • Добавлено предупреждение об ошибке Lint при установке черного или прозрачного фона для виджета Wear (Idedb0, b/529269573).
  • Включена удаленная операция создания писем CORE_TEXT для профиля виджетов Wear. Это позволяет RemoteText использовать функции шрифтов с переменной шириной, такие как оси шрифтов, высоту строк и т. д., в поддерживаемых хост-рендерах с автоматическим переходом на резервный вариант, если функция не поддерживается.

Исправления

  • Обновлена документация KDocs для аннотации AssociateWithGlanceWearWidget на основе отзывов разработчиков

Версия 1.0.0-alpha15

29 июля 2026 г.

androidx.glance.wear:wear:1.0.0-alpha15, androidx.glance.wear:wear-core:1.0.0-alpha15 и androidx.glance.wear:wear-tooling-preview:1.0.0-alpha15. Версия 1.0.0-alpha15 содержит эти коммиты.

Новые функции

  • Добавлено предупреждение Lint при установке пустого фона для документа Wear Widget. (Ic6475, b/529269573)

Версия 1.0.0-alpha14

15 июля 2026 г.

androidx.glance.wear:wear:1.0.0-alpha14, androidx.glance.wear:wear-core:1.0.0-alpha14 и androidx.glance.wear:wear-tooling-preview:1.0.0-alpha14. Версия 1.0.0-alpha14 содержит эти коммиты.

Изменения в API

  • Мы добавили поставщиков параметров предварительного просмотра RoundAllWidgetPreviewParams, RoundSmallWidgetPreviewParams и RoundLargeWidgetPreviewParams для виджетов Glance Wear. (If5336, b/512405233)

Новые функции

  • Мы настроили и добавили библиотеку Linter для виджетов Glance Wear.(If4218, b/527402079)
    • Добавлена проверка lint, чтобы убедиться, что подклассы GlanceWearWidgetService явно объявляют связанный класс виджета с помощью аннотации @AssociateWithGlanceWearWidget. (Idc575, b/477024153)
  • Мы улучшили обратную совместимость для виджетов, работающих на более старых хостах, путем распространения поддерживаемых операций через WearWidgetParams и добавления фильтрации профиля разрешенных операций к ним. (Ib0a1b, I83cb1, [b/526716195])

Версия 1.0.0-alpha13

1 июля 2026 г.

androidx.glance.wear:wear:1.0.0-alpha13, androidx.glance.wear:wear-core:1.0.0-alpha13 и androidx.glance.wear:wear-tooling-preview:1.0.0-alpha13. Версия 1.0.0-alpha13 содержит эти коммиты.

Изменения в API

  • Удалена проверка разрешений из heartRateAccuracy (I14269, b/522444636)

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

  • Мы изменили параметры виджета Wear в форме скругленного квадрата для предварительного просмотра на основе отзывов пользователей.

Версия 1.0.0-alpha12

17 июня 2026 г.

androidx.glance.wear:wear:1.0.0-alpha12, androidx.glance.wear:wear-core:1.0.0-alpha12 и androidx.glance.wear:wear-tooling-preview:1.0.0-alpha12. Версия 1.0.0-alpha12 содержит эти коммиты.

Новые функции

  • Добавлен AssociateWithGlanceWearWidget, который должен использоваться в GlanceWearWidgetService, чтобы указать, с какой реализацией GlanceWearWidget он связан. (Ifcabb, b/514679763)

    • Пример:
     @AssociateWithGlanceWearWidget(MyGlanceWearWidget::class)
 class MyGlanceWearWidgetService : GlanceWearWidgetService() {
   override val widget = MyGlanceWearWidget()
 }
 ```

  • Мы добавили кисть image в WearWidgetBrush, чтобы поддерживать фоны на основе растровых изображений в виджетах Wear. (I9a228, b/513481558)

  • Мы добавили вспомогательную функцию @Composable, WearWidgetPreview, чтобы упростить разработку виджетов Glance Wear, удалив стандартный код, необходимый для предварительного просмотра в IDE.

Изменения в API

  • Переименовано androidx.glance.wear.health.DataType в androidx.glance.wear.health.HealthData (I4cb0b, b/516746689)
  • isHeartRateBpmAvailable используется, чтобы определить, доступен ли heartRateBpm на хосте. (I5999d, b/514641567)
  • Добавлены операторы сравнения RemoteInt. (I5fe3d, b/513228889)
  • Общедоступными API стали Exposed captureRemoteDocument Flow API и новая перегрузка captureSingleRemoteDocument (принимающая RemoteCreationDisplayInfo). (I87b0e, b/513228889)
  • Мы добавили метод @CallSuper в жизненный цикл GlanceWearWidgetService

Версия 1.0.0-alpha11

3 июня 2026 г.

androidx.glance.wear:wear:1.0.0-alpha11, androidx.glance.wear:wear-core:1.0.0-alpha11 и androidx.glance.wear:wear-tooling-preview:1.0.0-alpha11. Версия 1.0.0-alpha11 содержит эти коммиты.

Изменения в API

  • Мы добавили WearWidgetPreview для предпросмотра виджетов Wear OS в Android Studio. (I36504, b/485147770)
  • Предоставлять доступ к переменным is*Available (isDailyStepsAvailable и т. д.), чтобы проверить, доступны ли и действительны ли связанные типы данных о здоровье. (Ib98a7, b/498179656)
  • В GlanceWearWidget добавлен API triggerUpdateAll, который позволяет запускать обновление всех виджетов определенного приложения. (I6ab20, b/510896410)

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

  • Добавьте информацию о версии отрисовщика в WearWidgetParams в качестве внутреннего поля, чтобы избежать ошибок в документе, созданном с помощью версии alpha10. (Idcf8e, b/511263591, b/512830184)
  • Запускайте принудительное обновление в режиме отладки или эмуляторе для виджетов Wear.

Версия 1.0.0-alpha10

19 мая 2026 г.

androidx.glance.wear:wear:1.0.0-alpha10, androidx.glance.wear:wear-core:1.0.0-alpha10 и androidx.glance.wear:wear-tooling-preview:1.0.0-alpha10. Версия 1.0.0-alpha10 содержит эти коммиты.

Изменения в API

  • Предоставьте доступ к API glance.wear.health.DataType в виджете Wear. Разработчики могут использовать эти API для доступа к данным о состоянии системы.

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

  • Исправлена циклическая ошибка, возникавшая в версии alpha09 на эмуляторе Wear 7 или устройствах с рендерером 1.6, из-за того что в проигрыватель для виджета "Самое главное" на устройстве Wear отправлялась пустая ось шрифта.

Версия 1.0.0-alpha09

6 мая 2026 г.

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

Изменения в API

  • Мы добавили ExperimentalGlanceWearApi, который будет использоваться для экспериментальных функций Glance Wear. (Id2f76, b/498179813)

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

  • Обновлен парсер метаданных XML для виджетов Wear, чтобы он распознавал виджеты во время загрузки.

Версия 1.0.0-alpha08

22 апреля 2026 г.

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

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

  • В манифест библиотеки glance:wear:wear добавлен тег <queries>, чтобы запросы PackageManager отправлялись в нужные сервисы для получения push-уведомлений. (I192787)

Другое

  • Отменено изменение "Обновляет compileSdk Compose до 37" (I6007), которое также применяется к glance-wear, поэтому в этой версии требование compileSdk больше не равно 37.

Версия 1.0.0-alpha07

8 апреля 2026 г.

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

Новые функции

  • Добавьте фон виджета Wear по умолчанию, если WearWidgetBrush пуст или не указан. (I8300b)
  • Обновление getActiveWidgets API, чтобы возвращать тип контейнера виджета. (2772eb1)

Изменения в API

  • Изменен API обновления виджета, чтобы принимать WidgetInstanceId, и добавлен вспомогательный метод для получения идентификаторов виджета. Новый API возвращает значение IllegalArgumentException, если предоставленный идентификатор недействителен или не принадлежит вызывающему объекту. (I6f3c5, b/446828899)
  • Добавьте вертикальный и горизонтальный градиент в WearWidgetBrush. (If70ae, b/470080675)

Версия 1.0.0-alpha06

25 марта 2026 г.

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

Новые функции

  • Определите операции для встроенного профиля виджетов Wear.

Изменения в API

  • Мы переименовали CONTAINER_TYPE_FULLSCREEN в CONTAINER_TYPE_TILE_COMPAT, чтобы лучше различать виджет совместимости с полноэкранным режимом. В частности, в параметрах виджета тип FULLSCREEN будет заменен на LARGE.

Версия 1.0.0-alpha05

11 марта 2026 г.

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

Изменения в API

  • Мы добавили WearWidgetBrushAPI с методом color, который можно использовать для фона виджета Wear. (I66f54, b/464273091)
  • Метод fetchActiveWidgetsForProvider удален, так как уже есть метод fetchActiveWidgets. (I85e4e, b/486197890)

Версия 1.0.0-alpha04

25 февраля 2026 г.

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

Изменения в API

  • Добавлен API GlanceWearWidgetManager, позволяющий приложениям запрашивать активные виджеты и плитки. (I5be95)
  • Мы перенесли API из библиотеки glance:wear:wear-core в пакет androidx.glance.wear.core. (I429cf)

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

  • Добавлены распространенные типы Remote Composable и Modifier (Id1d40)

Версия 1.0.0-alpha03

11 февраля 2026 г.

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

Изменения в API

  • Добавлена поддержка событий взаимодействия в GlanceWearWidget. (Ia4e28, b/469808447)

Версия 1.0.0-alpha02

28 января 2026 г.

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

Новые функции

  • Изменение параметра FULLSCREEN на LARGE в параметрах виджета (ad78d95)

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

  • Исправлено использование DataStore, из-за которого не могли показываться несколько экземпляров виджета (474f3e4).

Версия 1.0.0-alpha01

14 января 2026 г.

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

  • Glance Wear – это библиотека для создания виджетов для Wear OS с помощью RemoteCompose.