Glance Wear

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

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

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

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

מגניב

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

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

Kotlin

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

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

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

משוב

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

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

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

גרסה 1.0 של Glance 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 Widget.

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