פיתוח נייטיב עם Wear

  
כתיבת אפליקציות של Jetpack Compose למכשירים לבישים באמצעות אספקת פונקציונליות לתמיכה במכשירים לבישים ספציפיים, גדלים, צורות וסוגים מסוימים תנועות ניווט.
העדכון האחרון גרסה יציבה מועמד לפרסום גרסת בטא גרסת אלפא
21 באוגוסט 2024 1.3.1 1.4.0-rc01 - -

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

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

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

מגניב

dependencies {
    implementation "androidx.wear.compose:compose-foundation:1.3.1"

    // For Wear Material Design UX guidelines and specifications
    implementation "androidx.wear.compose:compose-material:1.3.1"

    // For integration between Wear Compose and Androidx Navigation libraries
    implementation "androidx.wear.compose:compose-navigation:1.3.1"

    // For Wear preview annotations
    implementation("androidx.wear.compose:compose-ui-tooling:1.3.1")
    
    // NOTE: DO NOT INCLUDE a dependency on androidx.compose.material:material.
    // androidx.wear.compose:compose-material is designed as a replacement
    // not an addition to androidx.compose.material:material.
    // If there are features from that you feel are missing from
    // androidx.wear.compose:compose-material please raise a bug to let us know.
}

Kotlin

dependencies {
    implementation("androidx.wear.compose:compose-foundation:1.3.1")

    // For Wear Material Design UX guidelines and specifications
    implementation("androidx.wear.compose:compose-material:1.3.1")

    // For integration between Wear Compose and Androidx Navigation libraries
    implementation("androidx.wear.compose:compose-navigation:1.3.1")
    
    // For Wear preview annotations
    implementation("androidx.wear.compose:compose-ui-tooling:1.3.1")

    // NOTE: DO NOT INCLUDE a dependency on androidx.compose.material:material.
    // androidx.wear.compose:compose-material is designed as a replacement
    // not an addition to androidx.compose.material:material.
    // If there are features from that you feel are missing from
    // androidx.wear.compose:compose-material please raise a bug to let us know.
}

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

משוב

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

דיווח על בעיה חדשה

מקורות מידע בנושא מעקב אחר בעיות אפשר לקבל מידע נוסף.

גרסה 1.0 של Wear Compose Material3

גרסה 1.0.0-alpha23

14 במאי 2024

androidx.wear.compose:compose-material3:1.0.0-alpha23 משוחרר. גרסה 1.0.0-alpha23 מכילה את התחייבויות אלה.

שינויים ב-API

  • עדכנו את ממשקי ה-API של ToggleButton ו-RadioButton, כך שאפשר להגדיר צבעים מושבתים. (If13a7)
  • הוספנו CircularProgressIndicator חדש ל-Material3. (Ib3bd7)

תיקוני באגים

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

גרסה 1.0.0-alpha22

1 במאי 2024

androidx.wear.compose:compose-material3:1.0.0-alpha22 משוחרר. גרסה 1.0.0-alpha22 מכילה את התחייבויות אלה.

שינויים ב-API

  • עדכנו את ColorScheme של Material3. (I7b2b8)
  • עדכנו את מתג Material3 – וגם כמה שינויי צבע, הסימן תואם עכשיו לתיבת הסימון. (Icac7b)

תיקוני באגים

  • צריך לעדכן את כל הדגמות השילוב כדי להשתמש במגביל החדש של rotaryScrollable. (I25090)

גרסה 1.0.0-alpha21

17 באפריל 2024

androidx.wear.compose:compose-material3:1.0.0-alpha21 משוחרר. גרסה 1.0.0-alpha21 מכילה את התחייבויות אלה.

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

גרסה 1.0.0-alpha20

3 באפריל 2024

androidx.wear.compose:compose-material3:1.0.0-alpha20 משוחרר. גרסה 1.0.0-alpha20 מכילה את התחייבויות אלה.

תיקוני באגים

  • שינינו את שלבי האלפא של המצב הלחץ והמיקוד של 'הדים' לצורך ניגודיות. (I59f0a)
  • הוספנו ריווח בין התוויות הראשיות והמשניות ב-Button, ב-ToggleButton וב-RadioButton, בעקבות השינויים האחרונים בסגנונות הטיפוגרפיה ובגובהי השורות. (I2c0ba)

גרסה 1.0.0-alpha19

6 במרץ 2024

androidx.wear.compose:compose-material3:1.0.0-alpha19 משוחרר. גרסה 1.0.0-alpha19 מכילה את התחייבויות אלה.

שינויים ב-API

  • הוספנו את TimeText לספרייה של Wear Compose Material3. הרכיב הזה מציג את השעה הנוכחית (והסטטוס הנוסף) בחלק העליון של המסך. ה-Material3 API החדש והתמציתי מונע כפילויות בין תוכן לינארי ותוכן מעוקל. (I4d7c3)
  • עדכנו את שמות הפרמטרים מ-onSelected ל-onSelect עבור RadioButton. (I1a971)
  • יצירת אסימון של RadioButton ו-SplitRadioButton וגם ארגון מחדש של השיטות הקיימות כדי לצמצם את כמות החיפוש CompositionLocal על ידי הוספת מופעים של צבעים שנשמרו במטמון ויצירת שיטות של RadioButtonColors ו-SplitRadioButtonColors לשימוש פנימי. (I02b33)

גרסה 1.0.0-alpha18

21 בפברואר 2024

androidx.wear.compose:compose-material3:1.0.0-alpha18 משוחרר. גרסה 1.0.0-alpha18 מכילה את התחייבויות אלה.

שינויים ב-API

  • חיברנו מחדש את תבניות ברירות המחדל של CardColors, ToggleButtonColors ו-SplitToggleButtonColors על ידי יצירת מכונות שנשמרו במטמון באופן פנימי וצמצום השימוש ב-CompositionLocal. (If3fec)

גרסה 1.0.0-alpha17

7 בפברואר 2024

androidx.wear.compose:compose-material3:1.0.0-alpha17 משוחרר. גרסה 1.0.0-alpha17 מכילה את התחייבויות אלה.

שינויים ב-API

  • עדכנו את ה-button API כך שישתמש ב-buttonColors כברירת מחדל והסרנו את הכפילויות ב-filledButtonColors. (I4fe3b)
  • חיברנו מחדש את דפוסי ברירת המחדל של ButtonColors, IconButtonColors ו-TextButtonColors על ידי יצירת מכונה ששמורה במטמון באופן פנימי וצמצום השימוש ב-CompositionLocal. (I5f51c)
  • הסרנו את התקורה של rememberUpdatedState בקטגוריות צבעים ספציפיות לרכיבים וסימנו methods של רכיב גישה בתוך סיווגי הצבעים כפנימיות. (If6571)

תיקוני באגים

  • עדכנו את Modifier.minimumInteractiveComponentSize לשימוש של Modifier.node. (Iba6b7)

גרסה 1.0.0-alpha16

24 בינואר 2024

androidx.wear.compose:compose-material3:1.0.0-alpha16 משוחרר. גרסה 1.0.0-alpha16 מכילה את התחייבויות אלה.

תכונות חדשות

  • הוספנו את המאפיין CompactButton, שיכול להשתמש באותם צבעים מלאים, ממולאים וקווי מתאר כמו לחצן.(I05df0)

שינויים ב-API

  • הוספנו את RadioButton/SplitRadioButton כמאגרים לפקדים לבחירה, כמו פקד הרדיו. בניגוד למה שקיים ToggleButton הקיים, אפשר לבחור את השדה RadioButton (ופועל בתוך קבוצה נבחרת), ואילו ToggleButton ניתן להחליף מצב (והוא עצמאי). (I61275)
  • אנחנו מסירים את LocalContentAlpha מספריית Wear Compose Material3 כדי לשמור על עקביות עם הספרייה Compose Material3. (I49a0a)
  • רכיבי Wear של החומר והלבישים שחושפים MutableInteractionSource ב-API עודכנו, ועכשיו הם כוללים MutableInteractionSource עם ערך null שברירת המחדל שלו היא null. אין כאן שינויים סמנטיים: העברת ערך null פירושה שלא רוצים להניף את ה-MutableInteractionSource, והוא ייווצר בתוך הרכיב במקרה הצורך. שינוי ל-null מאפשר לרכיבים מסוימים לא להקצות אף פעם MutableInteractionSource, ומאפשר לרכיבים אחרים ליצור מכונה באופן מדורג רק כשהם צריכים. פעולה זו משפרת את הביצועים ברכיבים האלה. אם אתם לא משתמשים בMutableInteractionSource שאתם מעבירים לרכיבים האלה, מומלץ להעביר במקום זאת ערך null. מומלץ גם לבצע שינויים דומים ברכיבים שלכם. (Ib90fc, b/298048146)
  • הוספת ממשק API של Ripple API בספריות wear:compose-material ו-wear:compose-material3, שמחליף את rememberRipple שהוצא משימוש. בנוסף, מתווסף CompositionLocal, LocalUseFallbackRippleImplementation זמני, כדי להחזיר רכיבי Material לשימוש בממשקי ה-API של rememberRipple/RippleTheme שהוצאו משימוש. האפשרות הזו תוסר בגרסה היציבה הבאה, והיא נועדה לשמש רק כאמצעי עזר זמני להעברה במקרים שבהם בחרת לספק RippleTheme בהתאמה אישית. בכתובתdeveloper.android.com אפשר למצוא מידע על העברה ומידע נוסף על הסיבה לשינוי. (af92b21)
  • ביצענו שיפורים קלים ב-API של HorizontalPageIndicator ובתיעוד שלו. (I60efc)
  • עדכנו את ColorScheme כך שלא יהיה ניתן לשנות את ההגדרות שלו, כך שעדכוני צבעים נפרדים יהיו פחות יעילים, אבל תייעל את השימוש בצבעים. הסיבה לשינוי הזה היא שברוב האפליקציות לא יהיה עדכון של צבעים ספציפיים כתרחיש לדוגמה העיקרי. זה עדיין אפשרי, אבל הוא יבנה מחדש את הנתונים מבעבר, וכתוצאה מכך נצמצם משמעותית את מספר המינויים לפי מדינות באמצעות כל הקודים המהותיים, מה שישפיע על האתחול ועל עלות זמן הריצה של תרחישים יותר רגילים לדוגמה. (Ibc2d6)
  • ממשקי ה-API של ToggleButton ו-SplitToggleButton עודכנו כדי לאפשר התאמה אישית של צבעים מושבתים. בנוסף, אסימונים של Material Design משמשים עכשיו לערכי צבעים וטיפוגרפיה. (If087c)
  • צבעי הרקע של תמונת הלחצן עודכנו לשימוש באסימונים בעיצוב Material Design. (Iba215)
  • שינינו את הרכיבים Checkbox, Switch ו-RadioButton לתצוגה בלבד על ידי הסרת הטיפול בקליקים. הרכיבים האלה צפויים להיות בשימוש ב-(Split)ToggleButton שמטפל בלחיצה, לכן הרכיבים מצוינים עכשיו באופן ברור יותר כרכיבים לרשת המדיה בלבד (ולא מיועדים לשימוש עצמאי ב-Wear). (I2322e)

תיקוני באגים

  • הוספנו אסימונים לערכי תנועה של משך זמן וההתאמות ב-Wear Compose Material 3. (I437cd)
  • תיקנו באג ב-ToggleButton, ב-SplitToggleButton, ב-Checkbox, ב-Switch וב-RadioButton כך שהודעות בנושא נגישות לא יחזרו על עצמן (בעבר, התפקידים הסמנטיים שוכפלו). (Ica281)
  • הסרנו את שכבת ה-Materialcore של CompactButton כדי לשפר את הביצועים. 7902858

גרסה 1.0.0-alpha15

15 בנובמבר 2023

androidx.wear.compose:compose-material3:1.0.0-alpha15 משוחרר. גרסה 1.0.0-alpha15 מכילה את התחייבויות אלה.

שינויים ב-API

  • שינינו את השם של רמת הבסיס SwipeToDismissBox לשם BasicSwipeToDismissBox. כך ההבחנה ברורה יותר בין הרכיב ברמת הבסיס לבין רמת Material3 SwipeToDismissBox. הכלי הזה שולף צבעים מ-MaterialTheme כדי להשתמש בהם ליצור מיפויים ומאציל את ההטמעה הנותרת ל-BasicSwipeToDismissBox. (Ibecfc)

תיקוני באגים

  • הסרנו את שכבת הליבה של החומר עבור הלחצן Material3 כדי לשפר את הביצועים. (I55555)

גרסה 1.0.0-alpha14

18 באוקטובר 2023

androidx.wear.compose:compose-material3:1.0.0-alpha14 משוחרר. גרסה 1.0.0-alpha14 מכילה את התחייבויות אלה.

שינויים ב-API

  • הסרנו את הפרמטר indicatorStyle מה-Material3 HorizontalPageIndicator – במקום זאת, הוא יופיע לצורת המסך של המכשיר (ליניארי או עגול). (I83728)
  • יצרנו הפרדה בין הצבעים של SplitToggleButton לבין הצבעים של ToggleButton על ידי הוספת מחלקה חדשה מסוג SplitToggleButtonColors. (I78bee)

גרסה 1.0.0-alpha13

4 באוקטובר 2023

androidx.wear.compose:compose-material3:1.0.0-alpha13 משוחרר. גרסה 1.0.0-alpha13 מכילה את התחייבויות אלה.

שינויים ב-API

  • הוספנו שדה 'כתוביות' אופציונלי ל-TitleCard. (Ifc45a)
  • הוספנו אסימונים צבעוניים של Material Design עבור TextButton. (I769dc)

גרסה 1.0.0-alpha12

20 בספטמבר 2023

androidx.wear.compose:compose-material3:1.0.0-alpha12 משוחרר. גרסה 1.0.0-alpha12 מכילה את התחייבויות אלה.

שינויים ב-API

  • עדכנו את IconButton כך שישתמשו באסימונים של עיצוב Material Design. (I3f137)
  • עדכנו את IconToggleButton כך שישתמשו באסימונים של עיצוב Material Design. (I7d263)
  • הפכנו לציבור את הבנאים של CheckboxColors, RadioButtonColors, SwitchColors. (I82b73)

גרסה 1.0.0-alpha11

6 בספטמבר 2023

androidx.wear.compose:compose-material3:1.0.0-alpha11 משוחרר. גרסה 1.0.0-alpha11 מכילה את התחייבויות אלה.

תיקוני באגים

  • עדכנו את הטיפוגרפיה של כרטיסים של Material3 ל-TitleMedium. (I597bd)
  • עדכנו את הטיפוגרפיה ואת ההתאמה ל-Material3 ListHeader ו-ListSubheader. (Ib5ceb)

גרסה 1.0.0-alpha10

23 באוגוסט 2023

androidx.wear.compose:compose-material3:1.0.0-alpha10 משוחרר. גרסה 1.0.0-alpha10 מכילה את התחייבויות אלה.

תכונות חדשות

  • הוספת HorizontalPageIndicator בספרייה של Wear Material3. (Ifee99)

שינויים ב-API

  • עדכון קוד הלחצנים כדי להשתמש באסימוני עיצוב של Material3. (I92fe4)
  • אנחנו מצהירים על ממשקי ה-API של Wear Material 3 Stepper ו-Slider כניסיוניים כשהפרטים של ממשק המשתמש עדיין נמצאים בשלבי סיום. (I84d54)
  • הסרנו את המידות של ExtraSmall מהעיגולים TextButton ולTextToggleButton כי הגודל הזה רלוונטי רק למידות IconButton. (Ibc7d5)

תיקוני באגים

  • עדכנו את ההנחיות לגבי הטיפוגרפיה עבור TextToggleButton לשימוש ב-LabelL for LargeButtonSize (Ib10fa)
  • עדכנו את ההנחיות לגבי הטיפוגרפיה עבור TextButton לשימוש ב-LabelL for LargeButtonSize (I8f3a7)
  • הגדרנו את יעד המגע המינימלי של הכרטיס כ-48dp לנגישות. (Ieb9b1)
  • הוספת AppCard עם הדגמת תמונה, על ידי הסרת AppCard עם הדגמת רקע (Id735f)
  • תיקון באג בלחצנים עגולים שבהם תנאי הצירוף לא קושרו בצורה נכונה. (I5e162)

גרסה 1.0.0-alpha09

9 באוגוסט 2023

androidx.wear.compose:compose-material3:1.0.0-alpha09 משוחרר. גרסה 1.0.0-alpha09 מכילה את התחייבויות אלה.

תכונות חדשות

  • הוספנו את המאפיין ToggleButton עבור content3 (I6bed6)

שינויים ב-API

  • הפעלנו את ההערה FloatRange בתור אילוצי API , שצוינו בעבר בתגובות. (Icb401)
  • עדכנו את הטיפוגרפיה של Wear Material3 בהתאם להנחיות האחרונות בנושא Material3. (I1bad6)

תיקוני באגים

  • עדכנו את הצבעים של Button, IconButton ו-TextButton בהתאם לעיצוב Material3. (Ib2495)
  • תיקנו את אפשרות החשיפה של סימני הסימון בתיבות סימון במצבים מושבתים. (Ib25bf)

גרסה 1.0.0-alpha08

26 ביולי 2023

androidx.wear.compose:compose-material3:1.0.0-alpha08 משוחרר. גרסה 1.0.0-alpha08 מכילה את התחייבויות אלה.

תכונות חדשות

  • הוספנו את פקדי הבחירה הבאים עבור Material3 – Switch, Checkbox, RadioButton. (Ib918c)
  • הוספנו את IconToggleButton ו-TextToggleButton ל-Material3, לחצן מתג עגול עם חריץ יחיד לסמל ולטקסט בהתאמה. למידות שונות של ToggleButton, מומלץ להשתמש במאפיין Modifier.touchTargetAwareSize עם המידות שמופיעות בלחצני החלפת המצב המתאימים. (I9f015)
  • הוספנו את ListHeader ואת ListSubheader לרכיבי Material3. (איביפה)
  • הוספנו את Material3 SwipeToDismissBox, שקוראת ל-בסיסי SwipeToDismissBox החדש ומספק ערכי ברירת מחדל של צבעים מהעיצוב. (I275fb)
  • הוספנו את Material3 InlineSlider ל-Wear Compose. הם מאפשרים למשתמשים לבחור מתוך מגוון ערכים. טווח הבחירה מוצג כעמודה בין ערכי המינימום והמקסימום של הטווח, מתוכו משתמשים יכולים לבחור ערך יחיד. InlineSlider אידיאלי להתאמת הגדרות כמו עוצמת הקול או הבהירות. (I7085f)

שינויים ב-API

  • עדכנו את הצורות בעיצוב של Wear Material 3 ועכשיו הן מבוססות על RoundedCornerShape במקום על shape. (Idb133)
  • הפכנו את קבועי הגובה של לחצן כציבוריים (Idbfde)
  • קובצי API מעודכנים כדי להוסיף הערות על ביטול תאימות (I8e87a, b/287516207)
  • עדכנו את InlineSliderColors ב-Wear Compose Material 3 כך שיהיו בו נכסים ציבוריים ונכסים ציבוריים. (I6b632)
  • עדכנו את כל סיווגי הצבעים ב'חומר הלימוד של Wear Compose' כך שיהיו בהם בנאים ציבוריים ונכסים ציבוריים. (I17702)
  • הפכנו את קבועי המרווח הפנימי האופקי והאנכי של הלחצן כציבוריים. (Ieeaf7)

תיקוני באגים

  • הלחצן יכוונן עכשיו את הגובה שלו כך שיתאים לתוכן שגדל בגלל גופנים גדולים של נגישות, כשנדרש (Iaf302)
  • עדכנו כמה הדגמות של לחצנים כדי לפתור בעיות נגישות. (I61ce9)
  • Stepper ו-InlineSlider תומכים עכשיו בקליקים חוזרים בלחיצה ארוכה, כך שאפשר להגדיל או להקטין במהירות את הערך של Stepper ושל InlineSlider על ידי לחיצה על הלחצנים + או - (I27359)

גרסה 1.0.0-alpha07

21 ביוני 2023

androidx.wear.compose:compose-material3:1.0.0-alpha07 משוחרר. גרסה 1.0.0-alpha07 מכילה את התחייבויות אלה.

תכונות חדשות

  • הוספנו את הרכיב Stepper לספרייה שלנו לכתיבה עבור Wear OS Material 3. הגרסה הזו דומה לגרסה הקודמת של Material, אבל היא לא סובלת מהסמנטיקה של הטווח כברירת מחדל, בעקבות משוב מהמפתחים. אנחנו מספקים Modifier.rangeSemantics מקרים שבהם נדרשת סמנטיקה של טווח. (Ic39fd)
  • הוספנו את curvedText לספרייה שלנו לכתיבה עבור Wear OS Material 3. (Ia8ae3)

תיקוני באגים

  • העדכון של wear.compose.foundation הוגדר כתלות ב-API של wear.compose.material3 (I72004, b/285404743)

גרסה 1.0.0-alpha06

7 ביוני 2023

androidx.wear.compose:compose-material3:1.0.0-alpha06 משוחרר. גרסה 1.0.0-alpha06 מכילה את התחייבויות אלה.

תיקוני באגים

  • עדכנו את TextButton כך שישתמש בפונקציית התוסף toDisabledColor לקביעת ערכי אלפא שהושבתו בצורה נכונה. (I814c8)

גרסה 1.0.0-alpha05

24 במאי 2023

androidx.wear.compose:compose-material3:1.0.0-alpha05 משוחרר. גרסה 1.0.0-alpha05 מכילה את התחייבויות אלה.

תכונות חדשות

  • הוספנו את TextButton ל-Material3, לחצן עגול עם חריץ יחיד לטקסט. לגדלים שונים של TextButton, מומלץ להשתמש ב-Modifier.touchTargetAwareSize וב-ExtraSmallButtonSize, SmallButtonSize, DefaultButtonSize ו-LargeButtonSizeIcon שסופקו ב-TextButtonDefaults. כברירת המחדל, TextButton, ללא גבול ורקע שקוף לפעולות עם הדגשה נמוכה. לפעולות שדורשות הדגשה גבוהה, יש להשתמש ב-filledTextButtonColors. לצורך הדגשה בינונית, קווית TextButton, הגדירו את הגבול ל-ButtonDefaults.outlinedButtonBorder; לשטח אמצעי בין קווי אורך ורוחב, יש להשתמש ב-filledTonalTextButtonColors. (I667e4)
  • הוספנו את Card, OutlinedCard, AppCard ואת TitleCard לספרייה של Wear Compose Material3. אפשר גם לתת ל-AppCard ול-TitleCard את המראה עם קווי מתאר באמצעות CardDefaults.outlinedCardColors ו-CardDefaults.outlinedCardBorder(I80e72)

שינויים ב-API

  • העברנו את הפרמטר של תווית הלחצן לסוף כדי לתמוך בתחביר lambda בסוף, והסרנו את פרמטר התפקיד (מכיוון שאפשר לשנות את ההגדרה הזו באמצעות Modifier.semantics). הבנאים של ButtonColors הופכים עכשיו לציבוריים. (Ie1b6d)

גרסה 1.0.0-alpha04

10 במאי 2023

androidx.wear.compose:compose-material3:1.0.0-alpha04 משוחרר. גרסה 1.0.0-alpha04 מכילה את התחייבויות אלה.

תכונות חדשות

  • הוספנו את IconButton ל-Material3, לחצן עגול עם מיקום יחיד לסמל/תמונה. קיימות ארבע וריאציות: IconButton, FilledIconButton, FilledTonalIconButton ו-OutlinedIconButton. לגדלים שונים של IconButton, מומלץ להשתמש ב-Modifier.touchTargetAwareSize וב-ExtraSmallButtonSize, SmallButtonSize, DefaultButtonSize ו-LargeButtonSizeIcon שסופקו ב-IconButtonDefaults. אנחנו מספקים גם IconButtonDefaults.iconSizeFor כדי לקבוע את גודל הסמל המומלץ עבור גודל לחצן נתון. (I721d4)

