Glance Wear

  
Glance Wear es una biblioteca para compilar widgets para Wear OS
Actualización más reciente Versión estable Versión potencial Versión beta Versión alfa
23 de septiembre de 2026 - - - 1.0.0-alpha19

Cómo declarar dependencias

Para agregar una dependencia en glance-wear, debes agregar el repositorio de Maven de Google a tu proyecto. Consulta el repositorio de Maven de Google para obtener más información.

Agrega las dependencias de los artefactos que necesites en el archivo build.gradle de tu app o módulo:

Groovy

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

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

Kotlin

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

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

Para obtener más información sobre las dependencias, consulta Cómo agregar dependencias de compilación.

Comentarios

Tus comentarios ayudan a mejorar Jetpack. Avísanos si descubres nuevos errores o tienes ideas para mejorar esta biblioteca. Consulta los errores existentes de esta biblioteca antes de crear uno nuevo. Puedes agregar tu voto a un error existente haciendo clic en el botón de la estrella.

Crear un error nuevo

Consulta la documentación sobre la herramienta Issue Tracker para obtener más información.

Wear Glance versión 1.0

Versión 1.0.0-alpha19

23 de septiembre de 2026

Lanzamiento de androidx.glance.wear:wear:1.0.0-alpha19, androidx.glance.wear:wear-core:1.0.0-alpha19 y androidx.glance.wear:wear-tooling-preview:1.0.0-alpha19. La versión 1.0.0-alpha19 contiene estas confirmaciones.

Solo se realizan cambios en las pruebas internas.

Versión 1.0.0-alpha18

9 de septiembre de 2026

Lanzamiento de androidx.glance.wear:wear:1.0.0-alpha18, androidx.glance.wear:wear-core:1.0.0-alpha18 y androidx.glance.wear:wear-tooling-preview:1.0.0-alpha18. La versión 1.0.0-alpha18 contiene estas confirmaciones.

Cambios en la API

  • Se agregó el parámetro useSafeFallbackRendererVersion a WearWidgetPreview para permitir la vista previa de widgets con un conjunto seguro de operaciones admitidas para hosts más antiguos. (I9c324)

Correcciones de errores

  • compileSdk para las bibliotecas de Compose actualizadas a la versión 37.1. Esto requerirá la actualización transitiva de compileSdk para todas las apps y bibliotecas que usen Compose. (I05b0f)
  • Se agregó una comprobación de lint para advertir sobre el uso redundante del parámetro fontFamily en los widgets para Wear. (I7730c)

Versión 1.0.0-alpha17

26 de agosto de 2026

Lanzamiento de androidx.glance.wear:wear:1.0.0-alpha17, androidx.glance.wear:wear-core:1.0.0-alpha17 y androidx.glance.wear:wear-tooling-preview:1.0.0-alpha17. La versión 1.0.0-alpha17 contiene estas confirmaciones.

Nuevas funciones

  • Se agregaron verificaciones de lint en Glance Wear para aplicar que cada <container> en un archivo XML de <wearwidget-provider> para metadatos de widgets especifique de forma explícita un atributo de tipo que sea compatible y no defina tipos duplicados. (I52c9a, b/464458215)

Versión 1.0.0-alpha16

12 de agosto de 2026

Lanzamiento de androidx.glance.wear:wear:1.0.0-alpha16, androidx.glance.wear:wear-core:1.0.0-alpha16 y androidx.glance.wear:wear-tooling-preview:1.0.0-alpha16. La versión 1.0.0-alpha16 contiene estas confirmaciones.

Nuevas funciones

  • Se agregó la validación de Lint para los metadatos XML de <wearwidget-provider> para garantizar que estén presentes los elementos de configuración obligatorios (como container y previewImage). (Ia9983, b/464458215)
  • Se agregó una advertencia de error de Lint para configurar un fondo negro o transparente en un widget de Wear (Idedb0, b/529269573).
  • Se habilitó la operación CORE_TEXT Remote Compose para el perfil de Wear Widgets. Esto permite que RemoteText use funciones de fuentes variables, como ejes de fuentes, alturas de línea, etcétera, en renderizadores de host compatibles, con una alternativa automática cuando no se admite.

