Wear

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

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

פריט מידע שנוצר בתהליך פיתוח (Artifact) גרסה יציבה גרסה מועמדת להפצה גרסת בטא גרסת אלפא
wear 1.4.0 - - -
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.2.0 - - -
הספרייה הזו עודכנה לאחרונה ב-25 במרץ 2026

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

כדי להוסיף תלות ב-Wear, צריך להוסיף את מאגר Google Maven לפרויקט. מידע נוסף זמין במאמר בנושא מאגר 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.0"
    // Use to implement support for interactions between the Wearables and Phones
    implementation "androidx.wear:wear-remote-interactions:1.2.0"
}

Kotlin

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

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

משוב

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

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

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

גרסה 1.1 של Wear Core

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

גרסת ליבה של Wear‏ 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 לגבי ערכי null, שהן אנוטציות של שימוש בטיפוסים. מפתחי 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

‫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 מכילה את השמירות האלה.

  • אין שינויים חדשים בין גרסת beta01 לגרסת 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 לגבי ערכי null, שהן אנוטציות של שימוש בטיפוסים. מפתחי 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 עודכן לשימוש בפריט גרפי שניתן להזזה ברקע במקום ב-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 לשימוש בפריטים שניתן לצייר במקום בהוספת תצוגה כדי לתקן שגיאות במהלך השימוש ב-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 תומך עכשיו במשקלים של הרחבות, שפועלים באופן דומה למשקלים של פריסות רגילות. כלומר, אתם יכולים לציין את הגודל היחסי של רכיבי צאצא בלי לחשב את הזוויות שלהם ישירות. הוספנו גם MaxAngleDegreesbest effort, שמתחשבים בו כשמרחיבים רכיבי צאצא עם משקלים. לדוגמה, אפשר להגביל את הקשת עם כמה צאצאים עם משקלים ל-90 מעלות, והמערכת תתחשב גם במקום שתופסים רכיבים שלא הורחבו.

שינויים ב-API

  • הוספנו משקל ל-ArcLayout.LayoutParams, שמאפשר לווידג'ט להתרחב כדי למלא את השטח הזמין. אם יש יותר מווידג'ט אחד, החלק שלהם מהשטח הזמין יהיה יחסי למשקל שלהם. בנוסף, הוספנו את ArcLayout.setMaxAngleDegrees כדי שתוכלו למשל להגביל את ההרחבה ל-90 מעלות (הערה: ההגדרה הזו לא משפיעה על הפריסה של ווידג'טים צאצאים בגודל קבוע). לבסוף, ArcLayout.Widget כולל עכשיו setSweepAngleDegrees שמאפשר ל-ArcLayout להודיע לווידג'ט עם משקל שאינו אפס על הגודל שלו. (I75f24)
  • עודכן הערך של מאפיין האפשרות להשאיר את השדה ריק 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)
  • מניעת סגירה לא מכוונת של מקטעים (fragment) ב-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

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

Wear Ongoing & Interactions Version 1.1.0

גרסה 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)
  • עדכנו את ה-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-Phone-Interactions Version 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)

‫Wear-Phone-Interactions גרסה ‎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)

Wear Ongoing & Interactions Version 1.0.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 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, providing support for remote authentication on Wearables together with support for adding OAuth PKCE extension. יש גם פונקציות נוספות וספריות עזר לתקשורת.

ספריית האינטראקציות מרחוק מכילה ממשקי 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 גרסה ‎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. ב-methods שדורשות קריאה חוזרת, נדרש עכשיו גם 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-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 Version 1.0.0-alpha04

‫5 במאי 2021

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

שינויים ב-API

  • ב-OngoingActivity, השיטות מ-fromExistingOngoingActivity נקראות עכשיו recoverOngoingActivity.
  • ל-OngoingActivity יש עכשיו קבוצה מלאה של פונקציות getter, שהיו זמינות בעבר רק ב-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 גרסה ‎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 גרסה ‎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 לטלפונים. היא מאוכלסת בהתחלה במחלקות שהועברו מ-Wearable Support Library. (Id5180)

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

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

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

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