גרסה 1.0.0-alpha03

19 באפריל 2023

androidx.wear.compose:compose-material3:1.0.0-alpha03 משוחרר. גרסה 1.0.0-alpha03 מכילה את התחייבויות אלה.

שינויים ב-API

  • הוספנו את רכיב Material 3 – הלחצן הזה בצורת אצטדיון ונקרא בעבר צ'יפ בספריית Material Compose (חומר שנקרא 'לחצן' כדי לשמור על עקביות עם הספרייה Material 3). לחצן ברירת המחדל הוא רקע מלא ויש וריאציות ללחצנים הבאים: FilledTonal (רקע מושתק), עם קווי מתאר (שקוף עם מסגרת דקה) וסימן צאצא (רקע שקוף וללא שוליים), המשמשים לפעולות משלימות עם מידת הבולטוּת הנמוכה ביותר. לחצנים עגולים לתוכן פשוט של סמל וטקסט יופיעו בגרסה עתידית.(Ia6942)

גרסה 1.0.0-alpha02

5 באפריל 2023

androidx.wear.compose:compose-material3:1.0.0-alpha02 משוחרר. גרסה 1.0.0-alpha02 מכילה את התחייבויות אלה.

תיקוני באגים

  • הוספנו DefaultTextStyle ל-Wear Compose Material 3, שמגדיר PlatformTextStyle.includeFontPadding כ-true (ההגדרה הנוכחית) כברירת מחדל. כך נוכל לסנכרן את השבתת המרווח הפנימי של הגופן כברירת מחדל עם ספריות הכתיבה (מידע נוסף זמין במאמר תיקון מרווח פנימי של גופנים בכתיבה ברקע). (I7e461)

גרסה 1.0.0-alpha01

22 במרץ 2023

androidx.wear.compose:compose-material3:1.0.0-alpha01 משוחרר. גרסה 1.0.0-alpha01 מכילה את התחייבויות אלה.

תכונות חדשות

  • Material 3 הוא הפיתוח הבא של Material Design, והוא כולל עיצוב עיצוב ורכיבים מעודכנים. 'חומר לימוד' 3 ב-Wear Compose נועד להיות אחיד עם ספריית Material 3 Compose ב-Android. גרסת האלפא הראשונה הזו כוללת הטמעות פונקציונליות מוקדמות של הרכיבים הבאים:

    • עיצוב חומר - מגדיר את ערכת הצבעים, הטיפוגרפיה והצורות באופן עקבי בין רכיבים בספרייה. העיצוב של Material3 עבר שינוי צבעים שתומכים בניגודיות סבירה. (I84005)
    • טקסט/סמל - אבני בניין לאפליקציות ל-Wear Compose (I8e06a)

  • אנחנו נמשיך לפתח במקביל את Wear Material (androidx.wear.compose:compose-material) ואת Wear Material 3 (androidx.wear.compose:compose-material3). בגרסאות חדשות של חומר 3 יורחבו הווידג'ט שהוגדר כך שיכלול רכיבים מוכרים אחרים מ'פיתוח נייטיב' ל-Wear OS, כמו לחצנים, בוחרים ופסי ההזזה.

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

גרסה 1.4

גרסה 1.4.0-rc01

21 באוגוסט 2024

androidx.wear.compose:compose-*:1.4.0-rc01 משוחרר. גרסה 1.4.0-rc01 מכילה את ההתחייבויות האלה.

  • עדכנו את יחסי התלות של כתיבה ל-1.7.0-rc01 והצמדנו את הניווט ב-Wear Compose ל-androidx.lifecycle 2.8.3

גרסה 1.4.0-beta03

12 ביוני 2024

androidx.wear.compose:compose-*:1.4.0-beta03 משוחרר. גרסה 1.4.0-beta03 כוללת את ההתחייבויות האלה.

תיקוני באגים

  • עדכנו את Modifier.rotaryScrollable כדי להחליף את השימוש ב-'התמקדות' ב-'Target' כדי לשפר את הביצועים. (Id294b)
  • פתרנו בעיה שבה ProgressIndicator חזר על ההודעה שלו במסגרת TalkBack. (I94563)
  • עדכנו את הפרופילים הבסיסיים של הספרייה ב-Wear Compose. (I3cbc3)

גרסה 1.4.0-beta02

29 במאי 2024

androidx.wear.compose:compose-*:1.4.0-beta02 משוחרר. גרסה 1.4.0-beta02 כוללת את ההתחייבויות האלה.

תיקוני באגים

  • הגדלנו את רוחב הגבולות שמועבר לקוראי מסך מטקסט מעוקל כדי לטפל בבעיות בחיתוך (Id865f).
  • הגבלנו את הגבול של HorizontalPageIndicator שהועבר לקוראי מסך – בעבר, המדד הופיע במסך מלא (Id8d7a).

גרסה 1.4.0-beta01

14 במאי 2024

androidx.wear.compose:compose-*:1.4.0-beta01 משוחרר. גרסה 1.4.0-בטא01 מכילה את ההתחייבויות האלה.

בגרסת 1.4-בטא01 של 'כתיבה מהירה' ל-Wear OS, נראה שהגרסה הזו של הספרייה הושלמה ושה-API נעול (אלא אם הוא מסומן כניסיוני). Wear Compose 1.4 כולל את הפונקציונליות החדשה הבאה:

  • הוספנו את Modifier.rotaryScrollable, תכונה חדשה שמחברת בין אירועים עם חוגה לקונטיינרים שאפשר לגלול, ומאפשרת למשתמשים לגלול באמצעות כתר או מסגרת מסתובבת במכשיר Wear OS. בנוסף, ScalingLazyColumn ו-Picker תומכים עכשיו בקלט חוגה כברירת מחדל. משתמשים בפרמטר rotaryScrollableBehavior כדי להגדיר התנהגות גלילה או הצמדה. להתנהגות הצמדה, מומלץ לספק הצמדה (Snap) גם באמצעות הפרמטר flingBehavior לגלילה במגע.
  • עכשיו יש ב-SwipeDismissableNavHost אנימציית כניסה למעברים בתוך האפליקציה.
  • PositionIndicator מוצג עכשיו כברירת מחדל כשמסך מסוים מוצג בפעם הראשונה.
  • SelectableChip ו-SplitSelectableChip נוספו כוריאציה של ToggleChip – כדאי להשתמש בה בשילוב עם RadioButton כדי לספק סמנטיקה שניתן לבחור במקום סמנטיקה ניתנת להחלפת מצב לנגישות
  • ב-ListHeader יש עכשיו תמיכה בהתאמות גובה כשהתוכן זקוק לגובה נוסף כדי להתאים לגופנים גדולים.

תיקוני באגים

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

גרסה 1.4.0-alpha08

1 במאי 2024

androidx.wear.compose:compose-*:1.4.0-alpha08 משוחרר. גרסה 1.4.0-alpha08 מכילה את התחייבויות אלה.

שינויים ב-API

  • ביצענו את השינויים הבאים ב-Rotary API החדש: השם של Modifier.rotary שונה ל-Modifier.rotaryScrollable; שינה את השם של הממשק RotaryBehavior ל-RotaryScrollableBehavior והפונקציה handleScrollEvent ל-performScroll. שינה את השם של RotaryScrollableAdapter לשם RotaryScrollableLayoutInfoProvider והסיר את הנכס scrollableState. (I0c8a6)
  • ביצענו שינויים נוספים ב-Rotary API: לשנות את השם של RotaryScrollableLayoutInfoProvider ל-RotarySnapLayoutInfoProvider (כי הספק הזה נדרש רק לחוגה עם Snap). שינינו את סוג הפרמטר snapOffset ב-RotaryScrollableDefaults.snapBehavior snapOffset מ-Int ל-Dp. (Iddebe)
  • שינינו את השם של הפרמטר clickInteractionSource ב-SplitSelectableChip ל-containerInteractionSource. (Ia8f84)
  • עדכנו את שמות הפרמטרים של קריאה חוזרת לקליק עבור SplitSelectableChip – מ-onClick ל-onSelectionClick ומ-onBodyClick ל-onContainerClick. (I32237)

תיקוני באגים

  • עדכנו את המרווח הפנימי האופקי של PositionIndicator ל-2dp (היה 5dp), כדי לתקן באג שבו PositionIndicator (סרגל הגלילה) חופף לתוכן שאפשר לגלול. חשוב לדעת: השינוי הזה צפוי לגרום לשיבושים בצילומי המסך הקיימים שכוללים את PositionIndicator, בגלל השינוי במרווח הפנימי. (I57472)
  • שיפרנו את התיעוד של ה-API החוגה החדש על ידי תיאור ההבדלים בין מכשירים עם חוגה ברזולוציה נמוכה וברזולוציה גבוהה. (I63abe)
  • טיפלנו בחריגה מחוץ לטווח ב-SwipeDismissableNavHost שעלולה להיות מופעלת כאשר ערכי האלפא האינטרפולטיביים היו נמוכים מאפס. (Ib75a1, b/335782510)

גרסה 1.4.0-alpha07

17 באפריל 2024

androidx.wear.compose:compose-*:1.4.0-alpha07 משוחרר. גרסה 1.4.0-alpha07 מכילה את התחייבויות אלה.

שינויים ב-API

  • הוספנו את Modifier.rotary, תכונה חדשה שמחברת בין אירועים עם חוגה לקונטיינרים שאפשר לגלול, ומאפשרת למשתמשים לגלול באמצעות כתר או מסגרת מסתובבת במכשיר Wear OS. בנוסף, ScalingLazyColumn ו- Picker תומכים עכשיו בקלט חוגה כברירת מחדל, עם עומסי יתר חדשים שכוללים את הפרמטר rotaryBehavior לציון ההגדרה של גלילה או הצמדה. אם הפרמטר rotaryBehavior מוגדר להצמדה (Snap), מומלץ לספק הצמדה גם דרך הפרמטר flingBehavior, לגלילה במגע. (I2ef6f)
  • NestedScroll מקורות 'גרירה והיפוך' מוחלפים ב-UserInput וב-SideEffect כדי להתאים להגדרה המורחבת של המקורות האלה, שכוללים עכשיו אנימציות (אפקט צד) וגלגל העכבר ומקלדת (קלט משתמש). I40579
  • הוספנו את SelectableChip ואת SplitSelectableChip כדי שיהיה ברור יותר בין לחצני החלפת מצב כמו Switch/Checkbox לבין פקדים לבחירה כמו RadioButton. הפעולה הזו מחליפה את עומסי-היתר שנוספו קודם לכן של ToggleChip/SplitToggleChip בפרמטרים של selectionControl. (Ia0217)
  • ההגדרה לשינוי סטטוס החשיפה של IndeterminateStrokeWidth ב-ProgressIndicatorDefaults עודכנה ל'גלוי לכולם'. (I5b5a4)

גרסה 1.4.0-alpha06

3 באפריל 2024

androidx.wear.compose:compose-*:1.4.0-alpha06 משוחרר. גרסה 1.4.0-alpha06 מכילה את התחייבויות אלה.

תיקוני באגים

  • הוספנו טיוטה פנימית של תמיכה בחוגה, כחלק מהמאמץ הרחב של העברת ההתנהגות של Rotary מ-Horology ל-AndroidX. (I617d1)
  • הוספנו טיוטה פנימית של תמיכה במשוב הפיזי, כחלק מהמאמץ הרחב של העברת ההתנהגות של Rotary מ-Horology ל-AndroidX. (I5568a)

גרסה 1.4.0-alpha05

20 במרץ 2024

androidx.wear.compose:compose-*:1.4.0-alpha05 משוחרר. גרסה 1.4.0-alpha05 מכילה את התחייבויות אלה.

שינויים ב-API

  • הפכנו את הנכסים initialCenterItemIndex ו-initialCenterItemScrollOffset של ScalingLazyListState לציבוריים. (I0c616)
  • הפכנו את FullScreenStrokeWidth של ProgressIndicatorDefaults לציבורי. (Ibea23)

תיקוני באגים

  • שיפרנו את הביצועים של PositionIndicator על ידי הקטנת מספר השיחות ל-layoutInfo מ-ScalingLazyColumn. (Idc83d)

גרסה 1.4.0-alpha04

6 במרץ 2024

androidx.wear.compose:compose-*:1.4.0-alpha04 משוחרר. גרסה 1.4.0-alpha04 מכילה את התחייבויות אלה.

שינויים ב-API

  • הוספנו עומס יתר חדש עבור ToggleChip ו-SplitToggleChip, שמקבל את הפרמטר selectionControl במקום את הפרמטר toggleControl. כדאי להשתמש באפשרות הזו בשילוב עם הפקד RadioButton כדי לספק סמנטיקה שניתן לבחור במקום סמנטיקה ניתנת לבחירה לגבי נגישות (I1d6d9)
  • עדכנו את שמות הפרמטרים של עומס היתר החדש של selectionControl מ-onSelected ל-onSelect עבור ToggleChip ו-SplitToggleChip (I1a971)

גרסה 1.4.0-alpha03

21 בפברואר 2024

androidx.wear.compose:compose-*:1.4.0-alpha03 משוחרר. גרסה 1.4.0-alpha03 מכילה את התחייבויות אלה.

שינויים ב-API

  • ה-wrapper של Modifier.inspectable הוצא משימוש. ה-API הזה יגרום ליותר פסילות של השינוי שלך מהצורך, ולכן לא מומלץ להשתמש בו עכשיו. אנחנו ממליצים למפתחים להטמיע את השיטה inspectableProperties() ב-ModifierNodeElement אם הם רוצים לחשוף מאפייני התאמה לכלים. (Ib3236)

תיקוני באגים

  • תיקנו באג בתיעוד של WearPreview* הערות. (Id526d)

גרסה 1.4.0-alpha02

7 בפברואר 2024

androidx.wear.compose:compose-*:1.4.0-alpha02 משוחרר. גרסה 1.4.0-alpha02 מכילה את התחייבויות אלה.

תיקוני באגים

  • תיקנו באג בהחלקה לצורך חשיפה, כך שאפשר היה לבצע אינטראקציה עם פריט אחד (ולבטל) פעולה שהושלמה על ידי התחלת החלקה של פריט אחר.(Ide059)
  • עדכנו את השדה ListHeader כדי לתמוך בשינויי גובה במקרים שבהם נדרש שינוי לגובה של התוכן כדי להתאים לגופנים גדולים. (I7290c, b/251166127)

גרסה 1.4.0-alpha01

24 בינואר 2024

androidx.wear.compose:compose-*:1.4.0-alpha01 משוחרר. גרסה 1.4.0-alpha01 מכילה את התחייבויות אלה.

תכונות חדשות

  • הוספנו אנימציית רשומה ל-SwipeDismissableNavHost עבור מעברים בתוך האפליקציה.(cfeb79a)
  • PositionIndicator מוצג עכשיו כברירת מחדל כשמסך מסוים מוצג בפעם הראשונה. הטמענו את השינוי הזה כדי לעזור לכם לעמוד בהנחיות האיכות של Wear. לצערנו, יהיה צורך לעדכן בדיקות של צילומי מסך במסכים שכוללים את PositionIndicator, כי ה-PositionIndicator לא היה מוצג בעבר. (419cef7)

שינויים ב-API

  • הוספנו ממשק API חדש של Ripple API בספריות wear:compose-material ו-wear:compose-material3, שמחליף את rememberRipple שהוצא משימוש. בנוסף, מתווסף CompositionLocal, LocalUseFallbackRippleImplementation זמני, כדי להחזיר רכיבי Material לשימוש בממשקי ה-API של rememberRipple/RippleTheme שהוצאו משימוש. האפשרות הזו תוסר בגרסה היציבה הבאה, והיא נועדה לשמש רק כאמצעי עזר זמני להעברה במקרים שבהם בחרת לספק RippleTheme בהתאמה אישית. בכתובתdeveloper.android.com אפשר למצוא מידע על העברה ומידע נוסף על הסיבה לשינוי. (af92b21)
  • עדכנו את ColorScheme כך שלא יהיה ניתן לשנות את ההגדרות שלו, כך שעדכוני צבעים נפרדים יהיו פחות יעילים, אבל תייעל את השימוש בצבעים. הסיבה לשינוי הזה היא שברוב האפליקציות לא יהיה עדכון של צבעים ספציפיים כתרחיש לדוגמה העיקרי. זה עדיין אפשרי, אבל הוא יבנה מחדש את הנתונים מבעבר, וכתוצאה מכך נצמצם משמעותית את מספר המינויים לפי מדינות דרך כל הקוד המהותי, מה שישפיע על האתחול ועל עלות זמן הריצה של תרחישים יותר רגילים לדוגמה. (f5c48b7)
  • רכיבי Wear מהותי (חומר) של Wear ורכיבי Wear שחושפים MutableInteractionSource ב-API שלהם עודכנו, ועכשיו הם כוללים MutableInteractionSource ערך ריק (null) שמוגדר כברירת מחדל כ-null. אין כאן שינויים סמנטיים: העברת ערך null פירושה שלא רוצים להניף את ה-MutableInteractionSource, והוא ייווצר בתוך הרכיב במקרה הצורך. שינוי ל-null מאפשר לרכיבים מסוימים לא להקצות אף פעם MutableInteractionSource, ומאפשר לרכיבים אחרים ליצור מכונה באופן מדורג רק כשהם צריכים. פעולה זו משפרת את הביצועים ברכיבים האלה. אם אתם לא משתמשים בMutableInteractionSource שאתם מעבירים לרכיבים האלה, מומלץ להעביר במקום זאת ערך null. מומלץ גם לבצע שינויים דומים ברכיבים שלכם. (f8fa920)
  • עדכנו את rememberExpandableState כדי לשמור מצב מתרחב. כך תבטיחו שהנתונים יאוחסנו כשמנווטים למסך אחר וישוחזרו כשתחזרו למסך המקורי. (5c80095)

תיקוני באגים

  • עדכנו את ההגדרה ReduceMotion לשימוש ב-listener המודע למחזור החיים. (7c6b122)
  • עדכנו את ה-Listener של TouchExplorationStateProvider כך שיהיה מודע למחזור החיים (be28b01)
  • הסרנו את שכבת ה-Materialcore של CompactButton כדי לשפר את הביצועים (25db8e9)
  • שינינו את BasicSwipeToDismissBox מהקיזוזים של NaN כדי למנוע חריגים (b983739)
  • עדכנו את BasicSwipeToDismissBox כדי לוודא שערכי האלפא נמצאים בטווח 0,1
  • תיקנו באג ב-ToggleButton, ב-SplitToggleButton, ב-Checkbox, ב-Switch וב-RadioButton כך שהודעות בנושא נגישות לא יחזרו על עצמן (בעבר, התפקידים הסמנטיים שוכפלו) (d11eeb7)

גרסה 1.3

גרסה 1.3.1

3 באפריל 2024

androidx.wear.compose:compose-*:1.3.1 משוחרר. גרסה 1.3.1 כוללת את ההתחייבויות האלה.

תיקוני באגים

  • תיקנו באג בהחלקה לצורך חשיפה, כך שאפשר היה ליצור אינטראקציה עם (ולבטל) פעולה שחויבה על פריט אחד על ידי התחלת החלקה של פריט אחר. (Ide059)

גרסה 1.3.0

24 בינואר 2024

androidx.wear.compose:compose-*:1.3.0 משוחרר. גרסה 1.3.0 כוללת את ההתחייבויות האלה.

שינויים חשובים מאז 1.2.0

  • המחלקה SwipeToDismissBoxState, ספירת SwipeToDismissValue והפונקציה Modifier.edgeSwipeToDismiss של התוסף הן עכשיו כל חלק של החבילה androidx.wear.compose.foundation, במקום החבילה androidx.wear.compose.material. הארכיטקטורה המעודכנת הזו מאפשרת לכם ליישם טיפול באמצעות תנועות באופן עצמאי משיקולים אחרים בעיצוב. תהליכי עבודה של עיצוב Material Design, כמו שימוש בצבעים מעיצוב שהוגדר, מטופלים בנפרד.
  • הכיתות SwipeToRevealCard ו-SwipeToRevealChip עוזרות לכם להטמיע את recommended swipe-to-reveal guidance. הכיתה SwipeToRevealSample מדגימה איך להשתמש ברכיבים האלה.

  • בגרסת 1.3.0-alpha02 שלנו נוסף שינוי שגורם להגדלה לגובה של אובייקטים של Chip ו-ToggleChip כדי לתמוך טוב יותר בשינוי גודל הגופנים שנבחר על ידי המשתמש. כתוצאה מכך, עלולות להיווצר קטעי חיתוך. כדי לפתור את הבעיה, הצורה large של MaterialTheme משתמשת ברדיוס פינה גדול יותר (26dp במקום 24dp). אובייקטים מסוג Chip ו-ToggleChip משתמשים ברדיוס הפינות החדש הזה כדי למנוע חיתוך תוכן בפינות של צ'יפ ו-ToggleChip.

    • רוב Chips ו-ToggleChips לא השתנו, בהינתן גובה ברירת המחדל שלהם: 52 dp. עם זאת, אובייקטים מסוג Chip ו-ToggleChip שמכילים מספר שורות של טקסט של תווית ראשית או משנית, או שהגובה שלהם שונה, עלולים לגרום לשיבושים בבדיקות המסך.

שינויים נוספים

כדי לקבל מידע מקיף יותר על השינויים שהושקו בגרסה 1.3.0, אפשר לעיין בנתוני הגרסה של בטא01.

המלצות להטמעה

  • אם האפליקציה מאפשרת למשתמשים לנוע על פני התוכן במסך, למשל באפליקציה מבוססת-מפה, כדי להשבית את הטיפול בהחלקה על ידי הגדרה של userSwipeEnabled לערך false בתוכן הקומפוזבילי SwipeDismissableNavHost, ולכלול לחצן שמאפשר למשתמשים לעבור למסך הקודם.
  • כדי להשבית אנימציות של אינדיקטור מיקום במהלך אנימציות של מעבר הדרגתי ושינוי מיקום ברשימה של גלילה, משתמשים באובייקט SnapSpec.
  • בזמן שאפליקציית מדיה תטען תוכן להפעלה, צריך להציג תוכן קומפוזבילי ריק Placeholder.
  • כדי ליצור אוסף של פריטים שניתנים להרחבה על פי דרישה, כדאי להשתמש במחלקה ExpandableStateMapping הניסיונית.

גרסה 1.3.0-rc01

10 בינואר 2024

androidx.wear.compose:compose-*:1.3.0-rc01 משוחרר. גרסה 1.3.0-rc01 מכילה את ההתחייבויות האלה.

תיקוני באגים

  • עדכנו את הצורה הגדולה MaterialTheme לרדיוס פינה מעוגל של 26dp, והיא תשמש עכשיו את צ'יפ ואת ToggleChip. השינוי הזה נדרש כדי לתמוך בהתאמות גובה כשבתוכן נדרש גובה נוסף כדי להתאים לגופנים גדולים. אחרת, המבנה הקיים מחלק חלק מתוכן הטקסט.

    הטקסט נחתך בפינות
    איור 1: הטקסט נחתך בפינות.
    הטקסט לא נחתך
    איור 2: הטקסט לא נחתך.

    השינוי הזה עלול לגרום לשיבושים בבדיקות של צילומי המסך. (I2e6ae)

גרסה 1.3.0-beta02

13 בדצמבר 2023

androidx.wear.compose:compose-*:1.3.0-beta02 משוחרר. גרסה 1.3.0-beta02 מכילה את התחייבויות אלה.

תיקוני באגים

  • שחזרנו את תנועת ההחלקה הרצויה בBasicSwipeToDismissBox. זה השתנה בגרסה קודמת, כך שהחלק של השקף במעבר התרחש בזמן שהאצבע נגעה במסך. (Id8e76)

גרסה 1.3.0-beta01

15 בנובמבר 2023

androidx.wear.compose:compose-*:1.3.0-beta01 משוחרר. גרסה 1.3.0-beta01 מכילה את התחייבויות אלה.

