Glance
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.
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
etImageBlock
. (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
etGlanceCurvedModifier
. (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'unappWidgetId
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 deGlanceAppWidget
. (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 descurvedLine
etcurvedSpacer
, traduits enArcLine
etArcSpacer
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, uniquementRunCallbackAction
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 deGlanceAppWidget.updateAppWidgetState
et ajout deupdateAppWidgetState
qui utilisePreferences
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
surSingleEntityTemplate
. (I01ee0) - Mise à jour du nom de classe du modèle. (I3720e)
- Ajout des composables
LinearProgressIndicator
etCircularProgressIndicator
. (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
etCurvedText
. - Gestion de différents modes de chronologie pour les cartes en définissant
TimelineMode.SingleEntry
etTimelineMode.TimeBoundEntries
. LocalTimeInterval
, la composition locale fait référence à un intervalle de temps spécifique.BorderModifer
est un élémentGlanceModifier
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
etCircularProgressIndicator
. (Ie116b) actionStartBroadcastReceiver
est remplacé paractionSendBroadcast
. (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
- Déclarez les widgets de votre application avec GlanceAppWidget et GlanceAppWidgetReceiver.
- Composez votre UI avec l'ensemble initial de composables Glance : Box, Row, Column, Text, Button, LazyColumn, Image, Spacer.
- Appliquez des modificateurs aux composables à l'aide des méthodes GlanceModifier.
- Gérez les interactions des utilisateurs avec des actions prédéfinies.
- Fournissez des paramètres à Action avec ActionParameters.
- Gérez différents modes de taille en définissant SizeMode.Single, SizeMode.Exact ou SizeMode.Responsive.
- Conservez l'état GlanceAppWidget en fournissant une propriété GlanceStateDefinition.
- Compositions locales comme LocalContext, LocalState, LocalGlanceId ou LocalSize.
- Interagissez avec vos RemoteViews existantes à l'aide du composable AndroidRemoteViews.