Wear

יצירת אפליקציות לשעונים חכמים עם Wear OS by Google.

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

פריט מידע שנוצר בתהליך פיתוח (Artifact) גרסה יציבה גרסה מועמדת להפצה גרסת בטא גרסת אלפא
wear 1.3.0 - ‎1.4.0-beta01 -
wear-input 1.2.0 - - -
wear-input-testing 1.2.0 - - -
wear-ongoing 1.1.0 - - -
wear-phone-interactions 1.1.0 - - -
wear-remote-interactions 1.1.0 - ‎1.2.0-beta01 -
הספרייה הזו עודכנה לאחרונה ב-17 בדצמבר 2025

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

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

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

מגניב

dependencies {
    implementation "androidx.wear:wear:1.3.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.0"
    // Use to implement support for interactions between the Wearables and Phones
    implementation "androidx.wear:wear-remote-interactions:1.1.0"
}

Kotlin

dependencies {
    implementation("androidx.wear:wear:1.3.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.0")
    // Use to implement support for interactions between the Wearables and Phones
    implementation("androidx.wear:wear-remote-interactions:1.1.0")
}

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

משוב

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

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

מידע נוסף זמין במאמרי העזרה בנושא כלי המעקב אחר בעיות.

גרסה 1.0 של Wear Core

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

תיקוני באגים

  • הספרייה הזו משתמשת עכשיו בהערות לגבי ערכי null של JSpecify, שהן הערות לשימוש בסוגים. מפתחי 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)) כדי לבדוק תאימות.

גרסת טרום-השקה (Preview) של Wear Tooling‏ 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)

גרסה 1.4 של Wear

גרסה ‎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 מכילה את הקומטים האלה.

תיקוני באגים

  • הספרייה הזו משתמשת עכשיו בהערות לגבי ערכי null של JSpecify, שהן הערות לשימוש בסוגים. מפתחי 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 של Wear

גרסה 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 עודכן כך שישתמש ב-drawable של הרקע במקום ב-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 הועבר להיות שדה במקום שיטה. (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 best effort, שמתחשבים בו כשמרחיבים רכיבי צאצא עם משקלים. לדוגמה, אפשר להגביל את הקשת עם כמה צאצאים עם משקלים ל-90 מעלות, והמערכת תתחשב גם במקום שתופסים רכיבים שלא הורחבו.

שינויים ב-API

  • הוספנו משקל ל-ArcLayout.LayoutParams, שמאפשר לווידג'ט להתרחב כדי למלא את השטח הזמין. אם יש יותר מווידג'ט אחד, החלק שלהם בשטח הזמין יהיה יחסי למשקל שלהם. בנוסף, הוספנו את ArcLayout.setMaxAngleDegrees כדי שתוכלו, למשל, להגביל את ההרחבה ל-90 מעלות (הערה: ההגדרה הזו לא משפיעה על הפריסה של ווידג'טים צאצאים בגודל קבוע). לבסוף, ArcLayout.Widget כולל עכשיו את setSweepAngleDegrees, שמאפשר ל-ArcLayout להודיע לווידג'ט עם משקל שגדול מאפס על הגודל שלו. (I75f24)
  • עודכן מצב האפשרות לערך null של 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) - Avoid accidentally dismissing of fragments in SwipeDismissFrameLayout with a vertical fling (Idb6d8)

גרסה ‎1.3.0-alpha01

‫29 בספטמבר 2021

androidx.wear:wear:1.3.0-alpha01 משוחרר. גרסה ‎1.3.0-alpha01 מכילה את הקומיטים האלה.

תיקוני באגים

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

Wear-Remote-Interactions גרסה 1.2.0

גרסה ‎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.0 של Wear Ongoing & Interactions

גרסה 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 נעול (אלא אם צוין אחרת כניסיוני). ‫Wear Phone Interactions 1.1 כולל את הפונקציות והממשקי 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

‫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-alpha04

‫10 בינואר 2024

androidx.wear:wear-phone-interactions:1.1.0-alpha04 משוחרר. גרסה ‎1.1.0-alpha04 מכילה את הקומיטים האלה.

שינויים ב-API

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

גרסה ‎1.1.0-alpha02

‫10 בינואר 2024

androidx.wear:wear-remote-interactions:1.1.0-alpha02 משוחרר. גרסה ‎1.1.0-alpha02 מכילה את הקומיטים האלה.

שינויים ב-API

  • הוספנו את RemoteActivityHelper.isRemoteActivityHelperAvailable, שמאפשר לבדוק אם הפונקציונליות של הפעלת פעילות מרחוק זמינה. (I107a9)
  • עדכנו את הבונה של 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-Phone-Interactions Version 1.1.0-alpha03

9 במרץ 2022

androidx.wear:wear-phone-interactions:1.1.0-alpha03 משוחרר. גרסה ‎1.1.0-alpha03 מכילה את הקומיטים האלה.

תיקוני באגים

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

Wear-Phone-Interactions Version 1.1.0-alpha02

15 בדצמבר 2021

androidx.wear:wear-phone-interactions:1.1.0-alpha02 משוחרר. גרסה ‎1.1.0-alpha02 מכילה את הקומיטים האלה.

תיקוני באגים

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

Wear-Phone-Interactions Version 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.0 של Wear Ongoing & Interactions

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 Version 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 שאפשר להשתמש בה כדי לפתוח כוונות במכשירים אחרים (כלומר, משעון לטלפון).

Wear-Phone-Interactions Wear-Remote-Interactions Version 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)

