Glance Wear

  
‫Glance Wear היא ספרייה ליצירת ווידג'טים ל-Wear OS
העדכון האחרון גרסה יציבה גרסה מועמדת להפצה גרסת בטא גרסת אלפא
‫7 באוקטובר 2026 - - - ‎1.0.0-alpha20

הצהרה על יחסי תלות

כדי להוסיף תלות ב-glance-wear, צריך להוסיף את מאגר Maven של Google לפרויקט. מידע נוסף זמין במאמר בנושא מאגר ה-Maven של Google.

אתם יכולים להוסיף את יחסי התלות של הארטיפקטים שאתם צריכים בקובץ build.gradle של האפליקציה או המודול:

מגניב

dependencies {
    implementation "androidx.glance.wear:wear:1.0.0-alpha20"

    implementation "androidx.glance.wear:wear-core:1.0.0-alpha20"
}

Kotlin

dependencies {
    implementation("androidx.glance.wear:wear:1.0.0-alpha20")

    implementation("androidx.glance.wear:wear-core:1.0.0-alpha20")
}

מידע נוסף זמין במאמר הוספת יחסי תלות ב-build.

משוב

המשוב שלכם עוזר לנו לשפר את Jetpack. נשמח לדעת אם גיליתם בעיות חדשות או אם יש לכם רעיונות איך לשפר את הספרייה הזו. כדאי לעיין בבעיות הידועות בספרייה הזו לפני שמדווחים על בעיה. כדי להוסיף הצבעה בדיווח על בעיה קיימת, לוחצים על כפתור הכוכב.

יצירת דיווח על בעיה חדשה

מידע נוסף זמין במאמרי העזרה בנושא Issue Tracker.

גרסה 1.0 של Glance Wear

גרסה ‎1.0.0-alpha20

‫7 באוקטובר 2026

הגרסאות androidx.glance.wear:wear:1.0.0-alpha20, androidx.glance.wear:wear-core:1.0.0-alpha20 וגם androidx.glance.wear:wear-tooling-preview:1.0.0-alpha20 פורסמו. גרסה ‎1.0.0-alpha20 מכילה את השמירות האלה.

שינויים ב-API

  • נוספו הקבועים CATEGORY_PROVIDER_CONFIG,‏ EXTRA_CONFIG_WIDGET_ID ו-EXTRA_CONFIG_PROVIDER_COMPONENT אל GlanceWearWidget לטיפול בכוונות של ספקי ווידג'טים להגדרת תצורה. (I32fa4)
  • השם של הפרמטר useSafeFallbackRendererVersion ב-WearWidgetPreview שונה ל-useBaselineHostVersion. (I07bca)

תיקוני באגים

  • תוקנו עדכוני הווידג'טים באמולטור של מגש הווידג'טים כשמפעילים את triggerUpdateAll בגרסאות שניתנות לניפוי באגים. (I22d3f)
  • הערך שמוגדר כברירת מחדל של useSafeFallbackRendererVersion ב-WearWidgetPreview השתנה מ-true ל-false, כך שתצוגות מקדימות יעברו רינדור עם הגרסה העדכנית ביותר של כלי הרינדור כברירת מחדל. (Ied6b9)

גרסה ‎1.0.0-alpha19

‫23 בספטמבר 2026

הגרסאות androidx.glance.wear:wear:1.0.0-alpha19, androidx.glance.wear:wear-core:1.0.0-alpha19 וגם androidx.glance.wear:wear-tooling-preview:1.0.0-alpha19 פורסמו. גרסה ‎1.0.0-alpha19 מכילה את השמירות האלה.

שינויים בבדיקה פנימית בלבד.

גרסה ‎1.0.0-alpha18

‫9 בספטמבר 2026

הגרסאות androidx.glance.wear:wear:1.0.0-alpha18, androidx.glance.wear:wear-core:1.0.0-alpha18 וגם androidx.glance.wear:wear-tooling-preview:1.0.0-alpha18 פורסמו. גרסה ‎1.0.0-alpha18 מכילה את השמירות האלה.

