Glance

Créez des mises en page pour des surfaces distantes à l'aide d'une API semblable à Jetpack Compose.
Dernière mise à jour Version stable Version finale Version bêta Version alpha
5 octobre 2022 - - - 1.0.0-alpha05

Déclarer des dépendances

Pour ajouter une dépendance à Glance, vous devez ajouter le dépôt Maven de Google à votre projet. Pour en savoir plus, consultez la section Dépôt Maven de Google.

Ajoutez les dépendances correspondant aux artefacts dont vous avez besoin dans le fichier build.gradle de votre application ou de votre module :

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"
    }
}

Pour en savoir plus sur les dépendances, consultez la page Ajouter des dépendances de build.

Commentaires

Vos commentaires nous aident à améliorer Jetpack. N'hésitez pas à nous contacter si vous découvrez de nouveaux problèmes ou si vous avez des idées pour améliorer cette bibliothèque. Veuillez consulter les problèmes existants de cette bibliothèque avant d'en signaler un nouveau. Vous pouvez ajouter votre vote à un problème existant en cliquant sur le bouton en forme d'étoile.

Signaler un problème

Pour en savoir plus, consultez la documentation sur l'outil Issue Tracker.

Version 1.0.0

Version 1.0.0-alpha05

5 octobre 2022

Publication de androidx.glance:glance:1.0.0-alpha05, androidx.glance:glance-appwidget:1.0.0-alpha05 et androidx.glance:glance-wear-tiles:1.0.0-alpha05. Liste des commits de la version 1.0.0-alpha05

Nouvelles fonctionnalités

  • Ajout de requestPinGlanceAppWidget à GlanceAppWidgetManager, ce qui permet aux applications d'inviter un utilisateur à ajouter son widget basé sur Glance à son écran d'accueil. (Ic6e47)
  • Ajout de ACTION_DEBUG_UPDATE à GlanceAppWidgetReceiver pour permettre aux développeurs de forcer la mise à jour de leur widget depuis adb sur les appareils en mode root et les émulateurs. (I94ae1)

Modifications apportées à l'API

  • Pour simplifier le cas d'utilisation, supprimez les boutons d'action d'en-tête dans les modèles Glance. (Ie4387)
  • Refactorisation du modèle d'entité unique pour qu'il réutilise la conception du sous-système de blocs. (Iecd2c)
  • Refactorisation du modèle de liste de Glance pour qu'il utilise la conception de blocs Text/Image/Action. (If0cc1)
  • Ajout d'une plage de numéros de priorité pour TextBlock et ImageBlock. (I73100)

Correction de bugs

  • Suppression de la dépendance Material3. (I28d1c)
  • Adoption d'un système plus cohérent pour ajouter des marges et des espaces dans les mises en page de modèles de Glance. (I29773)
  • Correction d'une règle ProGuard incorrecte qui empêchait la création de versions réduites.

Version 1.0.0-alpha04

10 août 2022

Publication d'androidx.glance:glance:1.0.0-alpha04, d'androidx.glance:glance-appwidget:1.0.0-alpha04 et d'androidx.glance:glance-wear-tiles:1.0.0-alpha04. Liste des commits de la version 1.0.0-alpha04

Nouvelles fonctionnalités

  • Ajout de fonctionnalités de coloration des boutons
  • Ajout de l'annotation GlanceComposable pour une meilleure vérification de la durée de compilation
  • Ajout de fonctionnalités Glance pour Wear

Modifications apportées à l'API

  • Mise à jour de l'API Data Gallery Data et de la vue condensée. (Ibc7a8)
  • Ajout de ButtonColors pour la configuration des boutons. (Iea88d, b/236305351)
  • ColorProvider.resolve a été renommé ColorProvider.getColor. (Ic9dfe)
  • Ajout de la méthode copy() à TextStyle. (I9aef6)
  • Ajout d'une classe ColorProviders qui peut être utilisée dans les thèmes de Glance. (I848b9, b/237012816)
  • Ajout de la compatibilité du modèle de liste avec les styles de liste et la vue réduite. (I50cdc)
  • Ajout d'informations sémantiques à GlanceModiier et GlanceCurvedModifier. (Ifda7e)
  • Ajout d'une annotation GlanceComposable. (I5dbf0)
  • Déplacement des modèles Glance dans le projet Glance principal. (I9db94)
  • Ajout de ColorProvider.resolve(). (Ife532, b/214733442)
  • Ajout d'une méthode pour obtenir GlanceId à partir d'un appWidgetId existant, ou un intent à partir d'une activité de configuration. (Icb70c, b/230391946)
  • Ajout d'une annotation GlanceComposable. (I2c21f)
  • Ajout de GlanceRemoteViews pour exécuter la composition en dehors de GlanceAppWidget. (I18f92)
  • Suppression de la couleur en ProgressIndicatorDefaults. (I40299)
  • La méthode "onRun" de ActionCallback a été renommée en "onAction", pour assurer la cohérence avec les API publiques, conformément aux commentaires sur l'examen de l'API. (Icfa57)
  • Conversion des mises en page de modèles Glance pour utiliser une carte. (I46bfd)
  • Ajout du composable RadioButton. (I4ecce)
  • Ajout de GlanceWearTiles pour la composition des cartes Wear. (Ia9f65)
  • Ajout d'un élément cliquable à GlanceCurvedModifier. (Iec2a0)
  • Implémentation de CurvedRow en tant que champ d'application et création d'un DSL pour ajouter des éléments composables et/ou incurvés normaux. Ajout des curvedLine et curvedSpacer, traduits en ArcLine et ArcSpacer dans des cartes proto. (Ib955b)
  • Mise à jour de la possibilité de valeur nulle dans core et appcompat pour assurer la correspondance avec Tiramisu DP2. (I0cbb7)
  • Ajout de la prise en charge de RuncallbackAction dans les glance-wear-tiles, uniquement RunCallbackAction avec le paramètre "NO" pour le moment. (Ide64a)