שינויים ב-API

  • הטקסט @TargetApi הוחלף בטקסט @RequiresApi. (I0184a, ‏ b/187447093, ‏ b/187447094)
  • הוספנו את WatchFaceControlClient.getDefaultProviderPoliciesAndType שמחזירה מיפוי של מזהי רכיבי מידע למדיניות של DefaultComplicationProvider ושל 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 וגרסה 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 זורק כעת 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 של השיטה הזו ל-data 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, ומכיוון שיכול להיות שיש הקשר אינטראקטיבי והקשר ללא ראש, צריך לבצע את הקריאה הזו. (I8a43c)
  • ‫WatchFaceControlClient.getOrCreateInteractiveWatchFaceClient מוציא עכשיו את החריג ServiceStartFailureException אם יש חריג בתצוגת השעון במהלך ההפעלה. בנוסף, המחלקה WatchFaceService זורקת עכשיו חריגה אם הפונקציה createWatchFace נמשכת יותר מ-6 שניות. (I59b2f)
  • הסרנו את מאפיין המזהה שלא נמצא בשימוש של GlesTextureComplication. (I28958)
  • עכשיו אפשר לציין בלוח השעון את התוויות של תיאורי התוכן לנגישות באמצעות המאפיין additionalContentDescriptionLabels של Renderer. בנוסף לשליטה בסדר של ContentDescriptionLabels, נוסף accessibilityTraversalIndex לסיבוכים. אפשר לשנות את זה באמצעות ComplicationsUserStyleSetting. (Ib7362)
  • הרחבת התיעוד בנושא טיפול באירועי מגע בתצוגת השעון. (Iaf31e)

תיקוני באגים

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

רכיבים בשעון Wear וגרסה 1.0.0-alpha12 של תצוגת השעון

21 באפריל 2021

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

תכונות חדשות

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

כדי לעודד תמיכה בנגישות של ספקי רכיבי מידע, הפכנו את השדה 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)
  • ה-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[]>, ומטעמי נוחות נוספה מחלקה UserStyleData ל-API הציבורי, ועכשיו נעשה בה שימוש ב-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)
  • הסרנו את ההמרות השונות של Binder wear-watchface-client, הן לא אמורות להיות נחוצות. (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)
  • תיקנו באג בהעברת נתונים (marshalling) בפורמטים של UserStyle, ששינה חלק מממשק ה-API הנסתר הלא יציב. (I8be09)
  • הוספנו את CustomValueUserStyleSetting שמאפשר לכם לאחסן מחרוזת אחת ספציפית לאפליקציה בתוך UserStyle. העורכים של תצוגות השעון שמוגדרים כברירת מחדל יתעלמו מהערך הזה. (Ic04d2)
  • ‫InstanceID לא מועבר בתוספות של הכוונה ל-R ולגרסאות ישנות יותר של Android WearOS שאי אפשר לשדרג. כדי לתמוך בכך, אנחנו מאפשרים עכשיו ש-InstanceID יהיה 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 כדי לגשת לפרטים של 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> במקום מערך int, ולכן קל יותר להשתמש בה. (I1f13d)
  • ProviderInfoRetriever.retrieveProviderInfo מחזירה עכשיו את הערך ListenableFuture<ProviderInfo[]> בצורה נכונה. (If2710)
  • עכשיו אפשר ליצור רכיב מידע שמושבת בהתחלה על ידי קריאה ל-setEnabled(false) ב-builder. (Idaa53)
  • ל-WatchFaceState יש עכשיו מאפיין isHeadless שמוגדר כ-True רק עבור מקרים של הפעלה ללא ממשק משתמש. (Ifa900)
  • החל מעכשיו, יש תמיכה אופציונלית בטעינה סינכרונית של רכיבי ציור ב-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. הערה: כדי לתמוך בלוח ציור של חומרה נדרשת רמת 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)

תיקוני באגים

  • השינוי שבוצע ב-ComplicationProviderService הוא הוספה של שיטה מפורשת getComplicationPreviewData. (I4905f)
  • הבדיקה של API lint ל-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, שמטפל בסגירה באמצעות כפתור החזרה או בהחלקה לסגירה, והוא מיועד לשימוש בתוך פעילות. צריך להוסיף לפחות מאזין אחד שיפעל על פעולת ביטול. בדרך כלל, מאזין יסיר תצוגה או מקטע (fragment) שמכילים אותו מהפעילות הנוכחית. הפונקציות 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

  • העברת הספרייה Ongoing Activities לספריית משנה חדשה: 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, שמטפל בסגירה באמצעות לחצן החזרה או בהחלקה לסגירה, ומיועד לשימוש בתוך פעילות. צריך להוסיף לפחות מאזין אחד שיפעל על פעולת ביטול. בדרך כלל, מאזין יסיר תצוגה או מקטע (fragment) שמכילים אותו מהפעילות הנוכחית. הפונקציות 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

  • ‫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)

תיקוני באגים

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

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)