שינויים ב-API

  • נוסף הפרמטר useSafeFallbackRendererVersion ל-WearWidgetPreview כדי לאפשר תצוגה מקדימה של ווידג'טים עם קבוצה בטוחה של פעולות נתמכות עבור מארחים ישנים יותר. (I9c324)

תיקוני באגים

  • ‫compileSdk Compose libraries updated to 37.1. כדי לעשות את זה, צריך לעדכן את compileSdk באופן טרנזיטיבי בכל האפליקציות והספריות שמשתמשות ב-Compose. (I05b0f)
  • הוספנו בדיקת lint כדי להזהיר מפני שימוש מיותר בפרמטר fontFamily בווידג'טים של Wear. (I7730c)

גרסה ‎1.0.0-alpha17

‫26 באוגוסט 2026

הגרסאות androidx.glance.wear:wear:1.0.0-alpha17, androidx.glance.wear:wear-core:1.0.0-alpha17 וגם androidx.glance.wear:wear-tooling-preview:1.0.0-alpha17 פורסמו. גרסה ‎1.0.0-alpha17 מכילה את השמירות האלה.

תכונות חדשות

  • הוספנו בדיקות lint ב-Glance Wear כדי לוודא שכל <container> בקובץ <wearwidget-provider> XML של נתוני Widget מציין באופן מפורש מאפיין type נתמך, ולא מגדיר סוגים כפולים. (I52c9a, ‏ b/464458215)

גרסה ‎1.0.0-alpha16

‫12 באוגוסט 2026

הגרסאות androidx.glance.wear:wear:1.0.0-alpha16, androidx.glance.wear:wear-core:1.0.0-alpha16 וגם androidx.glance.wear:wear-tooling-preview:1.0.0-alpha16 פורסמו. גרסה ‎1.0.0-alpha16 מכילה את השמירות האלה.

תכונות חדשות

  • הוספנו אימות Lint למטא-נתונים של <wearwidget-provider> XML כדי לוודא שרכיבי ההגדרה הנדרשים (כמו container ו-previewImage) קיימים. ‫(Ia9983, ‏ b/464458215)
  • נוספה אזהרה על שגיאת Lint להגדרת רקע שחור או שקוף לווידג'ט של Wear ‏ (Idedb0, ‏ b/529269573)
  • הפעלנו את הפעולה CORE_TEXT Remote Compose בפרופיל Wear Widgets. כך אפשר RemoteText להשתמש בתכונות של גופנים משתנים, כמו צירים של גופנים, גובה שורה וכו', בתוכנות עיבוד תומכות של המארח, עם מעבר אוטומטי לגיבוי אם אין תמיכה.

תיקונים

  • עדכנו את KDocs עבור AssociateWithGlanceWearWidget annotation בהתאם למשוב של המפתחים

גרסה ‎1.0.0-alpha15

‫29 ביולי 2026

הגרסאות androidx.glance.wear:wear:1.0.0-alpha15, androidx.glance.wear:wear-core:1.0.0-alpha15 וגם androidx.glance.wear:wear-tooling-preview:1.0.0-alpha15 פורסמו. גרסה ‎1.0.0-alpha15 מכילה את השמירות האלה.

תכונות חדשות

  • נוספה אזהרת Lint כשמגדירים רקע ריק למסמך Wear Widget. (Ic6475, b/529269573)

גרסה ‎1.0.0-alpha14

‫15 ביולי 2026

הגרסאות androidx.glance.wear:wear:1.0.0-alpha14, androidx.glance.wear:wear-core:1.0.0-alpha14 וגם androidx.glance.wear:wear-tooling-preview:1.0.0-alpha14 פורסמו. גרסה ‎1.0.0-alpha14 מכילה את השמירות האלה.

שינויים ב-API

  • הוספנו ספקי פרמטרים של תצוגה מקדימה של RoundAllWidgetPreviewParams,‏ RoundSmallWidgetPreviewParams ו-RoundLargeWidgetPreviewParams לווידג'טים של Glance Wear עם פינות מעוגלות. (If5336, b/512405233)

