תצוגת שעון ב-Wear

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

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

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

dependencies {
    // Use to implement wear watchfaces
    implementation "androidx.wear.watchface:watchface:1.2.1"

    // Use to implement wear watchface complications
    implementation "androidx.wear.watchface:watchface-complications-data-source:1.2.1"
    // (Kotlin-specific extensions)
    implementation "androidx.wear.watchface:watchface-complications-data-source-ktx:1.2.1"

    // Use to implement a watchface style and complication editor
    implementation "androidx.wear.watchface:watchface-editor:1.2.1"

    // Can use to render complications.
    // This library is optional and watchfaces may have custom implementation for rendering
    // complications.
    implementation "androidx.wear.watchface:watchface-complications-rendering:1.2.1"
}

dependencies {
    // Use to implement wear watchfaces
    implementation("androidx.wear.watchface:watchface:1.2.1")

    // Use to implement wear watchface complications
    implementation "androidx.wear.watchface:watchface-complications-data-source:1.2.1"
    // (Kotlin-specific extensions)
    implementation "androidx.wear.watchface:watchface-complications-data-source-ktx:1.2.1"

    // Use to implement a watchface style and complication editor
    implementation("androidx.wear.watchface:watchface-editor:1.2.1")

    // Can use to render complications.
    // This library is optional and watchfaces may have custom implementation for rendering
    // complications.
    implementation "androidx.wear.watchface:watchface-complications-rendering:1.2.1"
}

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

משוב

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

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

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

גרסה 1.3

גרסה ‎1.3.0-rc01

‫28 בינואר 2026

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

תכונות חדשות

• הוספת תמיכה בתצוגות מקדימות סטטיות של תכונות נוספות (8b2bed3)

גרסה ‎1.3.0-beta01

‫17 בדצמבר 2025

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

תכונות חדשות

• הוספנו תמיכה בנתוני תצוגה מקדימה סטטיים של רכיבי מידע, שבהם ספק רכיבי מידע יכול לציין נתוני תצוגה מקדימה סטטיים במניפסט שלו. אפשר לקרוא פרטים נוספים במאמר androidx.wear.watchface.complications.data.parser.StaticPreviewDataParser.
• הוספנו את מחלקת כלי העזר ComplicationTextFormatting עם תמיכה בעיצוב נתונים ושעה בצורה תמציתית ככל האפשר, וזה שימושי לרכיבי מידע שבהם המקום מוגבל מאוד.

שינויים ב-API

• הנכס הניסיוני Renderer.watchfaceColors הוא עכשיו פרטי. עדיין יש לציבור הרחב גישה לנכס הזה. (Ifdf60, ‏ b/409363281)

תיקוני באגים

• כדי להשתמש בפרויקטים שפורסמו עם Kotlin 2.0, צריך להשתמש ב-KGP 2.0.0 או בגרסה חדשה יותר. ‫(I48968, ‏ b/407632515)

גרסה ‎1.3.0-alpha07

‫23 באפריל 2025

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

תכונות חדשות

• כבר זמן מה שאפשר להגדיר סכימת UserStyle של תצוגת שעון, ואפשר להגדיר ColorUserStyleSetting ב-XML.

שינויים ב-API

• כדי להשתמש בפרויקטים שפורסמו עם Kotlin 2.0, צריך להשתמש ב-KGP 2.0.0 או בגרסה חדשה יותר. (Idb6b5)
• נוסף Watch Face Push API שמאפשר לאפליקציית Wear OS להתקין תצוגת שעון בשעון באופן פרוגרמטי.

תיקוני באגים

• מומלץ לספקי נתוני שעון שמשתמשים בגרסה 1.3.0-alpha06 לשדרג, כי תוקן באג שגורם לקריסה ב-ComplicationDataSourceUpdateRequester בגרסה הבאה של WearOS.

גרסה ‎1.3.0-alpha06

‫26 במרץ 2025

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

תכונות חדשות

• ממשקי ה-API של תצוגות השעון ב-Wear (watchface,‏ watchface-client,‏ watchface-client-guava,‏ watchface-complications-rendering,‏ watchface-data,‏ watchface-editor,‏ watchface-editor-guava ו-watchface-style) הוצאו משימוש לטובת Wear Watchface Format, ובסופו של דבר יוסרו מ-AndroidX. ממשקי ה-API של רכיבי המידע לא הוצאו משימוש והם יישארו. (Ice960)
• ממשקי ה-API של רכיבי המידע יכולים עכשיו לתקשר ישירות עם WearSDK, מה שהופך את התהליך ליעיל יותר כי יש פחות קפיצות של IPC.

גרסה ‎1.3.0-alpha05

‫15 בינואר 2025

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

תכונות חדשות

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

הוספנו תכונה שפונה ליצרני ציוד מקורי (OEM), שמאפשרת לספקי רכיבים של OEM להוסיף תוספים ל-ComplicationData לשימוש בתצוגות שעון של OEM.

שינויים ב-API

• בכיתות UserStyleSetting ו-UserStyleOption יש עכשיו כלי בנייה, והשימוש בהם הוא הדרך המומלצת ליצירת כיתות. (Iacd03)
• תמיכה בהעברת תוספים ב-ComplicationData. התכונה הזו מיועדת לשימוש של יצרני ציוד מקורי (OEM) ששולטים גם בספק של רכיב המידע וגם בתצוגת השעון שמקבלת את המידע. כדי להגדיר תוסף נדרשת הרשאת com.google.android.wearable.permission.COMPLICATION_EXTRAS. (I4e3b2)
• בדרך כלל, בתצוגות שעון המשתמש יכול לבחור צבעים באמצעות ListUserStyle, כשכל ListOption מיוצג על ידי סמל. מכיוון שסכימות UserStyle נשלחות באמצעות Bluetooth, חשוב לשמור על גודל קטן של הסכימה. זה יכול להיות בעייתי אם יש עשרות אפשרויות צבע בגלל כל הסמלים האלה. כדי לעזור לכם, הוספנו ColorUserStyleSetting במקומות שבהם האפשרות כוללת רשימה של צבעים במקום סמל, כך שהיא הרבה יותר קומפקטית. ‫(Ib542e)
• ‫ColorUserStyleSetting ו-ColorOption דורשים API 34 כדי להשתמש בהם. (I8771d)

תיקוני באגים

• הספרייה הזו משתמשת עכשיו באנוטציות של JSpecify לגבי ערכי null, שהן אנוטציות של שימוש בטיפוסים. מפתחי Kotlin צריכים להשתמש בארגומנט המהדר הבא כדי לאכוף שימוש נכון: -Xjspecify-annotations=strict (זו ברירת המחדל החל מגרסה 2.1.0 של מהדר Kotlin). (Ifd363, ‏ b/326456246)

גרסה ‎1.3.0-alpha04

‫18 בספטמבר 2024

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

תכונות חדשות

• הוספנו תמיכה בטעינה עצלה של סמלים ב-UserStyleSettings וב-UserStyleOptions, מה שמשפר את הביצועים של טעינת תצוגות השעון. (Iaf43d)
• נוספה אפשרות לצלם צילום מסך מעודכן בכל פעם שמשנים את הגדרות המערכת (למשל, אם משנים את הלוקאל) באמצעות הסמל החדש Watchface.setUpdateScreenshotOnConfigurationChange. ההגדרה הזו מושבתת כברירת מחדל. (I765a1)

תיקוני באגים

• הסרנו את האפשרות ליצור באופן ידני תרשים של הגישה לממשקי API חדשים של הפלטפורמה, כי זה קורה באופן אוטומטי באמצעות מידול API כשמשתמשים ב-R8 עם AGP 7.3 ואילך (למשל R8 גרסה 3.3) ובכל הבנייה כשמשתמשים ב-AGP 8.1 ואילך (למשל D8 גרסה 8.1). לקוחות שלא משתמשים ב-AGP מומלץ לעדכן לגרסה 8.1 ואילך של D8. למידע נוסף, מומלץ לעיין במאמר הזה. (Ia60e0, b/345472586)

גרסה ‎1.3.0-alpha03

‫17 באפריל 2024

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

שינויים ב-API

• הוספנו את EditorSession#setOverrideComplications שקובע באופן זמני את ComplicationData של מופע לוח השעון הבסיסי בזמן העריכה. אם הסיבוכים משתנים לעיתים רחוקות, השיטה הזו יעילה יותר מהעברת שינויים באמצעות EditorSession#renderWatchFaceToBitmap. (I19384)

תיקוני באגים

• בעבר, selectComplicationDataForInstant קרא ל-toApiComplicationData בכל ציר זמן, כלומר בדיקת השוויון הבאה של ההפניה === תמיד נכשלה. המשמעות היא שסיבוכים נטענו מחדש בכל פריים, מה שגרם לניצול הסוללה. (717406)

גרסה ‎1.3.0-alpha02

‫3 באפריל 2024

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

תכונות חדשות

• אנחנו משתמשים עכשיו בשוויון הפניה כדי להשוות בין best לבין selectedData כי האופרטור equals יקר. (446b00)

שינויים ב-API

• הוספנו API דינמי ללא חלופה ל-GoalProgressComplicationData. (c33264)

גרסה ‎1.3.0-alpha01

‫7 בפברואר 2024

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

תכונות חדשות

