Glance

Crea diseños para superficies remotas mediante una API de estilo de Jetpack Compose.
Actualización más reciente Versión estable Versión potencial Versión beta Versión alfa
5 de octubre de 2022 - - - 1.0.0-alpha05

Cómo declarar dependencias

Si deseas agregar una dependencia en Glance, debes agregar el repositorio de Maven de Google a tu proyecto. Lee el repositorio 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 {
    // For Glance support
    implementation "androidx.glance:glance:1.0.0"
    // For AppWidgets support
    implementation "androidx.glance:glance-appwidget:1.0.0"

    // For Wear-Tiles support
    implementation "androidx.glance:glance-wear-tiles:1.0.0-alpha05"
}

android {
    buildFeatures {
        compose true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.1.0-beta03"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

Kotlin

dependencies {
    // For Glance support
    implementation("androidx.glance:glance:1.0.0")
    
    // For AppWidgets support
    implementation("androidx.glance:glance-appwidget:1.0.0")

    // For Wear-Tiles support
    implementation("androidx.glance:glance-wear-tiles:1.0.0-alpha05")
}

android {
    buildFeatures {
        compose = true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.1.0-beta03"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

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 en esta biblioteca antes de crear uno nuevo. Para agregar tu voto a un error existente, haz clic en el botón de la estrella.

Cómo crear un error nuevo

Consulta la documentación sobre la Herramienta de seguimiento de errores para obtener más información.

Versión 1.0.0

Versión 1.0.0-alpha05

5 de octubre de 2022

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

Nuevas funciones

  • Se agregó requestPinGlanceAppWidget a GlanceAppWidgetManager para permite que las apps le soliciten al usuario que agregue su widget basado en Glance a la pantalla principal (Ic6e47).
  • Se agregó ACTION_DEBUG_UPDATE a GlanceAppWidgetReceiver para permitir que los desarrolladores fuercen su widget para que se actualice desde adb en emuladores y dispositivos con permisos de administrador (I94ae1).

Cambios en la API

  • Se quitaron los botones de acción del encabezado en las plantillas de Glance para simplificar el caso de uso (Ie4387).
  • Se refactorizó la plantilla de una sola entidad para reutilizar el diseño del subsistema de bloqueo (Iecd2c).
  • Se refactorizó la plantilla de lista de resumen para usar los diseños de bloques Text/Image/Action (If0cc1).
  • Se agregó un rango de números de prioridad para TextBlock y ImageBlock (I73100).

Correcciones de errores

  • Se quitó la dependencia de Material 3 (I28d1c).
  • Se migró a un sistema más coherente para agregar márgenes y espaciado en los diseños de plantilla de vista rápida (I29773).
  • Se corrigió la regla de Proguard con formato incorrecto que impedía la compilación de versiones reducidas.

Versión 1.0.0-alpha04

10 de agosto de 2022

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

Nuevas funciones

  • Se agregaron funciones para colorear botones.
  • Se agregó la anotación GlanceComposable para mejorar la verificación del tiempo de compilación.
  • Se agregaron funciones específicas de Wear.

Cambios en la API

  • Se actualizó las APIs de datos de Glance Gallery y la vista condensada (Ibc7a8).
  • Se agregó ButtonColors para configurar botones (Iea88d, b/236305351).
  • Se cambió el nombre de ColorProvider.resolve por ColorProvider.getColor (Ic9dfe).
  • Se agregó el método copy() a TextStyle (I9aef6).
  • Se agregó una clase ColorProviders que se puede usar como parte de los temas de Glance (I848b9, b/237012816).
  • Se agregó compatibilidad con plantillas de lista a los estilos de lista y la vista contraída (I50cdc).
  • Se agregaron elementos semánticos a GlanceModiier y GlanceCurvedModifier (Ifda7e).
  • Se agregó la anotación GlanceComposable (I5dbf0).
  • Se trasladaron las plantillas de Glance al proyecto principal de Glance (I9db94).
  • Se agregó ColorProvider.resolve() (Ife532, b/214733442).
  • Se agregó un método nuevo para obtener GlanceId de un appWidgetId existente o un intent de una actividad de configuración (Icb70c, b/230391946).
  • Se agregó la anotación GlanceComposable (I2c21f).
  • Se agregó GlanceRemoteViews para ejecutar la composición fuera de GlanceAppWidget (I18f92).
  • Se quitó el color en ProgressIndicatorDefaults (I40299).
  • Se cambió el nombre del método onRun de ActionCallback a onAction para que sea coherente con los comentarios de revisión de la API (Icfa57).
  • Se convirtieron los diseños de plantilla de un vistazo para usar un mapa (I46bfd).
  • Se agregó el elemento RadioButton que admite composición (I4ecce).
  • Se agregó GlanceWearTiles para componer tarjetas de Wear (Ia9f65).
  • Se agregó la posibilidad de hacer clics a GlanceCurvedModifier (Iec2a0).
  • Implementa CurvedRow como alcance y crea un DSL para agregar elementos normales que admiten composición o curvas. También se agregaron curvedLine y curvedSpacer, que se traducen a ArcLine y ArcSpacer en prototarjetas (Ib955b).
  • Se actualizó la nulabilidad en core y appcompat para que coincida con Tiramisu DP2 (I0cbb7).
  • Se agregó compatibilidad con RuncallbackAction en tarjetas de un vistazo. Por ahora, solo se admite RunCallbackAction SIN parámetro (Ide64a).

Contribución externa

  • Se actualizó la API de :compose:ui:ui-test (updateApi) debido a la migración de test-coroutines-lib (I3366d).

Versión 1.0.0-alpha03

23 de febrero de 2022

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

Nuevas funciones

  • La definición del estado simplificado tiene el valor predeterminado Preferences.

Cambios en la API

  • Para simplificar el control de estado, haz que PreferencesGlanceStateDefinition sea el control de estado predeterminado. Se quitó GlanceAppWidget.updateAppWidgetState y se agregó updateAppWidgetState, que usa Preferences de forma predeterminada (I58963).
  • Se agregó la clase TemplateText de Glance y se actualizó el diseño de la plantilla (I4e146).
  • Se agregó la infraestructura de contorno para la plantilla de forma libre (If03d6).
  • Se actualizaron los diseños de SingleEntityTemplate (If925d).
  • Se agregó LazyVerticalGrid (I5f442).
  • Usa ColorProvider en SingleEntityTemplate (I01ee0).
  • Se actualizó el nombre de la clase de plantilla (I3720e).
  • Se agregaron los elementos LinearProgressIndicator y CircularProgressIndicator que admiten composición (Ie116b).

Correcciones de errores

  • Implementación inicial de las plantillas de un vistazo; define los datos de "plantilla de un solo elemento" y un diseño de plantilla de ejemplo (I35837).
  • De forma predeterminada, alinea el contenido de la tarjeta en el centro (I264be).
  • Se corrigió un error de fillMaxSize/Width/Height en wear-tiles-tiles (I0a39f).

Versión 1.0.0-alpha02

26 de enero de 2022

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

Nuevas funciones

Esta versión contiene el conjunto de API para compilar Wear Tiles con el uso del entorno de ejecución de Compose y elementos componibles optimizados para "Glanceable".

  • Para declarar tu servicio de tarjetas para Wear, extiende GlanceTileService, un servicio para crear una tarjeta en la función Content() que admite composición.
  • Elementos específicos de glance que admiten composición: CurvedRow y CurvedText.
  • Controla diferentes modos de cronograma de mosaicos mediante la definición de TimelineMode.SingleEntry y TimelineMode.TimeBoundEntries.
  • LocalTimeInterval, la composición local hace referencia a un intervalo de tiempo específico.
  • BorderModifer es un elemento GlanceModifier que aplica un borde alrededor de un elemento.

Esta versión también incluye indicadores de progreso a la herramienta AppWidget Glance.

Cambios en la API

  • Se agregaron los elementos LinearProgressIndicator y CircularProgressIndicator que admiten composición. (Ie116b)
  • Se cambió actionStartBroadcastReceiver a actionSendBroadcast. (I7d555)
  • Se pasó Context a la devolución de llamada GlanceAppWidget onDelete. (I4c795)

Correcciones de errores

  • Se corrigió el manejo de OPTIONS_APPATTRIBUTE_SIZES si está presente, pero vacío. (I01f82)

Versión 1.0.0-alpha01

15 de diciembre de 2021

Lanzamiento de androidx.glance:glance:1.0.0-alpha01, androidx.glance:glance-appwidget:1.0.0-alpha01 y androidx.glance:glance-appwidget-proto:1.0.0-alpha01. La versión 1.0.0-alpha01 contiene estas confirmaciones.

Funciones de la versión inicial

  • La primera versión de Glance incluye el primer conjunto de API para compilar AppWidget mediante el tiempo de ejecución de Compose con un conjunto de nuevos elementos componibles optimizados para "Glanceables".

Funciones