תצוגת שעון ב-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-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)

תיקוני באגים

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

תכונות חדשות

• עכשיו אנחנו משתמשים בשוויון הפניה כדי להשוות בין הכי טוב לבין selectedData כי אופרטור השוויון יקר. (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‏ (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. (I31d88)
• ל-constructor של ComplicationSlotOverlay שהוצא משימוש יש עכשיו DeprecationLevel.WARNING, כך שאפשר לקרוא לו שוב מ-Java. (Ib308c)
• תיקנו כמה בעיות תאימות ל-Java ב-ComplicationRequestListener, ב-CanvasComplication, ב-ComplicationTapFilter וב-InteractiveWatchFaceClient באמצעות הערות עם @JvmDefaultWithCompatibility (Id94fc)
• הסרנו את התכונות הניסיוניות ProtoLayoutComplicationData ו-ListComplicationData. הסיפור של המפתחים בנושא הזה לא היה ברור, ואנחנו מקווים לחזור אליו בעתיד. (I9df05)
• הוספנו את ValueType בחזרה אל RangedValueComplicationData. ב-WeightedElementsComplicationData יש עכשיו תמיכה בצבע רקע. הסרנו את DiscreteRangedValueComplicationData כי הפונקציונליות שלו היא קבוצת משנה של WeightedElementsComplicationData. (I6446c)

תיקוני באגים

• צריך לכלול את התו isForScreenShot בסימן השוויון ובקוד הגיבוב. מוודאים שהמאפיין onRenderParametersChanged מקבל ערך isForScreenshot נכון (I04a41)
• תוקנו דליפות של WatchFaceControlService מלקוחות ללא ממשק משתמש. (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 שימש כשורש של איסוף אשפה (GC) ושמר על פעילות העריכה.(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 ל-constructor של ComplicationSlotOverlay (I157e8)
• הוספנו guava wrapper ל-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 מכילה את הקומיטים האלה.

תכונות חדשות

• הוספנו תמיכה ניסיונית בפורמטים חדשים שונים של מידע. אנחנו עובדים על פיתוח הפורמטים החדשים האלה, והם עשויים להשתנות ללא הודעה מוקדמת. בשלב הזה אין תמיכה בפורמטים האלה ב-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 של ה-wire משתמש עכשיו בחבילה פנימית. אנחנו לא רוצים שמצייני מיקום יפגעו בלוחות שעונים קיימים, שאולי משתמשים ב-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)
• אין יותר צורך ב-API‏ getPendingIntentForTouchEvent כי הבעיה הבסיסית תוקנה במסגרת, ולכן כל ממשקי ה-API שקשורים אליה הוסרו. אין צורך לבצע פעולה מיוחדת כדי להפעיל את PendingIntents, גם אם לחצתם לאחרונה על לחצן הבית. (I1f2e8)
• הוספנו את RendererParameters.isForScreenShot, שיהיה True אם הרינדור הוא לצילום מסך. חלק מהעיצובים של השעון עם אנימציות צריכים לדעת את זה כדי לבצע התאמות שיבטיחו את התוצאות הטובות ביותר. (I96d99)
• הוספנו את WatchFaceExceptionReason אל WatchFaceException כדי לספק הקשר לגבי מה שהשתבש. (I01d15)
• הסמל ComplicationDataSourceService.onImmediateComplicationRequest הוסר, ובמקומו נוסף הסמל ComplicationRequest.immediateResponseRequired כדי לציין שהספק צריך להגיב במהירות (התגובה צריכה להתקבל תוך פחות מ-100 אלפיות השנייה). הערה: הפונקציונליות הזו מוגנת על ידי הרשאה מיוחדת com.google.android.wearable.permission.USE_IMMEDIATE_COMPLICATION_UPDATE. (Ie6b23)
• עודכן מצב ה-nullability בספריות הליבה וב-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. האפשרות הזו מאפשרת לתאר היררכיה של סגנונות לשימוש בממשקי משתמש של כלי העריכה. הסגנון הבסיסי של המשתמש לא משתנה והוא עדיין 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. כשמבצעים סריאליזציה, כל tapAction משויך יאבד, ואם זה יקרה, 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 לכל תצוגת שעון. המטרה היא לאפשר לתצוגת השעון להציג את ערכי הנתונים האחרונים של התוסף שזמינים בטעינה, עד שהמערכת תעדכן אותם. יש method חדש ב-API‏, WatchFaceControlClient.hasComplicationCache, שמיועד ליצרני ציוד מקורי (OEM). יכול להיות שהפעולה הזו תשפיע על האסטרטגיה של המערכת לשליחת נתונים מורכבים לתצוגת השעון. בנוסף, לאובייקט ComplicationData יש מאפיין isCached, ומומלץ להציג רכיבי מידע ששמורים במטמון באופן שונה, כי אי אפשר לשמור במטמון את tapAction, והוא יהיה null ברכיב מידע ששמור במטמון. (I404b0)
• מזהה המופע של תצוגת השעון זמין עכשיו דרך WatchState.watchFaceInstanceId. ברוב תצוגות השעון לא צריך להשתמש בזה, אבל אם יש מצב לכל תצוגת שעון שלא נשמר בסכימה, זה המפתח שצריך להשתמש בו כדי לזהות את מופע תצוגת השעון. כדי לתמוך בכך, עכשיו אפשר לספק מזהה כשמתקשרים אל WatchFaceControlClient.createHeadlessWatchFaceClient. (I1ff98)
• ‫DefaultComplicationDataSourcePolicy Extended עם אפשרות להגדיר את 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, אחרת יש סיכון לעיכוב בהפעלת ה-UI thread. ‏(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)