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 - - -
הספרייה הזו עודכנה לאחרונה בתאריך: 8 באפריל 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-alpha02

‫8 באפריל 2026

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

תכונות חדשות

גרסה ‎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 nullness, שהן מסוג type-use. מפתחי Kotlin צריכים להשתמש בארגומנטים הבאים של הקומפיילר כדי לאכוף שימוש נכון: -Xjspecify-annotations=strict, -Xtype-enhancement-improvements-strict-mode (Icbfb9, ‏ b/326456246)

גרסה 1.0.0-alpha01

‫29 במאי 2024

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

שינויים ב-API

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

גרסת טרום-השקה (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 nullness, שהן מסוג type-use. מפתחי Kotlin צריכים להשתמש בארגומנטים הבאים של הקומפיילר כדי לאכוף שימוש נכון: -Xjspecify-annotations=strict, -Xtype-enhancement-improvements-strict-mode (If4b1a, ‏ b/326456246)

גרסה ‎1.4.0-alpha01

‫15 בנובמבר 2023

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

תיקוני באגים

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

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

שינויים ב-API

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

גרסה ‎1.3.0-alpha02

23 בפברואר 2022

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

תכונות חדשות

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

תיקוני באגים

  • הוספנו כללי ProGuard כדי לוודא שהקוד שקשור לנתונים סביבתיים יישמר (Idaa10)
  • מניעת סגירה לא מכוונת של רכיבי 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 מ-OAuthRequest מחזירה עכשיו מחרוזת ריקה אם כתובת ה-URL להפניה אוטומטית לא מוגדרת בכתובת ה-URL של הבקשה שצוינה. (I44242)

Wear-Phone-Interactions Version 1.1.0-alpha02

15 בדצמבר 2021

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

תיקוני באגים

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

Wear-Phone-Interactions גרסה ‎1.1.0-alpha01

‫15 בספטמבר 2021

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

שינויים ב-API

  • הנכס redirectUrl נוסף אל OAuthRequest. (I98840, Ie684d)

גרסה 1.0.0 של Wear Ongoing & Interactions

Wear-Phone-Interactions Version 1.0.1

15 בדצמבר 2021

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

תיקוני באגים

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

Wear-Phone-Interactions Wear-Remote-Interactions Version 1.0.0

‫15 בספטמבר 2021

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

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

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

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

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

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

Wear-Phone-Interactions Wear-Remote-Interactions Version 1.0.0-rc01

‫1 בספטמבר 2021

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

תיקוני באגים

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

Wear-Ongoing Version 1.1

גרסה 1.1.0

‫10 בספטמבר 2025

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

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

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

גרסה ‎1.1.0-rc01

‫27 באוגוסט 2025

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

גרסה ‎1.1.0-beta01

‫30 ביולי 2025

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

גרסה ‎1.1.0-alpha01

‫23 באוגוסט 2023

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

שינויים ב-API

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

תיקוני באגים

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

Wear-Ongoing Version 1.0.0

‫1 בספטמבר 2021

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

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

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

Wear-Phone-Interactions Wear-Remote-Interactions Version 1.0.0-beta01

‫18 באוגוסט 2021

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

שינויים ב-API

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

Wear-Ongoing Version 1.0.0-rc01

‫18 באוגוסט 2021

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

Wear-Ongoing Version 1.0.0-beta01

4 באוגוסט 2021

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

שינויים ב-API

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

Wear-Phone-Interactions Version 1.0.0-alpha07

4 באוגוסט 2021

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

שינויים ב-API

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

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

4 באוגוסט 2021

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

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

21 ביולי 2021

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

שינויים ב-API

  • המחלקות BridgingManagerSeviceBinder class הן עכשיו מחלקות משנה של Service, והשם שלהן שונה ל-BridgingManagerSevice. (I9fca2)
  • השיטה RemoteAuthClient.Callback.onAuthorizationError משתנה וכוללת את הפרמטר OAuthRequest. ב-Methods שדורשות קריאה חוזרת (callback) נדרש עכשיו גם 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

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

שינויים ב-API

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

גרסה ‎1.0.0-alpha21

‫1 בספטמבר 2021

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

שינויים ב-API

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

גרסה ‎1.0.0-alpha20

‫18 באוגוסט 2021

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

שינויים ב-API

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

גרסה ‎1.0.0-alpha19

4 באוגוסט 2021

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

שינויים ב-API

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

גרסה ‎1.0.0-alpha18

21 ביולי 2021

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

שינויים ב-API

  • העברנו את ComplicationHelperActivity לספרייה של androidx.wear:wear-watchface. (I39e76)
  • כדי לשמור על עקביות ובהירות, השם של ComplicationProvider שונה ל-ComplicationDataSource, וכל הכיתות שכללו את המילה Provider בשם שלהן קיבלו שם חדש באופן דומה. (Iaef0b)
  • ‫CanvasComplication.isHighlighted הועבר אל RenderParameters.pressedComplicationSlotIds. זהו צעד לקראת הפיכת CanvasComplication ללא שמירת מצב. כדי לתמוך בשינוי הזה, CanvasComplication.render מקבלת עכשיו גם את slotId כפרמטר, ואנחנו מעבירים עכשיו את ComplicationSlot אל GlesTextureComplication. (I50e6e)
  • הוספנו את headlessDeviceConfig ל-EditorRequest. אם הערך של הפרמטר הזה הוא לא null, המערכת משתמשת בו כדי ליצור מכונה ללא ראש שתומכת ב-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. הספרייה מוודאת שרק פקודה אחת ניתנת להרצה בכל זמן נתון.

  • כדי להקל על ההגדרה של UiThread, הוספנו את CanvasRenderer.uiThreadInit שמופעל פעם אחת ב-UiThread לפני כל קריאה להצגה. הוספנו גם את 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 Complications & Watchface Version 1.0.0-alpha13

‫5 במאי 2021

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

תכונות חדשות

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

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

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

שינויים ב-API

  • הוספנו תמיכה בשם רכיב null ב-ComplicationProviderInfo, שנדרשת כדי לתמוך בגרסאות ישנות יותר של Wear OS. (I744d2)
  • העברנו את androidx.wear.complications.SystemProviders מ-Java ל-Kotlin. (Ia1f8b)
  • הסתרנו את כל המחלקות מממשק ה-API הציבורי שנמצאות ב-android.support.wearable.complications ויצרנו עטיפות תואמות ב-AndroidX במקומות שנדרש. (I7bd50)
  • שינינו את השם של השיטה ב-TimeDifferenceComplicationText.Builder מ-setMinimumUnit ל-setMinimalTimeUnit. (I20c64)
  • הגדרנו שחובה להעביר את השדה contentDescription של ShortTextComplicationData.Builder, LongTextComplicationData.Builder ו-RangedValueComplicationData.Builder בבונה. (I8cb69)
  • שינינו את השם של ComplicationProviderService.onComplicationUpdate ל-onComplicationRequest, והוספנו את הפרמטרים id ו-type של השיטה הזו ל-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 לארגומנט חובה ב-constructor. הוספנו את 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 wireformats, שגרם לשינוי של חלק מממשק ה-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)
  • החל מגרסה 1.1.0, המחלקה 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 ו-data ‏ (I4dcc8)
  • במקום ComplicationRenderer.InvalidateCallback, אנחנו מוסיפים Complication#invalidate()‎ (I4f4c6)
  • ממשקי ה-API האלה יוצאים משימוש ב-WearableSupport ומוסרים כאן. (Ib425c)
  • שינינו את השם של חלק מהשיטות של הכלי ליצירת לוחות שעון כדי להדגיש את האופי שלהן כשיטות מדור קודם שמתאימות ל-Wear 2.0. (Idb775)
  • מועמד ראשון לגרסת בטא של API ל-wear/wear-watchface (Id3981)
  • הגרסה הראשונה של ה-API שמתבצע אחריה מעקב. (Ie9fe6)
  • הסתרנו כמו שצריך את ComplicationDrawable.BorderStyle IntDef ועברנו אל ComplicationStyle כדי לשמור על עקביות. (I27f7a)
  • הוספת הערות חסרות לשיטות ComplicationStyle‏ (I838fd)
  • לספרייה הזו אין ממשק API ציבורי (I88e2b)
  • כל מחלקות האפשרויות של קטגוריית הסגנון הן עכשיו סופיות כמו שצריך. (Ib8323)
  • הגרסה הראשונה של ה-API שמתבצע אחריה מעקב. (I27c85)

תיקוני באגים

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

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

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

תיקוני באגים

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

גרסה ‎1.2.0-alpha05

‫13 בינואר 2021

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

תיקוני באגים

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

גרסה ‎1.2.0-alpha04

‫16 בדצמבר 2020

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

שינויים ב-API

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

גרסה ‎1.2.0-alpha03

2 בדצמבר 2020

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

תכונות חדשות

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

גרסה ‎1.2.0-alpha02

‫29 בספטמבר 2021

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

שינויים ב-API

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

גרסה ‎1.2.0-alpha01

‫15 בספטמבר 2021

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

שינויים ב-API

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

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 שמשמשות לקבלת או להצבת תוספים שמייצגים את התוויות title, ‏ cancel, ‏ confirm ו-in progress, משתמשות עכשיו ב-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 אל 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 Version 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)