לפי גרסת 1.3-בטא01 של 'כתיבה מהירה' ל-Wear OS, הגרסה הזו של הספרייה הושלמה ושה-API נעול (אלא אם הוא סומן כניסיוני). Wear Compose 1.3 כולל את הפונקציונליות החדשה הבאה:

  • SwipeToDismissBoxState, SwipeToDismissValue ו-Modifier.edgeSwipeToDismiss הועברו מ-androidx.wear.compose.material ל-androidx.wear.compose.foundation, יחד עם ההטמעה הבסיסית של החלקה לסגירה ב-BasicSwipeToDismissBox. כך ניתן להשתמש בטיפול באמצעות תנועות של החלקה לסגירה בנפרד מהעיצוב מהותי, למשל, מ-SwipeDismissableNavHost ב-androidx.wear.compose.navigation. עדיין מומלץ להשתמש ב-SwipeToDismissBox מ-androidx.wear.compose.material עם Material Design, כי הוא שולף צבעים מה-MaterialTheme ואז מקצה את שאר ההטמעה ל-BasicSwipeToDismissBox.
  • ב-SwipeDismissableNavHost יש עכשיו תמיכה בפרמטר userSwipeEnabled חדש, כדי שאפשר יהיה להשבית את הטיפול בהחלקה במסכים שבהם הוא לא נדרש.
  • BasicSwipeToDismissBox שופר טיפול ממוקד באמצעות HierarchicalFocusCoordinator.
  • ב-SwipeToReveal יש תכנים קומפוזביליים חדשים של SwipeToRevealCard ו-SwipeToRevealChip ב'חומר' שעומדים בהנחיות המומלצות לגבי חוויית המשתמש ב-Card וב-Chip. הוא גם כולל ביטול תמיכה בפעולה המשנית.
  • המרווח הפנימי של הגופן מושבת עכשיו ב-DefaultTextStyle כדי לשמור על עקביות בפלטפורמת Android.
  • Chip ו-ToggleChip כווננו עכשיו את הגובה שלהם כדי להתאים לתוכן שגדל בגלל גופנים גדולים של נגישות
  • ב-PositionIndicator יש עכשיו מפרטים נפרדים של אנימציה עבור אנימציות עמעום, יציאה הדרגתי ושינוי מיקום. מסיבות שקשורות לביצועים, מומלץ להשבית את האפשרויות 'העמעום' ו'שינוי המיקום' בשימוש עם רשימות גלילה.
  • ExpandableStateMapping מספק דרך חדשה לייצר ExpandableStates כאשר צריך ליצור אותם על פי דרישה, ולא בהכרח עם היקף הרשאות @Composable.
  • ב-Placeholder אפשר עכשיו לאפס אם התוכן כבר לא במצב מוכן. בנוסף, הגדרת הפחתת התנועה חלה עכשיו על אפקט הניצוץ ותנועת האיפוס במכשיר Placeholder.

בעיות מוכרות

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

שינויים ב-API

  • שינינו את השם של רמת הבסיס SwipeToDismissBox לשם BasicSwipeToDismissBox. כך ההבחנה ברורה יותר בין הרכיב ברמת הבסיס לבין רמת החומר SwipeToDismissBox. הכלי הזה שולף צבעים מ-MaterialTheme כדי להשתמש בהם ליצור מיפויים ומאציל את ההטמעה הנותרת ל-BasicSwipeToDismissBox. (Ibecfc)
  • סימנו את rememberExpandableStateMapping כניסיוני ושיפרנו את הביצועים של expandableItem. (I5f6bc)
  • החלפנו את המחלקה SwipeToRevealAction בממשקי ה-API של הכרטיסים והצ'יפים ב-Material SwipeToReveal ב-API מבוסס-משבצות באמצעות תכנים קומפוזביליים של SwipeToRevealPrimaryAction, SwipeToRevealSecondaryAction ו-SwipeToRevealUndoAction. קוד לדוגמה כולל דוגמאות לשימוש בממשק ה-API החדש. (Ia8943)
  • החלפנו את דגלי האנימציה PositionIndicator בפרמטרים של AnimationSpec. אפשר להשבית את האנימציות הנפרדות על ידי העברת snap בתור AnimationSpec. I6c523

תיקוני באגים

  • תיקנו באג שהופעל על ידי טקסט מעוקל מוגבל כשהגודל מוגבל (I50efe)
  • טיפלנו בקריסה פוטנציאלית של NaN שקשורה ל-curvedComposable (I970eb)
  • החזרנו את הסרת האנימציה של ההדגשה של שינוי המיקום בתאריך PositionIndicator. (Ieb424)
  • הסרנו את שכבת הליבה של החומר לצ'יפ החומר כדי לשפר את הביצועים שלו. (If2dcb)

גרסה 1.3.0-alpha08

18 באוקטובר 2023

androidx.wear.compose:compose-*:1.3.0-alpha08 משוחרר. גרסה 1.3.0-alpha08 מכילה את התחייבויות אלה.

שינויים ב-API

  • הוספנו דגלים בודדים לעומסי יתר של PositionIndicator, כדי לשלוט באנימציות שונות: showFadeInAnimation, showFadeOutAnimation ו-showPositionAnimation. ה-API הקודם הוצא משימוש ומעביר קריאות לממשק החדש. מטעמי ביצועים ולשמירה על עקביות בחוויית המשתמש, כשמשתמשים ב-PositionIndicator עם רשימה שניתן לגלול, מומלץ להשבית את הדגלים showFadeInAnimation ו-showPositionAnimation. אם PositionIndicator משמש כאינדיקטור עצמאי, למשל לשינוי עוצמת הקול, מומלץ להפעיל את כל 3 האנימציות. (I44294)
  • הוצאנו משימוש את התכנים SwipeToDismissBoxState, SwipeToDismissValue ו-edgeSwipeToDismiss לאחר ההעברה של הפונקציונליות 'החלקה לסגירה' אל wear.compose.foundation. צריך להחליף אותם בwear.compose.foundation המקבילים. (Iee8c9)

תיקוני באגים

  • עדכנו את הפרופילים הבסיסיים של ספריות הרכיבים, החומרים והניווט ב-Wear. (Idb060)
  • שחזרנו שינוי התנהגותי ב-PositionIndicator שנכלל ב-CL הקודם, כך שהאנימציה של PositionIndicator הופעלה כשמסך הוצג לראשונה. אנחנו מתכוונים לבצע שינוי דומה בגרסת אלפא מוקדמת של 1.4, כך ש-PositionIndicator יוצג בהתחלה, אבל ללא אנימציה. (I41843)
  • טיפלנו בכמה בעיות בביצועים ב-PositionIndicator. (I1c654, b/302399827)
  • שיפרנו את הביצועים של הטמעת ברירת המחדל של ספק מצב הגילוי באמצעות מגע, כך שההסתמכות על State<Boolean> במקום על המצב הנגזרת מתבצעת. (Ieec4d)
  • הגדרנו מלבנים מסוג systemGestureExclusion ל-Android מגרסה 13 ואילך. (Ib1f4b)

גרסה 1.3.0-alpha07

4 באוקטובר 2023

androidx.wear.compose:compose-*:1.3.0-alpha07 משוחרר. גרסה 1.3.0-alpha07 מכילה את התחייבויות אלה.

שינויים ב-API

  • הוספנו דגלים נפרדים ל-PositionIndicator כדי לשלוט באנימציות שונות: showFadeInAnimation, showFadeOutAnimation ו-showPositionAnimation. ה-API הקודם הוצא משימוש ומעביר קריאות לממשק החדש. מטעמי ביצועים ולשמירה על עקביות בחוויית המשתמש, כשמשתמשים ב-PositionIndicator עם רשימה שניתן לגלול, מומלץ להשבית את הדגלים showFadeInAnimation ו-showPositionAnimation. אם PositionIndicator משמש כאינדיקטור עצמאי, למשל לשינוי עוצמת הקול, מומלץ להפעיל את כל 3 האנימציות. (Ia2d63)

תיקוני באגים

  • ביצענו שיפורים בהחלקה כדי לחשוף תנועה על ידי הוספת אנימציית עמעום לטקסט של הפעולה הראשית, והדרגתיות של הפעולה המשנית/שינוי קנה המידה של הסמלים בהרחבה מלאה של החלקה. (Ib7223)
  • מומלץ שפעולות 'החלקה להצגה' יהיו נגישות, והוספנו פעולות נגישות מותאמות אישית לדוגמאות של 'החלקה להצגה'. (I42224)
  • שיפרנו את הביצועים של SwipeToDismissBox, כולל ארגון מחדש כדי להבטיח שהלוגיקה הראשונית לא מפעילה הרכבה מחדש. השדה SwipeToDismissBox משורטט עכשיו כגודל המסך המלא. (Ie0aa2)
  • תיקנו באג כשה-PositionIndicator נעלם בטעות. (I2091a)
  • שיפרנו את הביצועים של PositionIndicator על ידי אופטימיזציה של הרכבים מחדש. נוספו לאחר מכן סימונים חדשים לשליטה באנימציות (fadeIn, fadeOut ו-positionChange) (ראו שינויים ב-API) (Ifac7d)
  • הוספנו בדיקות Microbenchmark עבור PositionIndicator (Idf875)

גרסה 1.3.0-alpha06

20 בספטמבר 2023

androidx.wear.compose:compose-*:1.3.0-alpha06 משוחרר. גרסה 1.3.0-alpha06 מכילה את התחייבויות אלה.

תיקוני באגים

  • הוספנו תמיכה בModifier.edgeSwipeToDismiss עם SwipeToReveal. (I95774, b/293444286)
  • הוספנו דוגמאות עבור 'חומר' SwipeToRevealChip ו-SwipeToRevealCard. (Ieb974)
  • עדכנו את הפרופילים הבסיסיים בספריות של Wear Compose Fundamentals ו-Material. (I1dd1f)

גרסה 1.3.0-alpha05

6 בספטמבר 2023

androidx.wear.compose:compose-*:1.3.0-alpha05 משוחרר. גרסה 1.3.0-alpha05 מכילה את התחייבויות אלה.

תיקוני באגים

  • הוספנו טיפול בקטע 'החלקה להצגה' כך שאפשר יהיה להחליק רק פריט אחד בכל פעם. (I3cd7a)
  • שיפרת את התיעוד של ScalingLazyColumnDefaults כדי להתאים טוב יותר את ההתנהגות שלו בפועל. (I886d3)

גרסה 1.3.0-alpha04

23 באוגוסט 2023

androidx.wear.compose:compose-*:1.3.0-alpha04 משוחרר. גרסה 1.3.0-alpha04 מכילה את התחייבויות אלה.

תכונות חדשות

  • הוספנו תמיכה בביטול הפעולה המשנית של SwipeToReveal. (I7a22d)

שינויים ב-API

  • הוספת HorizontalPageIndicator בספרייה של Wear Material3. (Ifee99)
  • הכלים לתצוגה המקדימה של Wear Compose עודכנו לשימוש בספרייה androidx.wear.tooling.preview. (Ib036e)

תיקוני באגים

  • תיקון באג בלחצנים עגולים שבהם תנאי הצירוף לא קושרו בצורה נכונה. (I5e162)

גרסה 1.3.0-alpha03

9 באוגוסט 2023

androidx.wear.compose:compose-*:1.3.0-alpha03 משוחרר. גרסה 1.3.0-alpha03 מכילה את התחייבויות אלה.

שינויים ב-API

  • הוספנו שני תכנים קומפוזביליים חדשים ב-Material להטמעה של SwipeToReveal עם כרטיסים וצ'יפים. התכנים הקומפוזביליים האלה תואמים להנחיות המומלצות לגבי חוויית המשתמש ברכיב, ועוזרים למפתחים להטמיע את SwipeToReveal ברכיבים הקיימים ב-Wear Material. (I7ec65)
  • הפעלנו את ההערות של FloatRange בתור אילוצי API, שצוינו בעבר בתגובות. (Icb401)

תיקוני באגים

  • העברנו את לוגיקת הגלילה הראשונית של ScalingLazyColumn אל onGloballyPositioned(). (Ic90f1)
  • אנחנו משתמשים עכשיו במדד drawWithCache ב-PositionIndicator, ב-ProgressIndicator וב-SelectionControls כדי לבצע אופטימיזציה של הקצאות הקווים. (I5f225, b/288234617)
  • תיקנו את אפשרות החשיפה של סימני הסימון בתיבות סימון במצבים מושבתים. (Ib25bf)
  • עדכנו את Placeholder כך שיאפשר איפוס כך שיציג את ה-placeholder במקרה שהתוכן כבר לא במצב מוכן. (Ibd820)
  • ביצענו כמה תיקונים בבדיקות Placeholder בעייתיות (Idb560)

גרסה 1.3.0-alpha02

26 ביולי 2023

androidx.wear.compose:compose-*:1.3.0-alpha02 משוחרר. גרסה 1.3.0-alpha02 מכילה את התחייבויות אלה.

שינויים ב-API

  • יצרנו את ExpandableStateMapping, דרך חדשה ליצור ExpandableStates במקרים שבהם צריך ליצור אותם על פי דרישה, ולא בהכרח במסגרת היקף של @Composable (Iff9e0)
  • SwipeToDismissBox הועברה מחבילה androidx.wear.compose.material לחבילה androidx.wear.compose.foundation. (I275fb)
  • קובצי API עודכנו כדי להוסיף הערות על ביטול התאימות. (I8e87a, b/287516207)
  • הפכנו את קבועי הגובה של Chip, CompactChip ו-ToggleChip כציבוריים (Idbfde)
  • הפכנו את המרווח הפנימי האופקי והאנכי של Chip ו-CompactChip לגלוי לכולם. (Ieeaf7)
  • נוספה פונקציונליות שמאפשרת להשבית את הטיפול בהחלקה בSwipeDismissableNavHost דרך הפרמטר החדש userSwipeEnabled. (Id2a0b, b/230865655)
  • עדכנו את ספריית הניווט של Wear Compose כדי להשתמש ב-SwipeToDismissBox החדש של Wear Compose Foundation. (I4ff8e)

תיקוני באגים

  • תיקנו באג מסוג z-order שבו התוכן הנכון לא הוצג על ידי expandedItem לאחר לחיצה על התנהגות הלחצן כשהיא מכילה לחצנים. (I1899d, b/289991514)
  • שיפור הטיפול בפוקוס של SwipeToDismissBox (ומכאן גם SwipeDismissableNavHost) באמצעות HierarchicalFocusCoordinator (I45362, b/277852486)
  • תיקנו את אופן הטיפול באמצעות תנועות בSwipeableV2 . (I89737)
  • סיימנו את תהליך ההגדרה הבסיסי של הפרופילים בגרסה 1.2. (Id5740)
  • בעקבות ההעברה של SwipeToDismissBox אל Foundation, ההטמעה של Material SwipeToDismissBox מעבירה עכשיו אל Foundation ומספקת ערכי צבעים שמוגדרים כברירת מחדל מהעיצוב.(If8451)
  • הוספנו סמנטיקה של כותרות אל ListHeader. (Ic5420)
  • Chip ו-ToggleChip יכווננו עכשיו את הגובה שלהם כך שיתאים לתוכן שגדל עקב גופנים גדולים לנגישות, כשיש צורך. (Iaf302)
  • תוקן באג בתפקיד הסמנטי של האזור שאפשר להקיש עליו במכשיר SplitToggleChip, בגלל נגישות. (Ieed3a)
  • ההגדרה של צמצום התנועה משביתה עכשיו את אפקט הנצנוץ ואת תנועת המחיקה ב-placeholders. (I91046)
  • Stepper ו-InlineSlider תומכים עכשיו בקליקים חוזרים בלחיצה ארוכה, כדי שאפשר יהיה להגדיל או להקטין במהירות את הערך של Stepper ושל InlineSlider על ידי לחיצה על הלחצנים + או -. (I27359)

גרסה 1.3.0-alpha01

21 ביוני 2023

androidx.wear.compose:compose-*:1.3.0-alpha01 משוחרר. גרסה 1.3.0-alpha01 מכילה את התחייבויות אלה.

תיקוני באגים

  • כפי שהודענו ב-1.2.0-alpha07 וב-1.2.0-alpha10, אנחנו משנים עכשיו את DefaultTextStyle כדי להשבית את המרווח הפנימי של הגופן כך שיהיה עקבי בכל פלטפורמת Android. הפעולה הזו תטפל במקרים מסוימים של חיתוך טקסט בגופנים גדולים ויכולה להשפיע גם על פריסות המסך, כך שיהיה צורך לעדכן את הבדיקות של צילומי המסך. לדוגמה, אפשר לראות כאן חיתוך טקסט (Ic6a86)
הטקסט נחתך בגופן גדול
איור 1: הטקסט נחתך.
  • הוא לא מופיע יותר כשהמרווח הפנימי של הגופן מושבת:
הטקסט לא נחתך וגופן גדול
איור 2: הטקסט לא נחתך.
  • עדכנו את wear.compose.foundation כך שתהיה תלות ב-API של wear.compose.material (I72004, b/285404743)
  • תיקנו באג ב-SwipeToDismissBox. מפתחות הרקע ומפתחות התוכן מועברים עכשיו לבלוק הזכירה, כדי שייווצרו מגבילים חדשים כשהתוכן או הרקע משתנים. (Ib876c, b/280392104)
  • עדכנו את השפה של TimeText כך שייעשה שימוש במיקום בעת בחירת הפורמט לפרק זמן של 12 או 24 שעות. (If4a3d)
  • תיקנו חוסר עקביות בפרמטרים של ברירת המחדל SwipeToDismissBox contentScrimColor. (I2d70f)
  • שיפרנו את הטיפול בתנועה בSwipeToReveal. (I28fb7)

בעיות מוכרות

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

גרסה 1.2

גרסה 1.2.1

18 באוקטובר 2023

androidx.wear.compose:compose-*:1.2.1 משוחרר. גרסה 1.2.1 כוללת את ההתחייבויות האלה.

תיקוני באגים

  • תוקן באג כשהמאפיין PositionIndicator נעלם בטעות. (7a167f)

גרסה 1.2.0

9 באוגוסט 2023

androidx.wear.compose:compose-*:1.2.0 משוחרר. גרסה 1.2.0 כוללת את ההתחייבויות האלה.

שינויים חשובים מאז 1.1.0

גרסה 1.2.0-rc01

26 ביולי 2023

androidx.wear.compose:compose-*:1.2.0-rc01 משוחרר. גרסה 1.2.0-rc01 מכילה את שמירות האלה.

תיקוני באגים

  • סיימנו את תהליך ההגדרה הבסיסי של הפרופילים בגרסה 1.2 (Id5740)

גרסה 1.2.0-beta02

7 ביוני 2023

androidx.wear.compose:compose-*:1.2.0-beta02 משוחרר. גרסה 1.2.0-beta02 מכילה את התחייבויות אלה.

תכונות חדשות

  • הוספנו את המשתנה הניסיוני LocalReduceMotion CompositionLocal החדש שמשבית את ההתאמה לעומס (scaling) ואת דהייה ב-ScalingLazyColumn. (I58024)

תיקוני באגים

  • עדכנו את הפרופילים הבסיסיים של ספריות החומרים והבסיסים של מוצרי Wear(I4725d)
  • תיקנו חוסר עקביות בערכי ברירת המחדל עבור SwipeToDismissBox פרמטרים מסוג contentScrimColor (I2d70f)
  • תיקנו את ערך ברירת המחדל DefaultTextStyle המשמש עבור ההגדרה IncludeFontPadding (I737ed)

גרסה 1.2.0-beta01

24 במאי 2023

androidx.wear.compose:compose-*:1.2.0-beta01 משוחרר. גרסה 1.2.0-beta01 מכילה את התחייבויות אלה.

מה חדש ב-Composes ב-Wear OS 1.2

לפי גרסת 1.2-בטא01 של 'כתיבה מהירה' ל-Wear OS, הגרסה הזו של הספרייה הושלמה ושה-API נעול (אלא אם הוא סומן כניסיוני). Wear Compose 1.2 כולל את הפונקציונליות החדשה הבאה:

  • expandableItem ו-expandableItems הם שני רכיבי Foundation חדשים שתומכים בהרחבה של פריטים בתוך ScalingLazyColumn. יש להשתמש ב-expandableItem לפריט אחד שניתן להרחבה, כמו 'טקסט' שמכיל את מספר השורות. שימוש במאפיין expandableItems לקבוצה של פריטים שניתנים להרחבה ובמאפיין expandableButton כדי ליצור לחצן שמתכווץ אחרי הרחבת התוכן.
  • HierarchicalFocusCoordinator – התוכן הקומפוזבילי הניסיוני הזה מאפשר לסמן עץ משנה של היצירה כשהמיקוד מופעל או כשהמיקוד מושבת.
  • Picker – ה-API כולל עכשיו את userScrollEnabled כדי לקבוע אם הבורר פעיל לגלילה של משתמשים.
  • PickerGroup – תוכן קומפוזבילי חדש לטיפול בכמה בוררים ביחד. הוא מטפל במיקוד בין הבוררים באמצעות ה-API HierarchicalFocusCoordinator, ומאפשר מרכוז אוטומטי של פריטים בבורר.
  • Placeholder - ביצענו עדכונים באנימציות ובאנימציות 'מחיקה'. אפקט המחיקה מוחל מיד כשהתוכן מוכן.
  • ScalingLazyColumn - העברנו את ScalingLazyColumn ואת הכיתות המשויכות מ-androidx.wear.compose.material.ScalingLazyColumn אל androidx.wear.compose.foundation.lazy.ScalingLazyColumn. כדי להשתמש בגרסה של Foundation.Lazy צריך לעדכן אותה.
  • SwipeToReveal – הוספנו תמיכה ניסיונית בתכונה 'החלקה להצגה' כאמצעי גישה לפעולות משניות, בנוסף לדפוס הקיים של 'לחיצה ארוכה'.
  • Stepper – עכשיו יש עומס יתר עם פרמטר enableRangeSemantics נוסף, כדי להקל על השבתת הסמנטיקה של טווח ברירת המחדל.
  • Previews – הוספנו את ההערות המותאמות אישית הבאות לתצוגה מקדימה של תכנים קומפוזביליים במסכי Wear: האפליקציה WearPreviewSmallRound מציגה את התוכן הקומפוזבילי במכשיר קטן ועגול. התכונה WearPreviewLargeRound מציגה תצוגה מקדימה של התוכן הקומפוזבילי במכשיר עגול גדול. התוכן הקומפוזבילי במכשיר WearPreviewSquare מוצג בתצוגה מקדימה במכשיר ריבועי. בנוסף, ההערות הבאות ותצוגות מקדימות של תצוגה מקדימה: WearPreviewFontScales מציגה תצוגה מקדימה של התכנים הקומפוזביליים במכשיר Wear עם גופנים בגדלים שונים, ואילו WearPreviewDevices מציג תצוגה מקדימה של התכנים הקומפוזביליים במכשירי Wear שונים.
  • הוספנו DefaultTextStyle ל-Wear Compose, שמגדיר את המאפיין PlatformTextStyle.includeFontPadding כ-True (זו ההגדרה הנוכחית) כברירת מחדל. כך נוכל לסנכרן את השבתת המרווח הפנימי של הגופנים כברירת מחדל עם ספריות הכתיבה בגרסת אלפא מוקדמת של 1.3. מידע נוסף זמין בכתובת 1.2.0-alpha10.

תכונות חדשות

  • הוספנו תמיכה ניסיונית באנימציה של שינוי קנה מידה והעמעום, כשמופעלת ההגדרה ההודעהDecrease_motion והם לא מתאימה. (I58024)

תיקוני באגים

  • תיעוד משופר עבור angularWidthDp ב-CurvedSize.kt (Iab75c)
  • SwipeDismissableNavHost מתעדת עכשיו אזהרה עם סיבות אפשריות למקבץ גיבוי ריק. הדבר נעשה כדי למנוע קריסות לא צפויות שנגרמות בגלל השגיאה IllegalArgumentException, שנדחתה כשהמקבץ לאחור היה ריק. (I04a81, b/277700155)

