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 - - ‎1.3.0-alpha01
הספרייה הזו עודכנה לאחרונה ב-3 ביוני 2026

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

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

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

מגניב

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

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

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

    // Use to implement support for interactions from the Wearables to Phones
    implementation "androidx.wear:wear-phone-interactions:1.1.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

‫3 ביוני 2026

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

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

גרסה ‎1.1.0-rc01

‫19 במאי 2026

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

גרסה ‎1.1.0-beta01

‫6 במאי 2026

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

שינויים ב-API

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

גרסה ‎1.1.0-alpha02

‫8 באפריל 2026

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

תכונות חדשות

גרסה ‎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 לשימוש ב-drawables במקום הוספת תצוגה כדי לתקן שגיאות במהלך השימוש ב-FragmentContainerView. (I851cd)

גרסה ‎1.3.0-alpha04

‫25 בינואר 2023

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

תיקוני באגים

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

גרסה ‎1.3.0-alpha03

‫24 באוגוסט 2022

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

תכונות חדשות

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

שינויים ב-API

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

גרסה 1.3.0 של Wear-Remote-Interactions

גרסה ‎1.3.0-alpha01

‫19 במאי 2026

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

שינויים ב-API

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

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 (מסוג public) ‏(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 (מסוג public) ‏(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 ומשתמשים בחלופות קטנות יותר.

גרסה ‎1.1.0-alpha03 של Wear-Phone-Interactions

9 במרץ 2022

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

תיקוני באגים

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

Wear-Phone-Interactions Version 1.1.0-alpha02

15 בדצמבר 2021

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

תיקוני באגים

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

Wear-Phone-Interactions Version 1.1.0-alpha01

‫15 בספטמבר 2021

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

שינויים ב-API

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

Wear Ongoing & Interactions Version 1.0.0

Wear-Phone-Interactions Version 1.0.1

15 בדצמבר 2021

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

תיקוני באגים

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

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

‫15 בספטמבר 2021

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

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

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

  • PhoneDeviceType, מספק שיטות עזר לקביעת סוג הטלפון שאליו השעון הנוכחי משויך, לשימוש במכשירים לבישים בלבד.
  • BridgingManager,‏ BridgingManagerService ו-BridgingConfig APIs כדי להפעיל או להשבית התראות בזמן ריצה, ואפשר גם להגדיר תגים להתראות שלא חלות עליהן הגבלות במצב גישור.
  • RemoteAuthClient, כולל תמיכה באימות מרחוק במכשירים לבישים ותמיכה בהוספת תוסף 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 גרסה ‎1.0.0-alpha07

4 באוגוסט 2021

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

שינויים ב-API

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

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

4 באוגוסט 2021

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

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

21 ביולי 2021

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

שינויים ב-API

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

תיקוני באגים

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

Wear-Phone-Interactions Version 1.0.0-alpha05

‫30 ביוני 2021

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

תיקוני באגים

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

Wear-Ongoing Version 1.0.0-alpha06

‫2 ביוני 2021

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

שינויים ב-API

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

תיקוני באגים

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

Wear-Ongoing Version 1.0.0-alpha05

‫18 במאי 2021

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

שינויים ב-API

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

    • הכיתה החדשה Status משמשת עכשיו ליצירת הסטטוס של OngoingActivity
    • OngoingActivityData ו-OngoingActivityStatus כבר לא חלק מממשק ה-API הציבורי.
  • השיעורים TextStatusPart ו-TimerStatusPart כבר לא חלק מממשק ה-API הציבורי. (I57fb6)

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

Wear-Ongoing 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 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. הספרייה מוודאת שרק פקודה אחת של GL ניתנת להרצה בכל זמן נתון.

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

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

שינויים ב-API

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

גרסה ‎1.0.0-alpha16

‫16 ביוני 2021

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

תכונות חדשות

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

תיקוני באגים

  • מניעת NPE ב-onComplicationProviderChooserResult (b/189594557)
  • פתרון בעיות שקשורות למשטחים לא פעילים ול-drawBlack ‏ (b/189452267)
  • תיקון בעיה של הרשאות גישה ל-complicationsManager.watchState (b/189457893)
  • תיקון באג שקשור לזמן החיים של Thread ברקע (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 שמחזירה מפה של מזהי רכיבי מידע למדיניות ברירת המחדל של ספקי רכיבי מידע ולסוג ברירת המחדל של רכיבי מידע. השיטה הזו מהירה יותר מיצירת מופע ללא ממשק משתמש, כי לא צריך לאתחל את תצוגת השעון באופן מלא כדי לבצע את השאילתה.

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

שינויים ב-API

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

גרסה ‎1.0.0-alpha14

‫18 במאי 2021

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

תכונות חדשות

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

שינויים ב-API

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

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

‫5 במאי 2021

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

תכונות חדשות

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

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

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

שינויים ב-API

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

תיקוני באגים

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

Wear Complications & Watchface Version 1.0.0-alpha12

21 באפריל 2021

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

תכונות חדשות

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

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

שינויים ב-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)
  • הסרנו את ההמרות השונות של wear-watchface-client Binder, הן לא אמורות להיות נחוצות. (Icc4c0)
  • לצורך עקביות, בוצע רפקטורינג של EditorServiceClient כדי להשתמש במאזינים במקום במתבוננים. (Iec3a4)
  • הוספנו כמה הערות חסרות של @Px אל InteractiveWatchFaceSysUiClient וגם אל WatchFaceControlClient. (I3277a)
  • שם המחלקה EditorObserverCallback שונה ל-EditorObserverListener כדי לשמור על עקביות. (Ie572d)
  • השדה EditorState.watchFaceInstanceId מוגבל לרמת API של Android R ומעלה, והוא כבר לא יכול להיות null. (Id52bb)
  • השם של EditorSession.launchComplicationProviderChooser שונה ל-openComplicationProviderChooser. (I9d441)
  • הפונקציה EditorSession.createOnWatchEditingSessionAsync קיבלה את השם החדש createOnWatchEditingSession והיא עכשיו פונקציית השעיה. (Id257b)
  • הוספתי כמה הערות חסרות של @UiThread ב-EditorSession. (I6935c)
  • השם של UserStyleSetting.affectsLayers שונה ל-affectedLayers. (I6e22b)

גרסה ‎1.0.0-alpha10

‫24 במרץ 2021

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

תכונות חדשות

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

שינויים ב-API

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

גרסה ‎1.0.0-alpha09

10 במרץ 2021

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

תכונות חדשות

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

שינויים ב-API

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

גרסה ‎1.0.0-alpha08

24 בפברואר 2021

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

תכונות חדשות

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

שינויים ב-API

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

גרסה ‎1.0.0-alpha07

‫10 בפברואר 2021

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

תכונות חדשות

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

שינויים ב-API

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

תיקוני באגים

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

גרסה ‎1.0.0-alpha06

‫27 בינואר 2021

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

תכונות חדשות

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

שינויים ב-API

  • ל-ComplicationProviderInfo יש עכשיו שדה ל-ComponentName של הספק. התמיכה בשדה הזה תתווסף ל-WearOS במועד מאוחר יותר, ובינתיים הוא יהיה null. (Id8fc4)
  • הוספנו את ProviderInfoRetriever.requestPreviewComplicationData שמאפשר לעורכי תצוגות שעון לבקש תצוגה מקדימה של ComplicationData. התכונה הזו שימושית כי יכול להיות שיהיה צורך בהרשאות כדי להציג סיבוכים בזמן אמת, ועכשיו אפשר להציג נתוני תצוגה מקדימה של סיבוכים שלא פעילים. (I2e1df)
  • ‫ComplicationManager הוא עכשיו פרמטר אופציונלי של WatchFace constructor, והארגומנטים סודרו מחדש כדי לאפשר זאת. (I66c76)
  • הוספנו חבילה אופציונלית ל-Complications, שאם היא מוגדרת היא מתמזגת עם הכוונה שנשלחת להפעלת פעילות בחירת הספק. (Ifd4ad)
  • הוספנו ספרייה חדשה של wear-watchface-editor כדי לתמוך בעורכים שמתארחים בתצוגת השעון וב-SysUi. מערכת SysUI תפעיל את העורכים האלה על ידי שליחת intent. שירות הפעילות של תצוגת השעון יכול להשתמש במחלקה החדשה EditorSession כדי לגשת לפרטים של תצוגת השעון ולתעד את התוצאה באמצעות Activity.setWatchRequestResult. (I2110d)
  • השם של LayerMode.DRAW_HIGHLIGHTED שונה ל-LayerMode.DRAW_OUTLINED, והשם של RenderParameters.highlightComplicationId שונה ל-RenderParameters.selectedComplicationId. עכשיו, בנוסף לסימון המתאים, מופיע גם קו מתאר של הסיבוך שצוין. (I90a40)
  • ה-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 תומכת עכשיו באופן אופציונלי בטעינה סינכרונית של רכיבי drawables. ההגדרה הזו משמשת את ממשקי ה-API של צילומי המסך. (I34d4a)

גרסה ‎1.0.0-alpha04

‫16 בדצמבר 2020

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

תכונות חדשות

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

שינויים ב-API

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

תיקוני באגים

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

גרסה ‎1.0.0-alpha03

‫2 בדצמבר 2020

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

תכונות חדשות

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

יש עכשיו תמיכה בקצב פריימים משתנה באמצעות הקצאה ל-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 to use new style complication api for consistency (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, ולכן המחלקה הזו עברה שינוי כדי לקבל פרמטרים דרך ה-constructor. (I61644)
  • שינוי השם של setBackgroundComplication לשם הבהרה. (I96fe3)
  • שימוש במאפייני Kotlin עבור ComplicationDrawable isHighlighted ונתונים (I4dcc8)
  • במקום ComplicationRenderer.InvalidateCallback, מוסיפים את Complication#invalidate()‎ (I4f4c6)
  • ממשקי ה-API האלה יוצאים משימוש ב-WearableSupport ומוסרים כאן. (Ib425c)
  • שינינו את השם של חלק מהשיטות של WatchFace builder כדי להדגיש את האופי שלהן כשיטות מדור קודם שמתאימות ל-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, שמטפל בסגירה באמצעות לחצן החזרה או בהחלקה לסגירה, והוא מיועד לשימוש בתוך פעילות. צריך להוסיף לפחות מאזין אחד שיפעל על פעולת ביטול. בדרך כלל, מאזין יסיר תצוגה או קטע שמכילים אותו מהפעילות הנוכחית. הפונקציות 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)

  • תוקן באג שגרם לכך שרכיבי RecyclerView עם גלילה אופקית גרמו ל-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 מכילה את השמירות האלה.

תיקוני באגים

  • תוקן באג שגרם לכך שרכיבי RecyclerView עם גלילה אופקית גרמו ל-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), להגדרת גופן הטקסט וסגנון ההדגשה או ההטיה. (I4653c)
  • השם של WearArcLayout שונה ל-ArcLayout, השם של WearCurvedText שונה ל-CurvedText והשם של WearArcLayout.ArcLayoutWidget שונה ל-ArcLayout.Widget. (I6e5ce)
    • בתאריך ArcLayout.Widget, שינית את השם של getThicknessPx לgetThickness.
    • הקבועים של היישור האנכי ב-ArcLayout.LayoutParams נקראים עכשיו בשמות שמתחילים ב-VERTICAL_ALIGN_ (במקום VALIGN_ כמו קודם)
  • ב-CurvedTextView, השיטות setMinSweepDegrees ו-setMaxSweepDegrees הוחלפו ב-setSweepRangeDegrees (I7a9d9)

גרסה ‎1.2.0-alpha08

‫5 במאי 2021

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

שינויים ב-API

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

גרסה ‎1.2.0-alpha07

‫24 במרץ 2021

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

תיקוני באגים

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

גרסה ‎1.2.0-alpha06

‫27 בינואר 2021

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

שינויים ב-API

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

תיקוני באגים

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

גרסה ‎1.2.0-alpha05

‫13 בינואר 2021

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

תיקוני באגים

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

גרסה ‎1.2.0-alpha04

‫16 בדצמבר 2020

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

שינויים ב-API

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

גרסה ‎1.2.0-alpha03

‫2 בדצמבר 2020

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

תכונות חדשות

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

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

גרסה ‎1.1.0-alpha01

‫27 בינואר 2021

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

שינויים ב-API

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

Wear-Input 1.0.0

גרסה 1.0.0

‫2 בדצמבר 2020

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

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

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

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

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

גרסה ‎1.0.0-rc01

11 בנובמבר 2020

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

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

גרסה ‎1.0.0-beta01

28 באוקטובר 2020

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

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

‫14 באוקטובר 2020

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

שינויים ב-API

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

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

‫2 בספטמבר 2020

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

תכונות חדשות

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

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