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
9 de septiembre de 2026 - - - 1.0.0-alpha18

Cómo declarar dependencias

Si deseas 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-alpha17"

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

Kotlin

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

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

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.

Glance Wear versión 1.0

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 compatibles para hosts más antiguos. (I9c324)

Correcciones de errores

  • Se actualizó compileSdk para las bibliotecas de Compose a 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 de 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 comprobaciones de lint en Glance Wear para garantizar que cada <container> en un XML <wearwidget-provider> para metadatos de widgets especifique de forma explícita un atributo de tipo 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 de Compose remoto CORE_TEXT para el perfil de widgets de Wear. Esto permite que RemoteText use funciones de fuentes variables, como ejes de fuentes, alturas de línea, etc., en renderizadores de host compatibles, con una alternativa automática cuando no es compatible.

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 configura un fondo vacío en el documento de widgets de 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 Glance Wear completamente redondeados. (If5336, b/512405233)

Nuevas funciones

  • Configuramos y agregamos la biblioteca de Linter para widgets de Glance Wear (If4218, b/527402079)
    • Se agregó una comprobació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 widgets que se ejecutan en hosts más antiguos propagando operaciones compatibles a través de WearWidgetParams y agregando el filtrado del perfil de operaciones permitidas a esos. (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 de los widgets 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 debe usarse en GlanceWearWidgetService para proporcionar a qué implementación de GlanceWearWidget está asociada. (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 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 boilerplate 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).
  • isHeartRateBpmAvailable se expone para determinar si heartRateBpm está disponible en el host. (I5999d, b/514641567)
  • Se expusieron los operadores de comparación RemoteInt. (I5fe3d, b/513228889)
  • Se expusieron la API de flujo captureRemoteDocument y una nueva sobrecarga captureSingleRemoteDocument (que toma RemoteCreationDisplayInfo) como APIs públicas. (I87b0e, b/513228889)
  • Agregamos @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 widgets de Wear en Android Studio. (I36504, b/485147770)
  • Expone 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

  • Incluye información sobre 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 de extracción forzada en el modo de depuración o el emulador para 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

  • Expone las APIs de glance.wear.health.DataType en el widget de Wear. Los desarrolladores pueden usar estas APIs para acceder a los datos de salud 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 ejecutaban el renderizador 1.6, ya que no se permitía enviar un eje de fuente vacío al reproductor para el widget de Glance Wear.

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 funciones experimentales de Glance Wear. (Id2f76, b/498179813)

Correcciones de errores

  • Se actualizó el analizador para los metadatos XML de widgets de Wear para que reconozca 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 asegurarse de que PackageManager consulte los servicios correctos para las actualizaciones push. (I192787)

Otro

  • Se revirtió "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

  • Agrega el fondo predeterminado del widget de Wear cuando WearWidgetBrush está vacío o no se especifica. (I8300b)
  • Actualiza la API de getActiveWidgets para mostrar el tipo de contenedor del widget. (2772eb1)

Cambios en la API

  • Cambia la API de actualización de widgets para tomar WidgetInstanceId y agregar un auxiliar 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 widgets de Wear intercalado.

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 la reversión de la asignación del tipo FULLSCREEN anterior a LARGE en los parámetros de widgets.

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 usarla 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)
  • Movimos las APIs de la biblioteca glance:wear:wear-core al paquete androidx.glance.wear.core. (I429cf)

Correcciones de errores

  • Expone tipos comunes de componibilidad y modificadores remotos (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

  • Agrega compatibilidad con 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

  • Reasigna FULLSCREEN a LARGE en los parámetros de widgets (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.