Correcciones

  • Se actualizaron los KDocs para la anotación AssociateWithGlanceWearWidget según los comentarios de los desarrolladores.

Versión 1.0.0-alpha15

29 de julio de 2026

Lanzamiento de androidx.glance.wear:wear:1.0.0-alpha15, androidx.glance.wear:wear-core:1.0.0-alpha15 y androidx.glance.wear:wear-tooling-preview:1.0.0-alpha15. La versión 1.0.0-alpha15 contiene estas confirmaciones.

Nuevas funciones

  • Se agregó una advertencia de Lint cuando se establece un fondo vacío en el documento del widget para Wear. (Ic6475, b/529269573)

Versión 1.0.0-alpha14

15 de julio de 2026

Lanzamiento de androidx.glance.wear:wear:1.0.0-alpha14, androidx.glance.wear:wear-core:1.0.0-alpha14 y androidx.glance.wear:wear-tooling-preview:1.0.0-alpha14. La versión 1.0.0-alpha14 contiene estas confirmaciones.

Cambios en la API

  • Agregamos proveedores de parámetros de vista previa RoundAllWidgetPreviewParams, RoundSmallWidgetPreviewParams y RoundLargeWidgetPreviewParams para widgets de Wear de Glance completamente redondeados. (If5336, b/512405233)

Nuevas funciones

  • Configuramos y agregamos la biblioteca de Linter para los widgets de Glance Wear (If4218, b/527402079).
    • Se agregó una verificación de lint para garantizar que las subclases de GlanceWearWidgetService declaren de forma explícita su clase de widget asociada con la anotación @AssociateWithGlanceWearWidget. (Idc575, b/477024153)
  • Mejoramos la compatibilidad con versiones anteriores para los widgets que se ejecutan en Hosts más antiguos propagando las operaciones admitidas a través de WearWidgetParams y agregando el filtrado del perfil de operaciones permitidas a esas. (Ib0a1b, I83cb1, [b/526716195])

Versión 1.0.0-alpha13

1 de julio de 2026

Lanzamiento de androidx.glance.wear:wear:1.0.0-alpha13, androidx.glance.wear:wear-core:1.0.0-alpha13 y androidx.glance.wear:wear-tooling-preview:1.0.0-alpha13. La versión 1.0.0-alpha13 contiene estas confirmaciones.

Cambios en la API

Correcciones de errores

  • Ajustamos los parámetros del widget de Wear con forma de squircle para la vista previa según los comentarios de UX

Versión 1.0.0-alpha12

17 de junio de 2026

Lanzamiento de androidx.glance.wear:wear:1.0.0-alpha12, androidx.glance.wear:wear-core:1.0.0-alpha12 y androidx.glance.wear:wear-tooling-preview:1.0.0-alpha12. La versión 1.0.0-alpha12 contiene estas confirmaciones.

