Wear

בטבלה הזו מפורטים כל פריטי המידע בקבוצה androidx.wear.

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

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

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

dependencies {
    implementation "androidx.wear:wear:1.4.0"

    // Add support for wearable specific inputs
    implementation "androidx.wear:wear-input:1.2.0"
    implementation "androidx.wear:wear-input-testing:1.2.0"

    // Use to implement wear ongoing activities
    implementation "androidx.wear:wear-ongoing:1.1.0"

    // Use to implement support for interactions from the Wearables to Phones
    implementation "androidx.wear:wear-phone-interactions:1.1.1"
    // Use to implement support for interactions between the Wearables and Phones
    implementation "androidx.wear:wear-remote-interactions:1.2.0"
}

dependencies {
    implementation("androidx.wear:wear:1.4.0")

    // Add support for wearable specific inputs
    implementation("androidx.wear:wear-input:1.2.0")
    implementation("androidx.wear:wear-input-testing:1.2.0")

    // Use to implement wear ongoing activities
    implementation("androidx.wear:wear-ongoing:1.1.0")

    // Use to implement support for interactions from the Wearables to Phones
    implementation("androidx.wear:wear-phone-interactions:1.1.1")
    // Use to implement support for interactions between the Wearables and Phones
    implementation("androidx.wear:wear-remote-interactions:1.2.0")
}

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

משוב

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

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

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

Wear-Core

גרסה 1.2

גרסה ‎1.2.0-alpha01

‫23 בספטמבר 2026

‫androidx.wear:wear-core:1.2.0-alpha01 מופץ. גרסה ‎1.2.0-alpha01 מכילה את השמירות האלה.

שינויים ב-API

• נוספו הקבועים WEAR_CINNAMON_BUN_1 ו-WEAR_CINNAMON_BUN_2 לגרסאות חדשות של Wear OS אל WearApiVersionHelper. (Ifec88)

גרסה 1.1

גרסה 1.1.0

‫3 ביוני 2026

‫androidx.wear:wear-core:1.1.0 מופץ. גרסה 1.1.0 מכילה את השמירות האלה.

התכונות העיקריות של גרסה 1.1.0: * נוסף CINNAMON_BUN ב-WearApiVersionHelper לבדיקות תאימות של API מול SDK 37.

גרסה ‎1.1.0-rc01

‫19 במאי 2026

androidx.wear:wear-core:1.1.0-rc01 פורסמה ללא שינויים מהגרסה הקודמת. גרסה ‎1.1.0-rc01 מכילה את השמירות האלה.

גרסה ‎1.1.0-beta01

‫6 במאי 2026

‫androidx.wear:wear-core:1.1.0-beta01 מופץ. גרסה ‎1.1.0-beta01 מכילה את השמירות האלה.

שינויים ב-API

• הוספנו את CINNAMON_BUN ב-WearApiVersionHelper לבדיקות תאימות ל-API מול SDK 37.

גרסה ‎1.1.0-alpha02

‫8 באפריל 2026

‫androidx.wear:wear-core:1.1.0-alpha02 מופץ. גרסה ‎1.1.0-alpha02 מכילה את השמירות האלה.

תכונות חדשות

• הוספת VersionCodes חדש ל-WearApiVersionHelper (I86bc1, ‏ b/487264133)

גרסה ‎1.1.0-alpha-01

‫25 במרץ 2026

‫androidx.wear:wear-core:1.1.0-alpha-01 מופץ. גרסה ‎1.1.0-alpha-01 מכילה את השמירות האלה.

שינויים ב-API

• הוספנו את CINNAMON_BUN (SDK 37) ב-WearApiVersionHelper. (Id1ee0, ‏ b/487264133)

גירסה 1.0

גרסה 1.0.0

‫17 בדצמבר 2025

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

התכונות העיקריות של גרסה 1.0.0:

• הוספנו את WearApiVersionHelper כדי לעזור בבדיקת תאימות של API בזמן ריצה ב-Wear. לקוחות יכולים להשתמש במחלקה הסטטית הזו ובשיטה (#isApiVersionAtLeast(VERSION)) שמופיעה בה כדי לבדוק תאימות.

גרסה ‎1.0.0-rc01

‫8 באוקטובר 2025

הגרסה androidx.wear:wear-core:1.0.0-rc01 יוצאת ללא שינויים. גרסה ‎1.0.0-rc01 מכילה את השמירות האלה.

גרסה ‎1.0.0-beta02

‫10 בספטמבר 2025

‫androidx.wear:wear-core:1.0.0-beta02 מופץ. גרסה ‎1.0.0-beta02 מכילה את השמירות האלה.

תיקוני באגים

• מניעה של הפעלת WearApiVersionHelper במכשירים ישנים יותר כשבודקים ממשקי API חדשים יותר.

גרסה ‎1.0.0-beta01

‫30 ביולי 2025

הגרסה androidx.wear:wear-core:1.0.0-beta01 הושקה ללא שינויים משמעותיים מאז גרסת האלפא האחרונה. גרסה ‎1.0.0-beta01 מכילה את השמירות האלה.

גרסה ‎1.0.0-alpha02

‫16 ביולי 2025

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

שינויים ב-API

• עדכונים WearApiVersionHelper כולל VIC/Baklava ‏ (I4676d)

תיקוני באגים

• הספרייה הזו משתמשת עכשיו באנוטציות של JSpecify nullness, שהן מסוג type-use. מפתחי Kotlin צריכים להשתמש בארגומנטים הבאים של הקומפיילר כדי לאכוף שימוש נכון: -Xjspecify-annotations=strict, -Xtype-enhancement-improvements-strict-mode (Icbfb9, ‏ b/326456246)

גרסה ‎1.0.0-alpha01

‫29 במאי 2024

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

שינויים ב-API

• נוסף מחלקה חדשה WearApiVersionhelper כדי לעזור בבדיקת תאימות של API בזמן ריצה ב-Wear. לקוחות יכולים להשתמש במחלקה הסטטית הזו ובשיטה שסופקה (#isApiVersionAtLeast(VERSION)) כדי לבדוק תאימות.

Wear

גרסה 1.4

גרסה 1.4.0

‫25 בפברואר 2026

‫androidx.wear:wear:1.4.0 מופץ. גרסה 1.4.0 מכילה את השמירות האלה.

שינויים חשובים מאז גרסה 1.3.0:

• תיקון באג שקשור למרכוז אנכי של הסמל ConfirmationOverlay כשאין הודעה. I496d8

גרסה ‎1.4.0-rc01

‫28 בינואר 2026

‫androidx.wear:wear:1.4.0-rc01 מופץ. גרסה ‎1.4.0-rc01 מכילה את השמירות האלה.

• אין שינויים חדשים בין גרסת בטא01 לגרסת rc01.

גרסה ‎1.4.0-beta01

‫17 בדצמבר 2025

‫androidx.wear:wear:1.4.0-beta01 מופץ. גרסה ‎1.4.0-beta01 מכילה את השמירות האלה.

• לא בוצעו שינויים משמעותיים מאז גרסת האלפא הקודמת.

גרסה ‎1.4.0-alpha02

‫16 ביולי 2025

‫androidx.wear:wear:1.4.0-alpha02 מופץ. גרסה ‎1.4.0-alpha02 מכילה את השמירות האלה.

תיקוני באגים

• הספרייה הזו משתמשת עכשיו באנוטציות של JSpecify nullness, שהן מסוג type-use. מפתחי Kotlin צריכים להשתמש בארגומנטים הבאים של הקומפיילר כדי לאכוף שימוש נכון: -Xjspecify-annotations=strict, -Xtype-enhancement-improvements-strict-mode (If4b1a, b/326456246)

גרסה ‎1.4.0-alpha01

‫15 בנובמבר 2023

‫androidx.wear:wear:1.4.0-alpha01 מופץ. גרסה ‎1.4.0-alpha01 מכילה את השמירות האלה.

תיקוני באגים

• מרכוז אנכי של הסמל ConfirmationOverlay כשאין הודעה. (I496d8)

גרסה 1.3

גרסה 1.3.0

‫9 באוגוסט 2023

הגרסה androidx.wear:wear:1.3.0 הופצה ללא שינויים מאז 1.3.0-rc01. גרסה 1.3.0 מכילה את השמירות האלה.

שינויים חשובים מאז גרסה 1.2.0

• העברה של AmbientModeSupport לשימוש ב-LifecycleObserver. הוצאה משימוש של AmbientModeSupport לטובת מחלקות חדשות שמודעות למחזור החיים.
• עדכון ConfirmationOverlay עם סמלים/פריסה חדשים, גופנים ומדדי גופנים
• ‫SwipeDismissTransitionHelper עודכן כדי להשתמש בפריט גרפי שניתן להזזה ברקע במקום ב-View שני כדי לתקן שגיאות בשימוש ב-FragmentContainerView
• SwipeDismissFrameLayout האנימציה עודכנה כדי שתהיה עקבית עם פלטפורמת Wear וההטמעות של Wear Compose.
• SwipeDismissFrameLayout תיקון באג שמונע סגירה מקרית של פרגמנטים בהחלקה אנכית
• ‫ArcLayout תומך עכשיו במשקלים של הרחבות, שפועלים באופן דומה למשקלים של פריסות רגילות.
• תמיכה ב-layoutDirection ב-ArcLayout

גרסה ‎1.3.0-rc01

‫21 ביוני 2023

הגרסה androidx.wear:wear:1.3.0-rc01 הופצה ללא שינויים מאז 1.3.0-beta01. גרסה ‎1.3.0-rc01 מכילה את השמירות האלה.

גרסה ‎1.3.0-beta01

‫7 ביוני 2023

‫androidx.wear:wear:1.3.0-beta01 מופץ. גרסה ‎1.3.0-beta01 מכילה את השמירות האלה.

שינויים ב-API

• עדכון של AmbientLifecycleObserver אחרי קבלת משוב. השם של AmbientLifecycleObserverInterface השתנה לשם AmbientLifecycleObserver, ואפשר לקבל מופע על ידי קריאה ל-AmbientLifecycleObserver(...). המאפיין isAmbient הועבר להיות שדה במקום method. (I84b4f)

תיקוני באגים

• הוספת בדיקות של ערך null כדי לטפל במקרים שבהם תצוגת ההורה היא null בזמן איפוס האלפא והתרגום ב-SwipeToDismiss. (Ib0ec7)

גרסה ‎1.3.0-alpha05

‫19 באפריל 2023

‫androidx.wear:wear:1.3.0-alpha05 מופץ. גרסה ‎1.3.0-alpha05 מכילה את השמירות האלה.

שינויים ב-API

• העברה של AmbientModeSupport לשימוש ב-LifecycleObserver. הוצאה משימוש של AmbientModeSupport לטובת מחלקות חדשות עם מודעות למחזור החיים. (I1593b)

תיקוני באגים

• עדכון הגישה של SwipeDismissTransitionHelper background scrim כך שישתמש ב-drawables במקום להוסיף תצוגה כדי לתקן שגיאות במהלך השימוש ב-FragmentContainerView. (I851cd)

גרסה ‎1.3.0-alpha04

‫25 בינואר 2023

‫androidx.wear:wear:1.3.0-alpha04 מופץ. גרסה ‎1.3.0-alpha04 מכילה את השמירות האלה.

תיקוני באגים

• עדכנו את האנימציה ב-SwipeDismissFrameLayout כדי שתהיה עקבית עם פלטפורמת Wear וההטמעות של Wear Compose. (I7261b)

גרסה ‎1.3.0-alpha03

‫24 באוגוסט 2022

‫androidx.wear:wear:1.3.0-alpha03 מופץ. גרסה ‎1.3.0-alpha03 מכילה את השמירות האלה.

תכונות חדשות

• ‫ArcLayout תומך עכשיו במשקלים של הרחבות, שפועלים באופן דומה למשקלים של פריסות רגילות. כלומר, אתם יכולים לציין את הגודל היחסי של רכיבי צאצא בלי לחשב את הזוויות שלהם ישירות. הוספנו גם את האפשרות MaxAngleDegrees, שמתייחסת להרחבת רכיבי צאצא עם משקלים. לדוגמה, אפשר להגביל את הקשת עם כמה צאצאים במשקלים ל-90 מעלות, והמגבלה הזו תתחשב גם במקום שתופסים רכיבים שלא הורחבו.

שינויים ב-API

• הוספנו משקל ל-ArcLayout.LayoutParams, שמאפשר לווידג'ט להתרחב כדי למלא את השטח הזמין. אם יש יותר מווידג'ט אחד, החלק שלהם מהשטח הזמין יהיה יחסי למשקל שלהם. בנוסף, הוספנו את ArcLayout.setMaxAngleDegrees כדי שתוכלו, למשל, להגביל את ההרחבה ל-90 מעלות (הערה: ההגדרה הזו לא משפיעה על הפריסה של ווידג'טים משניים בגודל קבוע). לבסוף, ל-ArcLayout.Widget יש עכשיו setSweepAngleDegrees שמאפשר ל-ArcLayout להודיע לווידג'ט עם משקל שאינו אפס על הגודל שלו. (I75f24)
• עודכן מאפיין המציין אם ערך יכול להיות ריק (nullability) של setColorFilter(I99ddf, b/236498063)

גרסה ‎1.3.0-alpha02

23 בפברואר 2022

‫androidx.wear:wear:1.3.0-alpha02 מופץ. גרסה ‎1.3.0-alpha02 מכילה את השמירות האלה.

תכונות חדשות

• תמיכה ב-layoutDirection ב-ArcLayout (I14d49)
• שיפור של הודעת תיאור התוכן ב-ConfirmationOverlay ‏ (I0fdf8)
• עדכון ConfirmationOverlay עם סמלים או פריסה חדשים. (If5b54)

תיקוני באגים

• נוספו כללי ProGuard כדי לוודא שהקוד שקשור לסביבה נשמר (Idaa10)
• הימנעות מסגירה לא מכוונת של פרגמנטים ב-SwipeDismissFrameLayout באמצעות הטלה אנכית (Idb6d8)
• תיקון של ConfirmationOverlay כשאין הודעה (I63e6f)

External Contribution

• ‫Dae Gyu LEE (Samsung) – מניעת סגירה לא מכוונת של פרגמנטים ב-SwipeDismissFrameLayout באמצעות החלקה אנכית (Idb6d8)

גרסה ‎1.3.0-alpha01

‫29 בספטמבר 2021

‫androidx.wear:wear:1.3.0-alpha01 מופץ. גרסה ‎1.3.0-alpha01 מכילה את השמירות האלה.

תיקוני באגים

• ConfirmationOverlay מעלה עכשיו את הסמל כדי להכיל הודעות ארוכות יותר, בלי שההודעה תיכנס למסגרת של המכשיר (או תצא מהמסך). (I54bff)

גרסה 1.2

גרסה 1.2.0

‫15 בספטמבר 2021

‫androidx.wear:wear:1.2.0 מופץ. גרסה 1.2.0 מכילה את השמירות האלה.

שינויים חשובים מאז גרסה 1.1.0

• נוסף רכיב CurvedText לכתיבה קלה של טקסט מעוקל בהתאם לעיקול של העיגול הגדול ביותר שאפשר לחרוט בתצוגה. דוגמה לשימוש:

  <androidx.wear.widget.CurvedText
          android:layout_width="wrap_content"
          android:layout_height="wrap_content"
          android:text="example curved text"
          app:anchorAngleDegrees="180"
          app:anchorPosition="center"
          app:clockwise="false"
          style="@android:style/TextAppearance.Large"
  />
  

  

• נוסף מאגר ArcLayout לפריסת רכיבי הצאצא שלו אחד אחרי השני על קשת בכיוון השעון או נגד כיוון השעון. הילדים שלו יכולים להיות ווידג'טים רגילים של Android או ווידג'טים 'מעוקלים' שמיישמים את הממשק ArcLayout.Widget. ‫(I536da) דוגמה לשימוש:

  <androidx.wear.widget.ArcLayout
          android:layout_width="match_parent"
          android:layout_height="match_parent"
          app:anchorPosition="center">
        <ImageView
                android:layout_width="20dp"
                android:layout_height="20dp"
                android:src="@drawable/ic_launcher"
        />
        <androidx.wear.widget.CurvedText
                android:layout_width="match_parent"
                android:layout_height="match_parent"
                android:text="Curved Text"
                style="@android:style/TextAppearance.Small"
                android:padding="2dp"
         />
    </androidx.wear.widget.WearArcLayout>
  

  

• נוסף מאגר פריסות חדש, DismissibleFrameLayout, שמטפל בסגירה באמצעות לחצן החזרה או בהחלקה לסגירה, והוא מיועד לשימוש בתוך פעילות. צריך להוסיף לפחות מאזין אחד שיפעל על פעולת סגירה. בדרך כלל, רכיב Listener יסיר תצוגה או קטע שמכילים אותו מהפעילות הנוכחית. הפונקציות setSwipeDismissible(boolean)‎ ו-setBackButtonDismissible(boolean)‎ מספקות שליטה ישירה בתכונות. הפריסה החדשה הזו נועדה להחליף את SwipeDismissFrameLayout הקיים.

• נוסף תמיכה בציון שאפשר להפעיל מחדש פעילות באופן אוטומטי כשהמכשיר יוצא ממצב תאורת אווירה במחלקה AmbientModeSupport. הפונקציונליות הזו הייתה זמינה בעבר במחלקה WearableActivity שהוצאה משימוש מ-WearableSupportLibrary. (I336ab)

• הועבר WearableCalendarContract class מ-Wearable Support Library. ה-API הזה מספק קבוצת משנה של הנתונים שזמינים דרך CalendarContract, אבל הוא מסונכרן אוטומטית עם מכשירים לבישים. (I6f2d7)

• נוסף API חדש WearTypeHelper ב-androidx.wear.utils כדי לקבוע אם מכשיר ה-Wear שצוין מיועד לסין. (Ib01a9)

• הוספנו ל-androidx.wear.widget.ConfirmationOverlay תכונות נגישות שיקריאו הודעות אם הן מוגדרות, ואחריהן תיאור של האנימציה. (I524dd)

• תוקן באג שגרם לקריסה של ConfirmationActivity אם לא סופקה הודעה. (Ie6055)

• תוקן באג שגרם לכך ש-WearableDrawerLayout הציג תצוגה מקדימה בכל האינטראקציות ב-RecyclerViews עם גלילה אופקית. (I24c7f)

גרסה ‎1.2.0-rc01

‫1 בספטמבר 2021

הגרסה של androidx.wear:wear:1.2.0-rc01 לא כוללת שינויים מאז גרסת הבטא האחרונה. גרסה ‎1.2.0-rc01 מכילה את השמירות האלה.

גרסה ‎1.2.0-beta01

‫18 באוגוסט 2021

‫androidx.wear:wear:1.2.0-beta01 מופץ. גרסה ‎1.2.0-beta01 מכילה את השמירות האלה.

תיקוני באגים

• תוקן באג שגרם לקריסת ConfirmationActivity אם לא סופקה הודעה. (Ie6055)

גרסה ‎1.2.0-alpha13

‫4 באוגוסט 2021

‫androidx.wear:wear:1.2.0-alpha13 מופץ. גרסה ‎1.2.0-alpha13 מכילה את השמירות האלה.

שינויים ב-API

• השם של WearTypeHelper.isChinaDevice שונה לWearTypeHelper.isChinaBuild. (I47302)

תיקוני באגים

• הוספנו ל-androidx.wear.widget.ConfirmationOverlay תכונות נגישות שיקריאו את ההודעות אם הן מוגדרות, ואחריהן תיאור של האנימציה. (I524dd)

גרסה ‎1.2.0-alpha12

‫21 ביולי 2021

‫androidx.wear:wear:1.2.0-alpha12 מופץ. גרסה ‎1.2.0-alpha12 מכילה את השמירות האלה.

שינויים ב-API

• הוספנו API חדש WearTypeHelper ב-androidx.wear.utils כדי לקבוע אם מכשיר Wear שצוין מיועד לסין. (Ib01a9)

גרסה ‎1.2.0-alpha11

‫30 ביוני 2021

‫androidx.wear:wear:1.2.0-alpha11 מופץ. גרסה ‎1.2.0-alpha11 מכילה את השמירות האלה.

תיקוני באגים

• תוקן באג שגרם לכך ש-WearableDrawerLayout הציג תצוגה מקדימה בכל האינטראקציות ב-RecyclerViews עם גלילה אופקית. (I24c7f)

גרסה ‎1.2.0-alpha10

‫2 ביוני 2021

‫androidx.wear:wear:1.2.0-alpha10 מופץ. גרסה ‎1.2.0-alpha10 מכילה את השמירות האלה.

תכונות חדשות

• גרסה Alpha10 משפרת את תמיכת הנגישות ב-Curved Text וב-ArcLayouts. בנוסף, בוצעו שינויים קלים בשמות של רכיבים ב-DismissibleFrameLayout כדי להבהיר את השימוש ב-API.

שינויים ב-API

• שינינו את השם של ה-methods הבאים ב-DismissibleFrameLayout (Ib195e):
  • Callback#onDismissed -> Callback#onDismissedFinished
  • isSwipeDismissible -> isDismissableBySwipe
  • isBackButtonDismissible -> isDismissableByBackButton
• השיטות הבאות הן סופיות (Ib195e):
  • setBackButtonDismissible
  • setSwipeDismissible
  • registerCallback
  • unregisterCallback

תיקוני באגים

• שימוש בתוכן של CurvedTextView ב-Talkback. (I05798)
• שיפור הנגישות לתצוגות רגילות ב-ArcLayout. (I4418d)

גרסה ‎1.2.0-alpha09

‫18 במאי 2021

‫androidx.wear:wear:1.2.0-alpha09 מופץ. גרסה ‎1.2.0-alpha09 מכילה את השמירות האלה.

שינויים ב-API

• נוספה פונקציה חדשה CurvedTextView.setTypeface() (בדומה ל-TextView's), להגדרת גופן הטקסט וסגנון ההדגשה או ההטיה. (I4653c)
• השם של WearArcLayout שונה ל-ArcLayout, השם של WearCurvedText שונה ל-CurvedText והשם של WearArcLayout.ArcLayoutWidget שונה ל-ArcLayout.Widget. (I6e5ce)
  • בתאריך ArcLayout.Widget, שינה את השם של getThicknessPx לgetThickness.
  • הקבועים של היישור האנכי ב-ArcLayout.LayoutParams נקראים עכשיו בשמות שמתחילים ב-VERTICAL_ALIGN_ (במקום VALIGN_ כמו קודם)
• ב-CurvedTextView, השיטות setMinSweepDegrees ו-setMaxSweepDegrees הוחלפו ב-setSweepRangeDegrees (I7a9d9)

גרסה ‎1.2.0-alpha08

‫5 במאי 2021

‫androidx.wear:wear:1.2.0-alpha08 מופץ. גרסה ‎1.2.0-alpha08 מכילה את השמירות האלה.

שינויים ב-API

• כדי לשפר את הבהירות של הקוד, הוספנו @FloatRange הערות לכמה פרמטרים של זווית ולסוגי החזרה. (I430dd)
• בממשק WearArcLayout.ArcLayoutWidget, השיטה insideClickArea נקראת עכשיו isPointInsideClickArea. (Ia7307)

גרסה ‎1.2.0-alpha07

‫24 במרץ 2021

‫androidx.wear:wear:1.2.0-alpha07 מופץ. גרסה ‎1.2.0-alpha07 מכילה את השמירות האלה.

תיקוני באגים

• תיקון שגיאות שקשורות לרכיבי צאצא לא מעוגלים בתוך WearArcLayout שנגרמות כתוצאה משימוש בגודל מסך עם גובה גדול יותר מרוחב. הילדים הלא מעוקלים האלה מוצבים עכשיו בצורה נכונה בתוך קשת בכל סוגי המסכים.

גרסה ‎1.2.0-alpha06

‫27 בינואר 2021

‫androidx.wear:wear:1.2.0-alpha06 מופץ. גרסה ‎1.2.0-alpha06 מכילה את השמירות האלה.

שינויים ב-API

• העברנו את ספריית הפעילויות המתמשכות לספריית משנה חדשה: wear-ongoing. המחלקות נמצאות עכשיו בחבילה androidx.wear.ongoing (קודם הן היו בחבילה androidx.wear.ongoingactivities) (I7c029)
• העברה של המחלקה WearableCalendarContract מ-Wearable Support Library אל AndroidX. ה-API הזה מספק קבוצת משנה של הנתונים שזמינים דרך CalendarContract, אבל הוא מסונכרן אוטומטית עם מכשירים לבישים. (I6f2d7)

תיקוני באגים

• השבתנו כברירת מחדל את התכונה של סגירת המסך בלחיצה על הכפתור "הקודם" ב-Dismissible FrameLayout, כי החלקה לסגירה נשארה הדרך העיקרית לחזרה למסך מלא במכשירים לבישים (Ic24e3)
• תוקנו כמה בעיות שקשורות לטיפול בניראות של רכיבי צאצא ב-WearArcLayout ‏ (Icf912)

גרסה ‎1.2.0-alpha05

‫13 בינואר 2021

‫androidx.wear:wear:1.2.0-alpha05 מופץ. גרסה ‎1.2.0-alpha05 מכילה את השמירות האלה.

תיקוני באגים

• עדכון של javadoc של המחלקה AmbientModeSupport כדי לספק קטעי קוד לדוגמה שימחישו טוב יותר את השימוש הכללי במחלקה הזו.

גרסה ‎1.2.0-alpha04

‫16 בדצמבר 2020

‫androidx.wear:wear:1.2.0-alpha04 מופץ. גרסה ‎1.2.0-alpha04 מכילה את השמירות האלה.

שינויים ב-API

• נוסף תמיכה בציון שאפשר להפעיל מחדש פעילות באופן אוטומטי כשהמכשיר יוצא ממצב תאורת אווירה במחלקה AmbientModeSupport. הפונקציונליות הזו הייתה זמינה בעבר במחלקה WearableActivity שהוצאה משימוש מ-WearableSupportLibrary. (I336ab)
• OngoingActivity
  • מעכשיו אפשר להגדיר קטגוריה כשיוצרים OngoingActivity, למשל OngoingActivitiy.Builder.getCategory(String)
  • ל-OngoingActivityData נוספה חותמת זמן של מועד היצירה של OngoingActivity – OngoingActivityData.getTimestamp()
  • (I91cb4)
• נוסף תמיכה בהגדרת שוליים ברכיבי צאצא של WearArcLayout על ידי שינוי פרמטרים של פריסה להרחבת MarginLayoutParams, כלומר WearArcLayout.LayoutParams מרחיב את android.view.ViewGroup.MarginLayoutParams. (I2cd88)
• שינוי ברירת המחדל של סוג העוגן של WearCurvedTextView ל-WearArcLayout.ANCHOR_CENTER (היה WearArcLayout.ANCHOR_START). השינוי הזה מפשט את החוזה בין פריסת הקשת לבין הטקסט המעוקל, כי הטקסט המעוקל מצייר את עצמו כברירת מחדל במרכז בציר ה-X בחלק העליון, ופריסת הקשת של רכיב האב יכולה לסובב אותו למקום שבו הוא צריך להיות. (I105ff)

גרסה ‎1.2.0-alpha03

‫2 בדצמבר 2020

‫androidx.wear:wear:1.2.0-alpha03 מופץ. גרסה ‎1.2.0-alpha03 מכילה את השמירות האלה.

תכונות חדשות

רכיב פריסה חדש DismissibleFrameLayout, שמטפל בסגירה באמצעות לחצן החזרה או בהחלקה לסגירה, ומיועד לשימוש בתוך פעילות. צריך להוסיף לפחות מאזין אחד שיפעל על פעולת סגירה. בדרך כלל, רכיב Listener יסיר תצוגה או קטע שמכילים אותו מהפעילות הנוכחית. הפונקציות setSwipeDismissible(boolean)‎ ו-setBackButtonDismissible(boolean)‎ מספקות שליטה ישירה בתכונות. הפריסה החדשה הזו נועדה להחליף את SwipeDismissFrameLayout הקיים.

ווידג'טים מעוקלים מטפלים עכשיו באירועי מגע. ווידג'טים רגילים בתוך WearArcLayout יקבלו את כל אירועי המגע, שמופים למרחב הקואורדינטות שלהם. אפשר להגדיר ל-WearCurvedTextView (בתוך WearArcLayout או מחוצה לו) מטפלים באירועים onClick ו-onLongClick.

הפעילויות בכיתות שמתקיימות באופן שוטף הן עכשיו VersionedParcelables במקום להשתמש בסדרות (serialization) או בביטול סדרות (deserialization) בהתאמה אישית. עכשיו צריך להוסיף את הסמל הסטטי ואת כוונת המגע.

שינויים ב-API

• המאפיין sweepDegrees של WearCurvedTextView מופרד ל-minSweepDegrees ול-maxSweepDegrees כדי לאפשר פריסה גמישה יותר של הווידג'ט הזה.

גרסה ‎1.2.0-alpha02

11 בנובמבר 2020

‫androidx.wear:wear:1.2.0-alpha02 מופץ. גרסה ‎1.2.0-alpha02 מכילה את השמירות האלה.

בגרסה הזו נוסף לראשונה Ongoing Activities API (ממשק API לפעילויות מתמשכות). מפתחים יכולים להשתמש ב-API הזה כדי לציין שפעילות שנמשכת זמן רב, כמו אימון כושר או הפעלת מדיה, מתבצעת כרגע. ההרשאה מאפשרת למפתחים לספק עדכוני סטטוס תקופתיים כמו 'מרחק וזמן ריצה' או 'הטראק הנוכחי שמופעל' להצגה בתצוגת השעון או במפעיל האפליקציות. הפונקציונליות הזו מיועדת למכשירים עתידיים שבהם מופעלת הפונקציונליות של פעילות מתמשכת.

שינויים ב-API

• ‫API חדש לפעילויות מתמשכות, זו פעולה שלא מתבצעת ב'מכשירים לא נתמכים'. (I69a31)

גרסה ‎1.2.0-alpha01

28 באוקטובר 2020

‫androidx.wear:wear:1.2.0-alpha01 מופץ. גרסה ‎1.2.0-alpha01 מכילה את השמירות האלה.

תכונות חדשות

• נוסף רכיב WearCurvedTextView לכתיבה קלה של טקסט מעוקל בהתאם לעיקול של המעגל הגדול ביותר שאפשר לחסום בתצוגה. דוגמה לשימוש:

<androidx.wear.widget.WearCurvedTextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="example curved text"
        app:anchorAngleDegrees="180"
        app:anchorPosition="center"
        app:clockwise="false"
        style="@android:style/TextAppearance.Large"
/>

• נוסף מאגר WearArcLayout לפריסת רכיבי הצאצא שלו אחד אחרי השני על קשת בכיוון השעון או נגד כיוון השעון. הילדים שלו יכולים להיות גם ווידג'טים רגילים של Android או ווידג'טים 'מעוקלים' שמיישמים את הממשק ArcLayoutWidget שלו. דוגמה לשימוש:

<androidx.wear.widget.WearArcLayout
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        app:anchorPosition="center">
      <ImageView
              android:layout_width="20dp"
              android:layout_height="20dp"
              android:src="@drawable/ic_launcher"
      />
      <androidx.wear.widget.WearCurvedTextView
              android:layout_width="match_parent"
              android:layout_height="match_parent"
              android:text="Curved Text"
              style="@android:style/TextAppearance.Small"
              android:padding="2dp"
       />
  </androidx.wear.widget.WearArcLayout>

(I536da)

גרסה 1.1

גרסה 1.1.0

‫14 באוקטובר 2020

‫androidx.wear:wear:1.1.0 מופץ. גרסה 1.1.0 מכילה את השמירות האלה.

שינויים משמעותיים מאז גרסה 1.0.0

• הוספנו את הקידומת layout_ למאפיין boxedEdges (עכשיו layout_BoxedEdges) עבור BoxInsetLayout כדי לעמוד בדרישות של מוסכמת מתן השמות ב-Android. כך תסירו את שגיאת ה-linter ב-Android Studio לגבי המאפיינים האלה. (I4272f)
• הוספנו את האפשרות EXTRA_ANIMATION_DURATION_MILLIS ל-ConfirmationActivity כדי לאפשר את משך הזמן שבו מוצגת תיבת הדו-שיח לאישור. (adb83ce, ‏ b/143356547)
• עדכנו את WearableActionDrawViewכך שהרחבת חלונית הזזה של פעולות תתבצע רק כשהמגירה תיפתח בפעם הראשונה. (I01026, ‏ b/163870541)

גרסה ‎1.1.0-rc03

‫2 בספטמבר 2020

‫androidx.wear:wear:1.1.0-rc03 מופץ. גרסה ‎1.1.0-rc03 מכילה את השמירות האלה.

תיקוני באגים

• תוקנה בעיה שגרמה לכך שחלונית הפעולות לא הציגה תוכן כשפתחו אותה. (I01026, ‏ b/163870541)

גרסה ‎1.1.0-rc02

‫24 ביוני 2020

‫androidx.wear:wear:1.1.0-rc02 מופץ. גרסה ‎1.1.0-rc02 מכילה את השמירות האלה.

תיקוני באגים

• הוספנו את הקידומת layout_ למאפיין boxedEdges (עכשיו layout_boxedEdges) עבור BoxInsetLayout כדי לעמוד בדרישות של מוסכמת מתן השמות ב-Android. פעולה זו תסיר את שגיאת ה-linter ב-Android Studio לגבי המאפיינים האלה.

גרסה ‎1.1.0-rc01

14 במאי 2020

הגרסה androidx.wear:wear:1.1.0-rc01 הופצה ללא שינויים מאז .1.0-beta01. גרסה ‎1.1.0-rc01 מכילה את השמירות האלה.

גרסה ‎1.1.0-beta01

29 באפריל 2020

הגרסה androidx.wear:wear:1.1.0-beta01 יוצאת ללא שינויים מאז androidx.wear:wear:1.1.0-alpha01. גרסה ‎1.3.0-beta01 מכילה את השמירות האלה.

גרסה ‎1.1.0-alpha01

15 באפריל 2020

‫androidx.wear:wear:1.1.0-alpha01 מופץ. גרסה ‎1.1.0-alpha01 מכילה את השמירות האלה.

שינויים ב-API

• הוספנו את האפשרות EXTRA_ANIMATION_DURATION_MILLIS ל-ConfirmationActivity כדי לאפשר את משך הזמן שבו מוצגת תיבת הדו-שיח לאישור. (adb83ce, ‏ 134523c, ‏ b/143356547)

תיקוני באגים

• עדכנו את WearableActionDrawViewכך שהרחבת חלונית הזזה של פעולות תתבצע רק כשהמגירה תיפתח בפעם הראשונה. (5cd32f7)

Wear-Remote-Interactions

גרסה 1.3.0

גרסה ‎1.3.0-beta01

‫23 בספטמבר 2026

‫androidx.wear:wear-remote-interactions:1.3.0-beta01 מופץ. גרסה ‎1.3.0-beta01 מכילה את השמירות האלה.

• הוספנו את startRemoteActivityAttemptUnlock ואת startPhoneActivityWithUnlock ל-RemoteActivityHelper, כדי שאפליקציות ל-Wear OS יוכלו להתחיל פעילות בטלפון המחובר אחרי פתיחת הנעילה של הטלפון, בכפוף להרשמה של המשתמש לתכונה וליכולות הפלטפורמה. אם התכונה לא זמינה, אפשר לחזור לגרסה הקיימת של startRemoteActivityAttemptUnlockstartRemoteActivity.

גרסה ‎1.3.0-alpha01

‫19 במאי 2026

‫androidx.wear:wear-remote-interactions:1.3.0-alpha01 מופץ. גרסה ‎1.3.0-alpha01 מכילה את השמירות האלה.

שינויים ב-API

• הוספנו את startRemoteActivityAttemptUnlock ואת startPhoneActivityWithUnlock ל-RemoteActivityHelper, כדי שאפליקציות ל-Wear OS יוכלו להתחיל פעילות בטלפון המחובר אחרי פתיחת הנעילה של הטלפון, בכפוף להרשמה של המשתמש לתכונה וליכולות הפלטפורמה. אם התכונה לא זמינה, אפשר לחזור לגרסה הקיימת של startRemoteActivityAttemptUnlockstartRemoteActivity. (Ic23ae, b/468374830)

גרסה 1.2

גרסה 1.2.0

‫25 בפברואר 2026

‫androidx.wear:wear-remote-interactions:1.2.0 מופץ. גרסה 1.2.0 מכילה את השמירות האלה.

שינויים חשובים מאז גרסה 1.1.0:

• האפליקציה עודכנה RemoteActivityHelper.startRemoteActivity כדי להשתמש ב-API חדש של Wear SDK (‏startRemoteActivity) אם הוא זמין (מגרסה Wear 6 ואילך). Id1e77
• עדכנו את התלות בגרסה של Play Basement, שכללה את נקודת החולשה CVE-2022-2390.

גרסה ‎1.2.0-rc01

‫28 בינואר 2026

‫androidx.wear:wear-remote-interactions:1.2.0-rc01 מופץ. גרסה ‎1.2.0-rc01 מכילה את השמירות האלה.

תיקוני באגים

• עדכנו את התלות בגרסה של Play Basement, שכללה את נקודת החולשה CVE-2022-2390.

גרסה ‎1.2.0-beta01

‫17 בדצמבר 2025

‫androidx.wear:wear-remote-interactions:1.2.0-beta01 מופץ. גרסה ‎1.2.0-beta01 מכילה את השמירות האלה.

• לא בוצעו שינויים משמעותיים מאז גרסת האלפא הקודמת.

גרסה ‎1.2.0-alpha01

‫2 ביולי 2025

‫androidx.wear:wear-remote-interactions:1.2.0-alpha01 מופץ. גרסה ‎1.2.0-alpha01 מכילה את השמירות האלה.

תכונות חדשות

• האפליקציה עודכנה RemoteActivityHelper.startRemoteActivity כדי להשתמש ב-API חדש של Wear SDK (‏startRemoteActivity) אם הוא זמין (מגרסה Wear 6 ואילך). (Id1e77)

גרסה 1.1

גרסה 1.1.0

‫11 בדצמבר 2024

‫androidx.wear:wear-remote-interactions:1.1.0 מופץ. גרסה 1.1.0 מכילה את השמירות האלה.

שינויים חשובים מאז גרסה 1.0.0

• הוספנו את RemoteActivityHelper.isRemoteActivityHelperAvailable כדי לבדוק אם הפונקציונליות של הפעלת פעילות מרחוק זמינה. (I107a9)

גרסה ‎1.1.0-rc01

‫16 באוקטובר 2024

הגרסה androidx.wear:wear-remote-interactions:1.1.0-rc01 הופצה ללא שינויים מאז 1.1.0-beta01. גרסה ‎1.1.0-rc01 מכילה את השמירות האלה.

גרסה ‎1.1.0-beta01

‫24 ביולי 2024

‫androidx.wear:wear-remote-interactions:1.1.0-beta01 מופץ. גרסה ‎1.1.0-beta01 מכילה את השמירות האלה. גרסה 1.3.0-beta01 של Wear Remote Interactions מציינת שהגרסה הזו של הספרייה כוללת את כל התכונות וה-API נעול (למעט במקרים שבהם הוא מסומן כניסיוני).

גרסה ‎1.1.0-alpha02

‫10 בינואר 2024

‫androidx.wear:wear-remote-interactions:1.1.0-alpha02 מופץ. גרסה ‎1.1.0-alpha02 מכילה את השמירות האלה.

שינויים ב-API

• הוספנו את RemoteActivityHelper.isRemoteActivityHelperAvailable כדי לבדוק אם הפונקציונליות של הפעלת פעילות מרחוק זמינה. (I107a9)
• עדכנו את ה-constructor של RemoteActivityHelper כך שיכלול פרמטר אופציונלי שתואם ל-Java. (I75554)

גרסה ‎1.1.0-alpha01

‫21 ביוני 2023

‫androidx.wear:wear-remote-interactions:1.1.0-alpha01 מופץ. גרסה ‎1.1.0-alpha01 מכילה את השמירות האלה.

תיקוני באגים

• שיפרנו את האופן שבו מתבצעת השלמה וטיפול בשגיאות ב-RemoteActivityHelper. (I60d60)

External Contribution

• מסירים את התלות ב-Guava מ-wear-remote-interactions ומשתמשים בחלופות קטנות יותר.

Wear-Input

גרסה 1.2

גרסה 1.2.0

‫10 בספטמבר 2025

‫androidx.wear:wear-input:1.2.0 וגם androidx.wear:wear-input-testing:1.2.0 מופצים. גרסה 1.2.0 מכילה את השמירות האלה.

שינויים חשובים מאז גרסה 1.1.0:

• קבועים של מיקום לחצן פיזי שנחשפים.
• נוסף WearableRemoteInputExtender להגדרת תוספים ספציפיים ל-Wear ב-android.app.RemoteInput (לדוגמה, הפעלת קלט אמוג'י)

גרסה ‎1.2.0-rc01

‫27 באוגוסט 2025

הגרסאות של androidx.wear:wear-input:1.2.0-rc01 ו-androidx.wear:wear-input-testing:1.2.0-rc01 שוחררו ללא שינויים מאז גרסת הבטא האחרונה. גרסה ‎1.2.0-rc01 מכילה את השמירות האלה.

גרסה ‎1.2.0-beta01

‫30 ביולי 2025

הגרסאות androidx.wear:wear-input:1.2.0-beta01 ו-androidx.wear:wear-input-testing:1.2.0-beta01 פורסמו ללא שינויים משמעותיים מאז גרסאות האלפא האחרונות. גרסה ‎1.2.0-beta01 מכילה את השמירות האלה.

גרסה ‎1.2.0-alpha04

‫16 ביולי 2025

‫androidx.wear:wear-input:1.2.0-alpha04 וגם androidx.wear:wear-input-testing:1.2.0-alpha04 מופצים. גרסה ‎1.2.0-alpha04 מכילה את השמירות האלה.

תכונות חדשות

• צריך להתחשב בסיבוב המסך כשמחשבים את המיקום של הלחצנים הפיזיים ביחס למסך. (87a57e)

שינויים ב-API

• משנים את השם של LOC* ‎ ל-LOCATION* ‎ בקובץ wear-input. (I5e879)

תיקוני באגים

• הספרייה הזו משתמשת עכשיו באנוטציות של JSpecify nullness, שהן מסוג type-use. מפתחי Kotlin צריכים להשתמש בארגומנטים הבאים של הקומפיילר כדי לאכוף שימוש נכון: -Xjspecify-annotations=strict, -Xtype-enhancement-improvements-strict-mode (Icbfb9, ‏ b/326456246)

גרסה ‎1.2.0-alpha02

‫29 בספטמבר 2021

‫androidx.wear:wear-input:1.2.0-alpha02 וגם androidx.wear:wear-input-testing:1.2.0-alpha02 מופצים. גרסה ‎1.2.0-alpha02 מכילה את השמירות האלה.

שינויים ב-API

• שם המשתנה disallowEmoji שונה ל-setEmojisAllowed ב-WearableRemoteInputExtender כדי להגדיר אם תוצג האפשרות לצייר סמלי אמוג'י. (I28393)

גרסה ‎1.2.0-alpha01

‫15 בספטמבר 2021

‫androidx.wear:wear-input:1.2.0-alpha01 וגם androidx.wear:wear-input-testing:1.2.0-alpha01 מופצים. גרסה ‎1.2.0-alpha01 מכילה את השמירות האלה.

שינויים ב-API

• הצגנו את כל הקבועים של מיקומי הלחצנים מ-WearableButtons. (Ibb12c)
• נוספה המחלקה WearableRemoteInputExtender שאפשר להשתמש בה כדי להוסיף תוספים ספציפיים ל-Wear אל android.app.RemoteInput. (I01903)

גרסה 1.1

גרסה 1.1.0

‫18 באוגוסט 2021

‫androidx.wear:wear-input:1.1.0 וגם androidx.wear:wear-input-testing:1.1.0 מופצים. גרסה 1.1.0 מכילה את השמירות האלה.

שינויים חשובים מאז גרסה 1.0.0

• RemoteInputIntentHelper נוסף.
  • אפשר להשתמש במחלקה הזו כדי ליצור Intent של RemoteInput. אפשר להשתמש בנתונים האלה כדי לבקש קלט מהמשתמשים בפעילות שניתנת להתאמה אישית.

גרסה ‎1.1.0-rc01

‫4 באוגוסט 2021

‫androidx.wear:wear-input:1.1.0-rc01 וגם androidx.wear:wear-input-testing:1.1.0-rc01 מופצים. גרסה ‎1.1.0-rc01 מכילה את השמירות האלה.

אין שינויים ב-API מאז androidx.wear:wear-input:1.1.0-beta01 ו-androidx.wear:wear-input-testing:1.1.0-beta01

גרסה ‎1.1.0-beta01

‫21 ביולי 2021

הגרסאות androidx.wear:wear-input:1.1.0-beta01 ו-androidx.wear:wear-input-testing:1.1.0-beta01 יצאו ללא שינויים מאז 1.1.0-alpha03. גרסה ‎1.1.0-beta01 מכילה את השמירות האלה.

גרסה ‎1.1.0-alpha03

‫30 ביוני 2021

‫androidx.wear:wear-input:1.1.0-alpha03 וגם androidx.wear:wear-input-testing:1.1.0-alpha03 מופצים. גרסה ‎1.1.0-alpha03 מכילה את השמירות האלה.

תיקוני באגים

• תוקן באג שגרם לדחייה של כוונות RemoteInput שהתווספו להן RemoteInput באמצעות RemoteInputHelper.putRemoteInputsExtra.

גרסה ‎1.1.0-alpha02

‫18 במאי 2021

‫androidx.wear:wear-input:1.1.0-alpha02 וגם androidx.wear:wear-input-testing:1.1.0-alpha02 מופצים. גרסה ‎1.1.0-alpha02 מכילה את השמירות האלה.

שינויים ב-API

• השיטות של RemoteInputIntentHelper שמשמשות לקבלת או להצבת תוספים שמייצגים תוויות של שם, ביטול, אישור ובתהליך, משתמשות עכשיו ב-CharSequence במקום ב-String עבור התוויות האלה. (I0e71f)

גרסה ‎1.1.0-alpha01

‫27 בינואר 2021

‫androidx.wear:wear-input:1.1.0-alpha01 וגם androidx.wear:wear-input-testing:1.1.0-alpha01 מופצים. גרסה ‎1.1.0-alpha01 מכילה את השמירות האלה.

שינויים ב-API

• העברה של המחלקה RemoteInputIntent מ-Wearable Support Library ל-AndroidX. השם של המחלקה שהועברה משתנה ל-RemoteInputIntentHelper, שמספקת פונקציות עזר לתמיכה בקלטים מרחוק באמצעות הפעלת כוונה. (I47cee)

גירסה 1.0

גרסה 1.0.0

‫2 בדצמבר 2020

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

הגרסה הזו זהה לגרסה 1.0.0-rc01.

התכונות העיקריות בגרסה 1.0.0

• העברה של הפונקציונליות של WearableButtons מספריית התמיכה ב-Wearable אל Jetpack.

• נוספה ספריית androidx.wear.input.test.TestWearableButtonsProvider שמטמיעה את androidx.wear.input.WearableButtonsProvider כדי לעזור בבדיקת אפליקציות שפותחו באמצעות ספריית androidx.wear:wear-input.

גרסה ‎1.0.0-rc01

11 בנובמבר 2020

‫androidx.wear:wear-input:1.0.0-rc01 וגם androidx.wear:wear-input-testing:1.0.0-rc01 מופצים. גרסה ‎1.0.0-rc01 מכילה את השמירות האלה.

הגרסה הזו זהה לגרסה 1.0.0-beta01.

גרסה ‎1.0.0-beta01

28 באוקטובר 2020

הגרסאות androidx.wear:wear-input:1.0.0-beta01 ו-androidx.wear:wear-input-testing:1.0.0-beta01 יוצאות ללא שינויים מאז 1.1.0-alpha01. גרסה ‎1.0.0-beta01 מכילה את השמירות האלה.

Wear-Input-Testing גרסה ‎1.0.0-alpha01

‫14 באוקטובר 2020

‫androidx.wear:wear-input-testing:1.0.0-alpha01 מופץ. גרסה 1.0.0-alpha01 מכילה את השמירות האלה.

שינויים ב-API

• נוספה ספריית androidx.wear.input.test.TestWearableButtonsProvider שמטמיעה את androidx.wear.input.WearableButtonsProvider כדי לעזור בבדיקת אפליקציות שפותחו באמצעות ספריית androidx.wear:wear-input. (I0ed0c)

גרסה ‎1.0.0-alpha01 של Wear-Input

‫2 בספטמבר 2020

‫androidx.wear:wear-input:1.0.0-alpha01 מופץ. גרסה 1.0.0-alpha01 מכילה את השמירות האלה.

תכונות חדשות

העברה של הפונקציונליות של WearableButtons מספריית התמיכה ב-Wearable אל Jetpack. במהדורת Jetpack הבאה נספק תמיכה נוספת בבדיקות בספרייה androidx.wear:wear-input-testing.

Wear-Ongoing

גרסה 1.1

גרסה 1.1.0

‫10 בספטמבר 2025

‫androidx.wear:wear-ongoing:1.1.0 מופץ. גרסה 1.1.0 מכילה את השמירות האלה.

שינויים חשובים מאז גרסה 1.0.0:

• הוספנו שדה לתיאור תוכן בפעילויות שמתבצעות באופן שוטף, שמשמש שירותי נגישות.
• הוספנו הערות RequiresPermission לממשקי API שנדרשת להם הרשאת POST_NOTIFICATIONS ב-SDK 33 ומעלה.

גרסה ‎1.1.0-rc01

‫27 באוגוסט 2025

הגרסה של androidx.wear:wear-ongoing:1.1.0-rc01 שוחררה ללא שינויים מאז גרסת הבטא האחרונה. גרסה ‎1.1.0-rc01 מכילה את השמירות האלה.

גרסה ‎1.1.0-beta01

‫30 ביולי 2025

הגרסה androidx.wear:wear-ongoing:1.1.0-beta01 הושקה ללא שינויים משמעותיים מאז גרסת האלפא האחרונה. גרסה ‎1.1.0-beta01 מכילה את השמירות האלה.

גרסה ‎1.1.0-alpha01

‫23 באוגוסט 2023

‫androidx.wear:wear-ongoing:1.1.0-alpha01 מופץ. גרסה ‎1.1.0-alpha01 מכילה את השמירות האלה.

שינויים ב-API

• הוספנו שדה לתיאור התוכן לפעילות המתמשכת. שירותי הנגישות ישתמשו בתיאור הזה כדי לתאר את הפעילות המתמשכת. (I79fc6)

תיקוני באגים

• הוספנו את @RequiresPermission לממשקי API שנדרשת בהם הרשאת POST_NOTIFICATIONS ב-SDK 33 ומעלה. ‫(Ie542e, ‏ b/238790278)

גירסה 1.0

גרסה 1.0.0

‫1 בספטמבר 2021

‫androidx.wear:wear-ongoing:1.0.0 מופץ. גרסה 1.0.0 מכילה את השמירות האלה.

התכונות העיקריות בגרסה 1.0.0

• ‫Wear Ongoing Activities API הוא API למפתחים, כולל מפתחים של צד שלישי, שמשמש לסימון הפעילות שלהם כ'פעילות מתמשכת' ולספק את המידע הנדרש.
• פעילויות מתמשכות הן פעילויות שיכולות לפעול ברקע של השעון (למשל, אימונים, שיחות ומדיה). ב-Wear 3, פעילות שמוגדרת כפעילות מתמשכת תוצג בצורה בולטת יותר באמצעות סמל שכבת-על ייעודי בתצוגת השעון ועיבוד שונה במפעיל האפליקציות.
• מידע נוסף זמין במדריך בנושא פעילות מתמשכת ב-Wear

גרסה ‎1.0.0-rc01

‫18 באוגוסט 2021

הגרסה androidx.wear:wear-ongoing:1.0.0-rc01 יוצאת ללא שינויים מאז 1.0.0-beta01. גרסה ‎1.0.0-rc01 מכילה את השמירות האלה.

גרסה ‎1.0.0-beta01

‫4 באוגוסט 2021

‫androidx.wear:wear-ongoing:1.0.0-beta01 מופץ. גרסה ‎1.0.0-beta01 מכילה את השמירות האלה.

שינויים ב-API

• חלק מהשיטות להגדרת מאפיינים ב-OngoingActivity.Builder מקבלות עכשיו ארגומנט null כדי ליצור סימטריה ועקביות בין השיטות להגדרת מאפיינים לבין השיטות לקבלת מאפיינים (I17ee5)

גרסה ‎1.0.0-alpha06

‫2 ביוני 2021

‫androidx.wear:wear-ongoing:1.0.0-alpha06 מופץ. גרסה ‎1.0.0-alpha06 מכילה את השמירות האלה.

שינויים ב-API

• מוסיפים את השדה 'שם' לפעילות מתמשכת. (I7a405)

תיקוני באגים

• ‫SerializationHelper.copy() now does a defensive copy of the information (I8b276)
• שיפור המסמכים בנושא setCategory (Iff01f)

גרסה ‎1.0.0-alpha05

‫18 במאי 2021

‫androidx.wear:wear-ongoing:1.0.0-alpha05 מופץ. גרסה ‎1.0.0-alpha05 מכילה את השמירות האלה.

שינויים ב-API

• OngoingActivity כולל עכשיו שיטות getter לאחזור כל הערכים שהוגדרו ישירות באמצעות Builder (או ערכי ברירת המחדל שנלקחו מההתראה המשויכת). (Id8ac8)

  • הכיתה החדשה Status משמשת עכשיו ליצירת הסטטוס של OngoingActivity
  • ‫OngoingActivityData ו-OngoingActivityStatus כבר לא חלק מה-API הציבורי.

• הכיתות TextStatusPart ו-TimerStatusPart כבר לא חלק מה-API הציבורי. (I57fb6)

  • כדי ליצור Part עם טקסט סטטי, משתמשים ב-Status.TextPart.
  • כדי ליצור Part עם שעון עצר (ספירה כלפי מעלה), משתמשים ב-Status.Stopwatch
  • כדי ליצור Part עם טיימר (ספירה לאחור), משתמשים ב-Status.Timer

גרסה ‎1.0.0-alpha04

‫5 במאי 2021

‫androidx.wear:wear-ongoing:1.0.0-alpha04 מופץ. גרסה ‎1.0.0-alpha04 מכילה את השמירות האלה.

שינויים ב-API

• ב-OngoingActivity, השיטות מ-existingOngoingActivity נקראות עכשיו recoverOngoingActivity.
• ל-OngoingActivity יש עכשיו סט מלא של getters, שהיו זמינים בעבר רק ב-OngoingActivityData. (I0ee4d)

Wear-Phone-Interactions

גרסה 1.1

גרסה 1.1.1

‫15 ביולי 2026

‫androidx.wear:wear-phone-interactions:1.1.1 מופץ. גרסה 1.1.1 מכילה את השמירות האלה.

תיקוני פגיעות ואבטחה

• הוספנו אימות של פרמטר החבילה redirect_uri ב-RemoteAuthService. כך מוודאים שפלח החבילה של פרמטר השאילתה redirect_uri בכתובת ה-URL של הבקשה תואם לשם החבילה המאומת שקוראת לפונקציה, כששולחים בקשת אימות לטלפון וכשמקבלים את האסימון בחזרה. (I19da5, b/510833682)

גרסה 1.1.0

‫26 בפברואר 2025

‫androidx.wear:wear-phone-interactions:1.1.0 מופץ. גרסה 1.1.0 מכילה את השמירות האלה.

שינויים חשובים מאז גרסה 1.0.0

• הגרסה הזו כוללת תיקון באג חשוב באפליקציות שפועלות ב-Wear OS 5 (רמת API ‏34) ומעלה ומטרגטות רמת API ‏35 ומעלה.
• צריך לעדכן את האפליקציות לגרסה הזו של הספרייה לפני שמעדכנים את targetSdkVersion ל-35 ומעלה.
• אחרת, תופעל חריגה בזמן הריצה.
• נוספה הגדרה חדשה לסוג המכשיר המותאם – none, כשהמכשיר לא מותאם לטלפון.

גרסה ‎1.1.0-rc01

‫12 בפברואר 2025

הגרסה androidx.wear:wear-phone-interactions:1.1.0-rc01 יוצאת ללא שינויים משמעותיים מאז גרסת הבטא האחרונה. גרסה ‎1.1.0-rc01 מכילה את השמירות האלה.

גרסה ‎1.1.0-beta01

‫29 בינואר 2025

‫androidx.wear:wear-phone-interactions:1.1.0-beta01 מופץ. גרסה ‎1.1.0-beta01 מכילה את השמירות האלה.

תכונות חדשות

הגרסה 1.1.0-beta01 של Wear Phone Interactions מציינת שהגרסה הזו של הספרייה כוללת את כל התכונות וה-API נעול (אלא אם צוין אחרת כניסיוני). גרסה 1.1 של Wear Phone Interactions כוללת את הפונקציות וממשקי ה-API החדשים הבאים:

• הנכס redirectUrl נוסף אל OAuthRequest.
• תיקונים במאמרי העזרה
• אפשר להוסיף סוג נוסף ב-PhoneTypeHelper כדי לציין מתי המכשיר לא מוצמד לטלפון, במקום להשתמש בסוג הלא מוכר הקיים.

שינויים ב-API

• הוספנו הגדרה חדשה לסוג המכשיר המותאם – none, כשמכשיר לא מותאם לטלפון. (I06cb8)

גרסה ‎1.1.0-alpha05

‫11 בדצמבר 2024

‫androidx.wear:wear-phone-interactions:1.1.0-alpha05 מופץ. גרסה ‎1.1.0-alpha05 מכילה את השמירות האלה.

תיקוני באגים

• תיקון באג שגורם לקריסה כשמריצים את האפליקציה ב-Wear OS 5 (רמת API‏ 34) ומעלה, בזמן שהיא מטרגטת רמת API‏ 35 ומעלה. צריך לעדכן את האפליקציות לגרסה הזו של הספרייה לפני שמעדכנים את targetSdkVersion ל-35 ומעלה.

גרסה ‎1.1.0-alpha04

‫10 בינואר 2024

‫androidx.wear:wear-phone-interactions:1.1.0-alpha04 מופץ. גרסה ‎1.1.0-alpha04 מכילה את השמירות האלה.

שינויים ב-API

• הוספנו את RemoteAuthClient.isRemoteAuthAvailable שבודק אם אימות מרחוק זמין. (Ibc10c)

גרסה ‎1.1.0-alpha03

9 במרץ 2022

‫androidx.wear:wear-phone-interactions:1.1.0-alpha03 מופץ. גרסה ‎1.1.0-alpha03 מכילה את השמירות האלה.

תיקוני באגים

• ‫redirectUrl from OAuthRequest מחזירה עכשיו מחרוזת ריקה אם כתובת ה-URL להפניה אוטומטית לא מוגדרת בכתובת ה-URL של הבקשה שצוינה. (I44242)

גרסה ‎1.1.0-alpha02

15 בדצמבר 2021

‫androidx.wear:wear-phone-interactions:1.1.0-alpha02 מופץ. גרסה ‎1.1.0-alpha02 מכילה את השמירות האלה.

תיקוני באגים

• צריך לתקן את השגיאות במסמכי RemoteAuthClient, כולל שגיאה בקטע של קוד לדוגמה והקישור הלא פעיל אל ErrorCode (I260e8)

גרסה ‎1.1.0-alpha01

‫15 בספטמבר 2021

‫androidx.wear:wear-phone-interactions:1.1.0-alpha01 מופץ. גרסה ‎1.1.0-alpha01 מכילה את השמירות האלה.

שינויים ב-API

• נוסף המאפיין redirectUrl אל OAuthRequest. ‫(I98840, ‏ Ie684d)

גירסה 1.0

Wear-Phone-Interactions Version 1.0.1

15 בדצמבר 2021

‫androidx.wear:wear-phone-interactions:1.0.1 מופץ. גרסה 1.0.1 מכילה את השמירות האלה.

תיקוני באגים

• תוקנה חריגה שהופעלה מ-BridgingManager כשניסו להשבית התראות מגשרות בלי excludedTags.

Wear-Phone-Interactions Wear-Remote-Interactions

גירסה 1.0

גרסה 1.0.0

‫15 בספטמבר 2021

‫androidx.wear:wear-phone-interactions:1.0.0 וגם androidx.wear:wear-remote-interactions:1.0.0 מופצים. גרסה 1.0.0 מכילה את השמירות האלה.

התכונות העיקריות בגרסה 1.0.0

ספריית האינטראקציות עם הטלפון מכילה ממשקי API לאינטראקציות ממכשירים לבישים עם טלפונים. הוא מכיל את הפרטים הבאים:

• ‫PhoneDeviceType, שמספק שיטות עזר לקביעת סוג הטלפון שאליו השעון הנוכחי משויך, לשימוש במכשירים לבישים בלבד.
• ‫BridgingManager,‏ BridgingManagerService ו-BridgingConfig APIs כדי להפעיל או להשבית התראות בזמן ריצה, ואפשר גם להגדיר תגים להתראות שלא חלות עליהן הגבלות במצב גישור.
• ‫RemoteAuthClient, כולל תמיכה באימות מרחוק במכשירים לבישים ותמיכה בהוספת תוסף OAuth PKCE. יש גם פונקציות נוספות וסיוע בכיתות לתקשורת.

ספריית האינטראקציות מרחוק מכילה ממשקי API לאינטראקציות בין מכשירים לבישים לבין טלפונים. הוא מכיל את הפרטים הבאים:

• ‫WatchFaceConfigIntentHelper, שמספק פונקציות עזר לציון המזהה ושם הרכיב בפעילויות ההגדרה של לוח השעון באפליקציית הניהול בטלפון.
• מחלקת RemoteActivityHelper שאפשר להשתמש בה כדי לפתוח כוונות במכשירים אחרים (כלומר, משעון לטלפון).

גרסה ‎1.0.0-rc01

‫1 בספטמבר 2021

‫androidx.wear:wear-phone-interactions:1.0.0-rc01 וגם androidx.wear:wear-remote-interactions:1.0.0-rc01 מופצים. גרסה ‎1.0.0-rc01 מכילה את השמירות האלה.

תיקוני באגים

• תוקן באג שגרם לכך ששגיאות שהועלו ב-Google Play Services לא הועברו לקורא הפונקציה כשמשתמשים ב-RemoteActivityHelper ‏ (I60d60)
• תוקן באג שבו RemoteActivityHelper לא היה ממלא את ה-Future שלו אם לא היו צמתים מחוברים, או אם לא נמצא nodeId מבוקש (I60d60)

גרסה ‎1.0.0-beta01

‫18 באוגוסט 2021

‫androidx.wear:wear-phone-interactions:1.0.0-beta01 וגם androidx.wear:wear-remote-interactions:1.0.0-beta01 מופצים. גרסה ‎1.0.0-beta01 מכילה את השמירות האלה.

שינויים ב-API

• השם של הכיתה RemoteIntentHelper שונה ל-RemoteActivityHelper. השמות של הפונקציות RemoteIntentHelper#getRemoteIntentExtraIntent ו-RemoteIntentHelper#getRemoteIntentNodeId שונו ל-RemoteActivityHelper#getTargetIntent ו-RemoteActivityHelper#getTargetNodeId, בהתאמה. (Id2042)

Wear-Phone-Interactions Version 1.0.0-alpha07

‫4 באוגוסט 2021

‫androidx.wear:wear-phone-interactions:1.0.0-alpha07 מופץ. גרסה ‎1.0.0-alpha07 מכילה את השמירות האלה.

שינויים ב-API

• השם של WearTypeHelper.isChinaDevice שונה לWearTypeHelper.isChinaBuild. (I47302)
• עדכנו את ספריית RemoteAuthClient כדי לבחור אוטומטית את redirect_uri על סמך סוג המכשיר (שאר העולם/סין). (I38866)
• תוקן באג שגרם לכך שהמרת BridgingConfig אל/מ-Bundle נכשלה עם ClassCastException. נוספו בדיקות יחידה למחלקה BridgingManagerService. (I68ecb)

Wear-Remote-Interactions גרסה ‎1.0.0-alpha06

‫4 באוגוסט 2021

‫androidx.wear:wear-remote-interactions:1.0.0-alpha06 מופץ. גרסה ‎1.0.0-alpha06 מכילה את השמירות האלה.

‫Wear-Phone-Interactions גרסה ‎1.0.0-alpha06

‫21 ביולי 2021

‫androidx.wear:wear-phone-interactions:1.0.0-alpha06 מופץ. גרסה ‎1.0.0-alpha06 מכילה את השמירות האלה.

שינויים ב-API

• הסיווג BridgingManagerSeviceBinder הוא עכשיו סיווג משנה של Service, והשם שלו שונה ל-BridgingManagerSevice. (I9fca2)
• השיטה RemoteAuthClient.Callback.onAuthorizationError השתנתה כדי לכלול את הפרמטר OAuthRequest. בשיטות שדורשות קריאה חוזרת, נדרש עכשיו גם executor כדי שהקריאה החוזרת תפעל. (I35e11)

תיקוני באגים

• הבהרנו את API האימות באמצעות תיעוד של פרמטרים נוספים ושימוש במאפיינים איפה שאפשר. (I12287)

Wear-Phone-Interactions גרסה ‎1.0.0-alpha05

‫30 ביוני 2021

‫androidx.wear:wear-phone-interactions:1.0.0-alpha05 מופץ. גרסה ‎1.0.0-alpha05 מכילה את השמירות האלה.

תיקוני באגים

• פרמטרים מתועדים שצריך להעביר בבונה של BridgingConfig.Builder.

Wear-Remote-Interactions גרסה ‎1.0.0-alpha05

‫21 ביולי 2021

‫androidx.wear:wear-remote-interactions:1.0.0-alpha05 מופץ. גרסה ‎1.0.0-alpha05 מכילה את השמירות האלה.

שינויים ב-API

• הוספנו את המחלקה RemoteIntentHelper (לשעבר RemoteIntent בספריית התמיכה של Wearable) שאפשר להשתמש בה כדי לפתוח כוונות במכשירים אחרים (כלומר, משעון לטלפון). (I1d7e0)

• הסיווג PlayStoreAvailability הוסר מספריית AndroidX. כדי לזהות אם חנות Play זמינה בטלפון מחובר, משתמשים בשיטה androidx.phone.interactions.PhoneTypeHelper.getPhoneDeviceType כדי לקבוע אם הטלפון המחובר הוא טלפון Android. לאחר מכן משתמשים בשיטה androidx.wear.utils.WearTypeHelper.isChinaDevice כדי לקבוע אם הטלפון המחובר הוא מכשיר סיני. אם הטלפון הוא טלפון Android ולא מכשיר סיני, חנות Play תהיה זמינה. (Ie7dec)

Wear-Phone-Interactions גרסה ‎1.0.0-alpha04

‫7 באפריל 2021

‫androidx.wear:wear-phone-interactions:1.0.0-alpha04 מופץ. גרסה ‎1.0.0-alpha04 מכילה את השמירות האלה.

שינויים ב-API

• עדכנו את הקבועים ErrorCode כדי שהספרייה החדשה תהיה תואמת לאחור להטמעה בספריית התמיכה ב-Wearable.

תיקוני באגים

• תוקנה חריגה שנגרמה על ידי OAuth API חדש כשמתחילים סשן OAuth.

גרסה ‎1.0.0-alpha03 של Wear-Remote-Interactions

‫7 באפריל 2021

‫androidx.wear:wear-remote-interactions:1.0.0-alpha03 מופץ. גרסה ‎1.0.0-alpha03 מכילה את השמירות האלה.

שינויים ב-API

• השינוי של PlayStoreAvailability למחלקה שמכילה אובייקט נלווה עם שיטות סטטיות. השימוש נשאר זהה.

תיקוני באגים

• תוקן מסמך הסיכום של WatchFaceConfigIntentHelper כך שיוצג בו קוד לדוגמה עם תווים בפועל של HTML.

‫Wear-Ongoing Wear-Phone-Interactions גרסה ‎1.0.0-alpha03

10 במרץ 2021

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

תכונות חדשות

• העברה של OAuthClient מ-Wearable Support Library ל-AndroidX. השם של המחלקה שהועברה שונה ל-RemoteAuthClient, והיא מספקת תמיכה באימות מרחוק במכשירים לבישים, יחד עם תמיכה בהוספת תוסף OAuth PKCE. יש גם פונקציות נוספות וסיוע בכיתות לתקשורת.
• מעכשיו אפשר לשייך פעילויות מתמשכות להתראה עם תג באמצעות הבונה החדש OngoingActivity.Builder.

שינויים ב-API

• הוספנו תמיכה בתגי התראות בספרייה של פעילויות מתמשכות (I653b4)
• העברנו את OAuthClient מ-Wear Support Library ל-AndroidX, והוספנו תמיכה בתוסף OAuth PKCE ‏ (I3eaaa)

‫Wear-Remote-Interactions גרסה ‎1.0.0-alpha02

10 במרץ 2021

‫androidx.wear:wear-remote-interactions:1.0.0-alpha02 מופץ. גרסה ‎1.0.0-alpha02 מכילה את השמירות האלה.

תכונות חדשות

• העברנו את המחלקה PlayStoreAvailability מ-Wearable Support Library אל AndroidX, שמספקת API לבדיקה אם חנות Play זמינה בטלפון.

תיקוני באגים

• העברה של המחלקה PlayStoreAvailability מ-Wearable Support Library ל-AndroidX. (I69bfe)

גרסה ‎1.0.0-alpha02

‫10 בפברואר 2021

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

שינויים ב-API

• הוספנו תמיכה בסטטוס מורכב יותר. הם מורכבים מתבנית (או מכמה תבניות) ומסדרה של חלקים שישמשו למילוי משתני המיקום של התבנית. ל-OngoingActivityStatus יש עכשיו שיטה סטטית ליצירת סטטוסים פשוטים עם חלק אחד בלבד (טקסט או טיימר), ו-Builder ליצירת סטטוסים מורכבים יותר. (I1fe81)
• העברה של המחלקות BridgingManager ו-BridgingConfig מ-Wear Support Library אל AndroidX, שמספקת ממשקי API להפעלה או להשבתה של התראות בזמן ריצה, ואפשרות להגדיר תגים להתראות שפטורות ממצב הגישור. (I3a17e)

גרסה ‎1.0.0-alpha01

‫27 בינואר 2021

הגרסאות androidx.wear:wear-ongoing:1.0.0-alpha01,‏ androidx.wear:wear-phone-interactions:1.0.0-alpha01 וגם androidx.wear:wear-remote-interactions:1.0.0-alpha01 יוצאות. גרסה 1.0.0-alpha01 מכילה את השמירות האלה.

שינויים ב-API

• העברת ספריית הפעילויות המתמשכות לספריית משנה חדשה: wear-ongoing. המחלקות נמצאות עכשיו בחבילה androidx.wear.ongoing (קודם הן היו בחבילה androidx.wear.ongoingactivities) (I7c029)

• יוצרים ספריית תמיכה חדשה שתכיל מחלקות שתומכות באינטראקציות בין מכשירי Wearable לטלפונים. היא מאוכלסת בהתחלה במחלקות שהועברו מ-Wearable Support Library. (Id5180)

• העברה של המחלקה PhoneDeviceType מספריית התמיכה של Wearable אל AndroidX. השם של המחלקה שהועברה שונה ל-PhoneTypeHelper, והיא מספקת שיטות עזר לקביעת סוג הטלפון שהשעון הנוכחי משויך אליו, לשימוש רק במכשירים לבישים. (Ibd947)

• יוצרים ספריית תמיכה חדשה שתכיל מחלקות שתומכות באינטראקציות בין מכשירי Wearable לבין טלפונים. היא מאוכלסת בהתחלה במחלקות שהועברו מ-Wearable Support Library. (I9deb4)

• העברה של המחלקה WatchFaceCompanion מ-Wearable Support Library ל-AndroidX. השם של המחלקה שהועברה הוא WatchFaceConfigIntentHelper. המחלקה הזו מספקת פונקציות עזר לציון המזהה ושם הרכיב בפעילויות ההגדרה של תצוגת השעון באפליקציה הנלווית בטלפון. אפשר להשתמש בה גם באופן מקומי כדי להגדיר את תצוגת השעון במכשיר הלביש. (Ia455f)

Wear-Tooling-Preview

גירסה 1.0

גרסה 1.0.0

‫29 בנובמבר 2023

‫androidx.wear:wear-tooling-preview:1.0.0 מופץ. גרסה 1.0.0 מכילה את השמירות האלה.

תכונות בגרסה 1.0.0

• מוסיפים את WearDevices לרשימת מכשירי Wear התקינים שאפשר להשתמש בהם בתצוגות מקדימות של ממשק המשתמש.

גרסה ‎1.0.0-rc01

‫15 בנובמבר 2023

הגרסה androidx.wear:wear-tooling-preview:1.0.0-rc01 יוצאת ללא שינויים. גרסה ‎1.0.0-rc01 מכילה את השמירות האלה.

גרסה ‎1.0.0-beta01

‫18 באוקטובר 2023

הגרסה androidx.wear:wear-tooling-preview:1.0.0-beta01 יוצאת ללא שינויים. גרסה ‎1.0.0-beta01 מכילה את השמירות האלה.

גרסה ‎1.0.0-alpha01

‫23 באוגוסט 2023

‫androidx.wear:wear-tooling-preview:1.0.0-alpha01 מופץ. גרסה 1.0.0-alpha01 מכילה את השמירות האלה.

שינויים ב-API

• הוספה של WearDevices לרשימת מכשירי Wear תקינים שאפשר להשתמש בהם לתצוגות מקדימות של ממשק המשתמש (Ib036e)

רכיבים ותצוגת השעון ב-Wear

גירסה 1.0

גרסה ‎1.0.0-alpha22

‫15 בספטמבר 2021

‫androidx.wear:wear-*:1.0.0-alpha22 מופץ. גרסה ‎1.0.0-alpha22 מכילה את השמירות האלה.

תכונות חדשות

• ה-EditorSession נרשם עכשיו כמנוי ל-lifecycle observers, כך שלא צריך יותר לסגור אותו באופן מפורש כשהפעילות מסתיימת.

שינויים ב-API

• המחלקות EditorSession ו-ListenableEditorSession משתמשות עכשיו ב-StateFlows של Kotlin בשביל complicationSlotsState, ‏ ComplicationsPreviewData ו-ComplicationsDataSourceInfo. (I761d9)
• ‫EditorSession#userStyle הוא עכשיו MutableStateFlow<UserStyle> (I32ca9)
• הפונקציה EditorSession.createOnWatchEditorSession משתמשת עכשיו ב-lifecycle observer והיא נסגרת אוטומטית כשהיא מזהה onDestroy. בנוסף, createOnWatchEditorSession דורש עכשיו רק להעביר את הפעילות. שינויים זהים הוחלו גם על ListenableEditorSession. (Ic6b7f)
• הבנאי של CustomValueUserStyleSetting הוחזר כחלק מה-API הציבורי. (I2e69a)
• ‫UserStyle יורש עכשיו מ-Map<UserStyleSetting, UserStyleSetting.Option> ו-MutableUserStyleSetting#put, ויוצר IllegalArgumentException אם ההגדרה לא נמצאת בסכימה או אם האפשרות לא תואמת להגדרה. (Iba40f)

גרסה ‎1.0.0-alpha21

‫1 בספטמבר 2021

‫androidx.wear:wear-*:1.0.0-alpha21 מופץ. גרסה ‎1.0.0-alpha21 מכילה את השמירות האלה.

שינויים ב-API

• כל ממשקי ה-API הציבוריים של תצוגות השעון, הלקוח, העורך והסיבוכים משתמשים עכשיו ב-java.time.Instant לציון שעות במקום ב-Long. כתוצאה מכך, רמת ה-API המינימלית עלתה ל-26. (I3cd48)
• ממשקי ה-API של תצוגת השעון והרכיבים משתמשים עכשיו ב-ZonedDateTime הבלתי ניתן לשינוי במקום ביומן. (I25cf8)
• עכשיו, המערכת מאתחלת את ComplicationSlots באמצעות NoDataComplicationData, ל-ComplicationSlot.complicationData תמיד יש ערך, ו-CanvasComplicationDrawable.complicationData כבר לא יכול להיות null. ‫(I4dfd6) התכונה הזו מפחיתה את הבהוב התכונות הנוספות (אבל לא מבטלת אותו) כשעוברים בין תצוגות שעון.

גרסה ‎1.0.0-alpha20

‫18 באוגוסט 2021

‫androidx.wear:wear-*:1.0.0-alpha20 מופץ. גרסה ‎1.0.0-alpha20 מכילה את השמירות האלה.

שינויים ב-API

• הוספנו את createFallbackPreviewData ל-ComplicationDataSourceInfo, שאפשר להשתמש בו כש-ComplicationDataSourceInfoRetriever.retrievePreviewComplicationData מחזיר null. (I38c4d)
• המחלקות ComplicationDataSourceUpdateRequester הפכו לממשק כדי לאפשר יצירת אובייקטים מדומים בבדיקות יחידה. אפשר ליצור אובייקט ComplicationDataSourceUpdateRequester קונקרטי באמצעות ComplicationDataSourceUpdateRequester.create().‏ (I7da22)
• המאפיין RenderParameters.pressedComplicationSlotIds הוחלף במאפיין RenderParameters.lastComplicationTapDownEvents שחושף את המחלקה החדשה TapEvent שמכילה שלישייה של קואורדינטות x, y של ההקשה בפיקסלים וחותמת זמן. ‫WatchFace.TapListener.onTap הוחלף ב-onTapEvent(@TapType tapType: Int, tapEvent: TapEvent). בנוסף, הכרטיס InteractiveWatchFaceClient.displayPressedAnimation הוסר. (Id87d2)
• נוספה הערה מפורשת לגבי שרשור עבור setImportantForAccessibility (I990fa)
• הסוג ComplicationSlotBoundsType הועבר אל androidx-wear-watchface.ComplicationSlotBoundsType ב-wear/wear-watchface. (I09420)
• הוספנו תמיכה בהעברת מזהי משאבי מחרוזות אל UserStyleSetting ואל Options. זו הדרך המומלצת ליצור את האובייקטים האלה. (I03d5f)
• הוטלו מגבלות על הגודל המקסימלי של חוט של סכמת UserStyle. בנוסף, הסמלים בסכימה לא יכולים להיות גדולים מ-400x400 פיקסלים. (I3b65b)
• הוספנו מחלקה של MutableUserStyle כדי לתמוך בשינויים במופעים של UserStyle ‏ (I95a40)
• שינינו את השם של ListenableWatchFaceMetadataClient.Companion#listenableCreateWatchFaceMetadataClient ל-ListenableWatchFaceMetadataClient.Companion#createListenableWatchFaceMetadataClient. (I64ce2)
• שינינו את EditorState.previewComplicationsData כך שיכיל רק נתונים של רכיבים מופעלים, והוספנו את EditorSession.DEFAULT_PREVIEW_TIME_MILLIS שאם מעבירים אותו לבקשות renderWatchFaceToBitmap או PreviewScreenshotParams, הוא גורם לרכיבים להיות מוצגים בתצוגה המקדימה עם הזמן שמוגדר כברירת מחדל בתצוגת השעון. (If7b3c)
• הסרנו מ-API הציבורי את ה-constructors של UserStyleSetting שמקבלים CharSequence. מומלץ להשתמש במקום זאת בבוני המחרוזות שדורשים מזהים של StringResource. (I8537b)
• ‫CurrentUserStyleRepository.UserStyleChangeListener תומך עכשיו בהמרת SAM. (I85989)

גרסה ‎1.0.0-alpha19

‫4 באוגוסט 2021

‫androidx.wear:wear-*:1.0.0-alpha19 מופץ. גרסה ‎1.0.0-alpha19 מכילה את השמירות האלה.

שינויים ב-API

• הוספנו את ListenableWatchFaceMetadataClient.listenableCreateWatchFaceMetadataClient, שמספק יחידת עיטוף ListenableFuture ל-WatchFaceMetadataClient.createWatchFaceMetadataClient. (I5fa37)
• הפרמטר UserStyleOption.getOptionForId מקבל עכשיו UserStyleOption.Id במקום מערך בייטים. (I469be)
• הוספת הקבועים BooleanOption.TRUE ו-BooleanOption.FALSE וביטול האפשרות ליצור מופע (I46e09)
• הוספנו הערות לשיטות ב-wear-watchface-client שיכולות להציג RemoteException. (Ib8438)
• כדי לשמור על עקביות, שינינו את השם של EditorSession.createOnWatchEditingSession ל-createOnWatchEditorSession, וגם את השם של createHeadlessEditingSession ל-createHeadlessEditorSession. גם שמות העטיפות של guava השתנו. (I1526b)
• ‫EditorSession הוא עכשיו ממשק ו-ListenableEditorSession.commitChangesOnClose מוקצה עכשיו בצורה נכונה. (I7dc3e)
• מעכשיו אנחנו דוחים כל סכימת סגנון משתמש שיש בה הגדרות או אפשרויות עם מזהים סותרים (Ic2715)
• הוספנו עומס יתר של UserStyle.get שמקבל UserStyleSetting.Id. (I2aa0f)

גרסה ‎1.0.0-alpha18

‫21 ביולי 2021

‫androidx.wear:wear-*:1.0.0-alpha18 מופץ. גרסה ‎1.0.0-alpha18 מכילה את השמירות האלה.

שינויים ב-API

• העברנו את ComplicationHelperActivity לספרייה של androidx.wear:wear-watchface. (I39e76)
• לשם שמירה על עקביות ובהירות, השם ComplicationProvider שונה ל-ComplicationDataSource, וכל הכיתות שכללו את המילה Provider בשם שלהן קיבלו שם חדש באופן דומה. (Iaef0b)
• ‫CanvasComplication.isHighlighted הועבר אל RenderParameters.pressedComplicationSlotIds. זהו צעד לקראת הפיכת CanvasComplication ללא שמירת מצב. כדי לתמוך בשינוי הזה, הפונקציה CanvasComplication.render מקבלת עכשיו גם את slotId כפרמטר, ואנחנו מעבירים עכשיו את ComplicationSlot אל GlesTextureComplication. (I50e6e)
• הוספנו את headlessDeviceConfig אל EditorRequest. אם הערך של הפרמטר הזה הוא לא null, המערכת משתמשת בו כדי ליצור מופע headless שיגבה את EditorSession, במקום לפעול על המופע האינטראקטיבי. כך אפשר להפעיל את כלי העריכה לתצוגת שעון שלא מוגדרת כרגע. (I0a820)
• הוספנו WatchFaceMetadataClient ניסיוני שמאפשר אחזור יעיל של מטא-נתונים סטטיים של פני שעון, כמו UserStyleSchema ופרטים קבועים על ComplicationSlots. (I6bfdf)
• שינינו את השם של CanvasRenderer.uiThreadInit ל-init. (I6fff9)
• הוספנו את הפרמטר החדש האופציונלי PreviewScreenshotParams ל-EditorRequest. הפרמטר הזה מורה ל-EditorSession לצלם תצוגה מקדימה של המסך כשמבצעים commit עם הפרמטרים האלה. תמונת התצוגה המקדימה מוצגת ב-EditorState.previewImage. (Ic2c16)

תיקוני באגים

• המפתחים לא צריכים יותר להוסיף את ComplicationHelperActivity למניפסט שלהם. (I6f0c2)

גרסה ‎1.0.0-alpha17

‫30 ביוני 2021

‫androidx.wear:wear-*:1.0.0-alpha17 מופץ. גרסה ‎1.0.0-alpha17 מכילה את השמירות האלה.

תכונות חדשות

• ב-GlesRenderer,‏ makeUiThreadContextCurrent ו-makeBackgroundThreadContextCurrent הוחלפו ב-runUiThreadGlCommands וב-runBackgroundThreadGlCommands, שניהם מקבלים Runnable. הספרייה מוודאת שרק פקודה אחת של GL ניתנת להרצה בכל זמן נתון.

• כדי להקל על ההגדרה של UiThread, הוספנו את CanvasRenderer.uiThreadInit שמופעל פעם אחת ב-UiThread לפני כל קריאה ל-render. הוספנו גם את onRendererCreated ל-CanvasComplication, כדי שיהיה קל יותר ל-Renderer ול-CanvasComplication לשתף את הסטטוס.

• לשם הבהרה, שינינו את השם של Complication ל-ComplicationSlot ואת השם של complicationId ל-complicationSlotId או ל-complicationInstanceId, בהתאם לשימוש

שינויים ב-API

• לשם הבהרה, שינינו את השם של Complication ל-ComplicationSlot ואת השם של complicationId ל-complicationSlotId או ל-complicationInstanceId, בהתאם לשימוש. גם שמות של מחלקות שמשתמשות ב-Complication שונו. לדוגמה, ComplicationsManager נקרא עכשיו ComplicationSlotsManager. (I4da44)
• ב-GlesRenderer,‏ makeUiThreadContextCurrent ו-makeBackgroundThreadContextCurrent הוחלפו ב-runUiThreadGlCommands וב-runBackgroundThreadGlCommands, שניהם מקבלים Runnable. הפונקציות האלה נדרשות רק אם צריך לבצע קריאות ל-GL מחוץ ל-render, ‏ runBackgroundThreadGlCommands ו-onUiThreadGlSurfaceCreated. הדבר נדרש כי יכולים להיות כמה אובייקטים של GlesRenderer, שלכל אחד מהם יש הקשרים משלו באותו תהליך, אולי מתצוגות שעון שונות. בנוסף, הגישה להקשר הנוכחי המשותף של GL מסונכרנת עכשיו. (I04d59)
• הוספנו את CanvasRenderer.uiThreadInit שמופעל פעם אחת ב-UiThread לפני כל קריאה ל-render. בנוסף, לשם הבהרה ב-GlesRenderer, שינינו את השם של onGlContextCreated ל-onBackgroundThreadGlContextCreated ושל onGlSurfaceCreated ל-onUiThreadGlSurfaceCreated. (If86d0)
• השם של HeadlessWatchFaceClient וגם InteractiveWatchFaceClient getComplicationsSlotState השתנה לgetComplicationSlotsState. ב-ComplicationSlot: השמות של createRoundRectComplicationBuilder,‏ createBackgroundComplicationBuilder ו-createEdgeComplicationBuilder שונו ל-createRoundRectComplicationSlotBuilder,‏ createBackgroundComplicationSlotBuilder ו-createEdgeComplicationSlotBuilder בהתאמה. (Ib9adc)
• הוספנו את onRendererCreated ל-CanvasComplication, כדי שיהיה קל יותר ל-Renderer ול-CanvasComplication לשתף מצב. (I5e1ac)

גרסה ‎1.0.0-alpha16

‫16 ביוני 2021

‫androidx.wear:wear-*:1.0.0-alpha16 מופץ. גרסה ‎1.0.0-alpha16 מכילה את השמירות האלה.

תכונות חדשות

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

תיקוני באגים

• מניעת NPE ב-onComplicationProviderChooserResult (b/189594557)
• פתרון בעיות שקשורות למשטחים לא פעילים ול-drawBlack ‏ (b/189452267)
• תיקון בעיה של הרשאות גישה ל-complicationsManager.watchState (b/189457893)
• תיקון באג שקשור לזמן החיים של שרשור ברקע (b/189445428)
• תיקון בעיות בכלי לעריכת תצוגת השעון בגרסאות קודמות ל-R (b/189126313)
• לא לעדכן פרמטרים של אתחול ישיר לשינויים בסגנון העריכה (b/187177307)

גרסה ‎1.0.0-alpha15

‫2 ביוני 2021

‫androidx.wear:wear-*:1.0.0-alpha15 מופץ. גרסה ‎1.0.0-alpha15 מכילה את השמירות האלה.

תכונות חדשות

רוב האתחול של תצוגת השעון מתבצע עכשיו בשרשור ברקע, אבל אחרי הטעינה, כל העיבוד של תצוגת השעון וכו' מתבצע ב-UiThread. יש מחסום זיכרון בין הטעינה לבין הרינדור, כך שרוב ממשקי השעון של המשתמשים לא צריכים לעשות שום דבר מיוחד. יכול להיות שיהיו חריגים לגבי פני שעון שמשתמשים ב-GLES, כי ההקשר הוא ספציפי לשרשור ואנחנו יוצרים שני הקשרים מקושרים, כך שאפשר להעלות משאבי GL (למשל, טקסטורות ו-shaders) בשרשור הרקע ולהשתמש בהם ב-UiThread.

פיצלנו את יצירת עיצובי השעון לשלוש פונקציות: createUserStyleSchema, ‏ createComplicationsManager ו-createWatchFace. אנחנו מניחים שהפונקציות createUserStyleSchema ו-createComplicationsManager מהירות, והפונקציה createWatchFace עשויה לקחת זמן לטעינת הנכסים. כדי לנצל את היתרון הזה, הוספנו את WatchFaceControlClient.getDefaultProviderPoliciesAndType שמחזירה מפה של מזהי רכיבי מידע למדיניות ברירת המחדל של ספקי רכיבי מידע ול-ComplicationType שמוגדר כברירת מחדל. השיטה הזו מהירה יותר מיצירת מופע ללא ראש, כי לא צריך לאתחל את פני השעון באופן מלא כדי לבצע את השאילתה.

בנוסף, רכיבי מידע נוצרים עכשיו באמצעות CanvasComplicationFactory, שמאפשרת יצירה עצלה של רכיבי מידע מסוג CanvasComplication.

שינויים ב-API

• הטקסט @TargetApi הוחלף בטקסט @RequiresApi. (I0184a, ‏ b/187447093, ‏ b/187447094)
• הוספנו את WatchFaceControlClient.getDefaultProviderPoliciesAndType שמחזירה מפה של מזהי רכיבי מידע למדיניות ברירת המחדל של ספקי רכיבי מידע ולסוג ברירת המחדל של רכיבי מידע. במקרים שבהם אפשר, נעשה שימוש בנתיב מהיר שמונע בנייה מלאה של תצוגת השעון. כדי לאפשר זאת, נאלצנו לשנות את WatchFaceService API ולהוסיף לו שתי שיטות חדשות: createUserStyleSchema ו-createComplicationsManager. התוצאות של השיטות האלה מועברות אל createWatchFace. בנוסף, רכיבי Complication נוצרים עכשיו באמצעות CanvasComplicationFactory, שמאפשר יצירה עצלה של רכיבי העיבוד של CanvasComplication. (Iad6c1)
• הסרנו את MOST_RECENT_APP מ-SystemProviders. (I3df00)
• ‫ObservableWatchData היא עכשיו מחלקה אטומה. (Ic940d)
• הפונקציה CanvasComplicationFactory.create (שבדרך כלל קשורה לקלט/פלט) נקראת עכשיו בשרשור ברקע לכל רכיב לפני שהרינדור של שרשור ממשק המשתמש מתחיל. יש מחסום זיכרון בין השלב של בניית התוכן לבין השלב של העיבוד שלו, כך שלא נדרשים פרימיטיבים מיוחדים של שרשור. (Ia18f2)
• הבנייה של לוח השעון מתבצעת עכשיו בשרשור ברקע, למרות שכל העיבוד מתבצע בשרשור ממשק המשתמש. כדי לתמוך בכך, GlesRenderer תומך בשני הקשרים מקושרים. יכול להיות שהשיטות WatchFaceControlClient.createHeadlessWatchFaceClient ו-WatchFaceControlClient.getOrCreateInteractiveWatchFaceClient יסתיימו לפני שהשיטה WatchFaceService.createWatchFace תושלם. קריאות API הבאות ייחסמו עד שהאתחול של watchFace יושלם. (Id9f41)
• הערכים EXPANSION_DP ו-STROKE_WIDTH_DP לא מופיעים יותר בקובץ api.txt. (I54801)
• במקום לשלוח סשן null, גרמנו לכך ש-EditorSession.createOnWatchEditingSession יזרוק TimeoutCancellationException אם יש שגיאה. בנוסף, ערך ההחזרה של EditorRequest.createFromIntent ו-EditorSession.createOnWatchEditingSession הוא עכשיו NonNull. (I41eb4)

גרסה ‎1.0.0-alpha14

‫18 במאי 2021

‫androidx.wear:wear-*:1.0.0-alpha14 מופץ. גרסה ‎1.0.0-alpha14 מכילה את השמירות האלה.

תכונות חדשות

• ‫EditorSession.openComplicationProviderChooser מחזירה עכשיו ChosenComplicationProvider שמכיל את מזהה הסיבוך, ComplicationProviderInfo ו-Bundle שמכיל תוספות נוספות שהוחזרו על ידי הכלי לבחירת ספק.
• בנוסף, אנחנו מעבירים בהדרגה קוד ל-Kotlin, ורוב ה-API של לוחות השעון מוגדר עכשיו ב-Kotlin.

שינויים ב-API

• המאפיינים eglContext ו-eglDisplay של GlesRenderer הם עכשיו non-nullable. כל השגיאות ב-GL מדווחות עכשיו באמצעות GlesRenderer.GlesException ולא באמצעות RuntimeExceptions. (Ib1005)
• העברנו את androidx.wear.watchface.complications.rendering.ComplicationDrawable מ-Java ל-Kotlin (Ibc3eb)
• העברנו את androidx.wear.watchface.complications.rendering.ComplicationStyle מ-Java ל-Kotlin‏ (I3375e)
• הוספנו מידע על ספק הרכיב לכל רכיב ב-EditorSession. (I37f14)
• הרחבנו את התוצאה של EditorSession.openComplicationProviderChooser כך שתכלול מידע שהוחזר על ידי האפשרות שנבחרה. (Iead6d)

‫Wear Complications & Watchface גרסה ‎1.0.0-alpha13

‫5 במאי 2021

‫androidx.wear:wear-*:1.0.0-alpha13 מופץ. גרסה ‎1.0.0-alpha13 מכילה את השמירות האלה.

תכונות חדשות

• בתצוגות השעון יכולים להיות רכיבים חזותיים חשובים מעבר להצגת השעה והסיבוכים. כדי לספק תמיכה בקורא מסך, עכשיו אפשר להגדיר ללוח השעון תוויות של תיאורי תוכן לנגישות באמצעות המאפיין additionalContentDescriptionLabels של Renderer. בנוסף, כדי לשלוט בסדר של ContentDescriptionLabels, נוסף לסיבוכים accessibilityTraversalIndex. אפשר לשנות את זה באמצעות ComplicationsUserStyleSetting.

• כדי לעודד מפתחים לשקול בקפידה את השימוש בקוראי מסך, הפכנו את השדה contentDescription של ShortTextComplicationData.Builder, LongTextComplicationData.Builder ו-RangedValueComplicationData.Builder לחובה להעברה אל ה-constructor שלהם. אם מעבירים את הערך ComplicationText.EMPTY לפרמטר contentDescription, נוצר באופן אוטומטי contentDescription מהטקסט ומהשם.

• ‫WatchFaceControlClient.getOrCreateInteractiveWatchFaceClient מעכשיו מקפיצה הודעת שגיאה ServiceStartFailureException אם לתצוגת השעון יש חריג במהלך האתחול. כך קל יותר לאבחן בעיות במהלך הפעלת תצוגת השעון.

שינויים ב-API

• הוספנו תמיכה בשם רכיב מסוג null ב-ComplicationProviderInfo, שנדרשת לתמיכה בגרסאות ישנות יותר של Wear OS. (I744d2)
• העברנו את androidx.wear.complications.SystemProviders מ-Java ל-Kotlin. (Ia1f8b)
• הסתרנו את כל המחלקות מממשק ה-API הציבורי שנמצאות ב-android.support.wearable.complications ויצרנו עטיפות תואמות ב-AndroidX במקומות שנדרש. (I7bd50)
• שינינו את השם של השיטה ב-TimeDifferenceComplicationText.Builder מ-setMinimumUnit ל-setMinimalTimeUnit. (I20c64)
• הגדרנו את contentDescription השדות ShortTextComplicationData.Builder, LongTextComplicationData.Builder ו- RangedValueComplicationData.Builder כחובה להעברה בבונה. (I8cb69)
• שינינו את השם של ComplicationProviderService.onComplicationUpdate ל-onComplicationRequest, והוספנו את הפרמטרים id ו-type של השיטה הזו לנתונים ComplicationRequest. השם של המאזין המתאים שונה ל-ComplicationRequestListener, והשם של השיטה שלו שונה ל-ComplicationRequestListener.onComplicationData. (Iaf146)
• הסרנו את השיטה isActiveAt מ-ComplicationData והצגנו במקומה את השדה validTimeRange. אפשר להחליף את הקריאה הזו לשיטה ב-validTimeRange.contains. (I65936)
• שינינו את התיאור של ה-method ‏ComplicationProviderService.onComplicationActivated כדי לקבל ComplicationType במקום int. ‏(Idb5ff)
• העברנו את ProviderUpdateRequester מ-Java ל-Koltin. (Ibce13)
• הפונקציה GlesRender.makeContextCurrent גלויה עכשיו לכולם. יכול להיות שקוד של לוח שעון יצטרך לבצע קריאות ל-gl מחוץ ל-render ול-onGlContextCreated, ומכיוון שיכול להיות שיש הקשר אינטראקטיבי והקשר headless, צריך לבצע את הקריאה הזו. (I8a43c)
• השיטה WatchFaceControlClient.getOrCreateInteractiveWatchFaceClient מחזירה עכשיו ServiceStartFailureException אם יש שגיאה בהגדרת השעון. בנוסף, המחלקה WatchFaceService זורקת עכשיו חריגה אם הפונקציה createWatchFace נמשכת יותר מ-6 שניות. (I59b2f)
• הסרנו את מאפיין המזהה שלא נמצא בשימוש של GlesTextureComplication. (I28958)
• עכשיו אפשר לציין בלוח השעון תוויות של תיאורי תוכן לנגישות באמצעות המאפיין additionalContentDescriptionLabels של Renderer. בנוסף לשליטה בסדר של ContentDescriptionLabels, נוסף accessibilityTraversalIndex ל-complications. אפשר לשנות את זה באמצעות ComplicationsUserStyleSetting. (Ib7362)
• הרחבת התיעוד בנושא טיפול באירועי מגע בתצוגת השעון. (Iaf31e)

תיקוני באגים

• ‫EditorSession.getComplicationsPreviewData() מחזירה עכשיו מפה לכל הרכיבים ולא רק לרכיבים לא ריקים. מופע של EmptyComplicationData משמש לרכיבי מידע ריקים. (I1ef7e)

גרסה ‎1.0.0-alpha12 של Wear Complications & Watchface

21 באפריל 2021

‫androidx.wear:wear-*:1.0.0-alpha12 מופץ. גרסה ‎1.0.0-alpha12 מכילה את השמירות האלה.

תכונות חדשות

כדי להמחיש איזה היבט של השעון מוגדר, עורכים של תצוגות שעון צריכים להדגיש חלקים בתצוגת השעון. הרחבנו את RenderParameters כדי לאפשר הדגשה של סגנונות וגם של רכיבים. יש שכבת הדגשה אופציונלית חדשה שנועדה להיות ממוקמת מעל פני השעון עם שקיפות אלפא (ממשקי ה-API של צילומי המסך יכולים לבצע את המיקום הזה בשבילכם, או לספק את שכבת ההדגשה לבדה כדי לאפשר גמישות מקסימלית). לדוגמה, נניח שיש לכם סגנון שמאפשר להגדיר את המראה של מחוגי השעון. במקרה כזה, הפונקציה renderHighlightLayer של רכיב ה-renderer יכולה לצייר קו מתאר סביב המחוגים.

כדי לעודד תמיכה בנגישות של ספקי רכיבי מידע, הפכנו את השדה contentDescription של PhotoImageComplicationData.Builder,‏ MonochromaticImageComplicationData.Builder ו-SmallImageComplicationData.Builder לארגומנט חובה בבנאי. נוספו ComplicationTapFilter ו-Complication.createEdgeComplicationBuilder כדי לתמוך בתכונות נוספות בקצה (שמוצגות מסביב לקצה המסך). הרינדור והבדיקה של רכיבים בקצה התצוגה נתונים להחלטת תצוגת השעון. אי אפשר לבצע בדיקות פגיעה ב-Edge דרך עורך העזר.

שינויים ב-API

• הוספנו את הקידומת PROVIDER_ לקבועים ב-SystemProviders. (I1e773)
• הפכנו את השדות PhotoImageComplicationData.Builder, MonochromaticImageComplicationData.Builder ו-SmallImageComplicationData.Builder contentDescription לחובה להעברה בבונה. (I9643a)
• השם של ProviderInfoRetriever.requestPreviewComplicationData השתנה לשם retrievePreviewComplicationData. ‫(I911ee)
• הועברה ComplicationProviderService מ-Java ל-Koltin. (I849f2)
• השיטה ComplicationProviderService.onBind סופית עכשיו (I39af5)
• החזרנו את הממשק CanvasComplication והעברנו את CanvasComplicaitonDrawable, GlesTextureComplication ו-ComplicationHighlightRenderer אל wear-watchface-complications-rendering. (I84670)
• הקוד של RenderParameters עבר רפקטורינג כדי לתמוך בעיבוד של הדגשות מורחבות. עכשיו אפשר לבקש עיבוד של רכיבי מידע מרכזיים לסגנונות, וגם של כל רכיבי המידע המרכזיים או של רכיב מידע מרכזי יחיד. בנוסף, ל-CanvasRenderer ול-GlesRenderer יש עכשיו שיטה חדשה מופשטת renderHighlightLayer לרינדור של כל הדגשה שהעורך מבקש. השם של השכבה השתנה ל-WatchFaceLayer. (Ic2444)
• הוספנו את ComplicationTapFilter ו-Complication.createEdgeComplicationBuilder כדי לתמוך בסיבוכים של קצה המסך. הרינדור והבדיקה של רכיבים בקצה התצוגה נתונים להחלטת תצוגת השעון. אי אפשר לבצע בדיקות של תוכן מודעה מתוך כלי העריכה. (Ia6604)
• ‫DoubleRangeUserStyleSetting ו-LongRangeUserStyleSetting: defaultValue, ‏ maximumValue ו-minimumValue הם עכשיו מאפייני Kotlin. בנוסף, הוסרו פונקציות של UserStyleSetting.Option כמו toBooleanOption, ‏ toCoplicationOptions, ‏ toListOption ואחרות. (I52899)
• מוסיפים את גודל הסנטר למאפיינים של המכשיר שזמינים לתצוגת השעון. (I76e1e)
• הקונסטרוקטור של ComplicationHighlightRenderer מקבל עכשיו פרמטרים של outlineExpansion ו-outlineStrokeWidth. (I87009)
• ‫ComplicationDrawable.getNoDataText הוא עכשיו חלק מממשק ה-API הציבורי. (I00598)

גרסה ‎1.0.0-alpha11

‫7 באפריל 2021

‫androidx.wear:wear-*:1.0.0-alpha11 מופץ. גרסה ‎1.0.0-alpha11 מכילה את השמירות האלה.

תכונות חדשות

• הוספנו שיפורים נוספים לממשקי ה-API של תצוגות השעון. רוב השינויים הם שינויי שמות פשוטים, אבל InteractiveWatchFaceWcsClient ו-InteractiveWatchFaceSysUiClient מוזגו ל-InteractiveWatchFaceClient.

שינויים ב-API

• המאפיין ContentDescriptionLabel.text הוא עכשיו ComplicationText ולא TimeDependentText, שהיה חלק מספריית התמיכה הישנה של מכשירים לבישים. (I80c03)
• לא מובטח ש-SystemProviders.GOOGLE_PAY יהיה זמין בכל מכשירי Android R, ולכן הוא הוסר מהרשימה. עדיין אפשר להשתמש בספק הזה באמצעות DefaultComplicationProviderPolicy (If01b5)
• שינינו את השם של ComplicationUpdateCallback ל-ComplicationUpdateListener כדי לשמור על עקביות. (I61ec7)
• המיפוי של פורמט ה-wire של UserStyle השתנה ל-Map<String, byte[]>. כדי להקל על השימוש, נוספה מחלקה UserStyleData ל-API הציבורי, ועכשיו נעשה בה שימוש ב-wear-watchface-client וב-wear-watchface-editor. בנוסף, הערך של CustomValueUserStyleSetting.CustomValueOption.value הוא עכשיו byte[] במקום String. (Iaa103)
• ‫UserStyleSetting ו-UserStyleSetting.Option משתמשים עכשיו ב-UserStyleSetting.Id וב-UserStyleSetting.Option.Id בהתאמה כדי לאחסן את המזהים שלהם, במקום ב-String. (I63f72)
• השם של InteractiveWatchFaceClient.SystemState השתנה לשם WatchUiState. (I6a4e0)
• מיזגנו את InteractiveWatchFaceWcsClient וInteractiveWatchFaceSysUiClient כי היה קשה להסביר את חלוקת האחריות (Iff3fa)
• השמות של ערכי ה-enum של השכבות שונו לשם הבהרה. ‫Layer#TOP_LAYER נקרא עכשיו Layer#COMPLICATIONS_OVERLAY ו-Layer#BASE_LAYER נקרא עכשיו Layer#BASE (Ia144e)
• השם של UserStyleListener השתנה לשם UserStyleChangeListener (I18524)
• השם של UserStyleRepository השתנה לשם CurrentUserStyleRepository (I6ea53)
• השם של InteractiveWatchFaceWcsClient.updateInstance השתנה לשם updateWatchfaceInstance. (I321dc)
• שמות האירועים WatchFace TapType שונו כדי להתאים ל-MotionEvents / Compose. (I0dfd0)
• השם של takeWatchfaceScreenshot שונה ל-renderWatchFaceToBitmap, והשם של takeComplicationScreenshot שונה ל-renderComplicationToBitmap (Ie0697)
• ממשק CanvasComplication הוסר לטובת המחלקה הפתוחה CanvasComplicationDrawable. (I1f81f)
• הפונקציה WatcfaceControlServiceFactory הוסרה מה-API הציבורי. (I1f8d3)
• שינינו את השם של CanvasComplication.setData ל-CanvasComplication.loadData. (If1239)
• השם של ComplicationsManager.bringAttentionToComplication השתנה לשם displayPressedAnimation. (Ic4297)
• ל-WatchFaceService.createWatchFace יש עכשיו הערה @UiThread. (Ib54c2)
• בוצע שינוי בשם של פרמטר CanvasComplicationDrawable כדי לתקן באג. (I50dac)
• הוספנו את HeadlessWatchFaceClient.toBundle() ואת HeadlessWatchFaceClient.createFromBundle כדי לתמוך בשליחת HeadlessWatchFaceClient דרך AIDL. (I07c35)
• ל-HeadlessWatchFaceClient ול-InteractiveWatchFaceClient יש עכשיו ClientDisconnectListener ו-isConnectionAlive() כדי לאפשר לכם לראות אם החיבור נותק מסיבה כלשהי (למשל, אם תהליך ה-watchface הופסק). (Ie446d)
• הפונקציה WatchFaceControlClient#getOrCreateWallpaperServiceBackedInteractiveWatchFaceWcsClientAsync היא עכשיו פונקציית השעיה, והשם שלה השתנה ל-getOrCreateInteractiveWatchFaceClient. (Ib745d)
• השם של EditorState.commitChanges ושל hasCommitChanges() השתנה ל-shouldCommitChanges(). (I06e04)
• השם previewComplicationData שונה ל-previewComplicationsData כדי לציין שבמפה יש (בדרך כלל) יותר מסיבוך אחד. (I56c06)
• השם של InteractiveWatchFaceWcsClient.bringAttentionToComplication השתנה לשם displayPressedAnimation כדי לשמור על עקביות עם ComplicationsManager.displayPressedAnimation. (Ic9999)
• כל המופעים של מזהה המופע של לוח השעון עברו אריזה בקלאס WatchFaceId חדש (I45fdf)
• השם של המאפיין complicationState השתנה ל-complicationsState כדי לציין ריבוי. (Ided07)
• הסרנו את ההמרות השונות של wear-watchface-client Binder, הן לא אמורות להיות נחוצות. (Icc4c0)
• לשם עקביות, בוצע רפקטורינג של EditorServiceClient כדי להשתמש במאזינים במקום במעקב. (Iec3a4)
• הוספנו כמה הערות חסרות של @Px אל InteractiveWatchFaceSysUiClient וWatchFaceControlClient. (I3277a)
• שם הפונקציה EditorObserverCallback שונה ל-EditorObserverListener כדי לשמור על עקביות. (Ie572d)
• השדה EditorState.watchFaceInstanceId מוגבל לרמת API של Android R ומעלה, והוא כבר לא יכול להיות null. (Id52bb)
• השם של EditorSession.launchComplicationProviderChooser השתנה לשם openComplicationProviderChooser. (I9d441)
• השם של EditorSession.createOnWatchEditingSessionAsync השתנה לשם createOnWatchEditingSession, ועכשיו זו פונקציית השעיה. (Id257b)
• הוספנו כמה הערות חסרות של @UiThread ב-EditorSession. (I6935c)
• השם של UserStyleSetting.affectsLayers השתנה לשם affectedLayers. (I6e22b)

גרסה ‎1.0.0-alpha10

‫24 במרץ 2021

‫androidx.wear:wear-*:1.0.0-alpha10 מופץ. גרסה ‎1.0.0-alpha10 מכילה את השמירות האלה.

תכונות חדשות

• עכשיו אפשר ליצור אובייקטים של Open GL (למשל, טקסטורות) במהלך WatchFaceService.createWatchFace כי GlesRenderer דורש עכשיו קריאה מפורשת ל-initOpenGLContext שאפשר לבצע בתוך createWatchFace.

שינויים ב-API

• השימוש ב-IdAndComplicationData היה קצת מסורבל, ולכן הוא הוסר מה-API הציבורי. הכיתות והממשקים שהשתמשו בו עברו רפקטורינג. (I4c928)
• החלפנו את ReferenceTime ב-CountUpTimeReference וב-CountDownTimeReference, שהם ברורים יותר. (Ib66c6)
• הוספתי כמה הערות חסרות של @Px ושל @ColorInt. (I9bbc3)
• המאפיין Complication.complicationConfigExtras לא יכול להיות ריק, וערך ברירת המחדל שלו הוא Bundle.EMPTY. (Iad04f)
• ב-GlesRenderer, עכשיו צריך להפעיל את initOpenGLContext אחרי הבנייה. הפונקציה הזו הייתה פרט פנימי, אבל עכשיו היא ב-API הציבורי כדי לאפשר קריאות ל-GL מוקדם יותר בתוך createWatchFace. (I726c2)
• הסרנו את Complication.setRenderer כי הוא לא אמור להיות נחוץ. (Ie992f)
• ‫Complicaiton.setComplicationBounds כבר לא חלק מה-API הציבורי. אם אתם צריכים לשנות את המיקום של סיבוך, אפשר לעשות את זה דרך ComplicationsUserStyleSetting. (Ibd9e5)
• השם של ComplicationsManager.TapCallback.onComplicationSingleTapped השתנה לשם onComplicationTapped. (I3a55c)
• השם של ComplicationOutlineRenderer.drawComplicationSelectOutline השתנה לשם drawComplicationOutline. (I14b88)

גרסה ‎1.0.0-alpha09

10 במרץ 2021

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

תכונות חדשות

• הממשק בין מארח WCS/SysUI לבין תצוגת השעון השתנה. עכשיו עורכים יכולים לקבוע אם שינוי בסגנון יפעיל או ישבית רכיב (מופעל = initiallyEnabled בתוספת כל שינוי מ-ComplicationsUserStyleSetting). בנוסף, EditorService.closeEditorמאפשרת ל-SysUI לסגור מרחוק עורך של פני שעון, אם יש צורך בכך.
• בנוסף, InteractiveWatchFaceWcsClient.setUserStyle עם פקודה חזקה יותר updateInstance ש: משנה את מזהה המופע, מגדירה את הסגנון ומנקה את הסיבוכים בבת אחת.

שינויים ב-API

• ‫TraceEvents נוספו לספריות של לוחות השעון. (I1a141)
• ComplicationState כולל עכשיו מאפיין חדש initiallyEnabled שמאפשר לחזות את ההשלכות של מעבר בין סגנונות. (I8c905)
• החלפנו את InteractiveWatchFaceWcsClient.setUserStyle בפקודה מתקדמת יותר updateInstance ש: משנה את מזהה המופע, מגדירה את הסגנון ומנקה את הסיבוכים. (Ife6f6)
• ממשקי ה-API של צילומי המסך ב-WatchFaceClient כבר לא דוחסים את צילומי המסך כי זה היה איטי. במקום זאת, אנחנו משאירים את כל העיבוד שלאחר מכן למתקשר. (Id35af)
• עכשיו אפשר לסגור מרחוק את כלי העריכה של תצוגת השעון באמצעות EditorService.closeEditor. (Ic5aa4)
• נוספו הערות לגבי אפשרות של ערך null ‏ (Ic16ed)

גרסה ‎1.0.0-alpha08

24 בפברואר 2021

‫androidx.wear:wear-*:1.0.0-alpha08 מופץ. גרסה ‎1.0.0-alpha08 מכילה את השמירות האלה.

תכונות חדשות

• חלק מתצוגות השעון מתוכננות סביב תכונה נוספת ספציפית אחת או יותר. כדי לתמוך בכך, הוספנו את Complication.Builder#setFixedComplicationProvider. אם ההגדרה הזו היא true, המשתמש לא יכול לשנות את התכונה הנוספת במשבצת הזו.
• ספריות התצוגה של השעון מבוססות על Kotlin ומשתמשות בקורוטינות (למשל, פונקציות השעיה). למשתמשי Java, סיפקנו עטיפות ListenableFuture כדי לשפר את יכולת הפעולה ההדדית בספריות הבאות: wear/wear-watchface-guava, wear/wear-watchface-client-guava & wear/wear-watchface-editor-guava.

שינויים ב-API

• הסרנו את התמיכה בהקשה כפולה על רכיבי מידע כדי להפעיל את הכלי לבחירת ספק. התכונה הזו לא הייתה נפוצה בלוחות שעונים והקשתה על ההטמעה של SysUI. (I3ef24)
• יכול להיות שהשיטות של ProviderInfoRetriever יחזירו ServiceDisconnectedException אם ה-binder ייסגר באופן בלתי צפוי. (Ib2cc4)
• מגרסה Android 11 ואילך, יש הגבלות על המקרים שבהם אפשר להפעיל את ProviderChooser. בנוסף, אנחנו רוצים שהעורכים יבנו עם wear-watchface-editor החדש, ולכן אנחנו מסירים את ComplicationHelperActivity מה-API הציבורי. (Ib19c1)
• הסרה של שיטות סטטיות של ComplicationText לטובת שיטות לבנייה. (Ibe399)
• הוספנו עטיפות של guava ListenableFuture לשיטות שונות של ספריית תצוגות השעון שהושעו. (I16b2c)
• כדי להבהיר את השימוש ב-API, הוספנו בנאי משני ל-RenderParameters שלא דורש גוון, לשימוש עם LayerModes שאינם LayerMode.DRAW_OUTLINED. (I497ea)
• בעבר, הפונקציה ListUserStyleSetting הייתה שונה מהאחרות כי היה לה ארגומנט ברירת מחדל. עכשיו, כל הבונה של מחלקת המשנה StyleSetting מקבל את ערך ברירת המחדל בסוף. (I9dbfd)
• בוצע רפקטורינג ב-CanvasComplication כדי להשתמש בשיטה מוסתרת, וכך קל יותר להטמיע מחלקת משנה (I5b321)
• ביצענו רפקטורינג כדי להסיר את EditorResult לטובת EditorService חדש ו-EditorSession.broadcastState() כדי להזרים עדכונים לצופה (בדרך כלל SysUI). (Ic4370)
• חלק מתצוגות השעון מבוססות על תכונה מסוימת כחלק בלתי נפרד מתצוגת השעון, והספק לא ניתן להגדרה על ידי המשתמש. כדי לתמוך בזה, הוספנו את Complication.Builder#setFixedComplicationProvider. (I4509e)
• הבקשה EditorRequest מציינת עכשיו את שם החבילה ולא את ComponentName, כי היה מסורבל למערכת SysUI לחפש את שם המחלקה של העורך, ובאמת צריך רק את שם החבילה. (Ib6814)

גרסה ‎1.0.0-alpha07

‫10 בפברואר 2021

‫androidx.wear:wear-*:1.0.0-alpha07 מופץ. גרסה ‎1.0.0-alpha07 מכילה את השמירות האלה.

תכונות חדשות

• הפונקציה WatchFaceService.createWatchFace היא עכשיו פונקציית השהיה, מה שאומר שאין יותר צורך לחסום את השרשור של ממשק המשתמש בזמן ההמתנה לקלט/פלט. באופן דומה, wear-watchface-editor ו-wear-complications-data

שינויים ב-API

• הסרה של המחלקה PhotoImage ושימוש ישירות בסמל. (I8a70b)
• חשיפת ה-validTimeRange של ComplicationData. (I91366)
• הגדירו מאפיינים שקשורים לתמונה בצורה מפורשת יותר. (I81700)
• הפעולות wear-watchface-editor ו-wear-complications-data עברו רפקטורינג כדי להשתמש בפונקציות השהיה במקום בקורוטינות. בהמשך יתווספו עטיפות תאימות של Rx java ו-Future. ‫(If3c5f)
• המחלק ProviderInfoRetriever זורק עכשיו PreviewNotAvailableException אם הפונקציה requestPreviewComplicationData לא יכולה להחזיר נתוני תצוגה מקדימה בגלל בעיות בחיבור או חוסר תמיכה ב-API. (I4964d)
• הפונקציה WatchFaceControlService::createWatchFaceControlClient מושעית עכשיו, והפונקציה getOrCreateWallpaperServiceBackedInteractiveWatchFaceWcsClient נקראת עכשיו getOrCreateWallpaperServiceBackedInteractiveWatchFaceWcsClientAsync ומחזירה Deferred<InteractiveWatchFaceWcsClient>. בהמשך יתווספו עטיפות תאימות של RX java ו-Future. (I5d461)
• שינוי השם של CATEGORY_PROVIDER_CONFIG_ACTION לCATEGORY_PROVIDER_CONFIG. (I7c068)
• שימו לב שהפונקציה createOnWatchEditingSession מושעית עכשיו כי לפעמים פני השעון לא זמינים עד זמן קצר אחרי שהפעילות בכלי העריכה מתחילה. (Ida9aa)
• הפונקציה WatchFaceService.createWatchFace היא עכשיו פונקציית השהיה שמאפשרת אתחול אסינכרוני. בעבר הייתם צריכים לחסום את ה-thread הראשי. (If076a)
• ל-UserStyle יש עכשיו אופרטור מערך, והוספנו ל-UserStyle.Option עוזרים להמרת טיפוסים. (I35036)
• תיקנו באג בהעברה עם פורמטים של UserStyle, ששינה חלק מממשק ה-API הלא יציב והמוסתר. (I8be09)
• הוספנו את CustomValueUserStyleSetting שמאפשר לאחסן מחרוזת אחת ספציפית לאפליקציה בתוך UserStyle. העורכים של תצוגות השעון יתעלמו מהערך הזה. (Ic04d2)
• ‫InstanceID לא מועבר בתוספות של הכוונה ל-R ולגרסאות ישנות יותר של Android WearOS שאי אפשר לשדרג. כדי לתמוך בכך, אנחנו מאפשרים עכשיו שהערך של InstancID יהיה null. (Id8b78)
• הבקשה EditorRequest כוללת עכשיו את הרכיב editor ComponentName שמוגדר כרכיב ב-WatchFaceEditorContract.createIntent ‏ (I3cd06)
• ה-EditorResult של תצוגת השעון כולל עכשיו תצוגה מקדימה של ComplicationData כדי לאפשר לפונקציית קריאה חוזרת (caller) לצלם מסך של תצוגת השעון אחרי העריכה. (I2c561)

תיקוני באגים

• נוספו שינויים ב-toString() ל-UserStyle,‏ UserStyleSetting ו-UserStyleSchema, כדי לשפר את העבודה עם המחלקות האלה. (I9f5ec)

גרסה ‎1.0.0-alpha06

‫27 בינואר 2021

‫androidx.wear:wear-*:1.0.0-alpha06 מופץ. גרסה ‎1.0.0-alpha06 מכילה את השמירות האלה.

תכונות חדשות

• השקנו ספרייה חדשה wear/wear-watchface-editor שמאפשרת למפתחים של תצוגות שעון וליצרני ציוד מקורי (OEM) ליצור עורך סגנונות ועורך רכיבים. מערכת SysUI תשלח Intent לתצוגת השעון, שתשתמש במחלקה החדשה EditorSession כדי לגשת לפרטים של WatchFace ולתעד את התוצאה באמצעות Activity.setWatchRequestResult. כדי לתמוך בזה, הוספנו את ProviderInfoRetriever.requestPreviewComplicationData, שמאפשר לעורכי תצוגות שעון לבקש תצוגה מקדימה של ComplicationData. היתרון של תצוגה מקדימה של ComplicationData הוא שבניגוד לנתונים בזמן אמת, לא צריך לדאוג לגבי הצגת תיבות דו-שיח של הרשאות כשמעבדים את העורך (שימו לב: אם משתמש בוחר ספק עם הרשאה, הוא עדיין יתבקש להעניק את ההרשאה).

שינויים ב-API

• ל-ComplicationProviderInfo יש עכשיו שדה ל-ComponentName של הספק. התמיכה בשדה הזה תתווסף ל-WearOS במועד מאוחר יותר, ובינתיים הוא יהיה null. (Id8fc4)
• הוספנו את ProviderInfoRetriever.requestPreviewComplicationData שמאפשר לעורכי תצוגות שעון לבקש תצוגה מקדימה של ComplicationData. התכונה הזו שימושית כי יכול להיות שסיבוכים בזמן אמת ידרשו הרשאות, ועכשיו אפשר להציג נתוני תצוגה מקדימה לסיבוכים שלא פעילים. (I2e1df)
• ‫ComplicationManager הוא עכשיו פרמטר אופציונלי של WatchFace constructor, והארגומנטים סודרו מחדש כדי לאפשר זאת. (I66c76)
• הוספנו חבילה אופציונלית ל-Complications, שאם היא מוגדרת היא מתמזגת עם הכוונה שנשלחת להפעלת פעילות בחירת הספק. (Ifd4ad)
• הוספנו ספרייה חדשה, wear-watchface-editor, כדי לתמוך בעורכים שמתארחים בתצוגת השעון וב-SysUi. מערכת SysUI תפעיל את העורכים האלה על ידי שליחת Intent. שירות הפעילות של תצוגת השעון יכול להשתמש במחלקה החדשה EditorSession כדי לגשת לפרטים של תצוגת השעון ולתעד את התוצאה באמצעות Activity.setWatchRequestResult. (I2110d)
• השם של LayerMode.DRAW_HIGHLIGHTED שונה ל-LayerMode.DRAW_OUTLINED, והשם של RenderParameters.highlightComplicationId שונה ל-RenderParameters.selectedComplicationId. עכשיו, בנוסף לסימון של הסיבוך שצוין, הוא גם מתווה. (I90a40)
• העתיד של WatchFaceControlClient.getOrCreateWallpaperServiceBackedInteractiveWatchFaceWcsClient יכול עכשיו להיפתר עם ServiceStartFailureException אם השירות מפסיק לפעול בזמן ההמתנה ליצירת תצוגת השעון. (I0f509)
• ‫EditorSession.complicationPreviewData הוא עכשיו ListenableFuture כי אחזור הנתונים האלה הוא תהליך אסינכרוני. ‫(Iead9d)

תיקוני באגים

• אנחנו מסירים שדות שלא נמצאים בשימוש מ-ComplicationOverlay, ומשאירים את enabled ואת complicationBounds. (I17b71)

גרסה ‎1.0.0-alpha05

‫13 בינואר 2021

‫androidx.wear:wear-*:1.0.0-alpha05 מופץ. גרסה ‎1.0.0-alpha05 מכילה את השמירות האלה.

תכונות חדשות

בדרך כלל יש תמיכה במספר הגדרות של תכונות בתצוגות השעון, עם מספרים שונים של תכונות שמוצגות. כדי להקל על ההגדרה, אנחנו תומכים עכשיו בסיבוכים שמושבתים בהתחלה על ידי קריאה ל-setEnabled(false) ב-builder. אפשר להפעיל אותם מאוחר יותר באמצעות ComplicationsUserStyleSetting.

שינויים ב-API

• הפעילות ComplicationHelperActivity מקבלת עכשיו Collection<ComplicationType> במקום מערך של מספרים שלמים, ולכן קל יותר להשתמש בה. (I1f13d)
• ‫ProviderInfoRetriever.retrieveProviderInfo מחזירה עכשיו את הערך הנכון ListenableFuture<ProviderInfo[]>. (If2710)
• עכשיו אפשר ליצור רכיב מידע שמושבת בהתחלה על ידי קריאה ל-setEnabled(false) ב-builder. (Idaa53)
• ל-WatchFaceState יש עכשיו מאפיין isHeadless שמוגדר כ-True רק במקרים של מופעים ללא ממשק משתמש. (Ifa900)
• ‫ComplicationDrawable תומך עכשיו באופן אופציונלי בטעינה סינכרונית של drawables. הוא משמש את ממשקי ה-API של צילומי המסך. (I34d4a)

גרסה ‎1.0.0-alpha04

‫16 בדצמבר 2020

‫androidx.wear:wear-*:1.0.0-alpha04 מופץ. גרסה ‎1.0.0-alpha04 מכילה את השמירות האלה.

תכונות חדשות

• בספריית התצוגות של שעוני Wear יש עכשיו תמיכה בהגדרת גבולות לכל סוג. לדוגמה, אפשר לעבור לתיבת תוחמת רחבה עבור ComplicationType.LONG_TEXT, ולהשתמש בתיבת תוחמת קטנה יותר עבור סוגים אחרים.

שינויים ב-API

• רכיבים משתמשים עכשיו ב-ComplicationBounds, שעוטף Map<ComplicationType, RectF> כדי לתמוך בגדלים לפי סוג הרכיב. (I1ebe7)
• הפרמטר RenderParameters מאפשר עכשיו לציין את גוון ההדגשה לשימוש בצילומי מסך. (Iff42b)
• חוץ מהגבולות, עכשיו צריך להשתמש ב-ComplicationsUserStyleSetting כדי לשנות את הסיבוכים, כדי לוודא שהמערכת ההפעלה תישאר מסונכרנת. (I8dc5d)
• ה-Renderer הוא עכשיו מחלקה אטומה. כלומר, CanvasRenderer ו-GlesRenderer הן עכשיו מחלקות פנימיות של Renderer. (Iab5d4, ‏ b/173803230)
• השם של CanvasComplicationDrawable.drawHighlight שונה ל-drawOutline. ב-ObservableWatchData חסרות עכשיו כמה הערות UiThread. התכונה ScreenState הוסרה לחלוטין מ-WatchState. ‫(If1393)
• רמת ה-API המינימלית של wear-watchface היא עכשיו 25. הערה: כדי לתמוך בלוח ציור בחומרה, צריך להשתמש ברמת API‏ 26 ומעלה. (Ic9bbd)
• ל-InteractiveWatchFaceWcsClient יש עכשיו פונקציית עזר getComplicationIdAt. (I05811)
• רמת ה-API של wear-watchface-client הופחתה ל-25, אבל ממשקי ה-API של צילומי המסך דורשים רמת API 27. (Id31c2)

תיקוני באגים

• עכשיו אנחנו חושפים את ComplicationType של ComplicationData הנוכחי של הרכיב ב-ComplicationState. (I9b390)
• ל-InteractiveWatchFaceWcs יש עכשיו שיטה bringAttentionToComplication להדגשה קצרה של הסיבוך שצוין. (I6d31c)
• InteractiveWatchFaceWcsClient#setUserStyle יש עכשיו עומס יתר שמקבל Map<string, string=""> שיכול למנוע הלוך ושוב נוסף של IPC שנדרש כדי ליצור UserStyle. ‪(I24eec)</string,>

גרסה ‎1.0.0-alpha03

‫2 בדצמבר 2020

‫androidx.wear:wear-*:1.0.0-alpha03 מופץ. גרסה ‎1.0.0-alpha03 מכילה את השמירות האלה.

תכונות חדשות

למחלקת Complication יש עכשיו מאפיין compicationData שמאפשר לתצוגות שעון לעקוב אחרי שינויים ב-ComplicationData. כך אפשר לשנות את המידות של הסיבוך בהתאם לסוג הסיבוך.

יש עכשיו תמיכה בקצב פריימים משתנה באמצעות הקצאה ל-Renderer.interactiveDrawModeUpdateDelayMillis. בתצוגות שעון שמופעלות בהן אנימציות קצרות כל שנייה, אפשר לחסוך הרבה בסוללה אם השעון עובר למצב שינה כשהאנימציה לא פועלת.

שינויים ב-API

• השם של BACKGROUND_IMAGE השתנה לשם PHOTO_IMAGE, וגם השמות של המחלקות שקשורות אליו השתנו. הסיבוך הזה לא משמש רק לרקעים, ולכן שינינו את השם שלו. (I995c6)
• ‫DefaultComplicationProviderPolicy עם הערות מתאימות של IntDefs. (I3b431)
• הסתרנו את המחלקה TimeDependentText, והיא כבר לא חשופה דרך ContentDescriptionLabel. במקום זאת, הוספנו פונקציית גישה כדי לקבל את הטקסט בשעה ספציפית. (Ica692)
• הקונסטרוקטור של ObservableWatchData הוא עכשיו פנימי. (I30121, b/173802666)
• לרכיב יש עכשיו compicationData שמאפשר לתצוגות השעון לעקוב אחרי שינויים ב-ComplicationData. בנוסף, לרכיב יש קריאה חדשה ל-isActiveAt, שאפשר להשתמש בה כדי לדעת אם צריך להציג משהו בתאריך ובשעה שצוינו. (Ic0e2a)
• התג הריק SharedMemoryImage כבר לא נמצא ב-API הציבורי. (I7ee17)
• ל-WatchFace.overridePreviewReferenceTimeMillis יש עכשיו הערה מסוג IntRange, ולשיטות ה-getter וה-setter יש שמות עקביים. (Ia5f78)
• כדי להבהיר, מעכשיו Complication.Builder נוצר באמצעות Complication.createRoundRectComplicationBuilder או Complication.createBackgroundComplicationBuilder (I54063)
• נוסף WatchFace.TapListener שמאפשר ל-WatchFace לצפות בהקשות שלא נצרכו על ידי רכיבים. ‫(Ic2fe1, ‏ b/172721168)
• אפליקציית WatchFace תומכת עכשיו בקצב פריימים משתנה באמצעות הקצאה ל-Renderer.interactiveDrawModeUpdateDelayMillis. האפשרות הזו יכולה לעזור לשמור על חיי הסוללה כי היא מעבירה את הטפט למצב שינה כשהוא לא מונפש. (I707c9)
• אין יותר צורך ב-WatchFace.Builder, והפונקציות invalidate() ו-interactiveUpdateRateMillis הועברו ל-Renderer. (I329ea)
• לשיפור יכולת הפעולה ההדדית של Java, שונה השם של פונקציות ה-getter של מאפיינים בוליאניים ב-WatchState (I6d2f1)
• לצורך עקביות, שונה השם של TapListener ל-TapCallback ושל InvalidateCallback ל-InvalidateListener. (I9414e)
• אפשרויות הסגנון של תצוגות השעון ב-Wear 2.0 הועברו לקלאס משלהן לשם הבהרה. לשיטות ה-setter של WatchFace.Builder יש עכשיו שיטות getter סימטריות של המחלקה WatchFace. (Iefdfc)
• נוספו InteractiveWatchFaceWcsClient ו-WatchFaceControlClient.getOrCreateWallpaperServiceBackedInteractiveWatchFaceWcsClient שמאחזרים מופע קיים או יוצרים אותו אחרי ששירות הטפטים מתחבר ומפעיל את המנוע. (Id666e)
• ‫WatchFaceControlClient הוא עכשיו ממשק שמאפשר לבדיקות לבצע מוקינג שלו. (I875d9)
• ‫HeadlessWatchFaceClient,‏ InteractiveWatchFaceSysUiClientImpl ו-InteractiveWatchFaceWcsClient הם עכשיו ממשקים שמאפשרים לבצע בדיקות בצורה טובה יותר. (I7cdc3)
• הוספנו הערות לשיטות ב-wear-watchface-complications-rendering (I0d65c)

תיקוני באגים

• הסרה של צורת המסך מ-DeviceConfig, שהייתה כפולה android.content.res.Configuration#isScreenRound() (Ifadf4)
• השתנה מ-WatchFaceControlClient.getOrCreateWallpaperServiceBackedInteractiveWatchFaceWcsClient לקבלת Map<String, String> במקום UserStyle כי קשה ליצור UserStyle בלי לדעת את הסכימה, שאפשר לקבל רק אחרי שהלקוח נוצר. (Iea02a)
• צריך לתקן את InteractiveWatchFaceWcsClient כדי להשתמש ב-ComplicationState במקום בפורמט הנתונים. (Icb8a4)
• ‫UserStyleSettings הוא עכשיו מחלקה אטומה כי עורכי תצוגות השעון מבינים רק את המחלקות המובנות. (I2d797)

גרסה ‎1.0.0-alpha02

11 בנובמבר 2020

‫androidx.wear:wear-*:1.0.0-alpha02 מופץ. גרסה ‎1.0.0-alpha02 מכילה את השמירות האלה.

שינויים ב-API

• ‫ComplicationDetails נקרא עכשיו ComplicationState, והוא עטוף בצורה נכונה. השימושים בתמיכה בטכנולוגיה לבישה @ComplicationData.ComplicationType הועברו אל androidx ComplicationType. (I4dd36)
• מוסיפים פרמטר אופציונלי highlightedComplicationId ל-RenderParameters כדי לבקש הדגשה של רכיב מידע יחיד בצילומי מסך. (I66ce9)
• ‫ComplicationProviderService כדי להשתמש ב-API חדש של סיבוכים בסגנון חדש בשביל עקביות (Id5aea)
• getPreviewReferenceTimeMillis מקבל עכשיו זמני עיון מ-DeviceConfig. (I779fe)
• ממשק ה-API של Renderer פשוט יותר, ואפשר להשתמש ב-SurfaceHolder.Callback כדי לעקוב אחרי שינויים. (I210db)
• הערך CanvasComplicationRenderer לא מתחיל מ-Renderer, ולכן שינינו את השם שלו לשם הבהרה. (Ibe880)

תיקוני באגים

• הגרסה הראשונה של androidx.wear:wear-watchface-client (I1e35e)
• שינית את השם של GlesTextureComplication#renderer לשם הבהרה (Ib78f7)
• שינוי השם של StyleCategory לStyleSetting לשם הבהרה (I488c7)
• הוספת UserStyleSchema ל-API נקי יותר (If36f8)

גרסה ‎1.0.0-alpha01

28 באוקטובר 2020

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

שינויים ב-API

• הסרנו כמה דברים שלא התכוונו לחשוף ב-API ציבורי. (I41669)
• יוצרים ספרייה של androidx.wear:wear-complications-provider. (I77f1f)
• ‫ComplicationsUserStyleCategory היא הקטגוריה המומלצת החדשה להגדרת רכיבי מידע (I96909)
• הוספת wear-complication-data API. (I7c268)
• פונקציות עם ערכים בוליאניים שמוחזרים צריכות להתחיל ב-is ולא ב-get (If36ff)
• ההמלצה לגבי API היא להימנע משימוש ב-protected, ולכן המחלקה הזו עברה שינוי כדי לקבל פרמטרים דרך הבונה. (I61644)
• שינוי השם של setBackgroundComplication לשם הבהרה. (I96fe3)
• שימוש במאפייני Kotlin עבור ComplicationDrawable isHighlighted ונתונים (I4dcc8)
• במקום ComplicationRenderer.InvalidateCallback, אנחנו מוסיפים Complication#invalidate()‎ (I4f4c6)
• ממשקי ה-API האלה יוצאים משימוש ב-WearableSupport ומוסרים כאן. (Ib425c)
• שינינו את השם של חלק מהשיטות של כלי בניית לוחות השעון כדי להדגיש את המקור שלהן ב-Wear 2.0. (Idb775)
• גרסת הבטא הראשונה של API ל-wear/wear-watchface (Id3981)
• הגרסה הראשונה של ה-API שמתבצע אחריה מעקב. (Ie9fe6)
• הסתרנו כמו שצריך את ComplicationDrawable.BorderStyle IntDef ועברנו ל-ComplicationStyle כדי לשמור על עקביות. (I27f7a)
• הוספת הערות חסרות לשיטות ComplicationStyle‏ (I838fd)
• לספרייה הזו אין ממשק API ציבורי (I88e2b)
• כל מחלקות האפשרויות של קטגוריית הסגנון הן עכשיו סופיות. (Ib8323)
• הגרסה הראשונה של ה-API שמתבצע אחריה מעקב. (I27c85)

תיקוני באגים

• השיטה getComplicationPreviewData הוגדרה ב-ComplicationProviderService באופן מפורש. (I4905f)
• הבדיקה של API lint ל-MissingGetterMatchingBuilder מופעלת עבור androidx ‏ (I4bbea, ‏ b/138602561)
• משנים את השם של wear-complications-rendering. (Ifea02)
• השמות המוצגים של קטגוריות הסגנונות הם עכשיו CharSequences‏ (I28990)
• החלפנו את המילה Override (החלפה) במילה Overlay (שכבת-על) כדי להתאים למוסכמות השמות של העיצובים והסגנונות הנוכחיים. (I4fde9)
• השם של UserStyle#getOptions שונה לשם הבהרה. (I695b6)