גרסה 1.2.0-alpha10

10 במאי 2023

androidx.wear.compose:compose-*:1.2.0-alpha10 משוחרר. גרסה 1.2.0-alpha10 מכילה את התחייבויות אלה.

תכונות חדשות

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

שינויים ב-API

  • הוספנו את המאפיין RevealScope לתכנים קומפוזביליים של פעולות ב-SwipeToReveal, שנותן גישה לקיזוז שבו פעולות נוספות נחשפו. (I3fd56)

תיקוני באגים

  • תוקנה בעיה ב-ScalingLazyColumn שנתקע ב-Wear API 33 אחרי הנפילה (Ic4599)
  • ביצענו כמה שיפורי ביצועים של PositionIndicator כדי להפחית את ממשק המשתמש. (I35e92)
  • תיקנו באג בצ'יפ וב-CompactChip שבהם התפקיד הסמנטי כבר לא הוגדר כ-Role.Button. (I93f91, b/277326264)

בעיות מוכרות

  • זיהינו באג ב-Android Studio שגורם לכשל בעיבוד התצוגה המקדימה כשמוסיפים הערות עם @WearPreviewdevices ו- @WearPreviewFontScales. בקרוב יתוקן תיקון. חשוב לשים לב שההערות האחרות בתצוגה המקדימה פועלות כמו שצריך ב-Android Studio Giraffe מגרסה 2022.3.1 ואילך.

  • בגרסה 1.2.0-alpha07 הוספנו את DefaultTextStyle ל-Wear Compose, תוך שמירה על הערך הקיים של PlatformTextStyle.includeFontPting כ-true. לרקע, ניתן לעיין במאמר תיקון מרווח פנימי של גופן בכתיבה. אנחנו נשנה את ההגדרה DefaultTextStyle כדי להשבית את המרווח הפנימי של הגופן בגרסת אלפא מוקדמת של 1.3, כדי לשמור על עקביות בפלטפורמת Android. הפעולה הזו תטפל במקרים מסוימים של חיתוך טקסט בגופנים גדולים ויכולה להשפיע גם על פריסות המסך, לכן צריך לעדכן את הבדיקות של צילומי המסך. לדוגמה, בגופנים גדולים יחסית ניתן לראות כאן חיתוך טקסט:

הטקסט נחתך בגופן גדול
איור 1: הטקסט נחתך.
  • הוא לא מופיע יותר כשהמרווח הפנימי של הגופן מושבת:
הטקסט לא נחתך וגופן גדול
איור 2: הטקסט לא נחתך.

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

גרסה 1.2.0-alpha09

19 באפריל 2023

androidx.wear.compose:compose-*:1.2.0-alpha09 משוחרר. גרסה 1.2.0-alpha09 מכילה את התחייבויות אלה.

שינויים ב-API

  • צריך להוסיף את angularSizeDp לממשק ה-API של CurvedModifier להגדרת רוחב זוויתי ב-DP (I89a52)

תיקוני באגים

  • תיקנו בעיות נגישות בהדגמות בכלי לבחירת זמן(Id0eb7)

גרסה 1.2.0-alpha08

5 באפריל 2023

androidx.wear.compose:compose-*:1.2.0-alpha08 משוחרר. גרסה 1.2.0-alpha08 מכילה את התחייבויות אלה.

שינויים ב-API

  • שינינו את השם של ExpandableItemsState לשם ExpandableState. (If85ea)
  • הוספנו את המאפיין expandableButton כדי לפשט את תהליך יצירת לחצן שמתכווץ כאשר התוכן מורחב, וגם עדכנו את דוגמאות ההרחבה. (Iae309)

תיקוני באגים

  • דוגמאות משופרות להרחבה כדי להציג יותר אפשרויות. אנימציה של expandableItem ששונתה כדי שהתוכן שלה יהיה במרכז האנימציה. (I2f637)
  • בוצע עדכון של ToggleControls כדי למנוע הרכבות מחדש במהלך אנימציה ידנית של הצבעים באמצעות State. (I5d319)

גרסה 1.2.0-alpha07

22 במרץ 2023

androidx.wear.compose:compose-*:1.2.0-alpha07 משוחרר. גרסה 1.2.0-alpha07 מכילה את התחייבויות אלה.

שינויים ב-API

  • העברנו את רכיבי הפריט הניתן להרחבה (שנוספו בגרסה 1.2.0-alpha06) מחומר לבסיסי, כי לא הייתה להם הפניה משמעותית אל MaterialTheme. (Ib0525)

תיקוני באגים

  • תיקנו קריסה שאירעה במסך באמצעות PickerGroup. לשם כך, צריך לוודא שהמיקוד של PickerGroup מתבצע כמו שצריך כשאין בורר ממוקד. הוספנו גם תמיכה בגלילה ב-RSB בהדגמות של הבורר. (If8c19)
  • שיפרנו את המעברים בין תיבות הדו-שיח – עכשיו המעבר של המבוא חלק יותר כדי להתאים למעבר הסיום. (Ib5af9)
  • הוספנו DefaultTextStyle ל-Wear Compose, שמגדיר את המאפיין PlatformTextStyle.includeFontPadding כ-True (זו ההגדרה הנוכחית) כברירת מחדל. כך נוכל לסנכרן את השבתת המרווח הפנימי של הגופנים כברירת מחדל עם ספריות הכתיבה בעתיד (תיקון מרווח פנימי של גופנים בכתיבה) ברקע. (I2aee8)
  • בוטלה התלות של התצוגה המקדימה של UpsideDownCake באמצעות כתיבת פעילות שחסמה את הפרסום של אפליקציות בחנות Google Play. (I6443d)

גרסה 1.2.0-alpha06

8 במרץ 2023

androidx.wear.compose:compose-*:1.2.0-alpha06 משוחרר. גרסה 1.2.0-alpha06 מכילה את התחייבויות אלה.

שינויים ב-API

  • הוספת רכיב CurvedBox שמציב רכיבים זה על גבי זה בעולם המעוקל. (I29200)
  • נוספו פריטים שניתנים להרחבה - שני רכיבים חדשים שתומכים בקבוצה של פריטים שניתנים להרחבה ב-ScalingLazyColumn או בפריט יחיד שניתן להרחבה, כמו טקסט שבו מספר השורות מתרחב. (I95dd5)
  • הוספנו את ההערות המותאמות אישית הבאות לתצוגה מקדימה של תכנים קומפוזביליים במסכי Wear: ב-WearPreviewSmallRound מוצגת תצוגה מקדימה של התוכן הקומפוזבילי במכשיר קטן ועגול; התוכן הקומפוזבילי במכשיר WearPreviewLargeRound מוצג בתצוגה מקדימה במכשיר עגול גדול. התוכן הקומפוזבילי במכשיר WearPreviewSquare מוצג בתצוגה מקדימה במכשיר ריבועי. בנוסף, ההערות הבאות ותצוגות מקדימות של תצוגה מקדימה: WearPreviewFontScales מציגה תצוגה מקדימה של התכנים הקומפוזביליים במכשיר Wear עם גופנים בגדלים שונים, ואילו WearPreviewDevices מציג תצוגה מקדימה של התכנים הקומפוזביליים במכשירי Wear שונים. כדי להשתמש בתצוגות המקדימות האלה, עליכם להשתמש בגרסה העדכנית ביותר של Android Studio (Giraffe Canary 6) ואילך. לתשומת ליבך: אם ההערות האלה לא מתאימות למטרה שלך, עדיין אפשר יהיה להשתמש בתצוגה המקדימה ותומכת בהתאמה אישית נוספת באמצעות פרמטרים. (I397ff)
  • סימנו את HierarchicalFocusCoordinator כניסוי ניסיוני בזמן שהוא נחשב כמועמד להעברה לספריות ליבה של הרכבים, מאחר שהוא רלוונטי באופן נרחב. (I3a768)

תיקוני באגים

  • תוקן באג ב-HierarchicalFocusCoordinator, כשה-lambda שהועברה לפרמטר focusEnabled השתנה, עכשיו אנחנו משתמשים בפרמטר החדש כמו שצריך. (Icb353)
  • עדכנו את צבע התוכן המושבת שמוגדר כברירת מחדל ל'רקע' כשמשתמשים בצבעי ראשי כרקע בButton, בCompactButton, בChip, בCompactChip ובToggleButton. כך ניתן לשפר את הניגודיות מבחינת הנגישות. (I527cc)

גרסה 1.2.0-alpha05

22 בפברואר 2023

androidx.wear.compose:compose-*:1.2.0-alpha05 משוחרר. גרסה 1.2.0-alpha05 מכילה את התחייבויות אלה.

שינויים ב-API

  • ה-API של PickerGroup עודכן כדי לאפשר הפצה של מגבלות המינימום לתוכן הקומפוזבילי באופן אופציונלי. אם המדיניות מוגדרת כ-True, המגבלות המינימליות שהועברו מהרכיב הקומפוזבילי ברמה העליונה מותרות ב-PickerGroup. אם המדיניות מוגדרת כ-False, PickerGroup יאפס את המגבלות המינימליות. (I3e046)
  • הוספנו את animateScrollToOption ל- Picker API כדי לתמוך באנימציה פרוגרמטית באפשרות ספציפית של Picker (I6fe67)

תיקוני באגים

  • עדכנו את HorizontalPageIndicator כך שיתמוך בפריסות מימין לשמאל. (Ia4359)
  • נוספו בדיקות צילום מסך לפריסה מימין לשמאל ב-HorizontalPageIndicator (I6fbb8)
  • נוספו בדיקות נוספות ל-SwipeDismissableNavHostTest המשתמשים ב-TestNavHostController (I61d54)

גרסה 1.2.0-alpha04

8 בפברואר 2023

androidx.wear.compose:compose-*:1.2.0-alpha04 משוחרר. גרסה 1.2.0-alpha04 מכילה את התחייבויות אלה.

תכונות חדשות

  • PickerGroup לטיפול בכמה בוחרים יחד באמצעות ה-Focus API. המערכת מטפלת במוקד המיקוד בין הבוררים השונים, מאפשרת מרכוז אוטומטי של הבוררים על סמך פרמטרים ומאפשרת למפתחים לשנות את המיקוד בין הבוררים השונים בזמן הטיפול באירועים מהקבוצה. במצב טוקבאק, PickerGroup מטפל בפוקוס של TalkBack על ידי העברת המיקוד לבורר שנבחר מהקבוצה. (I60840)

שינויים ב-API

  • הוספנו עומס יתר ל-Stepper עם פרמטר enableRangeSemantics נוסף כדי להקל על השבתת הסמנטיקה של טווח ברירת המחדל (Ia61d4)

תיקוני באגים

  • אפשר להציב את ScalingLazyColumn בדף גלילה אופקית (Iec3f8, b/266555016)
  • שיפור של קובצי Kdocs ו-StepperTest בדיקות ניקיון. (Ic118e)
  • התלות של androidx.navigation עודכנה לגרסה 2.5.3 (If58ed)

גרסה 1.2.0-alpha03

25 בינואר 2023

androidx.wear.compose:compose-*:1.2.0-alpha03 משוחרר. גרסה 1.2.0-alpha03 מכילה את התחייבויות אלה.

שינויים ב-API

  • העברנו ScalingLazyColumn (וכיתות משויכות) מ-androidx.wear.compose.material.ScalingLazyColumn אל andrdoidx.wear.compose.foundation.lazy.ScalingLazyColumn (אפשר לעיין בדוגמה הזו להעברה). המיקום החדש הזה קרוב יותר למיקום של compose.foundation.lazy.LazyColumn, והוא טבעי יותר כי הוא לא רכיב חומר מקובע. השינוי מתבצע עכשיו כחלק מהכנת הספרייה החדשה של Material3, ואנחנו נעבוד עליה במקביל לספריית Material3 הקיימת. (I060e7)

השינויים הבאים הם חלק מההעברה של ScalingLazyColumn מ-Material אל Foundation.Lazy:

  • ממשקי ה-API של PositionIndicator שמטרגטים את Material ScalingLazyColumn הוצאו משימוש. צריך לעדכן לגרסה Foundation.Lazy ScalingLazyColumn. בנוסף, השדה anchorType נוסף אל ScalingLazyListLayoutInfo. (I29d95)
  • ScalingLazyColumn סומן כהוצאה משימוש בחבילת Wear Compose Material (I16d34)
  • עדכנו את מגביל ה-ScrollAway כך שישתמש ב-ScalingLazyListState מ-Wear Compose Foundation.Lazy והוצאנו את עומס החריגה מ-ScalingLazyListState מ-Wear Compose. (Ifc42c)
  • עדכנו את ממשקי ה-API של Dialog כך שישתמשו ב-ScalingLazyListState מ-Foundation.Lazy והוצאנו משימוש את עומסי-היתר שנעשה בהם שימוש ב-Material ScalingLazyListState (Ic8960)
  • עדכנו את ממשקי ה-API של Picker כך שישתמשו ב-ScalingParams מ-Foundation.Lazy והוצאנו משימוש את עומסי-היתר שנעשה בהם שימוש בחומר ScalingParams. (Idc3d8)

תיקוני באגים

  • תיקנו באג שגרם קומפוזיציות מחדש לא נחוצות ב-ScalingLazyListState.centerItemIndex כי אנחנו מוודאים שהפעולה 'דוחפת עדכונים' רק כשהערך משתנה בפועל (Ia9f38)
  • שיפרנו את הביצועים של SwipeToDismissBox (I3933b)
  • נוספו בדיקות השוואה לשוק עבור ScalingLazyColumn ב-Wear Compose Foundation (Ie00f9)
  • עדכנו כמה שיטות פנימיות של ScalingLazyColumn לכיתות ב-Material כדי להשתמש בשיטות המקבילות שלהן מ-Foundation.Lazy (I38aab)
  • תיקנו כמה בעיות בבדיקות של Picker והוספנו עוד בדיקות לבדיקת גלילה עם היסט (I6ac34)
  • העברנו את הדגמות השילוב של ScalingLazyColumn כך שיהיו תלויות ב-Foundation.Lazy במקום ב-Material ScalingLazyColumn (Ic6caa)
  • הוספנו פרמטרים אופציונליים של fromDate/toDate להדגמה של DatePicker שלנו (I961cd)

גרסה 1.2.0-alpha02

11 בינואר 2023

androidx.wear.compose:compose-*:1.2.0-alpha02 משוחרר. גרסה 1.2.0-alpha02 מכילה את התחייבויות אלה.

שינויים ב-API

  • בדיקות של ממשק המשתמש של Android לכתיבה ירוצו עכשיו אישורי פריסה לכל פריים כשמריצים פריימים לצורך מעבר למצב 'לא פעיל' (למשל, דרך waitForIdle). הדבר עלול להשפיע על בדיקות שמצהירות על פריימים בודדים של אנימציית פריסה. (I8ea08, b/222093277)
  • הפרמטר minLines נוסף ל-Wear Text כדי לאפשר התנהגות עקבית עם BasicText (I24874)
  • התג CompactChipTapTargetPadding הוגדר כגלוי לכולם כך שהוא יופיע במסמכים (If1e70, b/234119038)

תיקוני באגים

  • השבתת גרסאות build מרובות בפלטפורמות לחבילות wear.compose (Iad3d7)
  • תיקון kdocs עבור scrollToOption (I6f9a0)
  • בוצע עדכון של PlaceholderState.rememberPlaceholderState() לשימוש ב-rememberUpdatedState כדי שהמדינה תתעדכן אם ה-lambda של onContentReady. (I02635, b/260343754)
  • תיקנו בעיה של רעידות טקסט ברכיב Picker על ידי מינוף אסטרטגיית ההרכבה החדשה שנוספה אל Modifier.graphicsLayer. (I99302)
  • תיקנו באג שגרם להבהוב בהדגמה של DatePicker שלנו (I660bd)
  • שיפרנו את הנגישות בהדגמות של הכלי לבחירת תאריך ושעה של 12 שעות (I05e12)
  • עדכנו את ההדגמות של בורר השעה והתאריך, כך שהבוררים לא יושפעו משינויים ב-RSB לאחר ביטול הבחירה (I4aecb)

גרסה 1.2.0-alpha01

7 בדצמבר 2022

androidx.wear.compose:compose-*:1.2.0-alpha01 משוחרר. גרסה 1.2.0-alpha01 מכילה את התחייבויות אלה.

תכונות חדשות

  • עדכנו את הפונקציונליות הניסיונית של Placeholder כך שאפקט "Wipe Off" (מחיקה מושבת) מופעל מיידית כשהתוכן מוכן, במקום להמתין להתחלה של לולאת האנימציה הבאה. ערכנו גם כמה עדכונים של הנצנוץ ושל מחיקת האנימציות. (I5a7f4)

שינויים ב-API

  • הוספנו HierarchicalFocusCoordinatorתוכן קומפוזבילי כדי לאפשר סימון של תתי-עצים של היצירה כשמיקוד הפוקוס מופעל או כשהמיקוד מושבת.(I827cb)
  • הוספנו נכס חדש כדי לשנות את התפקיד הסמנטי של ToggleButton.(I67132)
  • עדכנו את TimeTextDefaults.TimeFormat12Hours כדי להסיר את AM/PM בTimeText. הפעולה הזו תשנה את ערך ברירת המחדל של הפרמטרים timeSource ב-API TimeText. (I1eb7f)
  • הרחבנו את Picker API כדי לשפר את הנגישות למסכים עם בורר מרובה. קיים נכס חדש userScrollEnabled שמאפשר לקבוע אם הבורר פעיל לגלילה של משתמשים. (I3c3aa)

תיקוני באגים

  • שינינו את רוחב הגבול המוגדר כברירת מחדל עבור OutlinedButton/OutlinedCompactButton מ-2.dp ל-1.dp כדי להתאים למפרטים הסופיים של חוויית המשתמש. (Icf84d)
  • כדי לצמצם את ההשפעה של הפריט הראשון שנוסף אל ScalingLazyColumn ריק שנראה כאילו הוא נגלל, הוספנו ערך משוער של autoCentering topPadding כשהתוכן ריק. השינוי הזה מחשב את המרווח הפנימי העליון שנדרש, בהנחה שפריט ראשוני בגובה 0.dp. עבור ScalingLazyListAnchorType.ItemStart זה תחשב את המרווח הפנימי העליון הנכון, עבור ScalingLazyListAnchorType.ItemCenter החישוב הזה לא יהיה נכון, מכיוון שגובה הפריטים נחוץ כדי להתאים את גודל התוכן באופן המתאים, וכתוצאה מכך מתבצעת גלילה קטנה כדי שייכנס לתוקף בהתבסס על הגובה האמיתי של הפריטים.(I239a4)
  • עדכנו את רצועת הרקע על האנימציה SwipeToDismiss כך שתתאים לפלטפורמת Wear. (I9003e)
  • תיקנו את הטיפול ב-PositionIndicator של LazyListState ושל ScalingLazyListState עבור פריטים בגודל 0 ברשימה, כדי למנוע שגיאות באפס.(Ic28dd)

גרסה 1.1

גרסה 1.1.2

8 בפברואר 2023

androidx.wear.compose:compose-foundation:1.1.2, androidx.wear.compose:compose-material:1.1.2 ו-androidx.wear.compose:compose-navigation:1.1.2 שוחררו. גרסה 1.1.2 כוללת את ההתחייבויות האלה.

תיקוני באגים

  • תיקנו באג שגרם קומפוזיציות מחדש לא נחוצות ב-ScalingLazyListState.centerItemIndex כי אנחנו מוודאים שהפעולה 'דוחפת עדכונים' רק כשהערך משתנה בפועל (Ia9f38)

גרסה 1.1.1

11 בינואר 2023

androidx.wear.compose:compose-foundation:1.1.1, androidx.wear.compose:compose-material:1.1.1 ו-androidx.wear.compose:compose-navigation:1.1.1 שוחררו. גרסה 1.1.1 כוללת את ההתחייבויות האלה.

תיקוני באגים

  • בוצע עדכון של PlaceholderState.rememberPlaceholderState() לשימוש ב-rememberUpdatedState כדי שהמדינה תתעדכן אם ה-lambda של onContentReady. (I02635, b/260343754)

גרסה 1.1.0

7 בדצמבר 2022

androidx.wear.compose:compose-foundation:1.1.0, androidx.wear.compose:compose-material:1.1.0 ו-androidx.wear.compose:compose-navigation:1.1.0 שוחררו. גרסה 1.1.0 כוללת את ההתחייבויות האלה.

שינויים חשובים מאז 1.0.0

תכונות חדשות

  • עדכנו את הפונקציונליות הניסיונית של Placeholder כך שאפקט "Wipe Off" (מחיקה מושבת) מופעל מיידית כשהתוכן מוכן, במקום להמתין להתחלה של לולאת האנימציה הבאה. ערכנו גם כמה עדכונים של הנצנוץ ושל מחיקת האנימציות. (I5a7f4)

תיקוני באגים

  • שינינו את רוחב הגבול המוגדר כברירת מחדל עבור OutlinedButton/OutlinedCompactButton מ-2.dp ל-1.dp כדי להתאים למפרטים הסופיים של חוויית המשתמש. (Icf84d)
  • כדי לצמצם את ההשפעה של הפריט הראשון שנוסף אל ScalingLazyColumn ריק שנראה כאילו הוא נגלל, הוספנו ערך משוער של autoCentering topPadding כשהתוכן ריק. השינוי הזה מחשב את המרווח הפנימי העליון שנדרש, בהנחה שפריט ראשוני בגובה 0.dp. עבור ScalingLazyListAnchorType.ItemStart זה תחשב את המרווח הפנימי העליון הנכון, עבור ScalingLazyListAnchorType.ItemCenter החישוב הזה לא יהיה נכון, מכיוון שגובה הפריטים נחוץ כדי להתאים את גודל התוכן באופן המתאים, וכתוצאה מכך מתבצעת גלילה קטנה כדי שייכנס לתוקף בהתבסס על הגובה האמיתי של הפריטים.(I239a4)
  • עדכנו את רצף הרקע שהוחל על האנימציה SwipeToDismiss כך שתתאים לפלטפורמת Wear.(I9003e)
  • תיקנו את הטיפול ב-PositionIndicator של LazyListState ושל ScalingLazyListState עבור פריטים בגודל 0 ברשימה, כדי למנוע שגיאות באפס.(Ic28dd)

גרסה 1.1.0-rc01

9 בנובמבר 2022

androidx.wear.compose:compose-foundation:1.1.0-rc01, androidx.wear.compose:compose-material:1.1.0-rc01 ו-androidx.wear.compose:compose-navigation:1.1.0-rc01 שוחררו. גרסה 1.1.0-rc01 מכילה את שמירות האלה.