Wear-Ongoing Version 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)

Wear-Ongoing Version 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

Wear-Phone-Interactions Wear-Remote-Interactions Version 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-Ongoing Version 1.0.0-rc01

‫18 באוגוסט 2021

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

Wear-Ongoing Version 1.0.0-beta01

‫4 באוגוסט 2021

androidx.wear:wear-ongoing:1.0.0-beta01 משוחרר. גרסה ‎1.0.0-beta01 מכילה את הקומיטים האלה.

שינויים ב-API

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

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 Version 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. ב-methods שדורשות קריאה חוזרת, נדרש עכשיו גם executor כדי שהקריאה החוזרת תפעל. (I35e11)

תיקוני באגים

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

Wear-Phone-Interactions Version 1.0.0-alpha05

‫30 ביוני 2021

androidx.wear:wear-phone-interactions:1.0.0-alpha05 משוחרר. גרסה ‎1.0.0-alpha05 מכילה את הקומיטים האלה.

תיקוני באגים

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

Wear-Ongoing Version 1.0.0-alpha06

‫2 ביוני 2021

androidx.wear:wear-ongoing:1.0.0-alpha06 משוחרר. גרסה ‎1.0.0-alpha06 מכילה את הקומיטים האלה.

שינויים ב-API

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

תיקוני באגים

  • SerializationHelper.copy() יוצר עכשיו עותק הגנתי של המידע (I8b276)
  • שיפור התיעוד של setCategory ‏ (Iff01f)

Wear-Ongoing Version 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

גרסה Wear-Ongoing‏ ‎1.0.0-alpha04

‫5 במאי 2021

androidx.wear:wear-ongoing:1.0.0-alpha04 משוחרר. גרסה ‎1.0.0-alpha04 מכילה את הקומיטים האלה.

שינויים ב-API

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

‫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 Version 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.

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

‫7 באפריל 2021

androidx.wear:wear-remote-interactions:1.0.0-alpha03 משוחרר. גרסה ‎1.0.0-alpha03 מכילה את הקומיטים האלה.

שינויים ב-API

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

תיקוני באגים

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

‫Wear-Ongoing Wear-Phone-Interactions Version 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 אל 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

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

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

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

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

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