תכונות חדשות

  • הגדרנו והוספנו ספריית Linter לווידג'טים של Glance Wear‏.(If4218, ‏ b/527402079)
    • נוסף בדיקת lint כדי לוודא שמחלקות משנה של GlanceWearWidgetService מצהירות במפורש על מחלקת הווידג'ט המשויכת באמצעות ההערה @AssociateWithGlanceWearWidget. (Idc575, b/477024153)
  • שיפרנו את התאימות לאחור של ווידג'טים שפועלים במארחים ישנים יותר. כדי לעשות את זה, העברנו פעולות נתמכות באמצעות WearWidgetParams והוספנו סינון של פרופיל הפעולות המותרות לפעולות האלה. (Ib0a1b, I83cb1, [b/526716195])

גרסה ‎1.0.0-alpha13

‫1 ביולי 2026

הגרסאות androidx.glance.wear:wear:1.0.0-alpha13, androidx.glance.wear:wear-core:1.0.0-alpha13 וגם androidx.glance.wear:wear-tooling-preview:1.0.0-alpha13 פורסמו. גרסה ‎1.0.0-alpha13 מכילה את השמירות האלה.

שינויים ב-API

  • הסרנו את בדיקת ההרשאות מ-heartRateAccuracy (I14269, ‏ b/522444636)

תיקוני באגים

  • שינינו את הפרמטרים של הווידג'ט של Wear בצורת ריבוע עם פינות מעוגלות לתצוגה מקדימה, בהתאם למשוב שקיבלנו על חוויית המשתמש

גרסה ‎1.0.0-alpha12

‫17 ביוני 2026

הגרסאות androidx.glance.wear:wear:1.0.0-alpha12, androidx.glance.wear:wear-core:1.0.0-alpha12 וגם androidx.glance.wear:wear-tooling-preview:1.0.0-alpha12 פורסמו. גרסה ‎1.0.0-alpha12 מכילה את השמירות האלה.