תיקוני באגים

  • הוספנו כללי פרופיל בסיסיים עבור Placeholders, ScrollAway, RadioButton, Switch, Checkbox, OutlinedButton, OutlinedCompactButton, OutlinedChip ו-OutlinedCompactChip. (I8249c)
  • תיקנו באג ב-Modifier.scrollAway כך שאם ה-itemIndex שצוין אינו חוקי (לדוגמה, אם אינדקס הפריט הזה נמצא מחוץ לטווח), הערך TimeText עדיין יוצג. (I2137a)
  • עדכנו את האנימציה SwipeToDismissBox כך שתתאים להטמעה של הפלטפורמה. אחרי אנימציית הלחיצה הראשונית, המסך מחליק ימינה ברגע שהסגירה מופעלת. (I41d34)
  • לצורך אופטימיזציה, עדכנו את המדיניות Modifier.scrollAway כך שהיא תקרא רק את scrollState בתוך בלוק המדידה, כדי להימנע מחיבור מחדש של הערך אחרי כל מדידה מחדש. (I4c6f1)
  • הוספנו מסמכים ודוגמה ל-placeholders כדי להראות את הסדר הנכון של Modifier.placeholder ו-Modifier.placeholderShimmer כשמחילים אותם על אותו תוכן קומפוזבילי. (Ie96f4, b/256583229)
  • שינינו את רוחב הגבול המוגדר כברירת מחדל עבור OutlinedCompactChip/OutlinedChip מ-2.dp ל-1.dp כדי להתאים למפרטים הסופיים של חוויית המשתמש. (Ib3d8e)
  • תיקנו באג ב-rememberPickerState שגרם לכך שנתוני הקלט המעודכנים לא נשמרו, כך שתכנים קומפוזביליים לא עודכנו אחרי שינויים בערכי הקלט. (I49ff6, b/255323197)
  • ביצענו כמה עדכונים של ממשק המשתמש ב-placeholders, 1) שינוי הדרגתי של הנצנוץ פי 1.5 מגודל המסך, 2) הוספה של התאמה (cubic bezier) להתקדמות הבהובת ו-3) האצת אנימציית המחיקה (250 אלפיות שנייה). (Id29c1)
  • תיקנו באג בממשק המשתמש באפקט המחיקה של ה-placeholder שבו הרקעים של הצ'יפים והכרטיסים נמחקו מעט מוקדם יותר כי לא הבאנו בחשבון את מיקום הרכיב על המסך. (I2c7cb)
  • עדכנו את שרטוט הרקע של ה-placeholder כדי למזג צבעים במקום להוסיף אותם בשכבות כשאפשר, כדי לצמצם את הסיכון למיזוג אלפא של השכבות השונות שנחתכו כך שלא יאפשרו לצבעי הבסיס לגלוש בקצוות הרקע של ה-placeholder. (I2ea26)
  • תיקנו את החישוב של ScalingLazyListState.centerItemIndex/centerItemOffset, כך שאם שני פריטים נמצאים בכל צד של קו המרכז של אזור התצוגה, הפריט הקרוב ביותר ייחשב כ-centerItem. (I30709, b/254257769)
  • תיקנו באג ב-ScalingLazyListState.layoutInfo.visibleItemsInfo שדיווח על קיזוזים שגויים במהלך האתחול של ScalingLazyColumn. בשלב הזה, רשימה ריקה תוחזר עד שכל הפריטים ברשימה יוצגו עם קיזוזים נכונים. צריך לבדוק את ScalingLazyListState.layoutInfo.visibleItemsInfo.isNotEmpty() כדי לוודא שהאתחול של ScalingLazyColumn הושלם והפריטים מוצגים. (I3a3b8)

גרסה 1.1.0-beta01

24 באוקטובר 2022

androidx.wear.compose:compose-foundation:1.1.0-beta01, androidx.wear.compose:compose-material:1.1.0-beta01 ו-androidx.wear.compose:compose-navigation:1.1.0-beta01 שוחררו. גרסה 1.1.0-beta01 מכילה את התחייבויות אלה.

מה חדש ב-Composes עבור Wear OS 1.1

לפי גרסה 1.1.0-בטא01 של 'כתיבה מהירה' ל-Wear OS, הגרסה הזו של הספרייה הושלמה ושה-API נעול.

  • הגרסה של Wear Compose 1.1 כוללת את הפונקציונליות החדשה הבאה:
    • הבורר – שיפורי הנגישות בכלי לבחירת מספר, כך שיהיה אפשר לנווט במסכים של בוחרי המסך באמצעות קוראי מסך ותיאור התוכן יהיה נגיש
    • הפרמטר contentDescription של הבורר משמש עכשיו רק לאפשרות של הבורר שנבחרה ומחזיר מחרוזת אפסית (בשמירה הקודמת, היה צורך להעביר מיפוי מהאפשרות לתיאור התוכן, אבל נעשה שימוש רק באפשרות שנבחרה).
    • עכשיו הפריטים בבורר תמיד יישור למרכז, לכן תיקון באג בזמן הגדרת הערך של gradientRatio כאפס הוביל לתוצאה הצדדית של שינוי היישור.
    • Chip/ToggleChip - עדכנו את מעברי הדירוג שמוגדרים כברירת מחדל ל-Chip/ToggleChip כדי שיתאימו למפרט העדכני של חוויית המשתמש. הערך של ChipDefaults.gradientBackgroundChipColors עודכן ועכשיו הוא 50% מהראשיות במקום 32.5%.
    • Chip/ToggleChip – נוספו עומסי יתר לשינוי צורות של צ'יפים
    • Chip/Button/ToggleButton – נוסף סגנון חדש עם קווי מתאר לצ'יפים וללחצנים, ולתכנים קומפוזביליים חדשים מסוג OutlinedChip ו-OutlinedButton שמספקים Chip/Button שקוף עם מסגרת דקה.
    • כרטיס – עדכנו את שדרוגי ברירת המחדל של הכרטיסים כדי להתאים אותם למפרט העדכני של חוויית המשתמש. הערך של CardDefaults.cardBackgroundPainter עודכן כך שיתחיל מ-30% מהערך הראשוני ויסתיים ב-20% מ-onSurfaceVariant (לפני כן היה 20% עד 10% onSurfaceVariant). ToggleChip.toggleChipColors משתנה משדרגת ליניארית של 75% פני שטח ל-32.5% ראשוני ל-0% לשטח ראשי של 50%.
    • Button/ToggleButton – נוספו מאפיינים לשינוי צורות לחצנים.
    • עיצוב – עדכנו את מספר צבעי ברירת המחדל בMaterialTheme כדי לשפר את הנגישות, כי הצבעים המקוריים לא היו מספיק ניגודיות, ולכן המשתמשים לא יכולים להבדיל בין רקעים של צ'יפים/כרטיסים/לחצנים לבין צבע הרקע של העיצוב.
    • InlineSlider/Stepper – נוספו תפקידים של לחצנים כדי לאפשר ל-Talkback לזהות אותם כלחצנים.
    • פיום - עכשיו PositionIndicator ממוקם והגודל שלו יתפוס רק את המקום הדרוש. האפשרות הזו שימושית, לדוגמה, אם מוסיפים מידע סמנטי, TalkBack עובר עכשיו לגבולות הנכונים של PositionIndicator במסך.
    • CurvedText/TimeText – נוספה האפשרות Modifier.scrollAway, שגוללת פריט אנכית או מחוץ לתצוגה לפי מצב הגלילה (עם עומסי יתר לעבודה עם Column, LazyColumn ו-ScalingLazyColumn). ScrollAway משמש בדרך כלל לגלילה TimeText מחוץ לתצוגה בזמן שהמשתמש מתחיל לגלול רשימת פריטים כלפי מעלה.
    • CurvedText/TimeText – נוספה תמיכה ב-fontFamily, ב-fontStyle וב-fontSynthesis ב-CurvedTextStyle, שניתן להשתמש בה ב-curvedText וב-basicCurvedText
    • CurvedText/TimeText - fontWeight נוסף ל-constructor ולשיטת ההעתקה ב-CurvedTextStyle
    • ToggleControls – נוספה אנימציה של מתגי Checkbox, Switch ו-RadioButton לשימוש עם ToggleChip ו-SplitToggleChip. אפשר להשתמש בסמלים האלה במקום בסמלים הסטטיים שסופקו על ידי ToggleChipDefaults (switchIcon, checkboxIcon ו-radioIcon).
    • Placeholder – נוספה תמיכה ניסיונית ב-placeholder. הדוח כולל שלושה אפקטים חזותיים ייחודיים שמיועדים לפעול יחד.
    • קודם כל, אפקט של מברשת רקע מסוג placeholder שנעשה בו שימוש בקונטיינרים כמו צ'יפ וכרטיסים, כדי לצייר על הרקע הרגיל בזמן המתנה לטעינת תוכן.
    • שנייה: מקש צירוף (Modifier.placeholder()) לשרטוט ווידג'ט placeholder בצורת אצטדיון מעל התוכן שנטען.
    • שלישית, אפקט הדרגתי/הנצנוץ (Modifier.placeholderShimmer()) המוצג מעל לשאר האפקטים כדי לציין למשתמשים שאנחנו ממתינים לנתונים לטעינה.
      • כל האפקטים האלה מיועדים להיות מתואמים, מהבהבים ומנוצים בצורה מתוזמרת.
  • יחסי התלות של הליבה לכתיבה עודכנו מ-1.2 ל-1.3

שינויים ב-API

  • עכשיו אפשר לציין פרמטרים של גופן (fontFamily, fontWeight, fontStyle ו-fontSynthesis) ישירות כפרמטרים של curvedText (Idc422)

תיקוני באגים

  • curveText ו-basicCurvedText יפעלו עכשיו כראוי עם Talkback (הצומת המכיל צומת קומפוזיציה בגודל מתאים (אבל ריק) המשויך אליהם, תוך שימוש בטקסט כתיאור התוכן) (I7af7c, b/210721259)
  • תיקון הבאג ב-Picker כאשר PickerState.repeatedItems = false מוסיף הגדרה מפורשת של פרמטרים לריכוך אוטומטי של בוררים בתוך ScalingLazyColumn, כדי להבטיח שניתן יהיה לגלול את האפשרות האפס למרכז התצוגה. (I8a4d7)

גרסה 1.1.0-alpha07

5 באוקטובר 2022

androidx.wear.compose:compose-foundation:1.1.0-alpha07, androidx.wear.compose:compose-material:1.1.0-alpha07 ו-androidx.wear.compose:compose-navigation:1.1.0-alpha07 שוחררו. גרסה 1.1.0-alpha07 מכילה את התחייבויות אלה.

תכונות חדשות

  • הוספנו תמיכה ב-placeholders ניסיונית. הדוח כולל שלושה אפקטים חזותיים ייחודיים שמיועדים לפעול יחד. קודם כל, אפקט של מברשת רקע מסוג placeholder שנעשה בו שימוש בקונטיינרים כמו צ'יפ וכרטיסים, כדי לצייר על הרקע הרגיל בזמן המתנה לטעינת תוכן. שנייה: מקש צירוף (Modifier.placeholder()) לשרטוט ווידג'ט placeholder בצורת אצטדיון מעל התוכן שנטען. שלישית, אפקט הדרגתי/הנצנוץ (Modifier.placeholderShimmer()) המוצג מעל לשאר האפקטים כדי לציין למשתמשים שאנחנו ממתינים לנתונים לטעינה. כל האפקטים האלה מיועדים להיות מתואמים, מהבהבים ומנוצים בצורה מתוזמרת. I3c339

שינויים ב-API

  • נוספה תמיכה ב-fontWeight, ב-fontFamily, ב-fontStyle וב-fontSynthesis ב- CurvedTextStyle, ניתן לשימוש ב-curvedText וב-basicCurvedText. אפשר להשתמש בפרמטרים האלה כדי לציין את הגופן והסגנון שבהם צריך להשתמש בטקסט העקום.(Iaa1a8),(I72759)
  • פרמטר ההיסט של Modifier.scrollAway עודכן ל-Dp כדי לשמור על עקביות עם Modifier.offset (בעבר הוא היה בפיקסלים). בנוסף, בוצע ארגון מחדש שמוגדר כLayoutModifier מבחינת יעילות. (I9f94b)
  • במסגרת ה-API החדש לבקרה על החלפת מצב, שינינו את השם RadioButton’s circleColor ל-ringColor. (I28fa9)
  • הוספנו אנימציה של מתגי Checkbox, Switch ו-RadioButton לשימוש עם ToggleChip ו-SplitToggleChip. אפשר להשתמש בסמלים האלה במקום בסמלים הסטטיים שסופקו על ידי ToggleChipDefaults (switchIcon, checkboxIcon ו-radioIcon). (I8a8c4)

גרסה 1.1.0-alpha06

21 בספטמבר 2022

androidx.wear.compose:compose-foundation:1.1.0-alpha06, androidx.wear.compose:compose-material:1.1.0-alpha06 ו-androidx.wear.compose:compose-navigation:1.1.0-alpha06 שוחררו. גרסה 1.1.0-alpha06 מכילה את התחייבויות אלה.

תכונות חדשות

  • הוספנו את התכונה Modifier.scrollAway, שגוללת את הפריט במצב אנכי או מחוץ לתצוגה, לפי מצב הגלילה (עם עומסי יתר לעבודה עם Column, LazyColumn ו-ScalingLazyColumn). ScrollAway משמש בדרך כלל לגלילה TimeText מחוץ לתצוגה בזמן שהמשתמש מתחיל לגלול רשימת פריטים כלפי מעלה. (I61766)

תיקוני באגים

  • עכשיו ה-PositionIndicator ממוקם והגודל שלו יתפוס רק את המקום הדרוש. האפשרות הזו שימושית, לדוגמה, אם מוסיפים מידע סמנטי, TalkBack עובר עכשיו לגבולות הנכונים של PositionIndicator במסך. (Ie6106, b/244409133)

גרסה 1.1.0-alpha05

7 בספטמבר 2022

androidx.wear.compose:compose-foundation:1.1.0-alpha05, androidx.wear.compose:compose-material:1.1.0-alpha05 ו-androidx.wear.compose:compose-navigation:1.1.0-alpha05 שוחררו. גרסה 1.1.0-alpha05 מכילה את התחייבויות אלה.

תיקוני באגים

  • נוספו תפקידים של לחצנים אל InlineSlider ו-Stepper כדי ש-TalkBack יוכל לזהות אותם כלחצנים. (Icb46c, b/244260275)
  • תיקנו את סדר ה-z של המיקום והמחוונים של הדפים ב-Scaffold. האינדיקטורים יופיעו עכשיו מעל מודעת הביניים ולכן הם לא יוסתרו על ידי מודעת הביניים אם היא קיימת. (Ib988f, b/244207528)

גרסה 1.1.0-alpha04

24 באוגוסט 2022

androidx.wear.compose:compose-foundation:1.1.0-alpha04, androidx.wear.compose:compose-material:1.1.0-alpha04 ו-androidx.wear.compose:compose-navigation:1.1.0-alpha04 שוחררו. גרסה 1.1.0-alpha04 מכילה את התחייבויות אלה.

שינויים ב-API

  • עדכנו כמה צבעי ברירת מחדל ב-MaterialTheme כדי לשפר את הנגישות, מאחר שהניגודיות בין הצבעים המקוריים לא הייתה מספקת מה שגרם למשתמשים להבחין בין רקעים של צ'יפים/כרטיסים/לחצנים לבין צבע הרקע של העיצוב. הצבעים המעודכנים הם פני שטח (0xFF202124->0xFF303133), onPrimary(0xFF202124->0xFF303133), onsecondary(0xFF202124->0xFF303133), primaryVariant(0xFF669DF6->0xFF80x4F8). שינויים בצבעים, אם כי עדינים יחסית, עשויים להשפיע על בדיקות קיימות של צילומי מסך. (81ab09)

תיקוני באגים

  • תיקון של באג לוגי ב-ScalingLazyColumn שעלול לגרום לכך שרשימות עם מספר קטן (בדרך כלל בדיוק 2) של פריטים ברשימה לא משלימים את האתחול וכתוצאה מכך מתרחשת שקיפות. (504347)

גרסה 1.1.0-alpha03

10 באוגוסט 2022

androidx.wear.compose:compose-foundation:1.1.0-alpha03, androidx.wear.compose:compose-material:1.1.0-alpha03 ו-androidx.wear.compose:compose-navigation:1.1.0-alpha03 שוחררו. גרסה 1.1.0-alpha03 מכילה את התחייבויות אלה.

תכונות חדשות

  • הוספנו סגנון חדש עם קווי מתאר ל-Chips ול-Buttons, ולתכנים קומפוזביליים חדשים מסוג OutlinedChip ו-OutlinedButton שמספקים Chip/Button שקוף עם מסגרת דקה. (Id5972)

שינויים ב-API

  • נוספו עומסי יתר לשינוי צורות לחצנים (Icccde)

תיקוני באגים

  • תיקנו את הגודל של אזור הבקרה של המתג בToggleChip כי הוא לא תאם למפרט חוויית המשתמש. במפרט חוויית המשתמש צריך להוסיף רווח של 4.dp בין התווית לאזור של סמל מתג הבקרה בגודל 24x24.dp, כך שיהיה רוחב כולל של 28.dp. עם זאת, בזמן ההטמעה מצוין אזור הבקרה למתג 36x24.dp. התוצאה היא שטח של 8.dp של תוויות טקסט שניתן להשתמש בו. הערה: תיקון הבאג הזה מעניק יותר מקום לתווית הטקסט, וכתוצאה מכך הוא עשוי להשפיע (חיובית) על פריסת הטקסט של הטקסט שגולש. אם יש בדיקות של צילומי מסך, כולל ToggleChips, יכול להיות שצריך לעדכן אותן. (I514c8, b/240548670)

גרסה 1.1.0-alpha02

27 ביולי 2022

androidx.wear.compose:compose-foundation:1.1.0-alpha02, androidx.wear.compose:compose-material:1.1.0-alpha02 ו-androidx.wear.compose:compose-navigation:1.1.0-alpha02 שוחררו. גרסה 1.1.0-alpha02 מכילה את התחייבויות אלה.

תכונות חדשות

  • שינינו את יחסי התלות של 'כתיבה' ל-Wear OS בספריות ליבה לכתיבה מגרסה 1.2.0 ל- 1.3.0-alpha0X

שינויים ב-API

  • נוספו עומסי יתר לשינוי צורות של צ'יפים (I02e87)

תיקוני באגים

  • הנפשנו את חשיפת מודעת הביניים בזמן הצגה/הסתרה של תיבת הדו-שיח, בהתאם לאנימציה הקיימת של שינוי קנה המידה. (Ida33e)
  • תיקנו באג שבו עלול להתרחש חילוק של אפסים עקב התנהגות של הנביטה בזמן גלילה. (I86cb6)
  • תוקן באג ב-ChipDefaults.childChipColor() כדי לוודא שצבע הרקע המושבת הוא שקוף לחלוטין. (I2b3c3, b/238057342)

גרסה 1.1.0-alpha01

29 ביוני 2022

androidx.wear.compose:compose-foundation:1.1.0-alpha01, androidx.wear.compose:compose-material:1.1.0-alpha01 ו-androidx.wear.compose:compose-navigation:1.1.0-alpha01 שוחררו. גרסה 1.1.0-alpha01 מכילה את התחייבויות אלה.

שינויים ב-API

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

תיקוני באגים

  • עדכנו את כללי הפרופיל הבסיסיים שכלולים בספריית Wear Compose (I9c694)
  • תיקנו את הכיוון של ההדרגתיות של הצ'יפים במצב מימין לשמאל. היה למעלה משמאל ->ימין למטה, עכשיו הוא ימין למעלה -> שמאל למטה. (Ic2e77)
  • עדכנו את מדרגי ברירת המחדל של Chip/ToggleChip/Card כדי שיתאימו למפרט העדכני של חוויית המשתמש. הערך של ChipDefaults.gradientBackgroundChipColors עודכן ועכשיו הוא 50% מהראשיות במקום 32.5%. הערך של CardDefaults.cardBackgroundPainter עודכן כך שיתחיל מ-30% מהערך הראשוני ויסתיים ב-20% מ-onSurfaceVariant (לפני כן היה 20% עד 10% onSurfaceVariant). ToggleChip.toggleChipColors משתנה משדרגת ליניארית של 75% פני שטח ל-32.5% ראשוני ל-0% לשטח ראשי של 50%. (I43bbd)
  • הוספנו צבע רקע (MaterialTheme.color.surface) מאחורי Chip/ToggleChips עם רקעים הדרגתיים, כדי להבטיח שניתן יהיה לראות אותם כראוי במקרה הלא סביר שבו נעשה שימוש בצבע בהיר מאחוריהם. (Ibe1a4, b/235937657)
  • עכשיו הפריטים בבורר תמיד יישור למרכז, לכן תיקון באג בזמן הגדרת הערך של gradientRatio כאפס הוביל לתוצאה הצדדית של שינוי היישור. (I712b8)

גירסה 1.0

גרסה 1.0.2

7 בספטמבר 2022

androidx.wear.compose:compose-foundation:1.0.2, androidx.wear.compose:compose-material:1.0.2 ו-androidx.wear.compose:compose-navigation:1.0.2 שוחררו. גרסה 1.0.2 כוללת את ההתחייבויות האלה.

תיקוני באגים

  • תיקנו את סדר ה-z של המיקום והמחוונים של הדפים ב-Scaffold. האינדיקטורים יופיעו עכשיו מעל מודעת הביניים ולכן הם לא יוסתרו על ידי מודעת הביניים אם היא קיימת. (Ib988f, b/244207528)

גרסה 1.0.1

24 באוגוסט 2022

androidx.wear.compose:compose-foundation:1.0.1, androidx.wear.compose:compose-material:1.0.1 ו-androidx.wear.compose:compose-navigation:1.0.1 שוחררו. גרסה 1.0.1 כוללת את ההתחייבויות האלה.

תיקוני באגים

  • תיקון של באג לוגי ב-ScalingLazyColumn שעלול לגרום לכך שרשימות עם מספר קטן (בדרך כלל בדיוק 2) של פריטים ברשימה לא משלימים את האתחול וכתוצאה מכך מתרחשת שקיפות. (076c61)

גרסה 1.0.0

27 ביולי 2022

androidx.wear.compose:compose-foundation:1.0.0, androidx.wear.compose:compose-material:1.0.0 ו-androidx.wear.compose:compose-navigation:1.0.0 שוחררו. גרסה 1.0.0 מכילה את ההתחייבויות האלה.

התכונות העיקריות של 1.0.0

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

תיקוני באגים

  • הנפשנו את חשיפת מודעת הביניים בזמן הצגה/הסתרה של תיבת הדו-שיח, בהתאם לאנימציה הקיימת של שינוי קנה המידה. (Ida33e)
  • תיקנו באג שבו עלול להתרחש חילוק של אפסים עקב התנהגות של הנביטה בזמן גלילה. (I86cb6)
  • תוקן באג ב-ChipDefaults.childChipColor() כדי לוודא שצבע הרקע המושבת הוא שקוף לחלוטין. (I2b3c3, b/238057342)

גרסה 1.0.0-rc02

22 ביוני 2022

androidx.wear.compose:compose-foundation:1.0.0-rc02, androidx.wear.compose:compose-material:1.0.0-rc02 ו-androidx.wear.compose:compose-navigation:1.0.0-rc02 שוחררו. גרסה 1.0.0-rc02 מכילה את ההתחייבויות האלה.

תיקוני באגים

  • תיקנו את הכיוון של ההדרגתיות של הכרטיסים במצב מימין לשמאל (RTL). הוא היה משמאל למעלה->ימין למטה, ועכשיו הוא מימין למעלה->בפינה השמאלית התחתונה. (Ic2e77)
  • עדכנו את מדרגי ברירת המחדל של Chip/ToggleChip/Card כדי שיתאימו למפרט העדכני של חוויית המשתמש. הערך של ChipDefaults.gradientBackgroundChipColors עודכן ועכשיו הוא 50% מהראשיות במקום 32.5%. הערך של CardDefaults.cardBackgroundPainter עודכן כך שיתחיל מ-30% מהמקור הראשוני ויסתיים ב-20% מ-onSurfaceVariant (לפני כן היה 20% עד 10% ב-OnSurfaceVariant). ToggleChip.toggleChipColors משתנה משיפוע לינארי של 75% בפני השטח של 32.5% הראשי, למשטח של 0% ל-50% הראשי. (I43bbd)
  • הוספנו צבע רקע (MaterialTheme.color.surface) מאחורי Chip/ToggleChips עם רקעים הדרגתיים, כדי להבטיח שניתן יהיה לראות אותם כראוי במקרה הלא סביר שבו נעשה שימוש בצבע בהיר מאחוריהם. (Ibe1a4, b/235937657)
  • עדכנו את כללי הפרופיל הבסיסיים שכלולים בספריית Wear Compose (I9c694)

גרסה 1.0.0-rc01

15 ביוני 2022

androidx.wear.compose:compose-foundation:1.0.0-rc01, androidx.wear.compose:compose-material:1.0.0-rc01 ו-androidx.wear.compose:compose-navigation:1.0.0-rc01 שוחררו. גרסה 1.0.0-rc01 מכילה את ההתחייבויות האלה.