רכיבים בשעון ועיצובים של תצוגת השעון 1.0.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 הבלתי ניתן לשינוי במקום ב-Calendar. (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. אם הפרמטר הזה לא ריק, המערכת משתמשת בו כדי ליצור מופע ללא ראש (headless) שיגבה את EditorSession, במקום לפעול על המופע האינטראקטיבי. כך אפשר להפעיל את כלי העריכה לתצוגת שעון שלא מוגדרת כרגע. (I0a820)
  • הוספנו WatchFaceMetadataClient ניסיוני שמאפשר אחזור יעיל של מטא-נתונים סטטיים של פני שעון, כמו UserStyleSchema ופרטים קבועים לגבי ComplicationSlots. (I6bfdf)
  • שינינו את השם של CanvasRenderer.uiThreadInit ל-init. (I6fff9)
  • הוספנו את הפרמטר החדש האופציונלי PreviewScreenshotParams ל-EditorRequest. הפרמטר הזה מורה ל-EditorSession לצלם תצוגה מקדימה של צילום מסך בהעברה עם הפרמטרים האלה. תמונת התצוגה המקדימה מוצגת ב-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. הספרייה מוודאת שרק פקודה אחת ניתנת להרצה בכל זמן נתון.

  • כדי להקל על ההגדרה של 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 לפני כל קריאה לעיבוד. בנוסף, כדי שהקוד יהיה ברור יותר, שינינו את השם של onGlContextCreated ל-onBackgroundThreadGlContextCreated ושל onGlSurfaceCreated ל-onUiThreadGlSurfaceCreated ב-GlesRenderer. (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 שמחזירה מפה של מזהי Complication אל DefaultComplicationProviderPolicies ואת ComplicationType שמוגדר כברירת מחדל. השיטה הזו מהירה יותר מיצירת מופע ללא ראש, כי לא צריך לאתחל את תצוגת השעון באופן מלא כדי לבצע את השאילתה.

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

שינויים ב-API

  • הטקסט @TargetApi הוחלף בטקסט @RequiresApi. (I0184a, ‏ b/187447093, ‏ b/187447094)
  • הוספנו את WatchFaceControlClient.getDefaultProviderPoliciesAndType שמחזירה מיפוי של מזהי רכיבי Complication אל DefaultComplicationProviderPolicies ואת ComplicationType שמוגדר כברירת מחדל. במקרים שבהם אפשר, נעשה שימוש בנתיב מהיר שמונע בנייה מלאה של תצוגת השעון. כדי לאפשר זאת, נאלצנו לשנות את 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 הבאות ייחסמו עד שהאתחול של לוח השעון יסתיים. (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

  • המאפיינים GlesRenderer‏ eglContext ו-eglDisplay הם עכשיו 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 Version 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 לחובה להעברה אל הקונסטרוקטורים שלהם. אם מעבירים את הערך ComplicationText.EMPTY לפרמטר contentDescription, נוצר באופן אוטומטי contentDescription מהטקסט ומהכותרת.

  • WatchFaceControlClient.getOrCreateInteractiveWatchFaceClient throws 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)
  • הפכנו את השדות ShortTextComplicationData.Builder, LongTextComplicationData.Builder ו-RangedValueComplicationData.Builder contentDescription לחובה להעברה בפונקציית הבנאי. (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)
  • עכשיו אפשר לציין בלוח השעון את התוויות של תיאורי התוכן לנגישות באמצעות המאפיין RendereradditionalContentDescriptionLabels. בנוסף לשליטה בסדר של ContentDescriptionLabels, נוסף accessibilityTraversalIndex לסיבוכים. אפשר לשנות את זה באמצעות ComplicationsUserStyleSetting. (Ib7362)
  • הרחבת התיעוד בנושא טיפול באירועי מגע בתצוגת השעון. (Iaf31e)

תיקוני באגים

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

Wear Complications & Watchface Version 1.0.0-alpha12

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)
  • הפכנו את השדה contentDescription של PhotoImageComplicationData.Builder, MonochromaticImageComplicationData.Builder ו-SmallImageComplicationData.Builder לחובה בהעברה בבונה. (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)
  • ה-constructor של 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)
  • הפורמט של מפת UserStyle שונה ל-Map<String, byte[]>. כדי להקל על השימוש, נוסף ל-API הציבורי מחלקה UserStyleData, ועכשיו נעשה בה שימוש ב-wear-watchface-client וב-wear-watchface-editor. בנוסף, הערך של CustomValueUserStyleSetting.CustomValueOption.value הוא עכשיו byte[] במקום String. (Iaa103)
  • UserStyleSetting ו-UserStyleSetting.Option משתמשים עכשיו ב-UserStyleSetting.Id וב-UserStyleSetting.Option.Id בהתאמה כדי לאחסן את המזהים שלהם, במקום במחרוזת. (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() כדי לאפשר לכם לבדוק אם החיבור נותק מסיבה כלשהי (למשל, אם לוח השעון נסגר). (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 לטובת שימוש ב-builders. (Ibe399)
  • הוספנו עטיפות של guava ListenableFuture לשיטות שונות של השעיית ספריית תצוגות השעון. (I16b2c)
  • כדי להבהיר את השימוש ב-API, הוספנו בנאי משני ל-RenderParameters שלא דורש גוון, לשימוש עם LayerModes שאינם LayerMode.DRAW_OUTLINED. (I497ea)
  • בעבר, הפונקציה ListUserStyleSetting הייתה שונה מהפונקציות האחרות כי היה לה ארגומנט ברירת מחדל. עכשיו, כל ה-constructors של מחלקת המשנה 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 נוספו לספרייה. המחלקה 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 wireformats, שמשפיע על חלק מממשקי ה-API הנסתרים הלא יציבים. (I8be09)
  • הוספנו את CustomValueUserStyleSetting שמאפשר לכם לאחסן מחרוזת אחת שספציפית לאפליקציה בתוך UserStyle. העורכים של תצוגות השעון שמוגדרים כברירת מחדל יתעלמו מהערך הזה. (Ic04d2)
  • ‫InstanceID לא מועבר בתוספות של הכוונה ל-R ולגרסאות קודמות של Android WearOS שאי אפשר לשדרג. כדי לתמוך בכך, אנחנו מאפשרים עכשיו שהערך של InstancID יהיה null. (Id8b78)
  • הבקשה EditorRequest כוללת עכשיו את הרכיב editor ComponentName שמוגדר כרכיב ב-WatchFaceEditorContract.createIntent ‏ (I3cd06)
  • ה-EditorResult של פני השעון כולל עכשיו תצוגה מקדימה של ComplicationData כדי לאפשר למתקשר לצלם מסך של פני השעון אחרי העריכה. (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)
  • הוספנו חבילה אופציונלית לרכיבי מידע, שאם היא מוגדרת היא מתמזגת עם הכוונה שנשלחת להפעלת פעילות לבחירת ספק. (Ifd4ad)
  • הוספנו ספרייה חדשה wear-watchface-editor כדי לתמוך בעורכים שמתארחים בתצוגת השעון וב-SysUi. מערכת SysUI תפעיל את כלי העריכה האלה על ידי שליחת intent. שירות הפעילות של תצוגת השעון יכול להשתמש במחלקה החדשה EditorSession כדי לגשת לפרטים של WatchFace ולתעד את התוצאה באמצעות Activity.setWatchRequestResult. (I2110d)
  • השם של LayerMode.DRAW_HIGHLIGHTED הוא עכשיו LayerMode.DRAW_OUTLINED, והשם של RenderParameters.highlightComplicationId הוא עכשיו RenderParameters.selectedComplicationId. הפונקציה הזו מציירת הדגשה על הסיבוך שצוין בנוסף לתיאור קצר. (I90a40)
  • ה-Future של 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 רק עבור מקרים של headless. (Ifa900)
  • החל מעכשיו, יש תמיכה אופציונלית בטעינה סינכרונית של רכיבי drawables ב-ComplicationDrawable. הערך הזה משמש את ממשקי ה-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. הערה: כדי לתמוך ב-canvas בחומרה, נדרשת רמת API‏ 26 ומעלה. (Ic9bbd)
  • ל-InteractiveWatchFaceWcsClient יש עכשיו פונקציית עזר getComplicationIdAt. (I05811)
  • רמת ה-API של wear-watchface-client הופחתה ל-25, אבל ממשקי ה-API של צילומי המסך דורשים רמת API של 27. (Id31c2)

תיקוני באגים

  • עכשיו אנחנו חושפים את ComplicationType של ComplicationData הנוכחי של Complication ב-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 מכילה את הקומיטים האלה.

תכונות חדשות

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

גרסה 1.2.0

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

    דוגמה לטקסט מעוקל ב-Android Wear

  • נוסף מאגר 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>
    

    דוגמה לטקסט קשתי ב-Android Wear

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

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

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

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

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

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

  • תוקן באג שגרם לכך שגלילה אופקית של RecyclerViews גרמה ל-WearableDrawerLayout להציץ בכל האינטראקציות. (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 מכילה את הקומיטים האלה.

תיקוני באגים

  • תוקן באג שגרם לכך שגלילה אופקית של RecyclerViews גרמה ל-WearableDrawerLayout להציץ בכל האינטראקציות. (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 נוספה חותמת זמן של מועד יצירת הפעילות המתמשכת – 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, שמטפל בסגירה באמצעות לחצן החזרה או בהחלקה לסגירה, ומיועד לשימוש בתוך פעילות. צריך להוסיף לפחות מאזין אחד שיפעל על פעולת ביטול. בדרך כלל, מאזין יסיר תצוגה או קטע שמכילים אותו מהפעילות הנוכחית. הפונקציות setSwipeDismissible(boolean)‎ ו-setBackButtonDismissible(boolean)‎ מספקות שליטה ישירה בתכונות. הפריסה החדשה הזו נועדה להחליף את הפריסה הקיימת SwipeDismissFrameLayout.

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

פעילויות מתמשכות בכיתות הן עכשיו VersionedParcelables במקום להשתמש בסריאליזציה/דה-סריאליזציה בהתאמה אישית. עכשיו צריך להוסיף סמל סטטי ופעולת הקשה.

שינויים ב-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 חדש לפעילויות מתמשכות, זו פעולה שלא מתבצעת ב'מכשירים לא נתמכים'. (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"
/>

דוגמה לטקסט מעוקל ב-Android Wear

  • נוסף מאגר 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>

דוגמה לטקסט קשתי ב-Android Wear

(I536da)

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)

תיקוני באגים

  • הספרייה הזו משתמשת עכשיו בהערות לגבי ערכי null של JSpecify, שהן הערות לשימוש בסוגים. מפתחי 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)

Wear-Input 1.1.0

גרסה 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, שמספקת פונקציות עזר לתמיכה בקלטים מרחוק באמצעות הפעלת intent. (I47cee)

Wear-Input 1.0.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)

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

‫2 בספטמבר 2020

androidx.wear:wear-input:1.0.0-alpha01 משוחרר. גרסה 1.0.0-alpha01 מכילה את הקומיטים האלה.

תכונות חדשות

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

גרסה 1.1.0

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