Glance Wear

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

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

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

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

מגניב

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

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

Kotlin

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

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

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

משוב

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

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

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

גרסה 1.0 של Glance Wear

גרסה ‎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> ב-XML של <wearwidget-provider> Widget Metadata מציין באופן מפורש מאפיין 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 פעולת כתיבה מרחוק בפרופיל של ווידג'טים ל-Wear. כך אפשר להשתמש ב-RemoteText בתכונות של גופנים משתנים, כמו צירים של גופנים, גובה שורות וכו', במעבדי רינדור של מארחים נתמכים, עם חזרה אוטומטית למצב קודם אם אין תמיכה.

תיקונים

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

גרסה ‎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 לשיטות מחזור החיים של 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)
  • נוסף API‏ triggerUpdateAll ל-GlanceWearWidget כדי להפעיל עדכון בכל הווידג'טים של האפליקציה הנתונה. (I6ab20, ‏ b/510896410)

תיקוני באגים

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

גרסה ‎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

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

תיקוני באגים

  • תוקנה בעיה של קריסה חוזרת שמתרחשת בגרסה alpha09 באמולטור Wear 7 או במכשירים שמופעל בהם רכיב ה-Renderer בגרסה 1.6. הבעיה נפתרה על ידי מניעת שליחה של ציר גופן ריק ל-Player עבור הווידג'ט 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 שולחת שאילתות לשירותים הנכונים לקבלת עדכונים בדחיפה. (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 והוספת פונקציית עזר לאחזור מזהים של ווידג'ט נתון. ה-API החדש מחזיר IllegalArgumentException אם המזהה שסופק לא תקין או לא בבעלות המתקשר. (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

  • נוסף ממשק API‏ GlanceWearWidgetManager שמאפשר לאפליקציות לשלוח שאילתות לגבי הווידג'טים והאריחים הפעילים שלהן. (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.