• WatchFaceServices יכולים לעבור אתחול בו-זמנית, ולכן הם צריכים להיות חסרי מצב. כדי לתמוך בזה, הוספנו את StatefulWatchFaceService שבו מועבר ערך נוסף שהוגדר על ידי המשתמש ונוצר על ידי createExtra() לכל ההחלפות שמופעלות במהלך האתחול.
• ב-GlesRenderer2 יש עכשיו עומס יתר של בנאי שמאפשר לציין רשימה של מאפיינים לניסיון בתורו עם eglChooseConfig.

שינויים ב-API

• ‫StatefulWatchFaceService תומך עכשיו בהחלפה של getComplicationSlotInflationFactory שאליה מועבר המשתנה הנוסף שמוגדר על ידי המשתמש ונוצר על ידי createExtra(). (I82d9f)
• חלק מהעיצובים של השעון צריכים לשתף נתונים משניים שנוצרו במהלך createUserStyleSchema עם שיטות האתחול האחרות. מכיוון שלא הייתה חלופה טובה יותר, מפתחים בדרך כלל יצרו את WatchFaceServices שלהם עם שמירת מצב. זה מסוכן כי יכולים להיווצר כמה מופעים בו-זמנית, מה שעלול לגרום לבאגים. כדי לפתור את הבעיה הזו, הוספנו את StatefulWatchFaceService ואת StatefulWatchFaceRuntimeService, שבהם נוצר סוג שהוגדר על ידי המשתמש על ידי createExtra() ומועבר לשיטות היצירה השונות כפרמטר. (If8a99)
• הוספנו את getUserStyleFlavors אל InteractiveWatchFaceClient, שמעניין בעיקר יצרני ציוד מקורי (OEM). (I0f5d8)
• ב-GlesRenderer2 יש עכשיו עומס יתר של בנאי שמאפשר לציין רשימה של מאפיינים לניסיון בתורו עם eglChooseConfig. לדוגמה, אפשר לנסות קודם תצורה עם החלקת קצוות, ואם צריך, לחזור לתצורה בלי החלקת קצוות. (I1ba74)
• ב-Android U, תתווסף תמיכה ב-SystemDataSources.DATA_SOURCE_HEART_RATE ל-WearOS. רכיב המידע הזה תומך בוודאות ברכיבי מידע מסוג SHORT_TEXT, אבל מומלץ שרכיב המידע מסוג ComplicationSlot יקבל גם SMALL_IMAGE, כי יצרני ציוד מקורי (OEM) עשויים לבחור להציג קיצור דרך לאפליקציית הבריאות שלהם במקום הערך בזמן אמת. (I34223)
• הוספנו את METADATA_KEY_CONFIG_RESTORE_SUPPORTED, שקובע מגרסה Android U ואילך מה קורה כשמערכת משוחזרת מגיבוי של מקור נתונים של רכיב עם METADATA_KEY_DATA_SOURCE_CONFIG_ACTION. כברירת מחדל, המערכת מניחה ששירות מקור הנתונים של התוסף תומך בגיבוי של כל נתוני ההגדרה, אבל אם זה לא המצב, אפשר להוסיף את הגדרת המטא-נתונים METADATA_KEY_DATA_SOURCE_CONFIG_ACTION לערך false, וכך לסמן את משבצת התוסף כלא מוגדרת. (I6c505)

גרסה 1.2

גרסה 1.2.1

‫24 בינואר 2024

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

תיקוני באגים

• תוקנה קריסה ב-Samsung Galaxy Watch 4, ‏ 5 ו-6. (43f0b0)

גרסה 1.2.0

‫29 בנובמבר 2023

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

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

• הוספנו תמיכה בכמה סוגים חדשים של רכיבים, שאפשר להשתמש בהם מגרסה Android T:
  • ‫GoalProgressComplicationData דומה לפונקציה RangedValueComplicationData, אבל היא מיועדת למדידת ההתקדמות להשגת יעד, כאשר הערך המינימלי הוא אפס והערך יכול להיות גדול מ-targetValue.
  • WeightedElementsComplicationData שמורכב ממערך של רכיבים (זוגות של משקל וצבע) יחד עם טקסט, כותרת או תמונה אופציונליים. יכול להיות שהם יוצגו כתרשים עוגה, שבו הצבעים צריכים להיות משמעותיים בהקשר, כי בדרך כלל אין מקום ברכיב מידע להצגת תוויות.
• הוספנו תמיכה בColorRanges אופציונלי לRangedValueComplicationData. בדרך כלל, התכונות הנוספות מוצגות בצבעים שנבחרו בשביל פני השעון, אבל לפעמים עדיף להשתמש ב-ComplicationDataSource כדי להגדיר את הצבעים, למשל כשיש להם משמעות סמנטית מסוימת. לדוגמה, אדום לכחול לטמפרטורה.
• כמעט כל סוג של ComplicationData תומך עכשיו ב-SmallImages.
• הוספנו את התג ComplicationDisplayPolicy, שבו DO_NOT_SHOW_WHEN_DEVICE_LOCKED מורה לתצוגת שעון תואמת לא להציג את הרכיב כשהמכשיר נעול.
• מגרסה Android T ואילך, יצרני ציוד מקורי (OEM) יוכלו לקבוע אם בקשה לרכיב מגיעה מתצוגת שעון ברשימה שהוגדרה על ידי מטא-נתונים של android.support.wearable.complications.SAFE_WATCH_FACES במניפסט של הספק באמצעות ComplicationRequest#isForSafeWatchFace. הספק יזדקק להרשאה com.google.wear.permission.GET_IS_FOR_SAFE_WATCH_FACE כדי לקבל נתונים אחרים מלבד TargetWatchFaceSafety.UNKNOWN`.
• התכונה UserStyleFlavors כבר לא ניסיונית.

גרסה ‎1.2.0-rc01

‫18 באוקטובר 2023

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

גרסה ‎1.2.0-beta02

‫6 בספטמבר 2023

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

תכונות חדשות

• המשחק SuspendingComplicationDataSourceService#onDestroy פתוח עכשיו. שימו לב שהוסר התמיכה בפריט מידע על מזג האוויר שמוגדר כברירת מחדל במערכת.

שינויים ב-API

• מחזירים את ההגדרה 'חשיפת מקור נתונים חדש לסיבוכים של מזג האוויר' למצב הקודם. (I6f335)

גרסה ‎1.2.0-beta01

‫23 באוגוסט 2023

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

תכונות חדשות

• החל מ-Android T, ‏ WearOS יתמוך עכשיו בסיבוך מערכת מזג אוויר כברירת מחדל.

שינויים ב-API

• הוספת חלופה למזג האוויר במקרה של תכונות נוספות במערכת. (Ia0994)
• התיקון הזה מוסיף את WatchFaceRuntimeService ואת WatchFaceControlClient.createWatchFaceRuntimeControlClient יחד עם עטיפות guava. הם מוסיפים תמיכה בזמני ריצה של תצוגות שעון, שהם סוג מיוחד של תצוגות שעון שנטענות מהגדרה מחבילה אחרת. בשלב הזה, WearOS תומכת רק בזמן הריצה של פורמט שעוני Android. (I2799f)
• התיקון הזה הוא המשך של aosp/2636578, שבו שינינו את השם של הגדרות ה-int, כך שכל קוד שתלוי ב-WatchFaceType, ב-CanvasType, ב-TapType או ב-ComplicationsSlotBoundsType לא צריך להשתנות. (I4098b)
• עדכנו את קובצי ה-API כדי להוסיף הערות לביטול התאימות. (I8e87a, ‏ b/287516207)
• התיקון הזה חושף קבועים של WatchFaceType ב-WatchFaceTypes, קבועים של CanvasType ב-CanvasTypes, קבועים של TapType ב-TapTypes וקבועים של ComplicationsSlotBoundsType ב-ComplicationsSlotBoundsType. (I3b85a, ‏ b/288750666)
• השימוש ב-WatchFace.OverlayStyle נמוך מאוד, והוא לא נתמך היטב על ידי יצרני ציוד מקורי (OEM). לכן אנחנו מוציאים אותו משימוש, ובכוונתנו להסיר אותו במועד מאוחר יותר. (I7344a)

גרסה ‎1.2.0-alpha09

‫21 ביוני 2023

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

תכונות חדשות

• ‫RangedValueComplicationData.Builder מקבל עכשיו DynamicFloat, ו-DynamicComplicationText חדש זמין כסיווג משנה של ComplicationText. שניהם יכולים להשתמש בביטויים דינמיים וגם בקשירות לפלטפורמה שמתעדכנות בתדירות של 1 הרץ במכשירי Wear 4 נתמכים.

שינויים ב-API

• נוספו סוגים דינמיים למרחק היומי, לקלוריות היומיות ולמספר הקומות היומי. מפתחות למקורות מידע בנושאי בריאות בפלטפורמה נמצאים עכשיו בקטע PlatformHealthSources.Keys (Ib7637)
• מטמיעים את PlatformDataProvider כדי לספק נתונים על הדופק ועל הצעדים היומיים. ממשק SensorGateway הוסר מ-API ציבורי. (I55b84)
• משנים את השם של StateEntryValue ל-DynamicDataValue ומעדכנים את ממשקי ה-API של המצב לשימוש ב-DynamicDataKey. (If1c01)
• הוספת AppDataKey לגישה למצב של אפליקציה שנשלח בדחיפה; הוספת PlatformDataKey לגישה לנתוני פלטפורמה; הוספת תמיכה במרחב שמות ב-StateStore. (I7985e)
• הוסרו enable מתוך disablePlatformSource שיטות מ-DynamicTypeEvaluator. המתקשר צריך להיות אחראי לעדכונים. (I78c6d)
• אפשרות להגביל את הגודל של סוגי נתונים מאוגדים. (Ie2966)

