בקצרה
העדכון האחרון | גרסה יציבה | גרסה מועמ��ת ��הפ��ה | גרס�� ��ט�� | גרסת אלפא |
---|---|---|---|---|
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.