Nuevas funciones

  • Se agregó AssociateWithGlanceWearWidget que se debe usar en GlanceWearWidgetService para indicar con qué implementación de GlanceWearWidget está asociado. (Ifcabb, b/514679763)

    • Por ejemplo:
     @AssociateWithGlanceWearWidget(MyGlanceWearWidget::class)
 class MyGlanceWearWidgetService : GlanceWearWidgetService() {
   override val widget = MyGlanceWearWidget()
 }
 ```

  • Agregamos el pincel image a WearWidgetBrush para admitir fondos de mapa de bits en los widgets de Wear. (I9a228, b/513481558)

  • Presentamos una función auxiliar @Composable, WearWidgetPreview, para simplificar el desarrollo de widgets de Glance Wear quitando el código estándar necesario para las vistas previas del IDE.

Cambios en la API

  • Se cambió el nombre de androidx.glance.wear.health.DataType a androidx.glance.wear.health.HealthData (I4cb0b, b/516746689).
  • Se expone isHeartRateBpmAvailable para determinar si heartRateBpm está disponible en el host. (I5999d, b/514641567)
  • Se exponen los operadores de comparación RemoteInt. (I5fe3d, b/513228889)
  • Se expusieron la API de Flow captureRemoteDocument y una nueva sobrecarga de captureSingleRemoteDocument (que toma RemoteCreationDisplayInfo) como APIs públicas. (I87b0e, b/513228889)
  • Se agregó @CallSuper a los métodos del ciclo de vida de GlanceWearWidgetService

Versión 1.0.0-alpha11

3 de junio de 2026

Lanzamiento de androidx.glance.wear:wear:1.0.0-alpha11, androidx.glance.wear:wear-core:1.0.0-alpha11 y androidx.glance.wear:wear-tooling-preview:1.0.0-alpha11. La versión 1.0.0-alpha11 contiene estas confirmaciones.

Cambios en la API

  • Agregamos WearWidgetPreview para obtener una vista previa de los Wear Widgets en Android Studio. (I36504, b/485147770)
  • Expón las variables is*Available (isDailyStepsAvailable, etc.) para verificar si el tipo de datos de salud relacionado está disponible y es válido. (Ib98a7, b/498179656)
  • Se agregó la API de triggerUpdateAll a GlanceWearWidget para activar la actualización en todos los widgets de la app determinada. (I6ab20, b/510896410)

Correcciones de errores

  • Se incluye información de la versión del renderizador en WearWidgetParams como campo interno para evitar interrupciones en el documento generado con la versión alpha10. (Idcf8e, b/511263591, b/512830184)
  • Activa el flujo de actualización forzada en el modo de depuración o en el emulador para los widgets de Wear.

Versión 1.0.0-alpha10

19 de mayo de 2026

Lanzamiento de androidx.glance.wear:wear:1.0.0-alpha10, androidx.glance.wear:wear-core:1.0.0-alpha10 y androidx.glance.wear:wear-tooling-preview:1.0.0-alpha10. La versión 1.0.0-alpha10 contiene estas confirmaciones.

Cambios en la API

  • Se exponen las APIs de glance.wear.health.DataType en el widget de Wear. Los desarrolladores pueden usar estas APIs para acceder a los datos de estado del sistema.

Correcciones de errores

  • Se corrigió un bucle de fallas que ocurría en la versión alpha09 en el emulador de Wear 7 o en dispositivos que ejecutan el renderizador 1.6, ya que no se permite que se envíe un eje de fuente vacío al reproductor para el widget de Wear de Glance.

Versión 1.0.0-alpha09

6 de mayo de 2026

Lanzamiento de androidx.glance.wear:wear:1.0.0-alpha09 y androidx.glance.wear:wear-core:1.0.0-alpha09. La versión 1.0.0-alpha09 contiene estas confirmaciones.

Cambios en la API

  • Agregamos ExperimentalGlanceWearApi, que se usará para las funciones experimentales de Wear de la función de Resumen. (Id2f76, b/498179813)

Correcciones de errores

  • Se actualizó el analizador de metadatos XML de widgets para Wear para que tenga en cuenta los widgets durante el arranque.

Versión 1.0.0-alpha08

22 de abril de 2026

Lanzamiento de androidx.glance.wear:wear:1.0.0-alpha08 y androidx.glance.wear:wear-core:1.0.0-alpha08. La versión 1.0.0-alpha08 contiene estas confirmaciones.

Correcciones de errores

  • Se agregó la etiqueta <queries> al manifiesto de la biblioteca glance:wear:wear para garantizar que PackageManager consulte los servicios correctos para las actualizaciones push. (I192787)

Otro

  • Se revirtió "Se actualiza compileSdk de Compose a 37" (I6007), que también se aplica a glance-wear, por lo que el requisito de compileSdk ya no es 37 en esta versión.

Versión 1.0.0-alpha07

8 de abril de 2026

Lanzamiento de androidx.glance.wear:wear:1.0.0-alpha07 y androidx.glance.wear:wear-core:1.0.0-alpha07. La versión 1.0.0-alpha07 contiene estas confirmaciones.

Nuevas funciones

  • Se agregó un fondo predeterminado para el widget de Wear cuando WearWidgetBrush está vacío o no se especifica. (I8300b)
  • Se actualizó la API de getActiveWidgets para que devuelva el tipo de contenedor del widget. (2772eb1)

Cambios en la API

  • Se actualizó la API de Change Widget para que tome WidgetInstanceId y se agregó un asistente para recuperar IDs de un widget determinado. La nueva API arroja IllegalArgumentException si el ID proporcionado no es válido o no pertenece al llamador. (I6f3c5, b/446828899)
  • Agrega un gradiente vertical y horizontal en WearWidgetBrush. (If70ae, b/470080675)

Versión 1.0.0-alpha06

25 de marzo de 2026

Lanzamiento de androidx.glance.wear:wear:1.0.0-alpha06 y androidx.glance.wear:wear-core:1.0.0-alpha06. La versión 1.0.0-alpha06 contiene estas confirmaciones.

Nuevas funciones

  • Define las operaciones para el perfil de Wear Widgets de forma intercalada.

Cambios en la API

  • Cambiamos el nombre de CONTAINER_TYPE_FULLSCREEN a CONTAINER_TYPE_TILE_COMPAT para diferenciar mejor el widget de compatibilidad con pantalla completa. Esto incluye revertir la asignación del tipo FULLSCREEN anterior a LARGE en los parámetros del widget.

Versión 1.0.0-alpha05

11 de marzo de 2026

Lanzamiento de androidx.glance.wear:wear:1.0.0-alpha05 y androidx.glance.wear:wear-core:1.0.0-alpha05. La versión 1.0.0-alpha05 contiene estas confirmaciones.

Cambios en la API

  • Agregamos la API de WearWidgetBrush con el método color para usarlo en el fondo del widget de Wear. (I66f54, b/464273091)
  • Se quitó el método fetchActiveWidgetsForProvider, ya que ya existe fetchActiveWidgets. (I85e4e, b/486197890)

Versión 1.0.0-alpha04

25 de febrero de 2026

Lanzamiento de androidx.glance.wear:wear:1.0.0-alpha04 y androidx.glance.wear:wear-core:1.0.0-alpha04. La versión 1.0.0-alpha04 contiene estas confirmaciones.

Cambios en la API

  • Se agregó la API de GlanceWearWidgetManager para permitir que las apps consulten sus widgets y tarjetas activos. (I5be95)
  • Trasladamos las APIs de la biblioteca glance:wear:wear-core al paquete androidx.glance.wear.core. (I429cf)

Correcciones de errores

  • Se exponen tipos comunes de Modifier y Remote Composable (Id1d40).

Versión 1.0.0-alpha03

11 de febrero de 2026

Lanzamiento de androidx.glance.wear:wear:1.0.0-alpha03 y androidx.glance.wear:wear-core:1.0.0-alpha03. La versión 1.0.0-alpha03 contiene estas confirmaciones.

Cambios en la API

  • Se agregó compatibilidad con los eventos de interacción a GlanceWearWidget. (Ia4e28, b/469808447)

Versión 1.0.0-alpha02

28 de enero de 2026

Lanzamiento de androidx.glance.wear:wear:1.0.0-alpha02 y androidx.glance.wear:wear-core:1.0.0-alpha02. La versión 1.0.0-alpha02 contiene estas confirmaciones.

Nuevas funciones

  • Se volvió a asignar FULLSCREEN a LARGE en los parámetros de Widget (ad78d95).

Correcciones de errores

  • Se corrigió el uso de DataStore que impedía que se mostraran varias instancias de widgets (474f3e4).

Versión 1.0.0-alpha01

14 de enero de 2026

Lanzamiento de androidx.glance.wear:wear:1.0.0-alpha01 y androidx.glance.wear:wear-core:1.0.0-alpha01. La versión 1.0.0-alpha01 contiene estas confirmaciones.

  • Glance Wear es una biblioteca para compilar widgets para Wear OS con RemoteCompose.