גרסה ‎1.2.0-alpha08

‫19 באפריל 2023

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

תכונות חדשות

• מגרסה Android T, ספקי רכיבים עם הרשאת com.google.wear.permission.GET_IS_FOR_SAFE_WATCH_FACE יכולים לרשום מטא-נתונים של androidx.wear.watchface.complications.datasource.SAFE_WATCH_FACE_SUPPORTED_TYPES שמבטלים את android.support.wearable.complications.SUPPORTED_TYPES כדי ליצור תצוגות שעון בטוחות. כלומר, ספק של רכיב מידע יכול לבחור להציג סוגים שונים של רכיבי מידע בפני משתמשים שסומכים על פני השעון לעומת משתמשים שלא סומכים עליהם.

שינויים ב-API

• העברה של מחלקת @Deprecated לנכס (I882d1, b/271441831)
• השתנה שם פרמטר הערך של Enum.valueOf (Ia9b89)
• עוד חריגים שהופעלו מ-enum valueOf (I818fe)
• הסרנו את renderWatchFaceToSurface והוספנו את createRemoteWatchFaceView, שמבוסס על SurfaceControlViewHost ומאפשר למבצע הקריאה להטמיע תצוגה מתוך תצוגת השעון, שמוצגת כשהלקוח קורא ל-RemoteWatchFaceViewHost#renderWatchFace. (Ib311d)
• הוספנו את renderWatchFaceToSurface ל-InteractiveWatchFaceClient, ל-HeadlessWatchFaceClient ול-EditorSession. בדרך כלל, שיטה זו תניב ביצועים טובים יותר מאשר רינדור למפת סיביות. (Ieacad)
• השם של ObservableStateStore שונה ל-StateStore. (Ieb0e2)
• הוספנו DynamicTypeEvaluator.Builder במקום ארגומנטים של בנאי כדי לאפשר יותר ארגומנטים אופציונליים, כולל ObservableStateStore שמוגדר עכשיו כברירת מחדל לחנות ריקה. (I6f832)
• הסדר של הפרמטרים ב-DynamicTypeEvaluator עבר שינוי. (Ic1ba4)
• ה-Executor נוסף ל-methods של DynamicTypeEvaluator.bind. (I346ab)
• הוספנו את startEvaluation ל-BoundDynamicType כדי להפעיל את ההערכה אחרי שסוג דינמי נקשר. (I19908)
• ספקי רכיבים עם הרשאת com.google.wear.permission.GET_IS_FOR_SAFE_WATCH_FACE יכולים לרשום מטא-נתונים של androidx.wear.watchface.complications.datasource.SAFE_WATCH_FACE_SUPPORTED_TYPES שמבטלים את android.support.wearable.complications.SUPPORTED_TYPES כדי ליצור תצוגות שעון בטוחות. (Id1c73)
• שינינו את השם של CustomValueUserStyleSettings2 ל-LargeCustomValueUserStyleSettings. (Ic17ac)

תיקוני באגים

• DynamicTypeValueReceiver#onPreUpdate הוסר. (I2dc35)

גרסה ‎1.2.0-alpha07

‫22 בפברואר 2023

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

תכונות חדשות

• מגרסה Android T ואילך, יצרני ציוד מקורי (OEM) יוכלו לקבוע אם בקשה לרכיב מגיעה מתצוגת שעון ברשימה שהוגדרה על ידי מטא-נתונים של android.support.wearable.complications.SAFE_WATCH_FACES במניפסט של הספק באמצעות ComplicationRequest#isForSafeWatchFace. הספק יצטרך את ההרשאה com.google.wear.permission.GET_IS_FOR_SAFE_WATCH_FACE כדי לקבל כל דבר אחר מלבד TargetWatchFaceSafety.UNKNOWN.

• בנוסף, החל מ-Android T CustomValueUserStyleSetting2 אפשר להשתמש בזיכרון של עד 12.5kb. המגבלה הקודמת ל-CustomValueUserStyleSetting הייתה 1kb. למרות שמגבלות הגודל הוגדלו, מפתחים של עיצובים לשעון צריכים להקפיד על גודל נתונים קטן כי ההגדרות נשלחות באמצעות Bluetooth במהלך העריכה, ורוחב הפס של Bluetooth מוגבל.

שינויים ב-API

• הוספנו פרמטר אופציונלי eglContextAttribList ל-GlesRenderer וגם ל-GlesRenderer2, שמאפשר להגדיר את EGL14.EGL_CONTEXT_CLIENT_VERSION שמועבר אל EGL14.eglCreateContext. (I2a83e)
• העברנו את ספריות תצוגות השעון אל androidx.core.util.Consumer במקום אל java.util.function.Consumer. (I273f5)
• יותר חריגים שנזרקים מ-KT property accessors‏ (Iff9d9)
• הוספנו את InteractiveWatchFaceClient.isComplicationDisplayPolicySupported כדי שהלקוח יוכל לקבוע אם הוא צריך לבצע אמולציה של תמיכה בשם תצוגות שעון ישנות. (I24c89)
• החלטנו ש-isForSafeWatchFace צריך להיות IntDef עם שלושה מצבים. (Ief2f7)
• ב-Android T הצגנו את ComplicationRequest.isForSafeWatchFace, שנועד לשימוש על ידי יצרני ציוד מקורי (OEM) ונדרש com.google.wear.permission.GET_IS_FOR_SAFE_WATCH_FACE. למקורות נתונים בתמונת המערכת, הפונקציה תחזיר true אם פני השעון ששולחים את הבקשה נמצאים ברשימת פני השעון הבטוחים שצוינו על ידי מקור הנתונים במניפסט שלו. (I0cbb6)
• ב-Android T הוספנו את CustomValueUserStyleSetting2 שיכול להכיל עד 12.5kb. המגבלה הקודמת ל-CustomValueUserStyleSetting הייתה 1kb. (I0b100)

גרסה ‎1.2.0-alpha06

‫25 בינואר 2023

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

תכונות חדשות

• אנחנו ממשיכים לעבוד על הוספת תמיכה בהצמדות של פלטפורמות של רכיבי מידע, אבל התכונה הזו עדיין לא מוכנה לשימוש. כדאי להמשיך להתעדכן!
• הוספנו תמיכה ב-XML ComplicationSlot לסוגי הסיבוכים החדשים, GOAL_PROGRESS ו-WEIGHTED_ELEMENTS.

תיקוני באגים

• תוקנה דליפה שבה עורך תצוגת השעון לא שוחרר כראוי במכשירי Samsung. (3b5987)
• תוקן באג שגרם לכך שלפעמים התכונות הנוספות לא הוצגו בצורה תקינה כשעברו בין תצוגות שעון עם כמה מועדפים. (b38ece)
• תוקן באג בסריאליזציה שקשור ל-perOptionScreenReaderNames וגרם לקריסות של תצוגות שעון. (e9f466)

גרסה ‎1.2.0-alpha05

‫7 בדצמבר 2022

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

תכונות חדשות

• לפני זמן מה הוספנו תמיכה בUserStyleSettings היררכי, ומגרסת Android T אפשר להגדיר יותר מComplicationSlotsUserStyleSetting אחד בהיררכיה. רק ComplicationSlotsUserStyleSetting אחד יהיה פעיל, על סמך בחירות הסגנון של המשתמש.

• אנחנו משפרים את התמיכה בקוראי מסך ב-ListOption וב-ComplicationSlotsOption על ידי הוספת שדה screenReaderName. שימו לב: לפני Android T, העורכים הנלווים יתעלמו מהשדה הזה.

שינויים ב-API

• הוספנו שדה חדש ואופציונלי screenReaderName ל-ListOption ול-ComplicationSlotsOption לשימוש העורכים – העורכים הנלווים במכשירים עם גרסה של Android לפני T יתעלמו ממנו. (I75326)
• מגרסה Android T ואילך, יש תמיכה בכמה ComplicationSlotsUserStyleSettings בהיררכיית סגנונות, כל עוד רק אחד מהם יכול להיות פעיל בכל רגע נתון. הוספנו פונקציית עזר findComplicationSlotsOptionForUserStyle ל-UserStyleSchema כדי לעזור למצוא את ComplicationSlotsOption הפעיל, אם יש כזה. (Ic2b06)
• RangedValuesTypes הועברו לאובייקט הנלווה של RangedValueComplicationData ושמם שונה ל-TYPE_UNDEFINED, ל-TYPE_RATING ול-TYPE_PERCENTAGE חדש נוסף. (I55d02)
• שינינו את השם של הניסוי DynamicFloat ל-FloatExpression וסימנו אותו כ-@hide. (Idf4f1)
• הוספת הערה @JvmDefaultWithCompatibility (I8f206)

גרסה ‎1.2.0-alpha04

9 בנובמבר 2022

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

תכונות חדשות