Contribution externe

  • Mise à jour de l'API :compose:ui:ui-test (updateApi) suite à la migration de test-coroutines-lib. (I3366d)

Version 1.0.0-alpha03

23 février 2022

Publication d'androidx.glance:glance-*:1.0.0-alpha03. Liste des commits de la version 1.0.0-alpha03

Nouvelles fonctionnalités

  • Simplification de la définition d'un état par défaut dans les Préférences.

Modifications apportées à l'API

  • Simplification de la gestion de l'état (PreferencesGlanceStateDefinition défini comme gestion de l'état par défaut). Suppression de GlanceAppWidget.updateAppWidgetState et ajout de updateAppWidgetState qui utilise Preferences par défaut. (I58963)
  • Ajout d'une classe TemplateText pour Glance et mise à jour la conception du modèle. (I4e146)
  • Ajout l'infrastructure des contours pour le modèle de format libre. (If03d6)
  • Mises à jour apportées à la mise en page SingleEntityTemplate. (If925d)
  • Ajout de LazyVerticalGrid. (I5f442)
  • Utilisation de ColorProvider sur SingleEntityTemplate. (I01ee0)
  • Mise à jour du nom de classe du modèle. (I3720e)
  • Ajout des composables LinearProgressIndicator et CircularProgressIndicator. (Ie116b)

Correction de bugs

  • Implémentation des modèles initiaux de Glance, définition des données du modèle "Single Item" et de la mise en page du modèle d'exemple. (I35837)
  • L'alignement par défaut du contenu des cartes a été défini sur le centre. (I264be)
  • Correction de bug avec fillMaxSize/Width/Height dans glance-wear-tiles. (I0a39f)

Version 1.0.0-alpha02

26 janvier 2022

Publication d'androidx.glance:glance-*:1.0.0-alpha02. Liste des commits de la version 1.0.0-alpha02

Nouvelles fonctionnalités

Cette version contient un ensemble d'API permettant de créer des cartes Wear à l'aide de l'environnement d'exécution de Compose, avec des composables optimisés pour le système de widgets "Glanceable".

  • Déclarez votre service de cartes Wear en étendant GlanceTileService, un service permettant de créer votre carte dans la fonction composable Content().
  • Ajout de composables Glance pour les cartes Wear : CurvedRow et CurvedText.
  • Gestion de différents modes de chronologie pour les cartes en définissant TimelineMode.SingleEntry et TimelineMode.TimeBoundEntries.
  • LocalTimeInterval, la composition locale fait référence à un intervalle de temps spécifique.
  • BorderModifer est un élément GlanceModifier qui applique une bordure autour d'un élément.

Cette version ajoute également des indicateurs de progression à AppWidget Glance.

Modifications apportées à l'API

  • Ajout des composables LinearProgressIndicator et CircularProgressIndicator. (Ie116b)
  • actionStartBroadcastReceiver est remplacé par actionSendBroadcast. (I7d555)
  • Transmission du contexte à un rappel GlanceAppWidget onDelete. (I4c795)

Correction de bugs

  • OPTIONS_APPWIDGET_SIZES fonctionne correctement si présent, mais vide. (I01f82)

Version 1.0.0-alpha01

15 décembre 2021

Publication de androidx.glance:glance:1.0.0-alpha01, androidx.glance:glance-appwidget:1.0.0-alpha01 et androidx.glance:glance-appwidget-proto:1.0.0-alpha01. Liste des commits de la version 1.0.0-alpha01

Fonctionnalités de la version initiale

  • La première version de Glance comprend le premier ensemble d'API permettant de créer des widgets AppWidget à l'aide de l'environnement d'exécution Compose, avec un ensemble de nouveaux composables optimisés pour le système de widgets "Glanceables".

Fonctionnalités