שינויים ב-API

  • ממשקים בספריות הרכבה נוצרים עכשיו באמצעות שיטות ברירת מחדל של jdk8 (I5bcf1)

תיקוני באגים

  • הסרנו את הקריאה המפורשת ל-fillMaxWidth() בכותרת הרשימה כי אין בה צורך. היא עלולה לגרום לבעיות אם המאפיין ScalinglazyColumn מכיל שילוב של רכיבי ListHeader() ו-Chip(), כי הרוחב עשוי לגדול או להתכווץ ככל שהרוחב של ListHeader פריטים נגלל פנימה או החוצה מהתצוגה. (I37144, b/235074035)
  • תיקנו באג ב-ScalingLazyColumn שגרם לכך שהפריטים ברשימה לא ייכתבו בצורה נכונה עד שתתבצע גלילה אם הפריט הרשימה ה-0 גדול מספיק (כולל מרווח פנימי) (Ic6159, b/234328517)
  • ביצענו שינוי קטן בהתאמה לScalingLazyColumn כשהפריטים מגיעים לקצה המסך בהתאם לעדכונים במפרט חוויית המשתמש. ערכים ישנים CubicBezierEasing(0.25f, 0.00f, 0.75f, 1.00f) -> הערכים החדשים: CubicBezierEasing(0.3f, 0f, 0.7f, 1f). כדי לשמור על ההתנהגות הישנה, אפשר לעקוף את scalingParams של ScalingLazyColumn (Ie375c)
  • הוספנו מרווח פנימי ל-CompactChip כדי להבטיח שגודל יעד ההקשה שלו הוא לפחות 48.dp גבוה בהתאם להנחיות הנגישות 'Material'. הפעולה הזו עשויה להשפיע על הפריסות שבהן השתמשת ב-CompactChips כי הן יתפסו יותר מקום. (I3d57c)

גרסה 1.0.0-beta03

1 ביוני 2022

androidx.wear.compose:compose-foundation:1.0.0-beta03, androidx.wear.compose:compose-material:1.0.0-beta03 ו-androidx.wear.compose:compose-navigation:1.0.0-beta03 שוחררו. גרסה 1.0.0-beta03 מכילה את התחייבויות אלה.

תכונות חדשות

  • הכנו ScalingLazyColumn פעולות במצב 'כתיבה' @Preview. (I3b3b6, b/232947354)

שינויים ב-API

  • שינינו את ערך ברירת המחדל של המאפיין ScalingLazyColumn.horizontalAlignment מ'התחלה' ל-CenterHorizontally, כדי להבטיח שכאשר פריטים ברשימה לא ימלאו את כל רוחב העמודה, הם יהיו מותאמים להשגת חשיפה מקסימלית. כדי לחזור לקבוצת ההתנהגות הקודמת horizontalAlignment = Alignment.Start.(I9ed4b)

בעיות מוכרות

  • גובה ההקשה/המגע של CompactChip קטן יותר מהנחיות הנגישות של Material. התיקון הזה יתוקן בגרסה הבאה (15 ביוני). אם משתמשים ב-CompactChip, זה משפיע על הפריסות כי עכשיו ל-ComactChips יש מרווח פנימי נוסף מעל ומתחת. צריך לשנות ולבדוק את הפריסות או לעיין בתגובות על הבאג כדי לעקוף את ההתנהגות הקיימת. (b/234332135)

תיקוני באגים

  • הדגמה חדשה לאנימציה של הוספה או הסרה של טקסט התחלה ב-TimeText. (I16d75)
  • הוספת בדיקות עבור HorizontalPageIndicator.PagesState (I64ed0)
  • העדכון של TimeText קרוב יותר למפרטי חוויית המשתמש (Ib7ea1)

גרסה 1.0.0-beta02

18 במאי 2022

androidx.wear.compose:compose-foundation:1.0.0-beta02, androidx.wear.compose:compose-material:1.0.0-beta02 ו-androidx.wear.compose:compose-navigation:1.0.0-beta02 שוחררו. גרסה 1.0.0-beta02 מכילה את התחייבויות אלה.

תכונות חדשות

  • מעכשיו, הבורר תמיד מגיב לגלילה באירועי גלילה, גם במצב קריאה בלבד. כך המשתמשים לא יצטרכו לבחור קודם בורר על ידי הקשה, לפני שהם יוכלו לגלול. במצב קריאה-בלבד, אפשרויות אחרות מאלה שנבחרות כרגע מוסתרות על ידי ספריית shim ב-gradientColor. (I72925)
  • שינינו את התנהגות חוויית המשתמש של Chip/ToggleChip/CompactChip/SplitToggleChip כדי למנוע מהאפליקציה fillMaxWidth כברירת מחדל. במקום זאת, הם יגדלו כך שיתאימו לתוכן שלהם. כדי לשמור את ההתנהגות הקודמת, פשוט מוסיפים את modifier = Modifier.fillMaxWidth()(I60a2c, b/232206371)

תיקוני באגים

  • בנאי של CurvedTextStyle שמשתמש ב-TextStyle עכשיו הוא גם מכבד את fontWeight(יכול להיות שהפרטים האלה יצורפו לשיטות ה-constructor וההעתקה בגרסאות עתידיות של ה-API) (Ieebb9)
  • שיפורים בהחלקה מהקצה. כשנעשה שימוש ב-Modifier.edgeSwipeToDismiss והחלקה שמאלה מופעלת מאזור הקצה, היא כבר לא מפעילה החלקה לסגירה כשהכיוון של ההחלקה משתנה ימינה. בעבר, היה אפשר להפעיל החלקה לסגירה על ידי החלקה שמאלה ואז החלקה ימינה.(I916ea)
  • ב-HorizontalPageIndicator מוצגים עכשיו עד 6 דפים במסך. אם יש יותר מ-6 דפים בסך הכל, יופיע אינדיקטור בחצי גודל משמאל או מימין, עם מעבר חלק בין דפים.(I2ac29)
  • שיפור התנהגות הצמדה שמוגדרת כברירת מחדל ב-ScalingLazyColumn וב-Picker (I49539)
  • שיפורים בהחלקה מהקצה. כשמשתמשים ב-Modifier.edgeSwipeToDismiss, החלקה לסגירה מופעלת רק כשהנגיעה הראשונה נוחתת מהקצה והחלקה ימינה. בעבר הייתה אפשרות להפעיל החלקה לסגירה על ידי החלקה מכל חלק במסך אם הגלילה מגיעה להתחלה.(I8ca2a)

גרסה 1.0.0-beta01

11 במאי 2022

androidx.wear.compose:compose-foundation:1.0.0-beta01, androidx.wear.compose:compose-material:1.0.0-beta01 ו-androidx.wear.compose:compose-navigation:1.0.0-beta01 שוחררו. גרסה 1.0.0-beta01 מכילה את התחייבויות אלה.

מה חדש ב-Composes עבור Wear OS 1.0

1.0.0-beta01 של 'כתיבה' ל-Wear OS הוא ציון דרך חשוב כי הספרייה הושלמה וה-API נעול.