• ב-Android T הוספנו תמיכה בשני סוגים חדשים של נתונים להצגה בשעון, GoalProgressComplicationData ו-WeightedElementsComplicationData.
• הפונקציה GoalProgressComplicationData דומה ל-RangedValueComplicationData, אבל הערך שלה יכול להיות גבוה מהיעד (בפונקציה RangedValueComplicationData הערך מוגבל לטווח [min .. max]), מה שמשפיע על העיצוב החזותי, ולכן היא לא מתאימה לכל פני השעון.
• ‫GoalProgressComplicationData מוסיף תמיכה בתרשימי עוגה ובפירוטים דומים של נתונים פשוטים.
• הוספנו תמיכה אופציונלית ב-ColorRamps ל-RangedValueComplicationData.
• ב-Android T, הוספנו את ComplicationPersistencePolicy ואת setCachePolicy ל-ComplicationData, שמאפשר כרגע לספק לשלוט בשמירה של רכיב מידע (כלומר, אם הוא נשמר במטמון אחרי הפעלה מחדש). ברוב הסיבוכים לא צריך להגדיר בקרת מטמון, אבל הגדרה כזו יכולה לפתור מקרים חריגים של נתונים לא עדכניים בסיבוכים מסוימים שמתעדכנים לעיתים קרובות (למשל סיבוכים של נתוני בריאות). הוספנו גם את התג ComplicationDisplayPolicy, שבו DO_NOT_SHOW_WHEN_DEVICE_LOCKED מורה לתצוגת שעון תואמת לא להציג את הרכיב כשהמכשיר נעול. (Ic9574)

שינויים ב-API

• התכונות GoalProgressComplicationData, ‏WeightedElementsComplicationData ו-ColorRamp כבר לא ניסיוניות. (Ica9e2)
• ‫ComplicationPersistencePolicy ו-ComplicationDisplayPolicy מסומנים עכשיו בצורה תקינה כ-T API. (I31d88)
• ל-constructor של ComplicationSlotOverlay שהוצא משימוש יש עכשיו DeprecationLevel.WARNING, כך שאפשר לקרוא לו שוב מ-Java. (Ib308c)
• תיקנו כמה בעיות תאימות ל-Java ב-ComplicationRequestListener, CanvasComplication, ComplicationTapFilter ו-InteractiveWatchFaceClient באמצעות הוספת הערות עם @JvmDefaultWithCompatibility (Id94fc)
• הסרנו את התכונות הניסיוניות ProtoLayoutComplicationData ו-ListComplicationData. הסיפור של המפתחים בנושא הזה לא היה ברור, ואנחנו מקווים לחזור אליו בעתיד. (I9df05)
• הוספנו בחזרה את ValueType אל RangedValueComplicationData. ב-WeightedElementsComplicationData יש עכשיו תמיכה בצבע רקע. הסרנו את DiscreteRangedValueComplicationData כי הפונקציונליות שלו היא קבוצת משנה של WeightedElementsComplicationData. (I6446c)

תיקוני באגים

• צריך לכלול את התו isForScreenShot בסימן השוויון ובקוד הגיבוב. מוודאים שהערך הנכון של isForScreenshot (I04a41) מופיע בשדה onRenderParametersChanged.
• תוקנו דליפות של WatchFaceControlService מלקוחות headless. (e90e00)

גרסה ‎1.2.0-alpha03

‫5 באוקטובר 2022

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

תכונות חדשות

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

שינויים ב-API

• הוצא משימוש UserStyleSchema.userStyleSettings כי rootUserStyleSettings הפכו ללא ניסיוניים (Ie96e3)
• העברת rootUserStyleSettings מניסוי (I8d6b3)
• סימנו את WatchFaceColors כניסיוני כי הוא לא נתמך בכל המערכות (I6d75d)
• הוספנו את DisconnectReasons ל-API הציבורי כדי לאפשר לו לעבוד עם IntDef. (I791f8)

תיקוני באגים

