בקצרה
העדכון האחרון | גרסה יציבה | גרסה מועמדת להפצה | גרסת בטא | גרסת אלפא |
---|---|---|---|---|
7 במאי 2025 | 1.1.1 | - | - | 1.2.0-alpha01 |
הצהרת יחסי תלות
כדי להוסיף תלות ב-Glance, צריך להוסיף את מאגר Google Maven לפרויקט. מידע נוסף זמין במאגר Maven של Google.
מוסיפים את יחסי התלות של הארטיפקטים הנדרשים בקובץ build.gradle
של האפליקציה או המודול:
מגניב
dependencies { // For Glance support implementation "androidx.glance:glance:1.2.0-alpha01" // For AppWidgets support implementation "androidx.glance:glance-appwidget:1.2.0-alpha01" // 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.2.0-alpha01") // For AppWidgets support implementation("androidx.glance:glance-appwidget:1.2.0-alpha01") // 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" } }
מידע נוסף על יחסי תלות זמין במאמר הוספת יחסי תלות ל-build.
משוב
המשוב שלכם עוזר לנו לשפר את Jetpack. אם נתקלתם בבעיות חדשות או שיש לכם רעיונות לשיפור הספרייה הזו, נשמח לשמוע מכם. לפני שיוצרים בעיה חדשה, כדאי לעיין בבעיות הקיימות בספרייה הזו. כדי להצביע על בעיה קיימת, לוחצים על לחצן הכוכב.
מידע נוסף זמין במסמכי התיעוד של Issue Tracker.
גרסה 1.2
גרסה 1.2.0-alpha01
7 במאי 2025
androidx.glance:glance-*:1.2.0-alpha01
משוחרר. גרסת 1.2.0-alpha01 כוללת את ההוספות האלה.
שינויים ב-API
- האפשרות
currentCompositeKeyHash
הוצאה משימוש. במקום זאת, אתם צריכים להשתמש ב-currentCompositeKeyHashCode
. ממשק ה-API החלופי מצפין את אותו גיבוב עם יותר ביטים, וכך מקטין באופן אקספוננציאלי את הסיכוי של שתי קבוצות אקראיות לא קשורות בהיררכיית הקומפוזיציה שיהיה להן אותו מפתח גיבוב.(I4cb6a, b/177562901) - נוספה ממשק API חדש לציון ערך אלפא (
0f
עד1f
) לרכיב ה-Glance Image composable ולרכיב לשינוי של תמונת הרקע. אם לא מציינים ערך, האלפא נשמרת מתמונת המקור. (I8ad05) - הוספת ממשקי Glance API לתצוגות מקדימות שנוצרו. משנים את
GlanceAppWidget.providePreview
כדי לספק פריסה של תצוגה מקדימה לווידג'ט. לאחר מכן, מתקשרים אלGlanceAppWidgetManager.setWidgetPreview
כדי להגדיר את התצוגה המקדימה. (Iced16) - הוספת
MultiProcessGlanceAppWidget
לתמיכה בהגדרות של תהליכים מרובים (Idbb90) - הסרת תג ניסיוני, עכשיו אנחנו תומכים ב-lambdas (I74d98, b/299361317)
- אפשר לציין את מקלט ה-lambda עבור
GlanceAppWidget.runComposition
(I84829) - מוסיפים את הפרמטר
previewSize
אלrequestPinGlanceAppWidget
(I9f8f0, b/303256067)
תיקוני באגים
- הסרנו את התיאור הידני של הגישה לממשקי API חדשים של פלטפורמות, כי הדבר מתבצע באופן אוטומטי באמצעות בניית מודלים של API כשמשתמשים ב-R8 עם AGP 7.3 ואילך (למשל, R8 בגרסה 3.3) ובכל גרסאות ה-build כשמשתמשים ב-AGP 8.1 ואילך (למשל, D8 בגרסה 8.1). לקוחות שלא משתמשים ב-AGP מומלצים לעדכן ל-D8 בגרסה 8.1 ואילך. למידע נוסף, מומלץ לעיין במאמר הזה. (If6b4c, b/345472586)
- עדכון הספריות של
glance-appwidget
לגרסהcompileSdk 35
(I2e26b)
גרסה 1.1
גרסה 1.1.1
16 באוקטובר 2024
androidx.glance:glance-*:1.1.1
משוחרר. גרסה 1.1.1 מכילה את ההוספות האלה.
תיקוני אבטחה
- החל מהשינוי הזה, androidx מבצע קומפילציה מול protobuf 4.28.2 כדי לטפל בבעיה CVE-2024-7254. כדי לטפל בסיכון של נקודת החולשה, צריך לשדרג את יחסי התלות בגרסה 1.1.0 של
androidx.glance:glance-appwidget-proto
ו-androidx.glance:glance-appwidget-external-protobuf
לגרסה 1.1.1.
גרסה 1.1.0
12 ביוני 2024
androidx.glance:glance-*:1.1.0
משוחרר. גרסת 1.1.0 מכילה את ההוספות האלה.
שינויים חשובים מאז גרסה 1.0.0
- העברת Glance לגרסה היציבה 1.1.0.
גרסה 1.1.0-rc01
14 במאי 2024
androidx.glance:glance-*:1.1.0-rc01
משוחרר. גרסת 1.1.0-rc01 כוללת את ההוספות האלה.
תכונות חדשות
- הוספנו פרמטרים של רוחב וגובה להערות בתצוגה המקדימה של Glance. העברת הגרסה 1.1.0 לסטטוס 'גרסה מועמדת להפצה'.
שינויים ב-API
- הוספת פרמטר אופציונלי ל-Scaffold. (If753f)
- מוסיפים פרמטרים של רוחב וגובה ל-Glance
@Preview
. (Ibabe8) - הסרת התמיכה בתצוגות מקדימות של משבצות ב-Glance Wear. (I3850a)
- הוספנו ממשק API להגדרת ערכי משקל מותאמים אישית עבור
FontStyle
. (I7390a) - שינוי השם של המאפיינים מסוג Enum של
ImplementationMode
ב-Viewfinder
כך שישקפו טוב יותר את ההטמעות הבסיסיות, והוספת קבועים קבועים ל-TransformationInfo.sourceRotation
(Ic6149)
תיקוני באגים
- תוקן באג שגרם לבעיות ברינדור של
ViewGroups
במצב תאימות לאחור (I8de92)
תרומה חיצונית
SharedTransitionScope
הניסיוני הוא עכשיו ממשק ולא כיתה. (Iaf856, b/338415048, b/338414702)
גרסה 1.1.0-beta02
17 באפריל 2024
androidx.glance:glance-*:1.1.0-beta02
משוחרר. הגרסה הזו מכילה קובצי jar של מקורות קוד שלא היו בגרסה הקודמת.
גרסה 1.1.0-beta01
3 באפריל 2024
androidx.glance:glance-*:1.1.0-beta01
משוחרר. גרסת 1.1.0-beta01 כוללת את ההוספות האלה.
גרסה 1.1.0-alpha01
7 בפברואר 2024
androidx.glance:glance-*:1.1.0-alpha01
משוחרר. גרסה 1.1.0-alpha01 כוללת את ההוספות האלה.
תכונות חדשות
- ספריית בדיקות יחידה ל-Glance שלא דורשת את UI Automator. אפשר לבדוק את הקוד של התצוגה המקדימה ישירות בלי להרחיב את התצוגה.
- רכיבים ברמה גבוהה יותר לפריסות פשוטות יותר.
- אפשרויות חדשות של ערכות נושא ושל מודификаторים.
- ממשק API חדש לקבלת רצף של RemoteViews מתמהיל,
runComposition
שינויים ב-API
- הוספת תפקיד צבע חדש
widgetBackground
לעיצובים של Glance. (Ia2ab8) - הוספה של
GlanceAppWidget.runComposition
(I6344c, b/298066147) - הוספת רכיב
TopBar
חדש (Ibd361) - הוספת שינויים שמוגדרים מראש למשתנה המשנה
clickable
. (Iacecf) - הוספת ממשק API חדש לצביעת כפתורים. האפשרות הזו אמורה להיות ניסיונית עד שגרסת 1.0 תשוחרר. (I92523)
- הוספת
runGlanceAppWidgetUnitTest
שמספק היקף לקריאה לשיטות ב-GlanceAppWidgetUnitTest
, כמוprovideComposable
כדי לספק רכיב קטן ומבודד לבדיקה,onNode
כדי למצוא רכיב Glance לבדיקה בתוכן שסופק. כך תוכלו לכתוב בדיקות יחידה לפונקציות מורכבות ספציפיות ב-AppWidget כדי לוודא שבתנאי קלט מסוימים הפונקציה מניבה את הקבוצה המיועדת של רכיבי ה-Glance הניתנים ליצירה. (I2f682) - הוספת המשתנה
testTag
לסמנטיקה לשימוש בבדיקות יחידה. (I8f62f) - update
TitleBar
– טקסט וסמלים שניתנים לצביעת בנפרד. (Ia0a60) - הוספת רכיב של תבנית עזר (I8a736)
- הוספת המסנן
hasActionRunCallbackClickAction
והטענהassertHasActionRunCallbackClickAction
לבדיקהactionRunCallack
. בנוסף, נוספו פונקציות מקוצרות נוספות של וריאנטים למסנני בדיקה שקשורים לפעולות –hasStartActivityClickAction<activityClass>(..)
, hasStartServiceAction<receiverClass>(..)
, hasSendBroadcastAction<receiverClass>(..)
. הוספת וריאציות דומות לוריאציות המקבילות שלassertHasXXX
. (Ieca63) - העברת ממשקי API שעדיין לא פורסמו. שינוי של משתנה מ'פנימי' ל'גלוי לכולם', אבל עם הגבלת גישה בספרייה (If2a08)
- הוספת method
onCompositionError
שבו מפתחים יכולים להריץ קוד כשמתרחשת שגיאה (I9b56f) - הוספת ממשקי API של לחצנים וסמלי לחצנים לתצוגה המקדימה (I0fd6f)
- הוספת המסננים
isLinearProgressIndicator
,isIndeterminateLinearProgressIndicator
,isIndeterminateCircularProgressIndicator
כדי להתאים למחווני ההתקדמות. הוספת מסנןhasAnyDescendants
כדי לבדוק אם לצומת יש צאצא בהיררכיית המשנה שלו שתואמת למתאמת ספציפי (Ifd426) - הוספת טענות נכוֹנוּת ומסננים כדי לאפשר בדיקה של פעולות לחיצה שמתחילות שירותים, פעילויות או שידורים. הבדיקה כוללת גם בדיקה אם רכיבי הקלט נבדקים. (I3041c)
גרסה 1.0.0
גרסה 1.0.0-alpha06
7 בפברואר 2024
androidx.glance:glance-appwidget-preview:1.0.0-alpha06
ו-androidx.glance:glance-preview:1.0.0-alpha06
משוחררים. גרסה 1.0.0-alpha06 מכילה את ההוספות האלה.
תכונות חדשות
- הגרסה עודכנה בהתאם למודול הראשי של Glance.
גרסה 1.0.0
6 בספטמבר 2023
androidx.glance:glance-*:1.0.0
משוחרר. גרסה 1.0.0 כוללת את ההצהרות האלה על ביצוע שינויים (commits).
תכונות עיקריות בגרסה 1.0.0
- מעבר של Glance לגרסה היציבה 1.0.0
גרסה 1.0.0-rc01
26 ביולי 2023
androidx.glance:glance-*:1.0.0-rc01
משוחרר. גרסה 1.0.0-rc01 כוללת את ההוספות האלה.
גרסה Glance עוברת ל-rc01 בדרך לגרסה היציבה 1.0.0.
תכונות חדשות
- הוספת פרמטרים מרכזיים ל-lambdas של פעולות כדי לקבל קריאה יציבה יותר לפעולות.
- הוספת היכולת לספק לפעולות
ActvityOptions
עדstartActivity
. - נוספה תמיכה ב-Android 14
שינויים ב-API
- הוספנו פרמטר מפתח אופציונלי לכל הרכיבים שמקבלים פונקציות lambda. (Id96c1, b/282445798)
- הוספנו תמיכה בהגדרת חבילת
ActivityOptions
עבורactionStartActivity
(I6a08d) - קובצי API ציבוריים וניסיוניים משולבים לנתיבי d, e, f ו-g (I03646, b/278769092)
- לא רלוונטי, שינויים בקובץ ה-API הם רק שינוי הסדר של השיטות (I5fa95)
- הוספת API להגדרת
CoroutineContext
לבקשותGlanceAppWidgetReceiver
(I0a100) - הוספנו ממשק API חדש כדי לספק
ActivityOptions
עבורLazyColumn
ו-LazyVerticalGrid
, שישמש לכל הפעולות ברשימה.(Id8d71)
תיקוני באגים
- לא רלוונטי, שינויים בקובץ ה-API הם רק שינוי הסדר של השיטות (I5fa95)
- הדגמה של סגנון רכיב הטקסט של Glance (Ie78a4)
גרסה 1.0.0-beta01
10 במאי 2023
androidx.glance:glance-*:1.0.0-beta01
משוחרר. גרסה 1.0.0-beta01 כוללת את ההצהרות האלה.
תכונות חדשות
- הספרייה עוברת לגרסת בטא.
- תמיכה בעיצוב באמצעות
GlanceTheme
, הוספת המודולים glance-material ו-glance-material3 לתמיכה בעיצובים בסגנון Material 2 ו-Material 3 ב-Glance. - נוספה תמיכה ב-
FontFamily
לממשקי API של טקסט. - הועבר
GlanceAppWidget
למנגנון עדכון מבוסס-סשן שלWorkManager
. משתמשים ב-Glance ל-AppWidgets
צריכים עכשיו לשנות אתGlanceAppWidget.provideGlance
במקום את השיטה הישנהContent
. מכיוון שהפעולה הזו מתבצעת עכשיו ב-worker, זהו מקום טוב לטעון משאבים, מסדי נתונים או פריטים ברשת בלי צורך ב-worker נפרד.
שינויים ב-API
- הוספנו את ה-API של
*Defaults
ל-Button
, ל-Checkbox
, ל-RadioButton
ול-Switch
. הוא מתאים את Glance לדפוסים של Jetpack Compose. (I94828) - מודול חדש של תבניות Glance (I94459)
- הפיכת
ResourceColorProvider
לפנימית למודול. שינוי תוכנה שעלול לגרום לכשל. צריך להשתמש ב-ResourceColorProvider
רק לצורך עיצוב דינמי, כדי למנוע מצבים שבהם חלק מהצבעים הם משאבים דינמיים וחלקם פותרים באופן מלא. (Ib0db7) - הוספת
FontFamily
כאפשרות ל-TextStyle
. (Ic19ba, b/274179837) - שם הפרמטר של הערך עבור
Enum.valueOf
השתנה (Ia9b89) - חריגות נוספות שהושלחו מהממשק המסווג
valueOf
(I818fe) - עדכנו את
GlanceAppWidget
כך שישתמש ב-provideGlance
כנקודת הכניסה הראשית. האפשרותGlanceAppWidget.Content
הוצאה משימוש. (I202b5) - נוספה אפשרות לספק גוון צבע לתמונות (I26192, b/212418562)
- אפשרות לקבלת ערכים null מסוגים נוספים של פונקציות מוסתרות שהוצאו משימוש. (Ibf7b0)
- הוספת הערה
@JvmDefaultWithCompatibility
(I8f206) - הוסר
SingleEntityTemplateData.displayHeader
שלא היה בשימוש. (I7f094) - נוספה תמיכה בשימוש ב-lambda כפונקציות קריאה חוזרת (Ia0bbd)
- העברת
DayNightColorProvider
למודול 'בקצרה' (I1842c, b/256934779) LocalColorProvider
יוסר מהתבניות. התבניות ישתמשו מעכשיו ב-GlanceTheme.colors
(Ic15e2)- הוסר היכולת להכיל ערך null מ-
Text(style: TextStyle)
(I7123b, b/237012816) - צבע ברירת המחדל של הטקסט הוא שחור. הסרת האפשרות של ערך null (I3072c, b/237012816)
- הפיכת העיצוב הדינמי
ColorProviders
לאובייקט משלו. הפיכתResourceColorProvider
לפנימית בתוך המודול. (Id0e2d, b/237012816) - מוסיפים את הקטגוריה 'לא מוגדרת' אל
ImageSize
. (I2fa39) - הסרת הפונקציה
GlanceAppWidget.Content
שהוצאה משימוש (Ib05f6) - הוספת המשתנה כפרמטר ל-
AndroidRemoteViews
. (I515d4) - הוספת
GlanceAppWidget.compose
כדי להקל על בדיקות היחידה (Ie9b28)
תיקוני באגים
- הוספנו ווידג'ט הדגמה לגופנים של טקסט ב-Glance (I5c3d7)
- הגדלת
AndroidRemoteViews
באמצעות Modifier. - בעיות עם צבעים לא עקביים של ערכות נושא נפתרו
- כל המשאבים מקבלים עכשיו קידומת כדי למנוע התנגשויות
גרסה 1.0.0-alpha05
5 באוקטובר 2022
התכונות androidx.glance:glance:1.0.0-alpha05
, androidx.glance:glance-appwidget:1.0.0-alpha05
וגם androidx.glance:glance-wear-tiles:1.0.0-alpha05
משוחררות. גרסה 1.0.0-alpha05 מכילה את ההוספות האלה.
תכונות חדשות
- הוספת
requestPinGlanceAppWidget
אלGlanceAppWidgetManager
, שמאפשרת לאפליקציות להציע למשתמש להוסיף את הווידג'ט שמבוסס על Glance למסך הבית. (Ic6e47) - הוספת
ACTION_DEBUG_UPDATE
ל-GlanceAppWidgetReceiver
כדי לאפשר למפתחים לאלץ את הווידג'ט להתעדכן מ-adb במכשירים עם הרשאת root ובמכשירי אמולטור. (I94ae1)
שינויים ב-API
- כדי לפשט את תרחיש השימוש, מומלץ להסיר את לחצני הפעולה בכותרות בתבניות של Glance. (Ie4387)
- שינוי תבנית של ישות יחידה כדי לעשות שימוש חוזר בתכנון של מערכת המשנה של הבלוק. (Iecd2c)
- תבנית רשימת התצוגה המקדימה עוצבה מחדש כך שתשתמש בעיצוב בלוקים
Text/Image/Action
. (If0cc1) - מוסיפים טווח מספרי עדיפות עבור
TextBlock
ו-ImageBlock
. (I73100)
תיקוני באגים
- הוסר התלות ב-Material3. (I28d1c)
- עברנו למערכת עקבית יותר להוספת שוליים ומרווחי טקסט בפריסות של תבניות התצוגה המפורטת. (I29773)
- תיקון כלל Proguard עם פורמט שגוי שחסם את האפשרות ליצור גרסאות build של גרסאות מינימליות.
גרסה 1.0.0-alpha04
10 באוגוסט 2022
התכונות androidx.glance:glance:1.0.0-alpha04
, androidx.glance:glance-appwidget:1.0.0-alpha04
וגם androidx.glance:glance-wear-tiles:1.0.0-alpha04
משוחררות. גרסה 1.0.0-alpha04 מכילה את ההצהרות האלה על ביצוע שינויים (commits).
תכונות חדשות
- נוספו תכונות של צביעת כפתורים.
- הוספת הערה
GlanceComposable
לבדיקות טובות יותר בזמן הידור. - נוספו תכונות Glance ספציפיות ל-Wear.
שינויים ב-API
- עדכון של Glance Gallery Data API ושל התצוגה המקוצרת. (Ibc7a8)
- הוספת
ButtonColors
להגדרת לחצנים. (Iea88d, b/236305351) - שינוי השם של
ColorProvider.resolve
ל-ColorProvider.getColor
(Ic9dfe) - הוספת השיטה
copy()
ל-TextStyle
. (I9aef6) - הוספת סוג
ColorProviders
שאפשר להשתמש בו כחלק מהנושאים של Glance. (I848b9, b/237012816) - הוספנו תמיכה בתבניות רשימות לסגנונות רשימה ולתצוגה מכוונת. (I50cdc)
- מוסיפים סמנטיקה ל-
GlanceModiier
ול-GlanceCurvedModifier
. (Ifda7e) - מוסיפים הערה מסוג
GlanceComposable
. (I5dbf0) - העברת התבניות של Glance לפרויקט הראשי של Glance. (I9db94)
- הוספה של
ColorProvider.resolve()
(Ife532, b/214733442) - שיטה חדשה לקבלת
GlanceId
מ-appWidgetId
קיים או מכוונה מפעילות הגדרה (Icb70c, b/230391946) - מוסיפים הערה מסוג
GlanceComposable
. (I2c21f) - נוספה
GlanceRemoteViews
להרצת קומפוזיציה מחוץ ל-GlanceAppWidget
. (I18f92) - מסירים את הצבע ב-
ProgressIndicatorDefaults
. (I40299) - צריך לשנות את השם של method onRun של
ActionCallback
ל-onAction, כדי לשמור על עקביות עם ממשקי ה-API הציבוריים, כפי שנדרש לפי המשוב שקיבלנו בבדיקה של ה-API. (Icfa57) - המרת פריסות של תבניות של תצוגת מבט מהיר כך שיכללו מפה (I46bfd)
- הוספת
RadioButton
שאפשר לשלב (I4ecce) - נוספה
GlanceWearTiles
ליצירת כרטיסי מידע ב-Wear (Ia9f65) - נוספה אפשרות ללחוץ על
GlanceCurvedModifier
(Iec2a0) - מטמיעים את
CurvedRow
כ-scope ויוצרים שפת DSL כדי להוסיף רכיבים רגילים שאפשר ליצור מהם קומפוזיציות ו/או רכיבים מעוקלים. נוספו גםcurvedLine
ו-curvedSpacer
, שמתורגמים ל-ArcLine
ול-ArcSpacer
בכרטיסי המידע של ה-proto (Ib955b) - עדכנו את האפשרות של ערך null ב-core וב-appcompat כך שתתאים ל-Tiramisu DP2 (I0cbb7)
- הוספת תמיכה ב-
RuncallbackAction
ב-glance-wear-tiles. נכון לעכשיו, יש תמיכה רק ב-RunCallbackAction
ללא פרמטר (Ide64a)
תרומה חיצונית
- עודכן :compose:ui:ui-test api (updateApi) עקב העברה של test-coroutines-lib (I3366d)
גרסה 1.0.0-alpha03
23 בפברואר 2022
androidx.glance:glance-*:1.0.0-alpha03
משוחרר. גרסה 1.0.0-alpha03 כוללת את ההצהרות האלה.
תכונות חדשות
- הגדרה פשוטה יותר של המצב שמוגדר כברירת מחדל בתור 'העדפות'.
שינויים ב-API
- כדי לפשט את טיפול המצבים, אפשר להגדיר את
PreferencesGlanceStateDefinition
כטיפול המצבים שמוגדר כברירת מחדל. הוסרGlanceAppWidget.updateAppWidgetState
והוצגupdateAppWidgetState
שמשתמש ב-Preferences
כברירת מחדל. (I58963) - הוספת הכיתה Glance TemplateText ועדכון העיצוב של התבנית (I4e146)
- הוספת תשתית של מתאר לתבנית Freeform (If03d6)
- עדכונים לפריסות של
SingleEntityTemplate
(If925d) - נוספה
LazyVerticalGrid
(I5f442) - שימוש ב-
ColorProvider
ב-SingleEntityTemplate
(I01ee0) - עדכון שם הכיתה של התבנית (I3720e)
- נוספו
LinearProgressIndicator
ו-CircularProgressIndicator
לרכיבים הניתנים לקישור. (Ie116b)
תיקוני באגים
- הטמעה ראשונית של תבניות 'בקצרה', הגדרת נתונים של 'תבנית של פריט יחיד' ותצוגה של תבנית לדוגמה (I35837)
- יישור התוכן של המשבצת למרכז כברירת מחדל (I264be)
- תיקון באג ב-fillMaxSize/Width/Height ב-glance-wear-tiles (I0a39f)
גרסה 1.0.0-alpha02
26 בינואר 2022
androidx.glance:glance-*:1.0.0-alpha02
משוחרר. גרסה 1.0.0-alpha02 מכילה את ההצהרות האלה.
תכונות חדשות
הגרסה הזו מכילה את קבוצת ממשקי ה-API ליצירת משבצות ב-Wear באמצעות סביבת זמן ריצה של Compose עם רכיבים מורכבים שעברו אופטימיזציה ל'סקירה מהירה'
- כדי להצהיר על שירות המשבצת שלכם ב-Wear, אתם צריכים להרחיב את
GlanceTileService
, שירות ליצירת המשבצת, בפונקציה הניתנת ליצירה Content(). - רכיבים מותאמים אישית של תצוגת מידע ב-Wear:
CurvedRow
, CurvedText
. - כדי לטפל במצבים שונים של ציר הזמן של המשבצת, מגדירים את
TimelineMode.SingleEntry
ו-TimelineMode.TimeBoundEntries
. LocalTimeInterval
, הרכיב 'מקומי' מתייחס לטווח זמן ספציפי.BorderModifer
הואGlanceModifier
שמחיל גבול סביב רכיב.
בגרסה הזו נוספו גם אינדיקטורים של התקדמות לתצוגה המקדימה של ווידג'טים של אפליקציות.
שינויים ב-API
- נוספו
LinearProgressIndicator
ו-CircularProgressIndicator
לרכיבים הניתנים לקישור. (Ie116b) - שינוי
actionStartBroadcastReceiver
ל-actionSendBroadcast
(I7d555) - העברת ההקשר ל-
GlanceAppWidget
onDelete callback (I4c795)
תיקוני באגים
- טיפול נכון ב-OPTIONS_APPWIDGET_SIZES אם הוא קיים אבל ריק. (I01f82)
גרסה 1.0.0-alpha01
15 בדצמבר 2021
התכונות androidx.glance:glance:1.0.0-alpha01
, androidx.glance:glance-appwidget:1.0.0-alpha01
וגם androidx.glance:glance-appwidget-proto:1.0.0-alpha01
משוחררות. גרסה 1.0.0-alpha01 מכילה את ההוספות האלה.
תכונות בגרסה הראשונית
- במהדורה הראשונה של Glance יש את הקבוצה הראשונה של ממשקי ה-API ליצירת רכיבי AppWidget באמצעות Compose Runtime, עם קבוצה חדשה של רכיבי Composables שעברו אופטימיזציה ל'רכיבי Glanceables'.
תכונות
- מגדירים את הווידג'טים של האפליקציה באמצעות GlanceAppWidget ו-GlanceAppWidgetReceiver.
- אפשר ליצור את ממשק המשתמש באמצעות הקבוצה הראשונית של רכיבי Glance Composables: Box, Row, Column, Text, Button, LazyColumn, Image, Spacer.
- מחילים משתני אופן הצגה על הרכיבים הניתנים לשילוב באמצעות השיטות של GlanceModifier.
- טיפול באינטראקציה של משתמשים באמצעות פעולות מוגדרות מראש.
- העברת פרמטרים ל-Action באמצעות ActionParameters.
- כדי לטפל במצבי גודל שונים, מגדירים את SizeMode.Single, SizeMode.Exact או SizeMode.Responsive.
- לשמור את מצב ה-GlanceAppWidget על ידי מתן GlanceStateDefinition.
- קומפוזיציות מקומיות כמו LocalContext, LocalState, LocalGlanceId, LocalSize.
- יכולת פעולה הדדית עם RemoteViews הקיימים באמצעות ה-Composable של AndroidRemoteViews.