רכיבי Wear Compose Material בגרסה 1.0 כוללים:

  • עיצוב Material – שמשמש כתחליף ל-MaterialTheme Compose for Mobile, מספק את הצבעים, הצורות והטיפוגרפיה של רכיבי הבנייה של גאדג'טים לבישים שמיישמים את הנחיות חוויית המשתמש של Wear Material Design, ברכישה מלאה.
  • Button, CompactButton ו-ToggleButton – הלחצן מציע משבצת אחת לצילום סמל, תמונה או טקסט קצר (3 תווים לכל היותר). עיגול בצורת עיגול עם גדלים מומלצים לברירת המחדל, ללחצנים גדולים או קטנים. ב-CompactButton יש חריץ אחד לצילום כל תוכן (סמל, תמונה או טקסט) והוא מעוגל, עם גודל רקע קטן במיוחד. ב-CompactButton יש מרווח פנימי שקוף מסביב לרקע שמגדיל את אזור הלחיצה. ToggleButton הוא לחצן שמאפשר מיקום יחיד לצילום כל תוכן (טקסט קצר, סמל או תמונה) ובמצבי הפעלה/כיבוי (מסומן/לא מסומן) עם צבעים וסמלים שונים כדי לציין אם מסומן או לא
  • כרטיסים - משמשים להצגת מידע על אפליקציות, כגון התראות. עיצוב גמיש לתרחישים שונים לדוגמה עם AppCard ו-TitleCard, שמעניק פריסות שונות ותמיכה לתמונות בתור תוכן או רקעים של כרטיסים.
  • צ'יפים – רכיבים בצורת אצטדיון שדומים ללחצנים, אבל עם אזור גדול יותר ומספר משבצות שאפשר להוסיף לתוויות, לתוויות משניות ולסמלים. בגדלים שונים עם תמיכה בתמונות בתור רקעים.
  • החלפת מצב של צ'יפים ו-SplitToggleChips – צ'יפ במצב מסומן/לא מסומן והוספה של חריץ ToggleControl, להצגת סמל כמו מתג או לחצן בחירה להצגת המצב המסומן של הרכיב. בנוסף, ב-SplitToggleChip יש שני אזורים שאפשר להקיש עליהם, אחד שאפשר ללחוץ עליו והשני אפשר להחלפה.
  • אינדיקטור התקדמות מעגלי – אינדיקטור התקדמות של חומר מלבוש עם שתי וריאציות. הראשון משקף את שיעור ההשלמה של משימה מתמשכת, ותומך בפער במסלול המעגלי בין זוויות ההתחלה והסיום. הערך השני מציין התקדמות לא צפויה למשך זמן המתנה שלא צוין.
  • CurdText – חלק מה-DSL לתיאור CurvedLayouts, יחד עם curvedRow ו-curvedColumn, לפרוס רכיבים מסביב למכשירים מעגליים. פרטים נוספים על CurvedLayout ו-CurvedModifier מופיעים במאמר 'בסיס רכיבי Wear' שבהמשך (שממלאים תפקיד דומה לזה של המגבילים בעולם הלא מעוקל ומאפשרים להגדיר היבטים שונים של פריסה, מרווח פנימי, הדרגה וכו').
  • תיבת דו-שיח, התראה ואישור - תיבת הדו-שיח מציגה תיבת דו-שיח במסך מלא, המוצגת בשכבות מעל כל תוכן אחר, ותומך בהחלקה לסגירה. נדרש משבצת אחת, שאמורה להיות מקובצת תוכן של תיבת דו-שיח מסוג חומר Wear, כמו 'התראה' או 'אישור'. התראה היא תוכן של תיבת דו-שיח מקובצת עם משבצות לסמל, לכותרת ולהודעה. יש בו עומסי יתר של שני לחצנים חיוביים ושליליים שמוצגים זה לצד זה, או חריץ לצ'יפ אחד או יותר בערימה אנכית. אישור הוא תוכן של תיבת דו-שיח מקובע שבו מוצגת הודעה במשך פרק זמן נתון. יש בו מקום לסמל או לתמונה (שיכול להיות מונפש).
  • אינדיקטור דף אופקי – מציג את מיקום הדף האופקי באופן שמתאים לגורם הצורה הלביש. נועדה להציג את המסך המלא ולהציג אינדיקטור מעוקל במכשירים עגולים. אפשר להשתמש בו עם מציג הדף המלווה.
  • סמל – הטמעת Wear של Icon בעזרת צבע ואלפא מעיצוב העיצוב של Wear. אם מדובר בסמל שניתן ללחוץ עליו, ראו 'לחצן' או 'צ'יפ'.
  • בורר - מציג רשימה של פריטים לבחירה שניתן לגלול. כברירת מחדל, פריטים יחזרו על עצמם 'ללא הגבלה' בשני הכיוונים. אפשר להציג במצב קריאה-בלבד כדי להסתיר אפשרויות שלא נבחרו.
  • אינדיקטור מיקום – מציג את מיקום הגלילה או אינדיקציה אחרת למיקום באופן שמתאים לגורם הצורה הלביש. מיועד למסך מלא ומציג אינדיקטור מעוקל במכשירים עגולים.
  • פילינג - הטמעת מבנה הפריסה החזותי הבסיסי של Wear Material Design. הרכיב הזה מספק API שמרכיב מספר רכיבים של Wear Material (כמו TimeText, PositionIndicator ו-Vignette) שמרכיבים את המסך, מה שמבטיח עבורם אסטרטגיית פריסה מתאימה ואיסוף נתונים נדרשים כדי שהרכיבים האלו יפעלו יחד כראוי.
  • ScalingLazyColumn – רכיב רשימת קנה מידה או עין הדג גלילה שמהווה חלק מרכזי בשפה של Wear Material Design. מספק אפקטים של התאמה לעומס (scaling) ושקיפות לגבי פריטי התוכן. ScalingLazyColumn מתוכנן כך שיוכל להתמודד עם מספר גדול של פריטי תוכן שעשויים להיות מהותיים ומורכבים רק במקרה הצורך.
  • פס הזזה - מאפשר למשתמשים לבחור מתוך מגוון ערכים. טווח הבחירות מוצג כעמודה, שניתן להציג עם מפרידים.
  • שלבים – רכיב במסך מלא שמאפשר למשתמשים לבחור מתוך טווח ערכים באמצעות לחצני הגדלה או הקטנה בחלק העליון והתחתון של המסך, עם חריץ באמצע לטקסט או לצ'יפ.
  • SlidesToCloseBox - מטפל בתנועה של החלקה לסגירה. נדרש מיקום אחד לרקע (מוצג רק במהלך תנועת ההחלקה) ולתוכן שבחזית. ניתן לשלב אותו עם ספריית הניווט של androidx באמצעות SwipeDismissableNavHost (מידע נוסף זמין בספריית הניווט של Wear Compose בהמשך).
  • טקסט – הטמעת Wear של הרכיב Material Material Text, מקבלת צבע ואלפא מהעיצוב של Wear Material Design
  • TimeText – רכיב להצגת השעה וסטטוס הבקשה בראש המסך. התאמה לצורת המסך באמצעות טקסט מעוקל במסכים עגולים.

  • דהייה בשוליים – עיצוב מסך לשימוש ב-Scaffold לטשטוש החלק העליון והתחתון של המסך כשנעשה שימוש בתוכן שניתן לגלול.

  • גם הרכיבים הבאים כלולים ב-Wear Compose Foundation:

  • CurvedLayout - Wear Foundation CurvedLayout הוא פורמט קומפוזבילי לפריסה שמציב את הילדים בקשתות ומסובב אותם לפי הצורך. הדבר דומה לפריסת שורות שמעוקלת לקטע של אנולוס. לתשומת ליבכם: התוכן של CurvedLayout הוא לא lambda קומפוזבילי, אלא DSL (שפה ספציפית לדומיין). כל הרכיבים ב-DSL של CurvedLayout תומכים בפרמטר אופציונלי של מגביל, שנוצר מ-CurvedModifier.

  • BasicCurvedText – רכיב ב-DSL CurvedLayout, basicCurvedText מאפשר למפתחים לכתוב בקלות טקסט מעוקל שמופיע אחרי העקום של מעגל (בדרך כלל בקצה של מסך מעגלי). ניתן ליצור את basicCurvedText רק בתוך CurvedLayout כדי להבטיח את החוויה הטובה ביותר. למשל, אפשר לציין את המיקום ולהשתמש ב-CurvedModifiers. לידיעתכם, ברוב המקרים כדאי להשתמש במקום זאת ב-CorpText, כי הוא מבוסס על עיצוב מהותי.

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

  • מעוקל ו- מוצגים קעורים – בדומה ל'שורה' ו'עמודה', אפשר להציב את curvedRow ו-curvedColumn בתוך CurvedLayout כדי לפרוס את הרכיבים לפי הצורך. עבור curvedRow, ניתן לציין את הכיוון של הפריסה הזוויתית והיישור הרדיאלי. עבור curvedColumn, אפשר לציין את היישור הזוויתי והכיוון הרדיאלי.

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

  • גם הרכיב הבא נכלל בניווט עם Wear Compose:

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

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

שינויים ב-API

  • נוספו CurvedModifier.padding* פונקציות. המחרוזות האלה משמשות כדי לציין רווח נוסף שיש להוסיף סביב רכיב מעוקל. (I4db4)
  • הוסרה כיתה פנימית אחת (CompositionLocal) (I42490)
  • הוספנו ערכים קבועים לגודל הסמלים Button, CompactButton וToggleButton, כקו מנחה (I57cab)
  • צריך להוסיף את הפרמטר שהופעל ל-AppCard ול-TitleCard. עכשיו יש להם API שדומה ל-androidx.compose.material Cards. כשהפרמטר מוגדר כ-False, לא ניתן ללחוץ על הכרטיס. (Idc48d, b/228869805)

תיקוני באגים

  • מערכת Stepper משביתה עכשיו את לחצני ההקטנה וההגדלה כשמגיעים למגבלות העליונות/התחתיות (והמערכת מחילה את ContentAlpha.מושבת על iconColor) (I4be9f)
  • הוספנו מרווח פנימי של 1dp מסביב לתוכן של הבורר כששורטטה עם הדרגתיות כדי למנוע רעידות בטקסט שמופיע בזמן החלקה. (I0b7b9)
  • הוספת בדיקות של צילומי מסך עבור PositionIndicator (I5e8bc)
  • הוספת בדיקות נוספות עבור AppCard ו-TitleCard (I85391, b/228869805)

גרסה 1.0.0-alpha21

20 באפריל 2022

androidx.wear.compose:compose-foundation:1.0.0-alpha21, androidx.wear.compose:compose-material:1.0.0-alpha21 ו-androidx.wear.compose:compose-navigation:1.0.0-alpha21 שוחררו. גרסה 1.0.0-alpha21 מכילה את התחייבויות אלה.

תכונות חדשות

  • נוספו מגבילי התאמה מעוקלים חדשים כדי לציין את הרקע של רכיב מפותל: CurvedModifier.background, .radialGradientBackground ו-.angularGradientBackground (I8f392)
  • אפשר לציין מצב גלישת טקסט מעוקל (קליפ/שלוש נקודות/גלוי). (I8e7aa)
  • נוסף מקש הצירוף CurvedModifier.weight, בדומה לזה שב'כתיבה'. אפשר להשתמש בו בתווי צאצאים של CurvedRow ו-CurvedLayout (לרוחב) וצאצאים של CurvedColumn (לגובה). (I8abbd)
  • נוספו ערכי הצירוף CurvedModifier.size, .angularSize ו-.radialSize כדי לציין את הגודל של רכיב מעוקל. (I623c7)

שינויים ב-API

  • שינוי הסדר של הפרמטרים כדי לוודא שהרקע מופיע לפני הצבע באופן עקבי בכל ה-API של Wear Compose (I43208)
  • הוסר בכיוון השעון ו- פרמטרים של insideOut והוחלפו בקבועים מפורשים יותר במחלקות חדשות. עכשיו הכיוון של פריסה מעוקלת יכול להיות מודע ל-LayoutDirection, והוא עובר בירושה כשהוא לא מוגדר (If0e6a)
  • החלפנו את הטקסט autoCenter: Boolean בכתובת autoCenter: AutoCentringParams כדי לפתור בעיה ב-API של ScalingLazyColumn. (Ia9c90)
  • שינינו את השם של iconTintColor ושל toggleControlTintColor ל-iconColor ול-toggleControlColor ב-API (Chip/ToggleChip/Dialog/Slider/Stepper/...) כי הצבע חל על משבצת הסמל/toggleControl. (Ied238)
  • שכתוב PageIndicatorStyle enum לסיווג ערך (I2dc72)
  • הוספנו את RowScope/ColumnScope/BoxScope לחלק מהמשבצות במשחקים הקומפוזביליים שלנו כדי לציין למפתחים את ההנחות לפריסות. כך מפתחים יוכלו להשתמש בהתאמות נוספות בחלק מהתכנים של מיקומי המודעות, ולא יהיה צורך לספק רכיבי פריסה נוספים. בנוסף, ביצענו כמה עדכונים קלים בצבעים של AppCard/TitleCard כך שערכי ברירת המחדל של timeColor ו-appColor הם contentColor. עדיין תהיה אפשרות לשנות את כל המאפיינים בנפרד במקרה הצורך. (I26b59)
  • אובייקט SwipeToDismissBoxState.Companion הפך לפרטי (I39e84)
  • תיקון סדר הפרמטרים עבור InlineSlider ו-Stepper. שינוי פשוט בהתאם להנחיות ה-API (I11fec)
  • הסרנו את האובייקט Saver של SwipeToDismissBoxState כי לא נעשה בו שימוש. (Ifb54e)
  • עדכנו את CompactChip ועכשיו הוא מותאם למפרט החדש של חוויית המשתמש. המרווח הפנימי הופחת לפורמט אופקי = 12.dp ואנכי = 0.dp. הגופן של התווית השתנה מלחצן לכיתוב 1. גודלי הסמלים המומלצים הם 20x20 אם יש סמל וגם תווית, וגודל של 24x24 לצ'יפ קומפקטי של סמל בלבד. בתרחיש לדוגמה בלבד של הסמל, וידאנו גם שהסמל מיושר למרכז. (Iea2be)
  • הוספנו כמה שדות חדשים ל-ScalingLazyListLayoutInfo כדי לאפשר למפתחים לדעת אילו contentPadding ו-autoCenteringPadding הוחלו. הפרמטרים האלה יכולים להיות שימושיים למפתחים בחישוב של הנעה או גלילה (I7577b)
  • הטמענו מעברים פנימה או החוצה עבור Dialog. נוסף פרמטר showDialog, ותיבת הדו-שיח שולטת עכשיו בחשיפה שלה (התכונה הזו מאפשרת לתיבת הדו-שיח להריץ אנימציות פתיחה וסיום כשתיבת הדו-שיח מוצגת או מוסתרת). שימו לב שהאנימציה בסיום לא מתבצעת כשהמשתמש יוצא מתיבת הדו-שיח באמצעות החלקה לסגירה. הוספנו גם ערך ברירת מחדל למצב בעומס היתר של SwipeToDismissBox שנוסף לאחרונה. (I682a0)
  • כדי לספק תמיכה טובה יותר ב-i18n וב-a11y, שינינו את ToggleChip ואת SplitToggleChip כך שכבר לא תהיה בהם ברירת מחדל למשבצת toggleControl. שינינו גם את ToggleChipDefaults כך שהשיטות הבאות יחזירו עכשיו ImageVector במקום סמל (שימו לב שמכיוון שהן כבר לא מחזירות @Composables, הן השתנו כך שיתחילו באותיות קטנות), SwitchIcon()->switchIcon(), CheckboxIcon->checkboxIcon() ו-RadioIcon()->radioIcon(). זה מאפשר ומעודד מפתחים ליצור תכנים קומפוזביליים משלהם ב-Icon() עם קבוצת contentDescription מתאימה. (I5bb5b)
  • הוספנו את הפרמטר SwipeDismissableNavHostState לפרמטר SwipeDismissableNavHost. התכונה הזו תומכת בשימוש בהחלקה מהקצה במסכים שמשמשים כיעדי ניווט, כי עכשיו אפשר להעלות את SwipeToDismissBoxState ולהשתמש בו לאתחול של SwipeDismissableNavHostState וגם של Modifier.edgeSwipeToDismiss במסכים שנדרשת בהם החלקה מהקצה. (I819f5, b/228336555)

תיקוני באגים

  • מוודאים שפריסות המעוגלות מעודכנות במקרה הצורך. (Ie8bfa, b/229079150)
  • תיקון באג ב-https://issuetracker.google.com/issues/226648931 (Ia0a0a, b/226648931)
  • הוסרו הערות ניסיוניות מיותרות (I88d7e)

גרסה 1.0.0-alpha20

6 באפריל 2022

androidx.wear.compose:compose-foundation:1.0.0-alpha20, androidx.wear.compose:compose-material:1.0.0-alpha20 ו-androidx.wear.compose:compose-navigation:1.0.0-alpha20 שוחררו. גרסה 1.0.0-alpha20 מכילה את התחייבויות אלה.

תכונות חדשות

  • הוספת מגביל edgeSwipeToDismiss בשדה SwipeToDismiss. המדיניות swipeToDismiss יכולה להיות פעילה רק בקצה השמאלי של אזור התצוגה. משמש כשמרכז המסך צריך להיות מסוגל לעבור בין דפים אופקיים, כמו גלילה דו-ממדית במפה או החלקה אופקית בין דפים.(I3fcec, b/200699800)

שינויים ב-API

  • יישום בסיסי של CurvedModifiers , מאפשר להוסיף דרכים להתאמה אישית של תוכן מפותל (אבל עדיין לא סופקו CurvedModifiers, ויכול להיות שתהיה אפשרות ליצור תכונות שינוי בהתאמה אישית בהמשך) (I9b8df)
  • EdgeSwipeמסמכי תיעוד המשנים וערכי ברירת המחדל מתעדכנים כדי להבין טוב יותר .(I6d00d)
  • מוסיפים חריץ אחד (PageIndicator) ל-Saffold. הוספה של PageIndicator ישירות ל-Saffold עשויה להבטיח שהוא יוצג כראוי במכשירים עגולים. (Ia6042)
  • מסירים את סמלי ברירת המחדל מהפרמטרים InlineSlider ו-Stepper. כך המפתחים יוכלו להיות קשובים יותר לדרישות ההתאמה לשוק המקומי ולנגישות. השימושים בסמלי ברירת המחדל הוצגו בהדגמות ובדוגמאות. (I7e6fd)
  • מחליפים את שמות הפרמטרים Trailing and Leading (התחלה וסוף) ב-TimeText (Iaac32)
  • הוספנו עומס יתר של SwipeToDismissBox עם פרמטר onDismissed כדי לתמוך בשימוש נפוץ בהפעלת אירוע ניווט לאחר שתנועת ההחלקה מסתיימת. (I50353, b/226565726)
  • הוסרו ExperimentalWearMaterialApi הערות מהשימוש ב-TimeText (Ide520)
  • סימנו את ממשקי ההיקף והמידע של ScalingLazyList/Column כחסומים, כי הם לא מיועדים למפתחים חיצוניים להטמעה, וכך נוכל להוסיף אליהם חברים חדשים בעתיד ללא שינויים בכשלים בינאריים. (I7d99f)
  • הוספנו נכס flingBehaviour חדש לבורר ושיטת PickerDefaults.flingBehaviour() כדי להפעיל את ההגדרה של התנהגות ההטיה, כמו הוספת תמיכה ב-RSB. PickerState מטמיע את הממשק ScrollableState. (Ib89c7)

תיקוני באגים

  • עדכון כללי הפרופיל הבסיסיים של Android Runtime (ART) בספריות Wear Compose. מערכת ART יכולה להשתמש בכללי הפרופיל במכשירים כדי ליצור מראש קבוצת משנה ספציפית של אפליקציה ולשפר את הביצועים שלה. הערה: לא תהיה לכך השפעה על אפליקציות שניתנות לניפוי באגים. (Iaa8ef)
  • שיפור מסמכי התיעוד (I2c051)

גרסה 1.0.0-alpha19

23 במרץ, 2022

androidx.wear.compose:compose-foundation:1.0.0-alpha19, androidx.wear.compose:compose-material:1.0.0-alpha19 ו-androidx.wear.compose:compose-navigation:1.0.0-alpha19 שוחררו. גרסה 1.0.0-alpha19 מכילה את התחייבויות אלה.

שינויים ב-API

  • השם של CurvedRow שונה ל-CurvedLayout. הוא הוחל מחדש להיקף עם DSL. באמצעות ה-DSL הזה, ניתן לציין פריסות עקומות מורכבות יותר באמצעות סדרה של curvedRow ו-curvedColumn מקוננים (שהם המקבילות לפריסה מעוקלת של 'שורה' ו'עמודה'). בתוך רכיבי הפריסה האלה, אפשר להשתמש בשלושה רכיבים: curvedComposable (כדי להוסיף כל @Composable), basicCurvedText (הטקסט המעוקל של הבסיס) ו-curvedText (ללבוש טקסט מעוקל תוך התמקדות בתוכן). (Ib776a)
  • מגדירים את הצד של PositionIndicator. עכשיו ניתן להגדיר את המיקום של מחוון המיקום הבסיסי בתור 'קצה' (מכוון לכיוון הפריסה), OppositeRsb (מביא בחשבון סיבוב מסך, כדי למקם את עצמו מול ה-RSB הפיזי) או כערכים המוחלטים משמאל ו- בסדר. (I2f1f3)
  • עבור SwipeToDismissBox שינינו את השם של SwipeDismissTarget.המקורית ל-SwipeToDismissValue.Default ול-SwipeDismissTarget.Dismissal ל-SwipeToDismissValue.Dismissed. בנוסף, העברנו את ההגדרות של SwipeToDismissBoxDefaults.BackgroundKey ו-SwipeToDismissBoxDefaults.ContentKey אל SwipeToDismissKeys.Background, SwipeToDismissKeys.Content בהתאמה. (I47a36)
  • הוספנו ל-Selecter מצב קריאה-בלבד, למסכים עם מספר משתמשים שבו ניתן לערוך רק בורר אחד בכל פעם. כשהבוחר מוגדר לקריאה בלבד, מוצגת האפשרות הנוכחית שנבחרה, ותווית אם ניתנה. (I879de)
  • בוצע ארגון מחדש של SwipeToDismissBoxState כדי להגביל את ההיקף של ExperimentalWearMaterialApi ל-Modifier.swipeable ו-SwipeableState, שנמצאים עכשיו בשימוש פנימי. ל-SwipeToDismissBoxState יש עכשיו חברים ב-currentValue, ב-targetValue, ב-isAnimationRunning וב-snapTo לתמיכה בתרחישים נפוצים. אפשר לפנות אלינו אם יש לך צורך בנכסים נוספים. תוקנה גם ההתנהגות של SwipeableState במקרה שבו היסט ההחלקה נמצא בתוך שגיאת עיגול של עוגן. (I58302)

תיקוני באגים

  • קוד פשוט וקבוע לזיהוי אם ניתן לגלול את התוכן של ScalingLazyColumn (משמש להחלטה אם להציג סרגל גלילה או לא) (I7bce0)
  • תוקן באג במדד המיקום כשמשתמשים בכמה מצבים ומחליפים ביניהם (I320b5)
  • עדכנו את הטיפוגרפיה/הגופנים של העיצוב המוגדר כברירת מחדל ב-Wear OS ל-Wear OS כך שיתאימו להנחיות האחרונות בנושא חוויית המשתמש. לתשומת ליבכם: display1 (40.sp) ו-display2 (34.sp) קטנים עכשיו מהערכים הקודמים, וביצענו כמה עדכונים קטנים נוספים בגובה השורה ובריווח השורות. (Ie3077)
  • הוספנו התנגדות לSwipeToDismissBox כך שתנועה תתרחש רק כשהחלקה כדי לסגור, ולא בכלל בכיוון ההפוך. (Ifdfb9)
  • שינינו כמה מערכי הפרמטרים שמוגדרים כברירת מחדל לפונקציות CircularProgressIndicator כדי להתאים אותן להנחיות חוויית המשתמש של Wear Material Design. עבור גרסת Spinner/Indeterminant, עודכנו הגודל (40->24.dp), צבע המחולק (primary->onBackground), שקיפות צבעי מעקב (30%->10%) ורוחב הקווים (4->3dp) עודכנו. עבור גרסת 'התקדמות/קבוע', השקיפות TrackColor (30%->10%) עודכנה. (I659cc)
  • עדכנו את הפרמטרים של ברירת המחדל להתאמה לעומס (scaling) של ScalingLazyColumn, כך שהם תואמים למפרטי חוויית המשתמש העדכניים ביותר של Wear Material Design. מבחינה חזותית, כתוצאה מכך מתקבלת התאמה לעומס של פריטים ברשימה קרוב יותר למרכז הרשימה, אבל ההיקף קטן יותר בקצה הרשימה מבעבר. (Ica8f3)
  • כמה התאמות של ScalingLazyColumnDefaults.snapFlingBehavior כדי לשפר את סוף האנימציה (If3260)

גרסה 1.0.0-alpha18

9 במרץ 2022

androidx.wear.compose:compose-foundation:1.0.0-alpha18, androidx.wear.compose:compose-material:1.0.0-alpha18 ו-androidx.wear.compose:compose-navigation:1.0.0-alpha18 שוחררו. גרסה 1.0.0-alpha18 מכילה את התחייבויות אלה.

שינויים ב-API

  • מספר שיפורים במחוון המיקום: הצגת תוצאה שינה את השם של PositionIndicatorVisibility. שיפורי ביצועים מסוימים כדי למנוע חישובים מחדש במקרה הצורך (Iaed9d)
  • הצבע המומלץ עבור SplitToggleChip עודכן. עכשיו יש ל-SplitToggleChip רקע בצבע אחיד כשהוא מסומן או לא מסומן, וצבוע של SwitchControl הוא האינדיקציה העיקרית לכך שהרכיב מסומן או לא. הוספנו ToggleDefaults.splitToggleChipColors() חדש כדי לתמוך בערכת הצבעים החדשה. בנוסף, הפכנו את השיטות של toggleChipColors() לפשוטות יותר תוך הסרת ה-SplitBackgroundOverlayColor (I7e66e)
  • הוספנו את הערך uncustomedSize ל-ScalingLazyListItemInfo כי לא בטוח לחשב את גודל הפריט המקורי באמצעות הגודל המותאם אישית וגורם קנה המידה בגלל רמת דיוק מתמטית של מספר ממשי (float). (I54657, b/221079441)
  • הוספה של HorizontalPageIndicator. הוא מייצג את המספר הכולל של הדפים ואת הדף שנבחר. המכשיר עשוי להיות לינארי או מעוקל, בהתאם לצורת המכשיר. הוא תומך גם בצורה מותאמת אישית של אינדיקטור, שמגדיר איך כל אינדיקטור מיוצג באופן חזותי. (Iac898)
  • עדכנו את PickerState כך שניתן יהיה לעדכן את numberOfOptions. האפשרות הזו תומכת בתרחישים לדוגמה כמו DatePicker, שבו מספר הימים בחודש משתנה בהתאם לחודש שנבחר. פרמטר ה-constructor של PickerState השתנה ל-InitialNumberOfOptions בהתאם. (Iad066)
  • הסתרת PositionIndicator כשמוצג סרגל גלילה ואי אפשר לגלול. (Id0a7f)
  • כדי לשמור על עקביות עם Scaffold, ברכיב של תיבת הדו-שיח במסך מלא מוצגים עכשיו PositionIndicator ו-Vignette. אנחנו גם משתמשים עכשיו ב-ScalingLazyColumn במקום ב-Column, כלומר התוכן של תיבת הדו-שיח נמצא עכשיו ב-ScalingLazyListScope (ובדרך כלל צריך להיות מוקף בפריט { /* content */ }). תיבת הדו-שיח תומכת בפרמטרverticalArrangement בהתאם. (Idea13)
  • שינינו את השם של מאפיין המתג ToggleChip ו-SplitToggleChip כדי להפעיל או להשבית את הבקרה כדי להתאים את העיצוב באופן טוב יותר ל-Material Design, במטרה לעזור למעצבים ולמפתחים לנווט ב-API. (If5921, b/220129803)
  • הוספנו ערך חדש לכיתוב 3 ל-Wear Material Theme Typology.Caption3 הוא גופן קטן המשמש לכתיבה ארוכה במיוחד, כמו טקסטים משפטיים. (I74b13, b/220128356)

תיקוני באגים

  • תפסיקו את האנימציה המצולמת כשאנחנו מגיעים לשם. (Idb69d)
  • הצגת שינויים במחוון המיקום. (I94cb9)
  • על סמך משוב לגבי ממשק המשתמש או חוויית המשתמש, שינינו את המרכז האוטומטי של ScalingLazyColumn כך שהוא יספק רק מספיק מקום כדי להבטיח שתהיה אפשרות לגלול באופן מלא את הפריטים עם האינדקס ScalingLazyListState.initialCenterItemIndex ומעלה למרכז אזור התצוגה. כך מפתחים יכולים למקם במרכז פריט אחד או שניים לגבי הפריט, שלא ניתן לגלול באמצע. פירוש הדבר הוא ש-ScalingLazyColumn של מרכז אוטומטי לא יוכל לגלול מעל initialCenterItemIndex/initialCenterItemScrollOffset (I22ee2)
  • הוספנו הדגמה של הכלי לבחירת תאריכים ותקנו באג ב-PickerState, שבו האפשרות הראשונית [נבחרה] לא הוחלה עד שהבורר הוצג. (Id0d7e)
  • כדי לצמצם את החיתוך של פריטי ScalingLazyColumn רחבים יותר במסכים עגולים, הגדלנו את המרווח הפנימי המוגדר כברירת מחדל לתוכן אופקי מ-8 ל-10dp. (I0d609)
  • מוודאים שה-PositionIndicator מוצג בזמן הגלילה. (Ied9a2)

גרסה 1.0.0-alpha17

23 בפברואר 2022

androidx.wear.compose:compose-foundation:1.0.0-alpha17, androidx.wear.compose:compose-material:1.0.0-alpha17 ו-androidx.wear.compose:compose-navigation:1.0.0-alpha17 שוחררו. גרסה 1.0.0-alpha17 מכילה את התחייבויות אלה.

תכונות חדשות

  • הוספנו תמיכה ב-Snap שניתן להשתמש בה עם ScalingLazyColumn. יש להגדיר את flingBehavior = ScalingLazyColumnDefaults.flingWithSnapBehavior(state) כדי להפעיל תמיכה בהצמדה. (I068d3, b/217377069)
  • הוספנו הדגמות ל- Picker בוחרים שעה בשעון של 24 שעות או 12 שעות. (Ie5552)

שינויים ב-API

  • תיקון בעיה ב-TimeText גופנים וגופנים מותאמים אישית סגנונות במכשיר ריבועי (Iea76e)
  • ב-ScalingLazyListLayoutInfo יש עכשיו מאפייני reverseLayout, viewportSize וכיוון שתואמים לאלו של LazyListLayoutInfo (I4f258, b/217917020)
  • ב-ScalingLazyColumn יש עכשיו נכס userScrollEnabled שתואם ל-LazyList (I164d0, b/217912513)
  • לבוררים יש עכשיו הדרגתיות בחלק העליון והתחתון כברירת מחדל (Iab92a)

תיקוני באגים

  • שינינו את ScalingLazyColumn כך שהוא כבר לא ימלא את כל השטח בהורה שלו בחמדנות. במקום זאת, הקובץ יקבל את הגודל שלו בהתאם לגודל התוכן שלו. לכן הוא תואם להתנהגות של LazyColumn. כדי להחזיר את ההתנהגות הקודמת, צריך להעביר את הפקודה Modifier.fillMaxWidth()/width()/widthIn() אל ScalingLazyColumn (I51bf8)
  • שיפרנו את הודעת החריגה ב-SwipeDismissableNavHost.kt שהופעלה אם המקבץ האחורי של הניווט הייתה ריקה. (I1b1dc)

גרסה 1.0.0-alpha16

9 בפברואר 2022

androidx.wear.compose:compose-foundation:1.0.0-alpha16, androidx.wear.compose:compose-material:1.0.0-alpha16 ו-androidx.wear.compose:compose-navigation:1.0.0-alpha16 שוחררו. גרסה 1.0.0-alpha16 מכילה את התחייבויות אלה.

תכונות חדשות

  • הוספה של CircularProgressIndicator. מחווני התקדמות מציגים את משך התהליך או זמן המתנה שלא צוין. תומכת בפער (cutout) ב-TimeText או ברכיבים אחרים אם משתמשים במסך מלא. (Iab8da)

שינויים ב-API

  • עכשיו יש לבוררים פרמטר flingBehavior, ערך ברירת המחדל גורם להם להיצמד לאפשרות הקרובה ביותר כשגוללים או מחליקים. (I09000)
  • API של מספר שלם נוסף ל-InlineSlider ול-Stepper (I1b5d6)

תיקוני באגים

  • שינינו את ברירת המחדל של startCenterItemIndex עבור ScalingLazyListState מ-0->1. כלומר, אלא אם מבטלים את השינוי בבניית המדינה באמצעות ScalingLazyListState.rememberScalingLazyListState(initialCenterItemIndex =), הפריט השני ברשימה (index == 1) ימוקם במרכז אזור התצוגה בזמן האתחול והפריט הראשון (index == 0) ימוקם לפניו. כך ניתן ליצור אפקט חזותי טוב יותר שמוגדר כברירת מחדל מחוץ לתיבה, כי רוב אזור התצוגה יהיה מלא בפריטים ברשימה. (I0c623, b/217344252)
  • הורדנו את ערך ברירת המחדל של ScalingLazyColumn מסוג extraPadding שנקבע כדי להבטיח שיש מספיק פריטים ברשימה לצייר (גם אם נקטין חלק מהם בגודלם) מ-10% ל-5%. פעולה זו תימנע מכתיבת פריטים נוספים ברשימה שייתכן שלא יופיעו באזור התצוגה. אם נעשה שימוש ב-scalingParams לא סטנדרטי (למשל, התאמה לעומס (scaling) בצורה קיצונית יותר), המפתח יכול להתאים מרווח פנימי נוסף באמצעות viewportVerticalOffsetResolver. (I76be4)
  • פתרון בעיה שקשורה ל-TimeText במספר שורות במכשיר ריבועי (Ibd3fb)
  • שינינו את ScalingLazyColumn כך שהוא כבר לא ימלא את כל השטח בהורה שלו בחמדנות. במקום זאת, הקובץ יקבל את הגודל שלו בהתאם לגודל התוכן שלו. לכן הוא תואם להתנהגות של LazyColumn. אם ברצונך להחזיר את ההתנהגות הקודמת, יש להעביר את Modifier.fillMaxSize() אל ScalingLazyColumn. הערה: השינוי הזה לא הושלם והוא יטופל בשינוי מעקב בגרסת האלפא הבאה. (I3cbfa)

גרסה 1.0.0-alpha15

26 בינואר, 2022

androidx.wear.compose:compose-foundation:1.0.0-alpha15, androidx.wear.compose:compose-material:1.0.0-alpha15 ו-androidx.wear.compose:compose-navigation:1.0.0-alpha15 שוחררו. גרסה 1.0.0-alpha15 מכילה את התחייבויות אלה.

שינויים ב-API

  • הוספנו נכס חדש autoCentering ל-ScalingLazyColumn. אם הערך הוא True (ברירת המחדל), ניתן יהיה לגלול את כל הפריטים, כולל הפריט הראשון והאחרון, כך שיהיו גלויים במרכז של אזור התצוגה של הרשימות. הערה: אם משתמשים במרכוז אוטומטי, מומלץ להגדיר מרווח פנימי של תוכן אנכי ל-0.dp. אם תספקו גם מרכוז אוטומטי וגם מרווח פנימי של תוכן, שניהם יגרמו לשטח נוסף פנוי לפני הפריט הראשון ואחרי הפריט האחרון ברשימה, מה שיאפשר גלילה נוספת. (I2a282, b/214922490)
  • הוספנו רכיב Dialog שמאפשר לכל תוכן קומפוזבילי להפעיל תיבת דו-שיח במסך מלא שנמצאת מעל תוכן אחר. כשמוצגת תיבת הדו-שיח, יש תמיכה בהחלקה לסגירה, והתוכן של ההורה יוצג ברקע במהלך תנועת ההחלקה. התוכן של תיבת הדו-שיח צריך להיות Alert או Confirmation (שינוי השם מהרכיבים המוקדמים יותר AlertDialog ו-ConfirmationDialog) – Alert, Confirmation ו-Dialog נמצאים כולם בחבילה androidx.wear.compose.material.dialog. אפשר להשתמש בהתראה ובאישור כיעדי ניווט. כמו כן, הוספנו את ColumnScope לפרמטרים של Alert (התראה) ו-Confirm (אישור) לפי הצורך. (Ia9014)
  • הסרנו את onSurfaceVariant2 מהגדרות ה-Compose for Material Designs ל-WearOS והחלפנו את השימושים בספרייה ב-onSurfaceVariant. (Icd592)
  • נוספה שיטה כדי לבחור אפשרות באופן פרוגרמטי ב-PickerState. עכשיו אפשר לציין את האפשרות שנבחרה גם כשיוצרים PickerState. (I92bdf)
  • הוספנו תמיכה בהתאמה אישית של התנהגות ההחלקה של ScalingLazyColumn. (I1ad2e, b/208842968)
  • הוספנו את NavController.currentBackStackEntryAsState() לספרייה Wear.Compose.Navigation. (If9028, b/212739653)
  • נוספו Modifier.onRotaryScrollEvent() ו-Modifier.onPreRotaryScrollEvent() למכשירי Wear עם לחצן צד מסתובב.(I18bf5, b/210748686)

גרסה 1.0.0-alpha14

12 בינואר, 2022

androidx.wear.compose:compose-foundation:1.0.0-alpha14, androidx.wear.compose:compose-material:1.0.0-alpha14 ו-androidx.wear.compose:compose-navigation:1.0.0-alpha14 שוחררו. גרסה 1.0.0-alpha14 מכילה את התחייבויות אלה.

תכונות חדשות

  • הוספנו מספר שיטות ל-ScalingLazyListState כדי לאפשר למפתחים לשלוט בגלילה לפריטים ספציפיים ברשימה וגם להגדיר את הפריט הראשוני ואת ההיסט ברשימה.

    כחלק מהשינוי, שינינו גם את ScalingLazyList כך שהיא תהיה ממוקדת מסביב למרכז אזור התצוגה של ScalingLazyList, ולא בהתחלה של אזור התצוגה.

    מאפיין חדש anchorType: ScalingLazyListAnchorType = ScalingLazyListAnchorType.ItemCenter נוסף ל-ScalingLazyList כדי לקבוע אם המרכז (ScalingLazyListAnchorType.ItemCenter) או Edge (ScalingLazyListAnchorType.ItemStart) צריך להיות מיושר לקו האמצע של אזור התצוגה.

    כתוצאה מכך, הערכים ScalingLazyListItemInfo.offset ו-ScalingLazyListItemInfo.adjustedOffset השתנו ועכשיו הם משקפים את ההיסט של הפריט ביחס למיקום של הפריט ברשימה ול-anchorType של הרשימה. לדוגמה עבור ScalingLazyColumn עם anchorType של ItemCenter ופריט ברשימה שממוקם במרכז שלו על קו האמצע של אזור התצוגה, ההיסט יהיה 0.

    השיטות החדשות הן scrollTo, animatedScrollTo, centerItemIndex ו-centerItemOffset. (I61b61)

  • הוספנו handler של לחצן 'הקודם' ל-SwipeDismissableNavHost, כך שלחיצה על 'חזרה' תעביר אתכם לרמה הקודמת בהיררכיית הניווט. (I5b086, b/210205624)

גרסה 1.0.0-alpha13

15 בדצמבר 2021

androidx.wear.compose:compose-foundation:1.0.0-alpha13, androidx.wear.compose:compose-material:1.0.0-alpha13 ו-androidx.wear.compose:compose-navigation:1.0.0-alpha13 שוחררו. גרסה 1.0.0-alpha13 מכילה את התחייבויות אלה.

שינויים ב-API

  • הפכנו את RangeIcons להגדרה פנימית (הפניה פנימית על ידי InlineSlider ועל Stepper). (I927ec)

תיקוני באגים

  • תוקנה בעיה שגרמה להוספה של יעד להיררכיית הכתיבה על ידי SwipeDismissableNavHost לפני שהיא הגיעה למצב CREATED של מחזור החיים, וכתוצאה מכך התקבל IllegalStateException. התיקון הזה היה דרישה מוקדמת לעדכון התלות ב-navigation-compose ל-2.4.0-beta02 והלאה. (I40a2b, b/207328687)

  • נוספה מחלקה מסוג 'טיפוסים בני מנייה (enum)' לצורך קבלת משאבים שניתן להזזה בספרייה של Wear Compose, כך שאין יותר צורך בחשיבה. תיקון באג שגרם להסרה של פריטים ניתנים להזזה של ספרייה כאשר minifyEnabled=true או shrinkResources=true הוסרו. (Ib2a98)

  • נוספו בדיקות של Stepper ב-Wear Compose (I2d03a)

  • נוספו דוגמאות של SwipeDismissableNavHost בניווט עם Wear Compose. (I85f06)

גרסה 1.0.0-alpha12

1 בדצמבר 2021

androidx.wear.compose:compose-foundation:1.0.0-alpha12, androidx.wear.compose:compose-material:1.0.0-alpha12 ו-androidx.wear.compose:compose-navigation:1.0.0-alpha12 שוחררו. גרסה 1.0.0-alpha12 מכילה את התחייבויות אלה.

תכונות חדשות

  • הוספנו רכיב Stepper שמאפשר למשתמשים לבחור מתוך מגוון ערכים. Stepper היא שליטה במסך מלא עם לחצני הגדלה והקטנה בחלק העליון והתחתון, וגם חריץ באמצע (צפוי לקבל צ'יפ או טקסט). אפשר להתאים אישית את סמלי הלחצנים לפי הצורך. (I625fe)

  • הוספנו 2 תכנים קומפוזביליים חדשים להצגת תיבות דו-שיח: AlertDialog מחכה לתשובה מהמשתמש ומציג כותרת, סמל, הודעה וגם א) שני לחצנים לבחירות פשוטות או שליליות, או ב) צ'יפים שהוערמו אנכית או צ'יפים של החלפת מצב לאפשרויות גמישות יותר, CertificateDialog מציגה אישור עם זמן קצוב לתפוגה. תיבת הדו-שיח הפשוטה הזו כוללת חריצים לכותרת ולסמל (מונפש). (Ic2cf8)