• אם SysUI מת, סוגרים את העורך הפתוח של השעון. אם תהליך SysUI יסתיים והכלי לעריכת תצוגת השעון לא ייסגר, יכול להיות שתצוגת השעון תישאר במצב לא עקבי כי המערכת מסתמכת על SysUI כדי לשמור את השינויים בסגנון המשתמש.(ba762a
• תוקן דליפת זיכרון ב-ComplicationDataSourceInfoRetriever, שבה המשך של קורוטינה ב-Kotlin שימש כשורש של איסוף אשפה ושמר על פעילות העריכה.(33ee06)

גרסה ‎1.2.0-alpha02

‫21 בספטמבר 2022

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

תכונות חדשות

• חלק מהתצוגות של השעון כוללות הגדרות מחוץ ל-UserStyle שמשפיעות על המראה שלהן (למשל, בחירת תמונת רקע). הוספנו את Renderer.sendPreviewImageNeedsUpdateRequest שמאפשר לתצוגת השעון לבקש תמונת תצוגה מקדימה מעודכנת. שימו לב: כדי שהתכונה הזו תפעל, צריך לעדכן את המערכת בהתאם.

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

• כמעט כל סוג של ComplicationData תומך עכשיו ב-SmallImages.

שינויים ב-API

• לפעמים מנהל הטפטים מתנתק ממנוע אחד ומתחבר למנוע אחר. הוספנו DisconnectReason int def והרחבנו את ClientDisconnectListener עם שיטה חדשה שכוללת DisconnectReason, כדי לאפשר למאזין לצפות בהתנתקויות של המנוע. (I45cce)
• נוספו שני פרמטרים אופציונליים nameResourceId ו-screenReaderResourceId לקונסטרוקטור ComplicationSlotOverlay (I157e8)
• הוספנו wrapper של guava ל-overload החדש של getOrCreateInteractiveWatchFaceClient עם PreviewImageUpdateRequestedListener. (Ic31f0)
• הוספנו את Renderer.sendPreviewImageNeedsUpdateRequest, שמועיל לתצוגות שעון שיש להן מצב מחוץ ל-UserStyleSchema שמשפיע על המראה שלהן (למשל, תצוגת שעון עם תמונת רקע שאפשר לבחור). בצד הלקוח, הוספנו את PreviewImageUpdateRequestedListener כפרמטר אופציונלי ל-getOrCreateInteractiveWatchFaceClient כדי לעקוב אחרי הבקשות האלה. (Iff44a)
• פישטנו את ה-API לחשיפת WatchFaceColors. עכשיו יש מאפיין פשוט בשם watchFaceColors ב-Renderer שאפשר להגדיר בתצוגת השעון. צריך לעדכן את המאפיין הזה לפי הצורך בתגובה לשינויים בסגנון. במקום להשתמש ב-WallpaperManager כדי לראות את שינויי הצבע, הוספנו את OnWatchFaceColorsListener ל-InteractiveWatchFaceClient. (I490bc)
• הוספנו את המחלקה WatchFaceColors שמכילה את שלושת הצבעים הבולטים ביותר בתצוגת השעון, והוספנו שיטות פתוחות watchfaceColors ו-notifyWatchFaceColorsChanged ל-Renderer. השיטות האלה מאפשרות למערכת לקבל את הצבעים של תצוגת השעון באמצעות WallpaperManager.getWallpaperColors. (I3d611)
• ‫ShortTextComplicationData, ‏ RangedValueComplicationData, ‏ NoPermissionComplicationData (וגרסאות ניסיוניות DiscreteRangedValueComplicationData, ‏ GoalProgressComplicationData ו-WeightedElementsComplicationData) תומכות עכשיו ב-SmallImages. אם תצוגת שעון בוחרת להציג נתון מורכב עם כמה צבעים, עכשיו יש לה אפשרות להשתמש בSmallImage צבעוני, בעוד שלפני כן היא הייתה צריכה להשתמש בתמונה מונוכרומטית. (I257df)
• שכתוב הקוד של PreviewImageUpdateRequestedListener כך שיהיה Consumer<> במקום זאת (Ia875d)
• החלפת סוג מותאם אישית של Single Abstract Method ‏ (SAM) ‏OnWatchfaceColorsListener בסוג גנרי של Java SAM ‏ (Consumer) ‏(I0c489)
• הוצאנו משימוש את השיטות הישנות getOrCreateInteractiveWatchFaceClient ו-listenableGetOrCreateInteractiveWatchFaceClient שלא מציינות PreviewImageUpdateRequestedListener. (Iec502)

תיקוני באגים

• השם של DisconnectReason.BINDER_DIED שונה ל-DisconnectReason.ENGINE_DIED. (I4eb0e)

גרסה ‎1.2.0-alpha01

‫10 באוגוסט 2022

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

תכונות חדשות

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

שינויים ב-API

• הכיתה הניסיונית BoundingArc היא עכשיו בלתי ניתנת לשינוי. (If624a)
• יכול להיות שיהיה קשה להקיש על סיבוכים קטנים. כדי לצמצם את הבעיה הזו, הוספנו תמיכה בשוליים שמגדילים את האזור שאפשר להקיש עליו בלי להשפיע על העיבוד. אלא אם צוין אחרת (בקוד או באמצעות XML), ל-ComplciationSlots יש שוליים בגודל אפס. (I14089)
• השתנה החתימה של getComplicationSlotInflationFactory(CurrentUserStyleRepository) כדי להחזיר מופע של factory שאינו null. החזרת ערך null הייתה שגיאה בעבר, ולכן השינוי הזה רק הופך את חוזה ה-API לברור יותר. (I0fcc0)
• הוספנו את הארגומנט currentUserStyleRepository לשיטה WatchFaceService.getComplicationSlotInflationFactory כדי לשמור על עקביות עם createComplicationSlotsManager. (I2ddd2)
• UserStyleFlavors כבר לא ניסיוניות. (I69cdc)
• הסרנו את התכונה הניסיונית ValueType מ-RangedValueComplicationData והוספנו במקומה את התכונה הניסיונית DiscreteRangedValueComplicationData, שדומה ל-RangedValueComplicationData אבל עם טווח וערך של מספרים שלמים. הוספנו גם את פונקציית הניסוי GoalProgressComplicationData, שדומה ל-RangedValueComplicationData, אבל היא מיועדת למעקב אחר ההתקדמות להשגת יעד שבו הערך המינימלי הוא אפס, והערך יכול להיות גדול מ-targetValue. הערה: לכל הווריאציות של RangedValue צריך לציין לפחות אחד מהמאפיינים הבאים: monochromeImage, ‏ text או title. (I9590c)
• הסרנו את boundsWithMargins מ-ComplicationSlotState כי אין תרחיש שימוש עבורו בתוכנת המערכת. (I42e26)
• הוספנו תמיכה ניסיונית ב-WeightedElementsComplicationData, שמורכב ממערך של רכיבים (זוגות של משקל וצבע) יחד עם טקסט, כותרת או תמונה אופציונליים. יכול להיות שהם יוצגו כתרשים עוגה, שבו הצבעים צריכים להיות משמעותיים בהקשר, כי בדרך כלל אין מקום ברכיב מידע להצגת תוויות. (I87eea)
• המאפיין הניסיוני ColorRamps, שמשמש באופן אופציונלי את RangedValueComplicationData ואת GoalProgressComplicationData, מאפשר עכשיו לציין רצף של עד שבעה צבעים ודגל שקובע אם הצבעים צריכים להיות מונפשים בצורה חלקה או אם צריך להציג שלבים מוצקים של צבע בגודל שווה. (I9f5bf)
• ‫RangedValueComplicationData.drawSegmented השתנה ל-valueType, שהוא מספר שלם עם ValueType IntDef תואם שמספק משמעות סמנטית לערך הטווח, ויכול לשמש את רכיב העיבוד של הסיבוך כדי להשפיע על הסגנון. (I0616b)
• הוספנו תמיכה ניסיונית באפשרות ColorRanges עד RangedValueComplicationData. בדרך כלל, התכונות הנוספות מוצגות בצבעים שנבחרו בשביל פני השעון, אבל לפעמים עדיף להשתמש ב-ComplicationDataSource כדי להגדיר את הצבעים, למשל כשיש להם משמעות סמנטית מסוימת. לדוגמה, אדום לכחול לטמפרטורה. (I5153a)
• הוספנו רמז ניסיוני drawSegmented ל-RangedValueComplicationData. האות הזה מאותת לרכיבי העיבוד לצייר את אינדיקטור הערך בטווח עם פלחים, כאשר פלח אחד = יחידה אחת. (I7d7c1)

תיקוני באגים

• הוספנו את האפשרות להגדיר את ComplicationSlotBounds ביחס למערכת קואורדינטות מוגדרת מראש של המסך. (I0985d)

גרסה 1.1

גרסה 1.1.1

‫10 באוגוסט 2022

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

• הגרסה הזו כוללת תיקוני באגים, ומומלץ מאוד למשתמשים בגרסה 1.1.0 לשדרג.

תיקוני באגים

• ההפעלה של תצוגת השעון היא אסינכרונית, ואם מתקבל רכיב לפני שתצוגת השעון מוכנה, הוא מתווסף לרשימה pendingInitialComplications ומוחל מאוחר יותר. לצערנו, ההגדרה pendingInitialComplications הוחלה מוקדם מדי, ולכן היה חלון זמן במהלך האתחול של פני השעון שבו עדיין הוצבו סיבוכים ב-pendingInitialComplications והמערכת התעלמה מהם. הבעיה תוקנה. בנוסף, התיקון הזה פותר באג שבו ComplicationRenderer ניסה בטעות לטעון placeholder באופן אסינכרוני, מה שגרם לכך שהטעינה נכשלה והגרפיקה של הקומפילציה לא עודכנה אף פעם. לבסוף, התיקון הזה פותר באג תיאורטי, בתקווה, שבו צריך למזג כמה pendingInitialComplications. (0d03ba3)

• תוקן פוטנציאל לקיפאון ב-InteractiveInstanceManager שבו getExistingInstanceOrSetPendingWallpaperInteractiveWatchFaceInstance החזיק את הנעילה יותר מהזמן הנדרש. בדרך כלל אנחנו מצפים שengine.setUserStyle יפעל במהירות, אבל אם מסיבה כלשהי זה לא קורה, יכול להיות שנגיע למצב של חסימה או ANR. התיקון הזה מוציא עבודה מיותרת מהנעילה, וכך מסיר את הפוטנציאל לקיפאון (5a2adca).

• תוקנו כמה בעיות שקשורות לשמירה של WatchFaceService. לפעמים, ה-WakeLock שומר את WatchFaceService, והוספת שיחה של release() פותרת את הבעיה. בנוסף, StateFlows יכול לשמור על WatchFaceService, וביטול CoroutineScopes הבסיסי פותר את הבעיה הזו.(fd48138)

• הוספת פסק זמן ל-awaitDeferredWatchFace* ותיקון watchfaceOverlayStyle NullPointerException. בנסיבות רגילות, לא אמור להיות פסק זמן, כולל אחרי התקנה חדשה ובתרחישים של DirectBoot שבהם עומס ה-CPU גבוה. תיקנו גם שגיאת NPE אם מתבצעת קריאה ל-getWatchfaceOverlayStyle אחרי close().(a4c3a5a)

גרסה 1.1.0

‫15 ביוני 2022

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

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

שיפורים בעריכה:

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

תצוגות שעון משופרות:

• עכשיו אפשר לציין את ComplicationType למקורות הנתונים הראשיים והמשניים, וכך המפתחים נהנים מגמישות רבה יותר בחוויית השימוש.
• הוספנו את ComplicationDataTimeline שמספק רצף של נתונים עם הגבלת זמן שיוצגו במסך השעון, שאפשר לשמור במטמון ולעדכן באופן אוטומטי. לדוגמה, תחזית מזג האוויר להיום בשעות שונות או כמה אירועים קרובים ביומן.
• ה-ComponentName של ספק הרכיבים הוא חלק מ-ComplicationData.
• הנתונים של רכיבי המידע נשמרים עכשיו במטמון, וכך חוויית המשתמש טובה יותר כשעוברים בין תצוגות שעון.

שינויים אחרים:

• מעכשיו אפשר להגדיר את UserStyleSchema ואת ComplicationSlots ב-XML. כך אפשר ליצור את פני השעון בצורה פשוטה יותר, והמערכת יכולה לבצע שאילתות על מטא-נתונים מהר יותר.
• תצוגות השעון יכולות עכשיו להשפיע על הצבעים שמשמשים לעיבוד שכבת העל של המערכת.

גרסה ‎1.1.0-rc01

‫18 במאי 2022

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

תכונות חדשות

• ביצענו כמה שינויים קלים בשימושיות של התמיכה ב-XML של תצוגות השעון, כדי שיהיה קל יותר לציין ComplicationSlotBounds ולתמוך בהפניות. הניסויים עם סיבוך קצה BoundingArc נמשכים, והם מועברים דרך drawHighlight, למרות שלא מומלץ להשתמש בהם בשלב הזה.

שינויים ב-API

• הוספנו עומס יתר ניסיוני של drawHighlight שמקבל פרמטר BoundingArc. (I705f8)
• קובצי XML של תצוגות שעון תומכים עכשיו בהפניות למשאבים. הוא מאפשר להשתמש באותם קבועים גם ב-XML וגם בקוד. (I3ef61)
• הוספנו את האפשרות להגדיר ComplicationSlotBounds בטופס center_x, ‏ center_y, ‏ size_x, ‏ size_y. מעכשיו אפשר גם להשתמש ביחידות שונות (למשל, dp) באמצעות הפניות למשאבים. (Iace98)

תיקוני באגים

• תוקנה בעיה ב-runBlockingWithTracing שגרמה להרצת משימות בהקשר שגוי.(4f595fe)
• הופכים את BaseEditorSession.close לסינכרוני. הבעיה ב-BaseEditorSession.close היא שהיא אסינכרונית, ולכן אנחנו מפרסמים את ComplicationDataSourceInfoRetriever מאוחר מדי, מה שמוביל לספאם של אזהרות ב-logcat. סביר להניח שהפעולה הזו לא מזיקה, אבל ספאם ב-logcat מסיח את הדעת וכדאי להימנע ממנו.(35a5308)

גרסה ‎1.1.0-beta02

‫11 במאי 2022

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

תכונות חדשות

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

שינויים ב-API

• הוספנו את המחלקה הניסיונית BoundingArc שמתארת את הגיאומטריה של משבצת לסיבוך בקצה. הוספנו את האפשרות הזו ל-ComplicationSlot והיא זמינה גם ב-ComplicationSlotState וב-WatchFaceMetadataClient. (I61a40)
• הוספנו את האפשרות להגדיר ירושה של הגדרות ב-XML של UserStyleSetting. הוא מאפשר לכם לצמצם את כמות המלל ולשתף הגדרה בין פני שעונים. (Ief841)
• הוספנו שני סוגים חדשים של ComplicationData בניסוי: ListComplicationData ו-ProtoLayoutComplicationData. נכון לעכשיו, אין תמיכה בעיבוד של אף אחד מהסוגים האלה, ו-WearOS לא מזהה את הסוגים האלה אם הם מתווספים למניפסט ComplicationDataSource's. (I1811c)

תיקוני באגים

• תיקון סריאליזציה של סוג TimeLineEntry. לא ביצענו סריאליזציה של סוג TimeLineEntry, מה שאומר ש-TimeLineEntries במטמון מסוג NoData יפורש באופן שגוי כאילו יש לו את הסוג של רכיב ה-Complication ברמת ההורה, וכתוצאה מכך יתרחשו שגיאות מסוג NPE כשמתבצעת גישה לשדות נדרשים שלא קיימים. (55ffdf5)
• תוקן באג שגרם לכך שsetComplicationData השמיט שדות של ציר הזמן(fb392f5)
• תוקן באג שבו מדי פעם runBlockingWithTracing הוביל ל-NPE‏(12ca62e)
• תוקן באג שגרם לכך שלפעמים קיבלנו ClassNotFoundException: android.support.wearable.complications.ComplicationText כשקיבלנו רכיב מידע.(217942d9)
• תוקן באג ב-GlesRenderer.backgroundThreadInitInternal שגרם לכך שהפונקציה onBackgroundThreadGlContextCreated הופעלה רק אם הופעלה הפונקציה EGL14.eglCreateContext. תוקן באג נוסף שגרם לבעיה חזותית בצילום המסך בגלל verticalFlip.(c674ad2)
• תוקן אימות גרסת ה-XML‏ WatchFaceService, שהיה נטען מהחבילה הלא נכונה.(dfa06f3)
• פורמט ה-placeholder של החוט משתמש עכשיו בחבילה פנימית. אנחנו לא רוצים שמצייני מיקום יפגעו בלוחות שעונים קיימים, שעשויים להשתמש ב-a.s.w.c.ComplicationData הפנימי המוסתר. בעבר, פורמט הנתונים של NoDataComplicationאחסון הנתונים הכיל את ה-placeholder בשדות הרגילים (בעייתי כי פני שעון ישנים היו מציגים את מחרוזת ה-placeholder, וזה לא היה רצוי). עכשיו אנחנו משתמשים בחבילה פנימית כדי לבודד את הנתונים האלה באופן מלא.(d5e7bd2)

גרסה ‎1.1.0-beta01

‫20 באפריל 2022

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

שינויים ב-API

• עכשיו, שיטות WatchFaceMetadataClient (getUserStyleSchema,‏ getComplicationSlotMetadataMap,‏ getUserStyleFlavors) ו-HeadlessWatchFaceClient.getUserStyleFlavors יוצרות RuntimeException לא מסומן במקום WatchFaceException. (I0718a)
• WatchFaceMetadataClient.WatchFaceException הועבר מהכיתה כדי לאפשר שימוש חוזר בו. (I4e869)

תיקוני באגים

• WatchFaceMetadataClient לא יקרוס יותר כשיישלח אליו ComplicationSlotBounds חלקי.(Iaafd)

גרסה ‎1.1.0-alpha05

‫6 באפריל 2022

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

תכונות חדשות

• עכשיו אפשר לדעת איזה מקור נתונים שלח ComplicationData על ידי בדיקת ComplicationData.dataSource. יכול להיות שחלק מתצוגות השעון ישתמשו בזה כדי להתאים אישית את תצוגת הרכיבים. (I44a73)

שינויים ב-API

• הוצאנו משימוש את Renderer.CanvasRenderer ו-Renderer.GlesRenderer לטובת Renderer.CanvasRenderer2 ו-Renderer.GlesRenderer2 שתומכים ב-SharedAssets, שמועברים לשיטות העיבוד. לשילוב עם Java הוספנו את ListenableCanvasRenderer2 ואת ListenableGlesRenderer2. (I31ffa)
• נוספה האפשרות להגדיר סגנונות – רשימה מוגדרת מראש של תצוגות שעון עם סגנונות (I04dd0)@WatchFaceFlavorsExperimental
• ‫Renderer.sharedAssets הוא עכשיו StateFlow והסרנו את Renderer.SharedAssetsFactory שלא היה בשימוש (I12ac5)
• האפשרות UserStyleSchema.userStyleSettings כבר לא הוצאה משימוש (Iba7e3)
• הוספנו את HeadlessWatchFaceClient.getUserStyleSchemaDigestHash שמאפשר ל-HeadlessWatchFaceClient להימנע מהתקורה הנמוכה יחסית של העברת הסכימה דרך AIDL לפני חישוב הגיבוב של התקציר. (I33597)
• הוספנו את isUserStyleSchemaStatic ל-WatchFaceMetadataClient, והערך הוא true אם ורק אם אפשר להסתמך על כך ש-UserStyleSchema לא ישתנה אלא אם חבילת ה-APK של תצוגת השעון תעודכן. (I45a3f)
• הוספנו את getDigestHash ל-UserStyleSchema, שמחשב גיבוב של תמצית הסכימה. אפשר להשתמש בשיטה הזו כדי לקבוע ביעילות אם UserStyleSchema השתנה. (I2063d)
• השם של METADATA_KEY_DATA_SOURCE_DEFAULT_CONFIGURATION_SUPPORTED שונה לMETADATA_KEY_DATA_SOURCE_DEFAULT_CONFIG_SUPPORTED (I9ba5d)
• UserStyleSetting.OnWatchEditorData שונה ל-UserStyleSetting.WatchFaceEditorData, הוא מכיל נתונים שמשמשים רק את כלי העריכה של עיצוב השעון. (If3afb)

גרסה ‎1.1.0-alpha04

9 במרץ 2022

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

שינויים ב-API

• יכול להיות שהערך העדכני של ComplicationData לא תמיד יהיה זמין (למשל, אם נתוני ComplicationData שנשמרו במטמון פג תוקף), ולכן הוספנו ל-NoDataComplication את placeholder אופציונלי של ComplicationData, וגם את ComplicationText.PLACEHOLDER,‏ MonochromaticImage.PLACEHOLDER,‏ SmallImage.PLACEHOLDER ו-PhotoImage.PLACEHOLDER, שאפשר להשתמש בהם רק בהקשר של placeholder‏ NoDataComplicationData. אם בוחרים באפשרות הזו, מוצע להציג את ה-placeholder האלה עם תיבות או קשתות אפורות. (I6285d)
• הוספנו את ComplicationData.getNextChangeInstant שמציין את הרגע המיידי הבא אחרי הרגע המיידי של ההפניה, שבו יכול להשתנות שדה כלשהו של הסיבוך. הערך הזה משמש באופן פנימי לתזמון פריימים לעדכונים של רכיבים. לדוגמה, אם תצוגת השעון מתעדכנת בדרך כלל פעם בדקה, הגדרת רכיב של שעון עצר תגרום לעדכון פעם בשנייה. (I7ceb2)
• עכשיו אפשר להשתמש ב-EditorSession.watchFaceId בכל רמות ה-API. בנוסף, הערך שלו תמיד יהיה עכשיו עקבי עם WatchState.watchFaceInstanceId. (I323b9)
• אין יותר צורך ב-getPendingIntentForTouchEvent API כי הבעיה הבסיסית תוקנה במסגרת, ולכן כל ממשקי ה-API שקשורים אליו הוסרו. אין צורך לבצע פעולות מיוחדות כדי להפעיל את PendingIntents, גם אם לחצתם לאחרונה על לחצן הבית. (I1f2e8)
• הוספנו את RendererParameters.isForScreenShot, שיהיה True אם הרינדור הוא לצילום מסך. חלק מהעיצובים של השעון עם אנימציות צריכים לדעת את זה כדי לבצע התאמות שיבטיחו את התוצאות הטובות ביותר. (I96d99)
• הוספנו את WatchFaceExceptionReason אל WatchFaceException כדי לספק הקשר לגבי מה שהשתבש. (I01d15)
• הוסר, במקומו נוסף ComplicationRequest.immediateResponseRequired כדי לציין שהספק צריך להגיב במהירות (התגובה צריכה להתקבל תוך פחות מ-100 אלפיות השנייה).ComplicationDataSourceService.onImmediateComplicationRequest הערה: הפונקציונליות הזו מוגנת על ידי הרשאה מיוחדת com.google.android.wearable.permission.USE_IMMEDIATE_COMPLICATION_UPDATE. (Ie6b23)
• עודכן מצב האפשרות לערך null בספריות הליבה וב-appcompat כך שיתאים ל-Tiramisu DP2‏ (I0cbb7)

תיקוני באגים

• עכשיו, אם אימות הסכימה נכשל, אפליקציית לוח השעון קורסת עם חריגה (Ia400f)

גרסה ‎1.1.0-alpha03

‫9 בפברואר 2022

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

שינויים ב-API

• הוספנו תמיכה ניסיונית בסכימות סגנונות היררכיות. הוספנו נכס חדש ל-androidx.wear.watchface.style.UserStyleSetting.Option, childSettings, שמשמש בהתחלה רק את ListOption. האפשרות הזו מאפשרת לתאר היררכיה של סגנונות לשימוש בממשקי משתמש של עורכים. ה-UserStyle הבסיסי לא משתנה והוא עדיין Map<String, ByteArray>. (Iaf6f4)
• הוספנו את WatchFace.OverlayStyle שמאפשר לתצוגת השעון להגדיר את העיבוד של שכבת העל של סטטוס המערכת. (I8520d)
• הוספנו clearWithBackgroundTintBeforeRenderingHighlightLayer פרמטר אופציונלי חדש של בנאי ל-CanvasRenderer (ברירת המחדל היא false). אם מגדירים את הפרמטר כ-true, הציור על הקנבס יימחק ויוחלף בצבע הרקע. (Ie01e5)
• נוסף מפתח המטא-נתונים androidx.watchface.complications.datasource.DEFAULT_CONFIGURATION_SUPPORTED שמאפשר למקורות נתונים של רכיבי שעון לציין שהם יכולים לספק ערך ברירת מחדל ללא הגדרה (Icc0d4)
• בדרך כלל, כשעורכים תצוגת שעון, יש גם מופע אינטראקטיבי וגם מופע ללא ראש. כדי לחסוך בזיכרון, הוספנו את Renderer.SharedAssets שמאפשר למעבד של תצוגת השעון לשתף נתונים שלא ניתן לשנות (למשל, טקסטורות ו-shaders) בין מופעים. המאפיינים GlesRenderer.setEglConfig ו-GlesRenderer.setEglDisplay הוצאו משימוש, לא הייתה כוונה לאפשר הגדרה שלהם, והגדרה שלהם הייתה מובילה להתנהגות לא מוגדרת. (I0d9e7)
• הוספנו את setNameResourceId ו-setScreenReaderNameResourceId (שמפנים למשאבי מחרוזות) אל ComplicationSlot.Builder ואל שיטות ה-getter התואמות ב-androidx.wear.watchface.client.ComplicationSlotState. כך המערכת יכולה לאחזר את השמות של ComplicationSlots לשימוש בעורכים ובקוראי מסך. (If6c6a)
• ‫WatchfaceMetadataClient.getUserStyleSchema ו-getComplicationSlotMetadataMap מחזירים עכשיו WatchFaceException במקום RemoteException. (I86f11)
• השמות של onSynchronousComplicationRequest ופונקציות קשורות ב-ComplicationDataSourceService השתנו ל-onImmediateComplicationRequest וכו'... (I87ba0)
• לעורכי תצוגות השעון יש הרבה פחות מקום במסך מאשר לעורכים של אפליקציות נלוות, ולכן הגיוני לתמוך בסמלים שונים לעורכי תצוגות השעון. התיקון הזה מוסיף את OnWatchEditorData (שכולל כרגע רק סמל) לכל UserStyleSettings ולמחלקות האפשרויות שלהם, במקומות המתאימים. (If1886)
• הוספנו את @JvmOverloads לבונה של ListenableGlesRenderer כדי לשפר את יכולת הפעולה ההדדית של Java. (I2974a)

תיקוני באגים

• ה-constructor של ListenableGlesRenderer מסומן עכשיו בצורה נכונה כ-@Throws(GlesException::class), ועכשיו אפשר להרחיב את המחלקה הזו ב-Java. (Iac6d0)
• תוקן באג שקשור ל-tapAction‏ PhotoImageComplicationData שלא מטופל בצורה נכונה (I1cc30)

גרסה ‎1.1.0-alpha02

‫12 בינואר 2022

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

תכונות חדשות

• כדי לעזור בניפוי באגים ובבדיקות, מחלקות המשנה שקשורות ל-ComplicationData כוללות עכשיו שיטות ששולטות על hashcode,‏ equals ו-toString, ולכן קל יותר לעבוד איתן.

שינויים ב-API

• WatchfaceMetadataClient שוב מחזירות RemoteExceptions במקרים המתאימים, וכך קל יותר לקוד הלקוח לזהות שגיאות מלוח השעון. (I78785)
• ל-ComplicationData ולמחלקות המשנה יש עכשיו hashcode, ‏ equals ו-toString. (I24bc6)

גרסה ‎1.1.0-alpha01

15 בדצמבר 2021

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

תכונות חדשות

• מעכשיו אפשר להגדיר את UserStyleSchema ואת ComplicationSlots ב-XML. כך קל יותר ליצור תצוגות שעון. בנוסף, השאילתות של WatchFaceMetadataClient מהירות יותר כי לא צריך לקשר אותן לשירות כדי לקבל את המטא-נתונים. התכונות WatchFaceMetadataClient ו-ListenableWatchFaceMetadataClient כבר לא ניסיוניות והן יהפכו לחלק מה-API היציב. המערכת תוכל לתמוך בכמה מופעים של תצוגת שעון, שלכל אחד מהם יהיו אפשרויות עיצוב שונות שהמשתמש יכול להגדיר. הם יופיעו בבורר תצוגות השעון. כדי להפעיל את ההגדרה הזו, מחוגי השעון צריכים לכלול את תג המטא-נתונים הבא בקובץ המניפסט שלהם.

      <meta-data
          android:name="androidx.wear.watchface.MULTIPLE_INSTANCES_ALLOWED"
          android:value="true" />
  

• חלק מתצוגות השעון כוללות מצב שלא נשמר ב-UserStyle. כדי לתמוך במצב הזה ובכמה מופעים, מזהה המופע של תצוגת השעון זמין עכשיו דרך WatchState.watchFaceInstanceId.

• ‫ComplicationData נשמר עכשיו במטמון כדי לאפשר הצגה מיידית של סיבוכים עם הטעינה. לפעמים המערכת שומרת את ComplicationData במטמון בזיכרון, ולפעמים ספריות של פני שעון מבצעות סריאליזציה של ComplicationData. כשמבצעים סריאליזציה, פעולת ההקשה המשויכת אובדת. אם זה קורה, ComplicationData.tapActionLostDueToSerialization מחזיר true ולוח השעון צריך להציג את הנתון בצורה שונה (למשל, באפור או שקוף למחצה) כדי לציין שאי אפשר להקיש עליו. המערכת תשלח ComplicationData מעודכן עם tapAction בהקדם האפשרי.

• כדי לתמוך במקרים שבהם לא כדאי לשמור במטמון חלק מהרכיבים ComplicationData למשך זמן רב, הוספנו תכונה כללית יותר ComplicationDataTimeline. אפשר להשתמש בזה כדי לספק רצף של ComplicationData עם הגבלת זמן שיוצגו במסך השעון, שניתן לשמור במטמון ולעדכן באופן אוטומטי. לדוגמה, תחזית מזג האוויר להיום בשעות שונות או כמה אירועים קרובים ביומן. הוספנו ל-ComplicationRequestListener את השיטה החדשה onComplicationDataTimeline, שבעזרתה אפשר להחזיר את הנתונים האלה.

• הארכנו את DefaultComplicationDataSourcePolicy כדי שתוכלו לציין את ComplicationType למקורות הנתונים הראשיים והמשניים.

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

• סביר להניח שהשינויים ב-PendingIntentTapListener יבוטלו, כי פתרנו את הבעיה הבסיסית (אי אפשר להפעיל פעילויות של לוח השעון למשך 5 שניות אחרי שלוחצים על לחצן הבית) במסגרת במקום.

שינויים ב-API

• הערך של ComplicationData.isCached השתנה ל-tapActionLostDueToSerialization, שהוא שימושי יותר כשקובעים אם משבצת הסיבוך צריכה להיות מוצגת בצורה שונה כדי לסמן שאי אפשר להקיש עליה. (I6de2f)
• ComplicationDataTimeline נוסף לקבוצה wear-complication-data-source. אפשר להשתמש בזה כדי לספק רצף של ComplicationData עם הגבלת זמן שיוצגו במסך השעון, שניתן לשמור במטמון ולעדכן באופן אוטומטי. לדוגמה, תחזית מזג האוויר להיום בשעות שונות או כמה אירועים קרובים ביומן. הוספנו ל-ComplicationRequestListener את השיטה החדשה onComplicationDataTimeline, שבעזרתה אפשר להחזיר את הנתונים האלה. יש עטיפה חדשה של Kotlin‏ SuspendingTimelineComplicationDataSourceService להשעיה של שירותי מקור נתונים. (Idecdc)
• הוספת את PendingIntentTapListener ואת WatchFaceControlClient.getPendingIntentForTouchEvent. הפתרון הזה יכול לעזור לתצוגות שעון שצריכות להפעיל כוונות בתגובה להקשות, כדי לעקוף בעיה שבה המסגרת חוסמת הפעלה של פעילויות חדשות למשך 5 שניות אחרי לחיצה על לחצן הבית. (I98074)
• הוספנו מטמון ComplicationData לכל תצוגת שעון. המטרה היא לאפשר לתצוגת השעון להציג את ערכי הנתונים האחרונים של הנתונים המורכבים בזמן הטעינה, עד שהמערכת תעדכן אותם. יש שיטת API חדשה, WatchFaceControlClient.hasComplicationCache שמיועדת ליצרני ציוד מקורי (OEM). הפעולה הזו עשויה להשפיע על האסטרטגיה של המערכת לשליחת נתונים מורכבים לתצוגת השעון. בנוסף, לרכיב ComplicationData יש מאפיין isCached, ומומלץ להציג רכיבי מידע ששמורים במטמון בצורה שונה, כי אי אפשר לשמור במטמון את tapAction, והוא יהיה null ברכיב מידע ששמור במטמון. (I404b0)
• מזהה המופע של תצוגת השעון זמין עכשיו דרך WatchState.watchFaceInstanceId. ברוב תצוגות השעון אין צורך להשתמש בערך הזה, אבל אם יש מצב לכל תצוגת שעון שלא נשמר בסכימה, זהו המפתח שבו צריך להשתמש כדי לזהות את מופע תצוגת השעון. כדי לתמוך בכך, עכשיו אפשר לספק מזהה כשמתקשרים אל WatchFaceControlClient.createHeadlessWatchFaceClient. (I1ff98)
• DefaultComplicationDataSourcePolicy מורחב עם האפשרות להגדיר את ComplicationTypes כברירת מחדל לספק הראשי, לספק המשני ולספק המערכת לגיבוי. המאפיין ComplicationSlot.defaultDataSourceType הוצא משימוש. (If0ce3)
• עכשיו אפשר לשנות את ComplicationSlot.configExtras ולעדכן אותו לפני שמתקשרים אל EditorSession.openComplicationDataSourceChooser(). (I6f852)
• הוספת את WatchFace.setComplicationDeniedDialogIntent ואת setComplicationRationaleDialogIntent. הכוונה היא להציג תיבת דו-שיח עם הסבר לפני בקשת הרשאות לסיבוך, ועוד תיבת דו-שיח עם הסבר על הצורך בהרשאה לסיבוך כשמנסים לערוך סיבוך כשההרשאות נדחות (הכלי לבחירת ספק לא ייפתח, ולכן צריך את תיבת הדו-שיח). (I3a29c)
• מעכשיו אפשר להגדיר את UserStyleSchema ואת ComplicationSlots ב-XML. כך קל יותר ליצור את פני השעון, והשאילתות של WatchFaceMetadataClient מהירות יותר כי הן לא צריכות להיות מקושרות לשירות כדי לקבל את המטא-נתונים. (I85bfa)
• נוסף InteractiveWatchFaceClient.supportsPendingIntentForTouchEvent כדי שלקוח יוכל לקבוע אם תצוגת שעון תומכת ב-getPendingIntentForTouchEvent. (I0b917)
• התכונות WatchFaceMetadataClient ו-ListenableWatchFaceMetadataClient כבר לא ניסיוניות. אפשר להשתמש בהם כדי לקבל ביעילות מטא-נתונים של לוחות שעון, במידת האפשר בלי לפתוח קובץ מאגד של לוח השעון. (Ibb827)
• נוספה תמיכה בספקי רכיבים סינכרוניים שבהם הרכיב מתעדכן בתדירות גבוהה מהרגיל, עד פעם בשנייה כשתצוגת השעון גלויה ולא במצב סביבה. כדי להשתמש בשיטה הזו, הספק צריך לכלול תג מטא-נתונים חדש androidx.wear.watchface.complications.data.source.SYNCHRONOUS_UPDATE_PERIOD_SECONDS במניפסט שלו ולבטל את onSynchronousComplicationRequest. בהתאם לאופי של מקור הנתונים, יכול להיות שיהיה צורך גם לבטל את ההגדרה של onStartSynchronousComplicationRequests ושל onStopInteractiveComplicationRequests כדי לקבל התראות כשהסיבוך נכנס למצב אינטראקטיבי ויוצא ממנו. (I8fe9d)

גירסה 1.0

גרסה 1.0.1

‫9 בפברואר 2022

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

תיקוני באגים

• תוקן באג שקשור ל-tapAction‏ PhotoImageComplicationData שלא טופל בצורה נכונה (I1cc30)

גרסה 1.0.0

1 בדצמבר 2021

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

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

חבילת androidx.wear.watchface היא הספרייה המומלצת החדשה לפיתוח תצוגות שעון ב-WearOS. יש בה מספר תכונות חדשות שלא היו בספריית התמיכה הקודמת ב-Wearable.

• הספרייה תומכת ישירות בסגנונות משתמש (למשל, שינוי פלטת הצבעים, הסגנון של מחוגי השעון, המראה של סימני השעות וכו') (ראו androidx.wear.watchface.style). עכשיו הרבה יותר קל לפתח עורך של תצוגת השעון באמצעות androidx.wear.watchface.editor, ואפשר לערוך את תצוגת השעון מאפליקציית המערכת הנלווית בלי לכתוב קוד נוסף.
• שיטות מומלצות מובנות. המערכת יוצרת באופן אוטומטי תוויות של תוכן לקורא מסך עבור סיבוכים (אפשר גם להוסיף תוויות משלכם), וקצב הפריימים יורד באופן אוטומטי כשהסוללה חלשה ולא בטעינה, כדי לשפר את אורך חיי הסוללה.
• נדרש פחות קוד כדי לפתח תצוגת שעון, במיוחד עבור רכיבים שבהם הרבה מהקוד הסטנדרטי הועבר לספרייה.

תיקוני באגים

• תיקון EditorSession.userStyle.compareAndSet (I6f676)
• תיקון השהיות קצרות מאוד בתצוגת השעון (Iffb97)
• העברת InteractiveWatchFaceImpl.onDestroy בשרשור UI (I83340)
• פתרון כמה בעיות שקשורות ל-broadcast receivers (I7d25f)

גרסה ‎1.0.0-rc01

‫3 בנובמבר 2021

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

תיקוני באגים

• תיקון של הפונקציה dump() (שנקראת על ידי adb shell dumpsys) שנפגמה בגלל העברות של זרימות. (087cf9e)

• צריך לוודא שסדר הפעולות של writeDirectBootPrefs נכון. אנחנו רוצים ש-writeDirectBootPrefs תמיד יפעל אחרי initStyleAndComplications, אחרת יש סיכון לעיכוב בהפעלת השרשור של ממשק המשתמש.(37650ac)

• מוודאים שהפונקציה Renderer.onDestroy נקראת. בתרחיש שבו הרכיב Renderer נוצר אבל WF init לא הושלם ומתבצעת קריאה ל-Engine.onDestroy, צריך לבצע קריאה ל-Renderer.onDestroy. (f9952dc)

• אופטימיזציה/תיקון של isBatteryLowAndNotCharging. בתיקון הזה, ההגדרה הראשונית של isBatteryLowAndNotCharging מוקדמת יותר, כך שאפשר לבצע אותה במקביל ל-createWatchFace. בנוסף, אנחנו מקשיבים עכשיו ל-ACTION_POWER_DISCONNECTED. (ddffd80

• ‫InteractiveWatchFaceClientImpl.isConnectionAlive צריך להיות false אחרי הסגירה (ab9774e)

גרסה ‎1.0.0-beta01

‫27 באוקטובר 2021

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

גרסה ‎1.0.0-alpha24

‫13 באוקטובר 2021

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

שינויים ב-API

• הכיתות בחבילה androidx.wear.watchface.complications הועברו לפרויקט חדש wear:watchface:watchface-complications. שימו לב: המשמעות היא שאי אפשר לכלול את הספרייה הזו וגם גרסת אלפא קודמת של wear:watchface:watchface-complications-data כי יוצגו שגיאות לגבי מחלקות כפולות. (I97195)
• הפונקציה Renderer.dump קיבלה את השם Renderer.onDump והיא מסומנת ב-@UiThread. (I44845)
• השם של InteractiveWatchFaceClient.addWatchFaceReadyListener השתנה ל-addOnWatchFaceReadyListener והשם של removeWatchFaceReadyListener השתנה ל-removeOnWatchFaceReadyListener. (I48fea)
• הפונקציות EditorSession getComplicationsPreviewData ו-getComplicationsDataSourceInfo הן כבר לא פונקציות השהיה, אלא מאפייני StateFlow<> שהערך שלהם הוא null בהתחלה. ב-ListenableEditorSession,‏ getListenableComplicationPreviewData ו-getListenableComplicationsProviderInfo הוסרו לטובת האובייקטים החדשים StateFlow<> ממחלקת הבסיס. אם אתם צריכים להאזין לשינויים בקוד Java, כדאי להשתמש ב-androidx.lifecycle.FlowLiveDataConversions.asLiveData כדי להמיר ל-LiveData<>. (Ic5483)

גרסה ‎1.0.0-alpha23

‫29 בספטמבר 2021

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

תכונות חדשות

ספריית עיצובי השעון היא עכשיו קבוצת ספריות אחת, ולכן הספריות הועברו ותצטרכו לעדכן את הייבוא של gradle באופן הבא:

שינויים ב-API

• מעבירים את הספריות הנפרדות androidx.wear Watchface ו-complications לקבוצת הספרייה androidx.wear.watchface. (b25f3c0)
• נוספה התכונה EditorRequest.canWatchFaceSupportHeadlessEditing כדי ליידע את הלקוח אם עורך תצוגת השעון תומך בעריכה ללא ראש. שימו לב שיהיו כמה תוצאות שליליות שגויות כי התמיכה נוספה ב-asop/1756809, אבל היא תחזיר את הערך הנכון לכל לוחות השעון העתידיים. (ca55590)
• ל-Renderer יש עכשיו שיטה dump() שאפשר לבטל כדי להוסיף נתונים בהתאמה אישית למידע שנוצר על ידי שירות הפעילות WatchFaceService של dumpsys של מעטפת ADB. (95235f9)
• הפונקציה InteractiveWatchFaceClient.addWatchFaceReadyListener מציינת עכשיו את ה-executor קודם. (563ac2f)
• הוסר StateFlowCompatHelper. במקומו צריך להשתמש ב-asLiveData ‏ (androidx.lifecycle.asLiveData). (bd35d3)
• המאפיין CurrentUserStyleRepository.userStyle לא ניתן לשינוי יותר. (I44889)
• השם של WatchFaceReadyListener השתנה ל-OnWatchFaceReadyListener. (Ic12a9)

תיקוני באגים

• ‫InteractiveInstanceManager.deleteInstance כדי לקרוא ל-onDestroy. הפעולה הזו נדרשת כדי לוודא ש-InteractiveWatchFaceImpl יאסוף את האשפה.(fce4af8, b/199485839)