תכונות חדשות

  • הוספנו את AssociateWithGlanceWearWidget שחייב לשמש ב-GlanceWearWidgetService כדי לציין לאיזו הטמעה של GlanceWearWidget הוא משויך. (Ifcabb, b/514679763)

    • לדוגמה:
     @AssociateWithGlanceWearWidget(MyGlanceWearWidget::class)
 class MyGlanceWearWidgetService : GlanceWearWidgetService() {
   override val widget = MyGlanceWearWidget()
 }
 ```

  • הוספנו את סמל המברשת image ל-WearWidgetBrush כדי לתמוך ברקעים של מפות סיביות בווידג'טים של Wear. (I9a228, b/513481558)

  • הוספנו פונקציית עזר @Composable, ‏ WearWidgetPreview, כדי לפשט את הפיתוח של ווידג'טים של Glance Wear. הפונקציה הזו מסירה את הקוד הסטנדרטי שנדרש לתצוגות מקדימות של IDE.

שינויים ב-API

  • השם של androidx.glance.wear.health.DataType שונה ל-androidx.glance.wear.health.HealthData (I4cb0b, b/516746689)
  • ‫isHeartRateBpmAvailable נחשף כדי לקבוע אם heartRateBpm זמין במארח. ‫(I5999d, ‏ b/514641567)
  • הוספנו אופרטורים להשוואה RemoteInt. (I5fe3d, ‏ b/513228889)
  • הוספנו את captureRemoteDocument Flow API ואת captureSingleRemoteDocument overload חדש (שמקבל RemoteCreationDisplayInfo) כממשקי API ציבוריים. (I87b0e, b/513228889)
  • הוספנו את @CallSuper ל-lifecycle methods של GlanceWearWidgetService

גרסה ‎1.0.0-alpha11

‫3 ביוני 2026

הגרסאות androidx.glance.wear:wear:1.0.0-alpha11, androidx.glance.wear:wear-core:1.0.0-alpha11 וגם androidx.glance.wear:wear-tooling-preview:1.0.0-alpha11 פורסמו. גרסה ‎1.0.0-alpha11 מכילה את השמירות האלה.

שינויים ב-API

  • הוספנו את WearWidgetPreview לתצוגה מקדימה של ווידג'טים ל-Wear OS ב-Android Studio. ‫(I36504, ‏ b/485147770)
  • חשיפת משתנים של is*Available (isDailyStepsAvailable וכו') כדי לוודא שסוג הנתונים הרלוונטי של הבריאות זמין ותקין. (Ib98a7, ‏ b/498179656)
  • נוסף triggerUpdateAll API ל-GlanceWearWidget כדי להפעיל עדכון בכל הווידג'טים של האפליקציה הנתונה. (I6ab20, ‏ b/510896410)

תיקוני באגים

  • כדי למנוע שיבושים במסמך שנוצר בגרסה alpha10, צריך לכלול את פרטי הגרסה של Renderer ב-WearWidgetParams כשדה פנימי. (Idcf8e, ‏ b/511263591, ‏ b/512830184)
  • מפעילים את תהליך העדכון של משיכת הכוח במצב ניפוי באגים או באמולטור של ווידג'טים ל-Wear.

גרסה ‎1.0.0-alpha10

‫19 במאי 2026

הגרסאות androidx.glance.wear:wear:1.0.0-alpha10, androidx.glance.wear:wear-core:1.0.0-alpha10 וגם androidx.glance.wear:wear-tooling-preview:1.0.0-alpha10 פורסמו. גרסה ‎1.0.0-alpha10 מכילה את השמירות האלה.

שינויים ב-API

  • חשיפת ממשקי API של glance.wear.health.DataType בווידג'ט של Wear. מפתחים יכולים להשתמש בממשקי ה-API האלה כדי לגשת לנתוני תקינות המערכת.

תיקוני באגים

  • תוקנה לולאת קריסה שמתרחשת בגרסה alpha09 באמולטור Wear 7 או במכשירים עם רכיב עיבוד (renderer) בגרסה 1.6, על ידי מניעת שליחה של ציר גופן ריק לנגן עבור הווידג'ט Glance Wear.

גרסה ‎1.0.0-alpha09

‫6 במאי 2026

‫androidx.glance.wear:wear:1.0.0-alpha09 וגם androidx.glance.wear:wear-core:1.0.0-alpha09 מופצים. גרסה ‎1.0.0-alpha09 מכילה את השמירות האלה.

שינויים ב-API

  • הוספנו את ExperimentalGlanceWearApi, שישמש לתכונות ניסיוניות של Glance Wear. (Id2f76, ‏ b/498179813)

תיקוני באגים

  • העדכון של כלי הניתוח של מטא-נתוני ה-XML של הווידג'טים ב-Wear מאפשר לו לזהות ווידג'טים במהלך ההפעלה.

גרסה ‎1.0.0-alpha08

‫22 באפריל 2026

‫androidx.glance.wear:wear:1.0.0-alpha08 וגם androidx.glance.wear:wear-core:1.0.0-alpha08 מופצים. גרסה ‎1.0.0-alpha08 מכילה את השמירות האלה.

תיקוני באגים

  • הוספנו תג <queries> למניפסט של ספריית glance:wear:wear כדי לוודא ש-PackageManager שולח שאילתות לשירותים הנכונים לקבלת עדכוני Push. (I192787)

אחר

  • ביטלנו את השינוי 'Updates Compose compileSdk to 37' (I6007) שחל גם על glance-wear, ולכן דרישת compileSdk כבר לא 37 בגרסה הזו.

גרסה ‎1.0.0-alpha07

‫8 באפריל 2026

‫androidx.glance.wear:wear:1.0.0-alpha07 וגם androidx.glance.wear:wear-core:1.0.0-alpha07 מופצים. גרסה ‎1.0.0-alpha07 מכילה את השמירות האלה.

תכונות חדשות

  • הוספת רקע לווידג'ט Wear כברירת מחדל אם WearWidgetBrush ריק או לא צוין. (I8300b)
  • עדכון getActiveWidgets API כדי להחזיר את סוג המאגר של הווידג'ט. (2772eb1)

שינויים ב-API

  • שינוי של Widget update API כך שיקבל WidgetInstanceId והוספה של helper לאחזור מזהים של ווידג'ט נתון. ה-API החדש מחזיר את השגיאה IllegalArgumentException אם המזהה שצוין לא תקין או לא בבעלות של מי שקורא ל-API. ‫(I6f3c5, ‏ b/446828899)
  • מוסיפים טווח צבעים אנכי ואופקי ב-WearWidgetBrush. (If70ae, b/470080675)

גרסה ‎1.0.0-alpha06

‫25 במרץ 2026

‫androidx.glance.wear:wear:1.0.0-alpha06 וגם androidx.glance.wear:wear-core:1.0.0-alpha06 מופצים. גרסה ‎1.0.0-alpha06 מכילה את השמירות האלה.

תכונות חדשות

  • מגדירים את הפעולות לפרופיל של ווידג'טים ב-Wear ישירות.

שינויים ב-API

  • שינינו את השם של CONTAINER_TYPE_FULLSCREEN ל-CONTAINER_TYPE_TILE_COMPAT כדי להבדיל טוב יותר בין הווידג'ט של התאמה למסך מלא. זה כולל חזרה ממיפוי שבו סוג ההמרה היה FULLSCREEN למיפוי שבו סוג ההמרה הוא LARGE בפרמטרים של הווידג'ט.

גרסה ‎1.0.0-alpha05

‫11 במרץ 2026

‫androidx.glance.wear:wear:1.0.0-alpha05 וגם androidx.glance.wear:wear-core:1.0.0-alpha05 מופצים. גרסה ‎1.0.0-alpha05 מכילה את השמירות האלה.

שינויים ב-API

  • הוספנו WearWidgetBrushAPI עם שיטת color לשימוש ברקע של הווידג'ט של Wear. (I66f54, ‏ b/464273091)
  • הוסר אמצעי התשלום fetchActiveWidgetsForProvider כי כבר קיים fetchActiveWidgets. (I85e4e, ‏ b/486197890)

גרסה ‎1.0.0-alpha04

‫25 בפברואר 2026

‫androidx.glance.wear:wear:1.0.0-alpha04 וגם androidx.glance.wear:wear-core:1.0.0-alpha04 מופצים. גרסה ‎1.0.0-alpha04 מכילה את השמירות האלה.

שינויים ב-API

  • נוסף GlanceWearWidgetManager API שמאפשר לאפליקציות לשלוח שאילתות לגבי הווידג'טים והמשבצות הפעילים שלהן. (I5be95)
  • העברנו ממשקי API מהספרייה glance:wear:wear-core לחבילה androidx.glance.wear.core. (I429cf)

תיקוני באגים

  • חשיפה של סוגים נפוצים של Remote Composable ו-Modifier‏ (Id1d40)

גרסה ‎1.0.0-alpha03

‫11 בפברואר 2026

‫androidx.glance.wear:wear:1.0.0-alpha03 וגם androidx.glance.wear:wear-core:1.0.0-alpha03 מופצים. גרסה ‎1.0.0-alpha03 מכילה את השמירות האלה.

שינויים ב-API

  • הוספנו תמיכה באירועי אינטראקציה ב-GlanceWearWidget. (Ia4e28, b/469808447)

גרסה ‎1.0.0-alpha02

‫28 בינואר 2026

‫androidx.glance.wear:wear:1.0.0-alpha02 וגם androidx.glance.wear:wear-core:1.0.0-alpha02 מופצים. גרסה ‎1.0.0-alpha02 מכילה את השמירות האלה.

תכונות חדשות

  • מיפוי מחדש של FULLSCREEN ל-LARGE בפרמטרים של הווידג'ט (ad78d95)

תיקוני באגים

  • תוקן השימוש ב-DataStore שגרם לכך שלא הוצגו כמה מופעים של ווידג'טים (474f3e4)

גרסה ‎1.0.0-alpha01

‫14 בינואר 2026

‫androidx.glance.wear:wear:1.0.0-alpha01 וגם androidx.glance.wear:wear-core:1.0.0-alpha01 מופצים. גרסה 1.0.0-alpha01 מכילה את השמירות האלה.

  • ‫Glance Wear היא ספרייה ליצירת ווידג'טים ל-Wear OS באמצעות RemoteCompose.