שינויים ב-API

  • הוספה של יחידות (אלפיות שנייה) לערכי משך הזמן המוצעים של תיבת הדו-שיח. (I09b48)

גרסה 1.0.0-alpha11

17 בנובמבר 2021

androidx.wear.compose:compose-foundation:1.0.0-alpha11, androidx.wear.compose:compose-material:1.0.0-alpha11 ו-androidx.wear.compose:compose-navigation:1.0.0-alpha11 שוחררו. גרסה 1.0.0-alpha11 מכילה את התחייבויות אלה.

תכונות חדשות

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

שינויים ב-API

  • נוסף ScalingLazyItemScope ומספר מתאמים חדשים למילויParentMaxSize/fillParentMaxwidth/fillParentMax לרוב כדי לאפשר התאמה של גודל פריטים ברשימה לפי הגודל של מאגר ההורה. אפשר להגדיר פריטים כך שימלאו את כל הגודל של תבנית ההורה או חלק ממנה. הפעולה הזו חושפת פונקציונליות שכבר זמינה ב-LazyRow/Column (I4612f)
  • נוספה תמיכה ב-ScalingLazyColumn כדי לאפשר לפריטים לקבל מפתח. כמו כן, הוספנו שיטות נוחות כדי לאפשר הוספת פריטים ממערך ומרשימות. (Ic1f89)

תיקוני באגים

  • דוגמאות נוספות ל-TimeText (I8cb64)

גרסה 1.0.0-alpha10

3 בנובמבר 2021

androidx.wear.compose:compose-foundation:1.0.0-alpha10, androidx.wear.compose:compose-material:1.0.0-alpha10 ו-androidx.wear.compose:compose-navigation:1.0.0-alpha10 שוחררו. גרסה 1.0.0-alpha10 מכילה את התחייבויות אלה.

תכונות חדשות

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

  • כדאי לנסות את תכונת הכתיבה החדשה של WearOS Codelab!

שינויים ב-API

  • מדד מאקרובנצ'מרק כולל עכשיו minSdkVersion של 23. (If2655)

תיקוני באגים

  • עדכון הטיפול במעבר ב: להחליקDismissableNavHost באפקט לוואי (I04994, b/202863359)
  • עדכון הטיפול במעבר ב: SlidesableNavHost (I1cbe0, b/202863359)

גרסה 1.0.0-alpha09

27 באוקטובר 2021

androidx.wear.compose:compose-foundation:1.0.0-alpha09, androidx.wear.compose:compose-material:1.0.0-alpha09 ו-androidx.wear.compose:compose-navigation:1.0.0-alpha09 שוחררו. גרסה 1.0.0-alpha09 מכילה את התחייבויות אלה.

תכונות חדשות

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

שינויים ב-API

  • הוספנו תמיכה למפתחים כדי לאפשר להם להתאים אישית את כל הצבעים בעיצוב החדש של Wear Material Design. (I4759b, b/199754668)

תיקוני באגים

  • נוספו דוגמאות של WAPToDismissBox שנשארות במצב קבוע (Ibaffe)
  • נוספו קישורים למדריכים בכתובת developer.android.com מ-KDocs ל-CurvedText, TimeText ו להחליקToDismissBox. (I399d4)
  • אם אין יעד נוכחי, ההגדרה SlidesableNavHost תושפע עכשיו אם אין יעד נוכחי (מציין Nav Graph לא נבנה באמצעות wear.compose.navigation.composable Utility function) (I91403)
  • נוספו מסמכים ודוגמאות נוספים לשימוש במקור זמן ב-TimeText (I4f6f0)

גרסה 1.0.0-alpha08

13 באוקטובר 2021

androidx.wear.compose:compose-foundation:1.0.0-alpha08, androidx.wear.compose:compose-material:1.0.0-alpha08 ו-androidx.wear.compose:compose-navigation:1.0.0-alpha08 שוחררו. גרסה 1.0.0-alpha08 מכילה את התחייבויות אלה.

שינויים ב-API

  • שינינו את השם של נכסי AppCard ו-TitleCard body ל-content והעברנו אותם לסוף רשימת הנכסים כדי לאפשר להם להיות מסומנים כ-lambda בסוף. שינינו גם את השם של bodyColor לשם contentColor כדי לשמור על עקביות עם השמות החדשים של מיקומי המודעות. (I57e78)

תיקוני באגים

  • קישורים נוספו אלdeveloper.android.com מדריכים מ-KDocs עבור לחצן, כרטיס, צ'יפ, עיצוב, מחוון מיקום והתאמה לעומס (scaling) של רכיבי עמודה. (I22428)
  • פתרון בעיות שקשורות ל-WearOS TapToDismissBox שלפעמים לא מטפלת בהחלקות. (I9387e)
  • נוספו דוגמאות עבור 'לחצן', 'לחצן קומפקטי', Chip, CompactChip, AppCard, TitleCard, לחצן החלפת מצב, SwitchChip, SplitToggleChip (Iddc15)
  • נוספו בדיקות ביצועים של מיקרו-בנצ'מרק עבור כרטיס, צ'יפ, החלפת צ'יפ, TimeText ו-ScalingLazyColumn. (If2fe9)

גרסה 1.0.0-alpha07

29 בספטמבר 2021

androidx.wear.compose:compose-foundation:1.0.0-alpha07, androidx.wear.compose:compose-material:1.0.0-alpha07 ו-androidx.wear.compose:compose-navigation:1.0.0-alpha07 שוחררו. גרסה 1.0.0-alpha07 מכילה את התחייבויות אלה.

תכונות חדשות

  • נוסף רכיב CurvedText בחומר, רכיב שמאפשר למפתחים לכתוב בקלות טקסט מעוקל שמופיע אחרי עקומים של מעגל (בדרך כלל בקצה של מסך עגול). (I19593)

שינויים ב-API

  • נוספו בדיקות של TimeText (Idfead)
  • הופכים את ArcPatingValues לממשק. (Iecd4c)
  • נוספה אנימציה ל-SlideToDismissBox (I9ad1b)
  • נוסף הפרמטר hasBackground ל-SlideToDismissBox כדי שאפשר יהיה להשבית את תנועת ההחלקה אין תוכן רקע להצגה. (I313d8)
  • rememberNavController() הוא עכשיו אופציונלי קבוצה של Navigator מופעים שיתווספו אל הוחזרו NavController לתמיכה טובה יותר אופציונלית מכשירי ניווט כמו אלה חומר ניווט למלווה. (I4619e)
  • הפניה בשם NamedNavArgument מאת ניווט נפוץ והסרת עותק מ- wear.compose.navigation. (I43af6)

תיקוני באגים

  • תוקנה רמת הרגישות של הבדיקה של CurvedRow במכשירים קטנים יותר. (If7941)
  • תיקנו הבהובים אפשריים ב-CurvedRow כשהתוכן מתעדכן, ומבטיח שהשורה המעוגלת תימדד מחדש (Ie4e06).
  • ChipDefaults.BackgroundChipColors() עודכן בהתאם לשינויים במפרטי חוויית המשתמש. ההדרגתיות מתחילה עכשיו ב-MaterialTheme.colors.primary באלפא 32.5% ומסתיימת ב-MaterialTheme.colors.surface עם alpha @ 0% על רקע של MaterialTheme.colors.surface ב-75% alpha. (Id1548)
  • עדכנו את הצבעים של BluetoothChip במצב שנבחר, כך שיתאימו להנחיות העדכניות של מפרטי חוויית המשתמש ב-Wear Material Design. לאחר הבחירה באפשרות SwitchChips, יש עכשיו רקע הדרגתי מ-MaterialTheme.color.surface @ 0% alpha, בפינה השמאלית העליונה עד MaterialTheme.color.primary @ 32% alpha, ימין למטה, על רקע של MaterialTheme.color.surface ב-75% alpha. התוצאה היא הבדל עדין יותר בין מצב מסומן לבין לא מסומן עבור מתג החלפת המצב. (Idd40b)

גרסה 1.0.0-alpha06

15 בספטמבר 2021

androidx.wear.compose:compose-foundation:1.0.0-alpha06, androidx.wear.compose:compose-material:1.0.0-alpha06 ו-androidx.wear.compose:compose-navigation:1.0.0-alpha06 שוחררו. גרסה 1.0.0-alpha06 מכילה את התחייבויות אלה.

תכונות חדשות

  • הוספנו את Scaffold של אפליקציה קומפוזבילית ברמה העליונה שמספקת מבנה לטיפול במיקום מדדי מיקום (כמו גלילה או נפח), אזור בחלק העליון של המסך להצגת השעה וסטטוס האפליקציה, וגם תומכת בדהייה בשוליים לטשטוש הקצה העליון והתחתון של המסך לתוכן שניתן לגלול. האזור הראשי של ה-Saffold הוא המקום שבו מוצבים התוכן של האפליקציה. (I5e0bf)
  • נוספה הטמעת TimeText של Wear Compose (I5654c)

ספריית הניווט של Wear Compose

  • הוספנו את הגרסה הראשונה של ספריית הניווט ל-Wear Compose, שמספקת שילוב בין ספריות הניווט של Wear Compose ושל Androidx. זהו אמצעי פשוט לניווט בין פונקציות @Composable כיעדים באפליקציה.

  • הגרסה הראשונית הזו מספקת:

    • תוכן קומפוזבילי עם SwipeDismissableNavHost שמארח תרשים ניווט ומספק ניווט אחורה באמצעות תנועות החלקה
    • התוסף NavGraphBuilder.composable שעוזר לבנות תרשימי ניווט
    • rememberSwipeDismissableNavController() כדי לאפשר מצב העלאה

  • שימוש לדוגמה שבו אנחנו יוצרים שני מסכים ומנווטים ביניהם:

    val navController = rememberSwipeDismissableNavController()
SwipeDismissableNavHost(
    navController = navController,
    startDestination = "start"
) {
    composable("start") {
        Column(
            horizontalAlignment = Alignment.CenterHorizontally,
            verticalArrangement = Arrangement.Center,
            modifier = Modifier.fillMaxSize(),
        ) {
            Button(onClick = { navController.navigate("next") }) {
                Text("Go")
            }
        }
    }
    composable("next") {
        Column(
            horizontalAlignment = Alignment.CenterHorizontally,
            verticalArrangement = Arrangement.Center,
            modifier = Modifier.fillMaxSize(),
        ) {
            Text("Swipe to go back")
        }
    }
}

  • הניווט ב-Wear Compose נארז כספרייה נפרדת, כך שאפליקציות פשוטות ל-WearCompose שמטמיעות שיטת ניווט משלהן באופן ידני לא נדרשות להיות תלויות בספריית הניווט של Androidx.

שינויים ב-API

  • SwipeDismissableNavHost עודכן לתמיכה rememberSaveable על ידי הגדרה של זהות המפתח לרקע ולתוכן (I746fd)
  • הוספנו מתאם PositionIndicator שיכול לטפל ב-LazyListState (I21b88)
  • עודכן ב-SlideToDismissBox כדי לתמוך בשמירת נתונים (Ie728b)
  • הוספנו ל-ScalingLazyColumn תמיכה בפריסה הפוכה. הפעולה הזו מאפשרת את ההיפוך של כיוון הגלילה והפריסה (I9e2fc)
  • הוצאו משימוש performGesture ו-GestureScope, שכוללים הוחלף על ידי performTouchInput ו-TouchInjectionScope. (Ia5f3f, b/190493367)
  • שינינו את השם של VignetteValue ל-VgnettePosition ושינינו את השם של VignetteValue.Both ל-VgnettePosition.TopAndBottom. (I57ad7)
  • שינינו את השם של ScalingLazyColumnState ל-ScalingLazyListState, ScalingLazyColumnItemInfo ל-ScalingLazyListItemInfo, ScalingLazyColumnLayoutInfo ל-ScalingLazyListLayoutInfo וב-ScalingLazyScope ל-ScalingLazyListScope במקרה שנחליט להוסיף את ההטמעה העתידית ScalingLazyListItemInfo. (I22734)

תיקוני באגים

  • תיעוד של CompactChip עודכן כדי לתאר מה קורה אם לא סופקו סמל או תווית. (I4ba88)
  • ביצענו כמה שינויים ברכיבים של כרטיס Wear. (I6b3d0)
    1. הריווח בין כותר לגוף הוקטן מ-8.dp ל-2.dp.
    2. גופן הכותרת של כרטיס הכותרת השתנה מגוף לכותרת 3.
    3. הדרגתיות של רקע הכרטיס השתנתה כדי לגרום לרקע להיראות כהה יותר.

גרסה 1.0.0-alpha05

1 בספטמבר 2021

androidx.wear.compose:compose-foundation:1.0.0-alpha05 ו-androidx.wear.compose:compose-material:1.0.0-alpha05 שוחררו. גרסה 1.0.0-alpha05 מכילה את התחייבויות אלה.

שינויים ב-API

  • סימון ArcPRevenueValues כ- @Stable (I57deb)
  • ב-ScalingLazyColumnState מוטמע עכשיו הממשק ScrollableState שמאפשר למפתחים גישה פרוגרמטית לגלילה של הרכיב. (I47dbc)

תיקוני באגים

  • הקטנו את הריווח בין Icon ל-Text in Chip ו-SwitchChip כדי להתאים אותם לעדכונים במפרט חוויית המשתמש. (I83802)

גרסה 1.0.0-alpha04

18 באוגוסט 2021

androidx.wear.compose:compose-foundation:1.0.0-alpha04 ו-androidx.wear.compose:compose-material:1.0.0-alpha04 שוחררו. גרסה 1.0.0-alpha04 מכילה את התחייבויות אלה.

תכונות חדשות

  • נוספה מקש TalkBackToDismissBox ומקש החלקה שניתן להשתמש בו כדי לתמוך בתנועת החלקה משמאל לימין לסגירה. למרות שהוא לא תלוי ברכיבי ניווט, הרשאה זו צפויה לשמש כדי לצאת ממסך אחד ולנווט למסך אחר. תאריך ההוספה בדיקות שילוב כדי להראות הדגמה של החלקה לסגירה. (I7baa)
  • הוספנו את הממשקים ScalingLazyColumnItemInfo ו-ScalingLazyColumnLayoutInfo למחלקה ScalingLazyColumnState כדי לאפשר למפתחים לדעת את המיקומים והגדלים בפועל של הפריטים ב-ScalingLazyColumn לאחר החלת ההתאמה. בנוסף, תיקנו באג באופן שבו חושב ההתאמה לעומס (scaling) כאשר מרווח פנימי של תוכן מוחל על ScalingLazyColumn. (I27c07)

שינויים ב-API

  • הוספת מחלקה של CurvedTextStyle כדי לציין עיצוב טקסט מעוקל אפשרויות. דומה ל-TextStyle, אבל תומך עכשיו רק בצבע, ב-fontSize וברקע. בעתיד נוסיף עוד אפשרויות עיצוב. (I96ac3)
  • הוספנו את הממשקים ScalingLazyColumnItemInfo ו-ScalingLazyColumnLayoutInfo למחלקה ScalingLazyColumnState כדי לאפשר למפתחים לדעת את המיקומים והגדלים בפועל של הפריטים ב-ScalingLazyColumn לאחר החלת ההתאמה. בנוסף, תיקנו באג באופן שבו חושב ההתאמה לעומס (scaling) כאשר מרווח פנימי של תוכן מוחל על ScalingLazyColumn. (I27c07)
  • הוספת את @ExperimentalWearMaterialApi ל-enum SwipeDismissTarget, חלק מ-API של SwipeToDismissBox. (I48b5e)

תיקוני באגים

  • נוסף חומר בדיקה ל-SlideToDismissBox (I9febc)

גרסה 1.0.0-alpha03

4 באוגוסט 2021

androidx.wear.compose:compose-foundation:1.0.0-alpha03 ו-androidx.wear.compose:compose-material:1.0.0-alpha03 שוחררו. גרסה 1.0.0-alpha03 מכילה את התחייבויות אלה.

שינויים ב-API

  • נוסף רכיב CurvedText, שמאפשר למפתחים לכתוב בקלות טקסט את העקום של מעגל (בדרך כלל בקצה של מסך מעגלי) (Id1267)
  • שינינו את השם CardDefaults.imageBackgroundPainter() לשם CardDefaults.imageWithScrimBackgroundPainter() כדי שיהיה ברור שעל תמונת הרקע יש שרטוט. (I53206)
  • הוספת רכיב ScalingLazyColumn שמספק רכיב רשימה עבור חומר Wear שמספק תצוגה בסגנון 'עין הדג', עם הקטנת גודל התוכן ברשימה והופכת לשקיפות בהתאם לקנה המידה הרצוי לקצה הרכיב. (I7070c)

תיקוני באגים

  • שינינו את צבע ברירת המחדל של התוכן של appName ב-AppCard בתגובה לעדכון במפרט חוויית המשתמש. הצבע שמוגדר עכשיו כברירת המחדל של appName הוא MaterialTheme.colors.onSurfaceVariant. בנוסף, חסר תיאור של מסמך הפרמטר עבור משבצת הכותרת. (Ic4ad1)

גרסה 1.0.0-alpha02

21 ביולי 2021

androidx.wear.compose:compose-foundation:1.0.0-alpha02 ו-androidx.wear.compose:compose-material:1.0.0-alpha02 שוחררו. גרסה 1.0.0-alpha02 מכילה את התחייבויות אלה.

תכונות חדשות

  • נוספה כיתה חדשה של CurvedRow לפריסת תכנים קומפוזביליים בקשת (I29941)
  • הוספנו סוג חדש של כרטיסים לשימוש באפליקציות (TitleCard), וגם הוספנו תמיכה בהצגת תמונות כרקע לכרטיסים, כדי להדגיש את התוכן שלהם (I53b0f)

שינויים ב-API

  • הוסיפו תמיכה ביישור רדיאלי ל-CurvedRow (בדומה ל- יישור אנכי בשורה) (Id9de5)
  • מוסיפים מחלקה חדשה של CurvedRow כדי לערוך תכנים קומפוזביליים בקשת (I29941)
  • הוספנו סוג חדש של כרטיסים לשימוש באפליקציות (TitleCard), וגם הוספנו תמיכה בהצגת תמונות כרקע לכרטיסים, כדי להדגיש את התוכן שלהם (I53b0f)
  • נוספו סמלי מתג (תיבת סימון, מתג ולחצני בחירה) ל-TurnChipDefaults כדי להקל על המפתחים להגדיר את SwitchChip ואת SplitToggleChips (I7b639)
  • המרווח הפנימי של תוכן ההתחלה והסיום של הצ'יפים עודכן כך שהוא נשאר בעקביות 14.dp, גם אם לצ'יפ יש סמל וגם אם לא (בעבר היה 12.dp אם קיים סמל, ו-14.dp אם לא) (I34c86)

תיקוני באגים

  • הוספת בדיקות של CurvedRow (I93cdb)
  • קשירת יחסי התלות של Wear Compose ל-Compose 1.0.0-rc01. (Ie6bc9)
  • שינינו את השיטה של ציור תמונות רקע בכרטיסים ובצ'יפים, כך שהתמונה נחתכה ולא נמתחת כדי לשמור על הפרופורציות של התמונה. (I29b41)
  • נוספו עוד הדגמות ובדיקות שילוב עבור 'לחצן' ו'לחצן החלפת מצב'. (5e27ed2)
  • נוספו עוד בדיקות צ'יפים כדי לכסות את צבעי התוכן של imageBackgroundChips (Ia9183)

גרסה 1.0.0-alpha01

1 ביולי 2021

androidx.wear.compose:compose-foundation:1.0.0-alpha01 ו-androidx.wear.compose:compose-material:1.0.0-alpha01 שוחררו. גרסה 1.0.0-alpha01 מכילה את התחייבויות אלה.

תכונות חדשות

Wear Compose הוא ספרייה מבוססת-Kotlin שמבוססת על פיתוח ותומכת ב-Wear Material Design, תוסף של Material Design לגאדג'טים לבישים של WearOS. גרסת האלפא הראשונה הזו כוללת הטמעות פונקציונליות מוקדמות של הרכיבים הבאים:

  • עיצוב חומר - מגדיר את הצבעים, הטיפוגרפיה והצורות באופן עקבי בכל הרכיבים שבהם נעשה שימוש מהספרייה הזו.
  • צ'יפ, CompactChip – צ'יפים הם בצורת אצטדיון ואפשר להוסיף להם תוכן של סמלים, תוויות ותוויות משניות.
  • - מתג החלפת מצב החלפת מצב, SplitToggleChip - סוג מיוחד של צ'יפ שכולל חריץ לסמל מתג דו-מצבי, כמו לחצן בחירה או תיבת סימון. בנוסף, SplitToggleChip כולל שני אזורים שאפשר להקיש עליהם, אחד שאפשר ללחוץ עליו והשני אפשר להחלפה.
  • לחצן, לחצן קומפקטי – הלחצנים הם עגולים, עם חריץ תוכן יחיד לסמל או עם טקסט מינימלי (3 תווים לכל היותר).
  • לחצן החלפת מצב – לחצן להפעלה או להשבתה של פעולה, עם חריץ יחיד לסמל או מספר מינימלי של טקסט (3 תווים לכל היותר).
  • כרטיס, AppCard – בצורת מלבן עם פינות מעוגלות, עם משבצות לתוכן כמו סמל האפליקציה, השעה, השם וגוף האפליקציה.

בגרסאות עתידיות תתבצע הרחבה של קבוצת הווידג'טים, והיא תתמוך בבוררים, במחוונים, ברשימות, באינדיקטורים של דפים, בתיבות דו-שיח, באינדיקטורים של גלילה אוטומטית, בתצוגה מקדימה ובפריטים נוספים.

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

Material Compose (חומר) של Wear Compose (חומר) מעוצב לפי אותם עקרונות של Compose Material, למרות שהוא מתמקד בגאדג'טים לבישים. כשמפתחים מכשירים לבישים, צריך להשתמש בספרייה 'חומרי לימוד מ-Wear Compose' במקום הספרייה 'יצירת חומרי לימוד'.

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