Wear Compose

  
כותבים אפליקציות Jetpack Compose למכשירי Wearable על ידי מתן פונקציונליות שתומכת במכשירים ספציפיים ללבישה, בגדלים, בצורות ובתנועות ניווט ספציפיות למכשירים כאלה.
העדכון האחרון גרסה יציבה גרסה מועמדת להפצה גרסת בטא גרסה אלפא
15 בינואר 2025 1.4.0 - - 1.5.0-alpha08

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

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

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

מגניב

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

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

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

    // For Wear preview annotations
    implementation("androidx.wear.compose:compose-ui-tooling:1.4.0")
    
    // 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.4.0")

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

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

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

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

מידע נוסף זמין במסמכי התיעוד של Issue Tracker.

Wear Compose Material3 גרסה 1.0

גרסה 1.0.0-alpha31

15 בינואר 2025

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

שינויים ב-API

  • עדכנו את כל הספריות של Wear Compose למצב 'ממשק API מפורש'. (Iebf9f)
  • עדכנו את ממשקי ה-API ScreenScaffold ו-EdgeButton כדי שיהיה קל יותר לציין את הרווח מסביב לתוכן במסכים שכוללים EdgeButton. ב-API החדש, ה-size של EdgeButton מועבר רק ל-EdgeButton, וה-ScreenScaffold מקבל פרמטר edgeButtonSpacing למרווח בין EdgeButton לבין תוכן הרשימה. (I424fd)
  • ב-DatePicker, שינינו את השמות של הפרמטרים minDate ל-maxDate ושל minValidDate ל-maxValidDate. ב-DatePickerColors, שינינו את השם של הפרמטר selectedPickerContentColor ל-activePickerContentColor ואת השם של unselectedPickerContentColor ל-inactivePickerContentColor (Iba17b)
  • עדכנו את הגדרות ברירת המחדל של ArcProgressIndicator ל-strokeWidth=6dp והמלצנו על diameter = 81.24% לגובה המסך (I6f248)
  • עדכנו את Confirmation API כך שישקף את השימוש בו כתיבת דו-שיח. הרכיב הניתן ליצירה נקרא עכשיו ConfirmationDialog, עם עדכונים משויכים בשמות של צבעים ושל כיתות ברירת המחדל. שינינו גם את השם של הפרמטר show ל-visible כדי לשמור על תאימות לממשקי API אחרים של אנימציה ב-Compose. בנוסף, הפכנו את האפשרויות ConfirmationDialogContent,‏ SuccessConfirmationDialogContent ו-FailureConfirmationDialogContent לזמינות במצבים שבהם מפתחים צריכים להתאים אישית את האנימציות של תיבת הדו-שיח של הפתיח/הסיום. (Iaeb33)
  • עדכנו את CircularProgressIndicatorContent ל-CircularProgressIndicatorStatic (הגרסה הלא אנימציה של CircularProgressIndicator) כדי שאפשר יהיה להשתמש בו עכשיו ליצירת CircularProgressIndicator עם אנימציות בהתאמה אישית. (I1346f)
  • תיקנו את סדר הפרמטרים ב-ArcProgressIndicator, והפרמטר המשנה הוצב במקום הראשון (I4656a)
  • שיפור ממשק ה-API של SwipeToReveal כדי לקבל פרמטר של חריץ טקסט לתווית הפעולות (למעט הפעולה המשנית) ולהסיר פרמטרים של תווית מהפעולה 'ביטול' (I5b3db)

תיקוני באגים

  • תיקנו באג שבו הפעולות החזוניות של LongPress הופעלו יותר מפעם אחת ב-Button, ב-Card, ב-IconButton וב-TextButton (Ia8b0f)
  • שינויים בחוויית המשתמש של AlertDialog – במסכים גדולים, לחצני האישור והסגירה קטנים יותר עכשיו. בנוסף, הרווח מתחת לכפתורי האישור והביטול גדל. (I4f066)
  • שינינו את מפרטי האנימציה של תווית לחצן הפעולה של הרכיב SwipeToReveal. (Ib87fb)
  • שינית את SwipeToReveal כדי להרחיב את המאגר בזמן שהטקסט מוצג. (I44cf8)
  • שיפור SwipeToReveal כדי לבצע משוב הפיזי כשההחלקה חורגת מהסף שבו הפעולה הראשית מתבצעת. (I23efe)
  • עדכנו את SwipeToReveal כך שיציג נקודה-שלושה-נקודות במקרה של טקסט שחורג מהמסגרת כברירת מחדל, עבור פעולות ראשיות ופעולות ביטול. (I71f5a)
  • תיקנו בעיה שגרמה לתנודות באנימציות של ButtonGroup. (I63f8f)
  • הוספנו סמנטיקה של טקסט ל-AnimatedText (I6063c)
  • עכשיו, כשתיבת הדו-שיח תוסר מהקומפוזיציה, היא תגרום לאיפוס של שינוי הגודל של הרקע (ללא התיקון הזה, מסך ההפעלה היה עלול להישאר במצב של שינוי גודל כלפי מטה) (Id24ac)
  • הוספנו אנימציה של טרנספורמציה של צורה ללחצנים ברכיב הסטפר (Id6ed3)

גרסה 1.0.0-alpha30

11 בדצמבר 2024

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

שינויים ב-API

  • בוצע שינוי ב-scrollTransform של TransformingLazyColumn, שגרם לשינוי ב-API. (I0c6dc)
  • עדכנו את IconToggleButtonShapes ו-TextToggleButtonShapes כך שיכללו שני פרמטרים שונים של צורה, uncheckedPressed ו-checkedPressed (I85dbd)
  • אפשרויות לא חוקיות של חודש/יום מוצגות עכשיו ב-DatePicker, עם invalidPickerContentColor חדש, כשמשתמשים ב-minDate או ב-maxDate. (If4541)
  • עדכנו את ה-API של Stepper כדי לספק משבצות increaseIcon ו-decreaseIcon – אפשר ליצור את התוכן שלהן כרגיל מהרכיב ה-Icon composable. (Id35da)
  • עדכנו את dynamicColorScheme על ידי הסרת הפרמטר האופציונלי defaultColorScheme, ועכשיו הפונקציה מחזירה את הערך ColorScheme שיכול להיות null. פירוש הדבר הוא שהמבצע של הקריאה החוזרת (caller) צריך לטפל באופן מפורש במקרה החלופי כאשר לא מסופקת ערכת צבעים דינמית. (I6d62e)
  • עדכנו את גדלי הסמלים ב-ButtonDefaults לשימוש עם CompactButton. ב-CompactButton שמכיל רק סמל צריך להשתמש ב-ButtonDefaults.SmallIconSize = 24.dp, ואילו ב-CompactButton שמכיל גם סמל וגם טקסט צריך להשתמש ב-ButtonDefaults.ExtraSmallIconSize = 20.dp. מומלץ שהתוכן של CompactButton יתבצע ב-wrap (במקום למלא את רוחב המסך המקסימלי), והטעימות עודכנו כדי להציג זאת. (I0582c)
  • הוספנו EdgeButtonDefaults עם גדלים מומלצים של סמלים ל-4 EdgeButtonSizes השונים. בנוסף, עדכנו את הפריסה של EdgeButton כך שהמרווח הפנימי התחתון יהיה גדול מעט יותר מהמרווח הפנימי העליון, וכך משפרים את המראה של תוכן הסמל ושל תוכן הטקסט. (Id772a)
  • הוספנו תנועה ל-LinearProgressIndicator וחשפנו את LinearProgressIndicatorContent, שמספק את התוכן החזותי ללא אנימציות. (Idee99)
  • הוספנו רכיב CircularProgressIndicatorContent חדש שאפשר להרכיב כדי להציג את התוכן החזותי של CircularProgressIndicator ללא אנימציות. (Ie33d4)
  • TransformingLazyColumn מספק עכשיו את המאפיין המקומי LocalTransformingLazyColumnItemScope, שרכיבי Card, Button ו-ListHeader משתמשים בו עכשיו כדי לעבור טרנספורמציה אוטומטית כשהם ממוקמים בתוך TransformingLazyColumn. מבצעי הקריאה יכולים להשבית את הטרנספורמציה האוטומטית באמצעות המעטפת החדשה TransformExclusion. (I1652f)
  • עדכנו את הסוג של ButtonDefaults.shape ל-RoundedCornerShape (Iccdf2)

תיקוני באגים

  • תיקנו באג כדי לכבד את האלפא הקיימת ברקע של TimeText (I1eb60)
  • הגדרנו את TextMotion ל-Animated כברירת מחדל בגופן שלנו, כדי למנוע רעידות בטקסט שנובעות מהצמדת גליפי האותיות לגבולות הפיקסלים במהלך פעולות שינוי התצוגה. (I626fa)
  • כדי לשפר את החשיפה, עדכנו את המראה של ScrollIndicator על ידי הגדלת הרוחב והרווח. (Ied7cb)
  • תיקנו באג ב-Modifier.scrollTransform בזמן הוספה, הסרה או העברה של פריטים. (I6830f)
  • תיקנו בעיה באנימציה של לחצן עגול בהקשות קצרות (בעבר, משך האנימציה המינימלי לא תמיד נשמר). (I757a7)
  • עדכנו את זווית הסנון של LevelIndicator ל-20% (כלומר 72 מעלות). (Idde5c)
  • תיקנו את המיקום של ScrollIndicator כשמשתמשים ב-ScalingLazyColumn עם AutoCenteringParams. (I387dd)
  • עדכנו את הצבעים והטיפוגרפיה של ListHeader ושל ListSubHeader. כמו כן, הצבעים של מתגי ההפעלה ב-CheckboxButton וב-SwitchButton. (I39817)
  • תיקנו את המיקום של ScrollIndicator ב-LazyColumn וב-ScalingLazyColumn באמצעות ContentPadding. (I2bc51)
  • תיקנו באג שזוהה באנימציית ההתקדמות של OpenOnPhoneDialog באמצעות CircularProgressIndicatorContent החדש. (I3e443)
  • עדכנו את HorizontalPagerScaffold ו-VerticalPagerScaffold כדי להשבית אנימציות כשהתכונה 'צמצום תנועה' מופעלת (Iaaf68)
  • הטמענו אנימציה נפרדת לאינדיקטורים של התקדמות מעגלית כשההתקדמות מגיעה ליותר מ-100%. (I47135)
  • תיקנו באג שבו EdgeButton יכול היה להופיע בצורה שגויה ברכיבי Pager (I91db9)

גרסה 1.0.0-alpha29

13 בנובמבר 2024

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

שינויים ב-API

  • עדכנו את TimeText כדי לספק תוכן ברירת מחדל שבו מוצג השעה. (Id23b3)
  • הפכנו את ScrollInfoProvider לפשוט יותר עבור PagerState על ידי הסרת הפרמטר orientation, שאין בו יותר צורך. ההתנהגות החדשה היא ש-TimeText יישאר במקום גם בחלוקה אופקית וגם בחלוקה אנכית לדפים. (I71767)
  • LocalHapticFeedback מספק עכשיו הטמעה HapticFeedback שמוגדרת כברירת מחדל כש-Vibrator API מציין שיש תמיכה בהפעלה של משוב מישוש. הוספנו את הערכים הבאים ל-HapticFeedbackType: Confirm, ‏ ContextClick, ‏ GestureEnd, ‏ GestureThresholdActivate, ‏ Reject, ‏ SegmentFrequentTick, ‏ SegmentTick, ‏ ToggleOn, ‏ ToggleOff, ‏ VirtualKey. רכיבים ב-Compose ל-Wear שאפשר ללחוץ עליהם לחיצה ארוכה, כמו Button,‏ IconButton,‏ TextButton ו-Card, מבצעים עכשיו את הפעולה ההדקית LONG_PRESS כשמספקים טיפול בלחיצה ארוכה. (I5083d)

תיקוני באגים

  • עדכנו את הבקשה לאישורים. (I04bff)
  • עדכנו את יחסי התלות המינימליים ב-API לגרסה 1.7.4 בספריות של Compose. (I88b46)
  • נוסף תנועה חדשה לתיבת הדו-שיח OpenOnPhone. (I1e10a)
  • תיקנו באג ב-LevelIndicator, כך שהוא מוצג עכשיו בצורה נכונה כשהערך שלו הוא אפס. (Ie95a4)
  • עדכנו את האנימציות HorizontalPageIndicator ו-VerticalPageIndicator. (I5c8f3)
  • הוספנו אנימציה של התכווצות לנקודה ל-ArcProgressIndicator לא ידוע. (I9fd51)

גרסה 1.0.0-alpha28

30 באוקטובר 2024

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

שינויים ב-API

  • הוספנו וריאנט של קשת לאינדיקטור ההתקדמות המעגלי הלא ידוע (I2efc1)
  • הפכנו לציבוריים את הרכיבים הניתנים לשילוב של AlertDialogContent ו-Dialog שמרכיבים את ה-API של AlertDialog, כדי שתוכלו להוסיף התאמה אישית לפי הצורך (למשל, התאמה אישית של אנימציית AlertDialog תוך שמירה על פריסת התוכן המומלצת). בנוסף, הוספנו את הפרמטרים Modifier ו-Color לחברים EdgeButton, ‏ ConfirmButton ו-DismissButton ב-AlertDialogDefaults. (I4eb71)
  • עדכנו את ה-API של Placeholder באופן הבא: שינינו את השם של PlaceholderState.startPlaceholderAnimation ל-PlaceholderState.animatePlaceholder, את השם של PlaceholderState.isShowContent ל-PlaceholderState.isHidden ואת השם של PlaceholderDefaults.shape ל-PlaceholderDefaults.Shape. שינינו את השם של הפרמטר painter ב-painterWithPlaceholderOverlayBackgroundBrush ל-originalPainter. שינינו את ההצגה של PlaceholderState.placeholderProgression מ'גלוי לכולם' ל'פנימי' ושינינו את השם שלו ל-placeholderShimmerProgression. הוספנו קבועים של משך אנימציה של placeholder ל-PlaceholderDefaults. (Ie5a59)
  • עדכנו את EdgeButton API באופן הבא: שינינו את שם הפרמטר ב-ScreenScaffold מ-bottomButton ל-edgeButton, והפכנו את EdgeButtonSize ל-value class. (Ieef15)
  • שינינו את החשיפה של copy() ל'גלוי לכולם' בכיתות של wear material3 Colors (I0287f)

תיקוני באגים

  • הוספנו משך זמן מינימלי לאנימציה של IconToggleButton ו-TextToggleButton בלחיצה (Ieb333)
  • נוספה משך זמן מינימלי לאנימציית הצורות IconButton ו-TextButton (Iebcee)
  • תוקנה האפשרות של DatePicker לחזור על הפעולה. (I3587c)
  • נוספה תנועה לתיבת הדו-שיח של ההתראות ולתיבת הדו-שיח של האישור. (I173b1)

גרסה 1.0.0-alpha27

16 באוקטובר 2024

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

שינויים ב-API

  • עדכנו את ScreenScaffold ו-ScrollIndicator בעקבות שינוי השם של Wear Compose Foundation LazyColumn ל-TransformingLazyColumn. (I0608b)
  • השם של הפרמטר preferredHeight של EdgeButton השתנה ל-buttonSize, וניתן לבחור את הערך שלו רק מתוך 4 קבועים בכיתה החדשה של הערכים EdgeButtonSize. (Icdd70)
  • שינינו את השם של ListSubheader ל-ListSubHeader והוספנו ערכים ברירת מחדל שגלויים לכולם עבור ListHeader ו-ListSubHeader. (I96730)
  • הוספנו ל-Wear רכיבים חדשים של HorizontalPagerScaffold ו-VerticalPagerScaffold שמספקים אנימציות חדשות ותיאום בין טקסט הזמן לבין רכיבי אינדיקטור הדף. (Iff7d0)
  • הוספנו תמיכה במכשירים עם לחצן מסתובב ל-HorizontalPagerScaffold ול-VerticalPagerScaffold, כדי לאפשר למשתמשים לנווט במכשירי ה-pager באמצעות מכשירי קלט עם לחצן מסתובב. (I9770d)
  • ביצענו שינויים ב-MotionScheme API כדי לפשט את השימוש ולשפר את העקביות. הוסרו פונקציות remember מוטמעות והתוכניות המובנות של תנועה הועברו לאובייקט נלווה ייעודי של MotionScheme. השמות של standardMotionScheme ו-expressiveMotionScheme שונו ל'רגיל' ו'רגשי'. (I5fd45)
  • הוספנו תמיכה בערכת צבעים דינמית שמבוססת על צבעי המערכת. (I073e9)
  • עדכנו את ה-Stepper בהתאם למפרטי חוויית המשתמש העדכניים ביותר. (I622bb)

תיקוני באגים

  • עדכנו את הגופנים והמרווחים של רכיבי הכרטיסים. (I3ae48)
  • שינינו את הריפוד ב-AlertDialog בין הלחצנים 'אישור'/'ביטול' לשאר התוכן מ-8dp ל-12dp בהתאם למפרטי UX (Ie55f0)
  • עדכנו את אטימות הצבע של הרכיב פס ההזזה. (Idb383)

גרסה 1.0.0-alpha26

2 באוקטובר 2024

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

שינויים ב-API

  • עדכנו את ה-API ואת המראה של HorizontalPageIndicator והוספנו את VerticalPageIndicator לשימוש עם VerticalPager (Ic9309)
  • AlertDialog תומך עכשיו באפשרות להשמיט את הלחצן התחתון שמוגדר כברירת מחדל מהוריאציה של מקבץ הלחצנים, בתצוגות מותאמות אישית שבהן לא נדרש EdgeButton. (I34fa9)
  • הוספנו רכיב SwipeToReveal ל-Material 3 ב-Wear (Ic38b2)
  • הוספנו תמיכה בהחלקה דו-כיוונית ב-SwipeToReveal, למקרים נדירים שבהם המסך הנוכחי לא תומך בהחלקה כדי לסגור. ברירת המחדל עדיין היא החלקה כדי לחשוף רק בהחלקות מימין לשמאל, ומומלץ מאוד לפעול בהתאם לברירת המחדל כדי למנוע התנגשויות עם החלקה כדי לסגור. (Ifac04)
  • שינינו את השם של הפרמטר buttonHeight של EdgeButton ל-preferredHeight. (I4fab3)
  • גרסת Kotlin עודכנה ל-1.9 (I1a14c)
  • שינינו את השם של OpenOnPhoneDialogDefaults.Icon ל-OpenOnPhoneDialogDefaults.OpenOnPhoneIcon כדי למנוע התנגשות עם Icon‏(I0f391)
  • הוספנו תמיכה ב-ScrollIndicator ב-LazyColumn. (Ia546a)
  • עדכנו את ערכי ברירת המחדל של TextToggleButton ו-IconToggleButton. (I7aaa9)
  • הפכנו את ממשקי ה-API של Picker ו-PickerGroup לפשוטים יותר. (Id0653)
  • הוספנו את CardDefaults.Shape ו-CardDefaults.Height, שהיו (כאסימונים) פרטיים למפתחים שמשתמשים בספרייה. (I1594a, ‏ b/347649765)
  • שינינו את השם של פרמטר ההתקדמות של אינדיקטור התקדמות מעגלי עם פלחים בינאריים ל-segmentValue. (Ib72d9)
  • עדכנו את הצבעים והפריסה של פס ההזזה. (Ic3eec)

תיקוני באגים

  • עדכנו את האנימציה של הסמל openOnPhone (I66f85)
  • אנחנו משתמשים עכשיו בסמלי Google Symbols ב-Slider, ב-TimePicker וב-DatePicker. (I46c7c)
  • עדכנו את ה-paddings ב-Confirmation וב-OpenOnPhoneDialog. (Iaa82e)

גרסה 1.0.0-alpha25

18 בספטמבר 2024

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

שינויים ב-API

  • הוספנו אינדיקטור של התקדמות מעגלית לא ידועה. (I427a7)
  • הוספנו תמיכה בחריגה ממכסת ההתקדמות (התקדמות של יותר מ-100%) גם ב-CircularProgressIndicator וגם ב-SegmentedCircularProgressIndicator. כשההתקדמות חורגת מ-1.0, היא תסומן בצבע החדש overflowTrack. (Iaaa3d)
  • הסמלים העגולים IconToggleButton ו-TextToggleButton תומכים עכשיו באנימציה חדשה של צורות, שבה צורות שונות מייצגות מצבים של סימון, ביטול סימון ולחיצה. עדיין יש תמיכה בגרסת האנימציה הקודמת של הצורה במצב 'הלחצן נלחץ'. (I29f03)
  • הסרנו את התמיכה בשימוש ב-EdgeButton עם Column, בגלל הצורך לציין את גובה EdgeButton באופן מפורש ב-ScreenScaffold. (Ie353d)
  • הוספנו תמיכה ב-LazyColumn של Wear Compose באמצעות ScreenScaffold שלנו (והוספנו הטמעה של ScrollInfoProvider ל-LazyColumnState). (Ib8d29)
  • שילבנו את LocalTextMaxLines, ‏ LocalTextAlign ו-LocalTextOverflow ליצירת קומפוזיציה מקומית יחידה של LocalTextConfiguration, כדי לספק פתרון גמיש יותר בעתיד. (I5edbc)
  • הוספנו את arc-large כסולם נוסף של גופנים, שמיועד למחרוזות טקסט קצרות של כותרות בחלק העליון או התחתון של המסך, כמו בשכבות-על של אישורים. (I60e3e)
  • הוספנו ל-Button הגדרות ברירת מחדל לגדלים מומלצים של סמלים גדולים וגדולים במיוחד, ולרווחים בין התוכן. (I84675)

תיקוני באגים

  • עדכנו את הצבעים של IconButton ושל TextButton. (I48324)
  • שינינו את עומסי היתר הבסיסיים של Button כך שיוצגו במרכז האנכי, כדי לשמור על עקביות עם עומסי יתר אחרים. כדי לשחזר את ההתנהגות הקודמת, משתמשים ב-Modifier.align מה-RowScope. (I66e57)

גרסה 1.0.0-alpha24

4 בספטמבר 2024

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

שינויים ב-API

  • הוספנו ערכת תנועה לעיצוב Material3. הרכיבים בספרייה ישתמשו בנתונים האלה כדי להחיל את מפרטי האנימציה, כמו קפיצים לתנועה דרמטית. (I54ff3)
  • הוספנו לספריית Material3 את הרכיבים AppScaffold ו-ScreenScaffold, שכוללים פונקציונליות לתיאום השכבות והמעברים של TimeText ו-ScrollIndicator. AppScaffold מספק רמה עליונה של רכיבי תבנית שממוקמים מעל כל המסכים. לכן, הוספת TimeText ל-AppScaffold מאפשרת לו להישאר במקום בזמן החלקה בין המסכים. המסכים עצמם יכולים לשנות או להסתיר את טקסט השעה. ScreenScaffold מספק מקום ל-ScrollIndicator ומפעיל אנימציה של מחוון הגלילה באופן אוטומטי בזמן הגלילה, כולל זמן קצוב לתפוגה להסתרת מחוון הגלילה אחרי חוסר פעילות. (I047d6)
  • הוספנו את ScrollIndicator עם העיצוב החדש של Material3. לתמונה יש גודל קבוע של תמונה ממוזערת על סמך תוכן הרשימה הראשוני, כדי למנוע שינויים בגודל כשהתוכן הלא פעיל נטען ברשימה. (Ic228d)
  • שינינו את ה-API של ScrollAway כך ש-ScreenStage הוא סוג ערך במקום סוג enum, כדי לאפשר הוספה של שלבים נוספים לפי הצורך בהמשך. (I48c93)
  • הוספנו את EdgeButton, לחצן ייחודי ל-Wear בצורה שמתאימה לעיקול של החלק התחתון של המסך (I16369)
  • הוספנו משבצת חדשה ל-ScreenScaffold ללחצן התחתית (כמו EdgeButton), שיוצג וישנה את הגודל שלו בהתאם לתוכן שגלול (I032eb)
  • הוספנו את Modifier.scrollTransform וגם את Modifier.targetMorphingHeight כדי להוסיף אפקטים של תנועה בסגנון Material3 לפריטים ב-LazyColumn. (Ie229a)
  • הוספנו את SegmentedCircularProgressIndicator כגרסה של CircularProgressIndicator. בגרסת ה-Variation המפולחת מוצג ערך אחד של התקדמות בכל הפלחים, או שמוצג כל פלח כמצב מופעל/מושבת. (I6e059)
  • הוספנו את LinearProgressIndicator כחלופה ל-CircularProgressIndicator הקיים. (I89182)
  • הוספנו את AlertDialog, שמספק פריסות להצגת הנחיות חשובות למשתמש. יש וריאציות של זוג לחצני אישור/ביטול או לחצן תחתון יחיד (בדרך כלל EdgeButton) מתחת למקבץ של אפשרויות. בשתי הווריאציות יש משבצות לסמל, לשם ולטקסט נוסף כדי לספק פרטים נוספים. (Ieb873)
  • הוספנו את OpenOnPhoneDialog, שצריך להשתמש בו כדי לציין פעולה שתמשיך בטלפון של המשתמש. OpenOnPhoneDialog נסגרת אחרי זמן קצוב לתפוגה. (I978fd)
  • הוספנו את Confirmation, רכיב של תיבת דו-שיח עם חריצי סמלים וטקסט מעוקל או לינארי. יש וריאציות ספציפיות להודעות על הצלחה/כישלון. אישורי הבקשות נסגרים באופן אוטומטי לאחר זמן קצוב. (Ib43e8)
  • הוספנו רקע ל-TimeText כדי לצמצם בעיות שבהן התוכן הבסיסי ו-TimeText חפפו והסתירו את השעה. (Ia11fd)
  • הוספנו את LevelIndicator, שמציג את הערך של הגדרה כמו עוצמת קול, וניתן להשתמש בו עם הרכיב הקיים Stepper כדי ליצור מסך של עוצמת קול. LevelIndicator דומה ל-ScrollIndicator, אבל מוצג בצד השני של המסך, עם קו עבה יותר וצבע אחר של מחוון כברירת מחדל. (I8a4ac)
  • הוספנו את TimePicker, עם פריסות לשעון 24 שעות (עם או בלי שניות) או לשעון 12 שעות עם בחירה של am/pm. (Ia5124)
  • הוספנו את השדה DatePicker, עם הגדרה של סדר העמודות (כלומר יום-חודש-שנה, חודש-יום-שנה או שנה-חודש-יום) ותאריכים מינימום/מקסימום אופציונליים. (Ibf13b)
  • הוספנו פרמטר משקל לפונקציה text של TimeText. במקרים שבהם TimeText מורכב מכמה רכיבי טקסט, האפשרות הזו מאפשרת לקבוע איך המרחב יהיה מחולק. (I36700)
  • הוספנו את RadioButton ואת SplitRadioButton – הרכיבים האלה מפשטים את ה-API הקודם על ידי שילוב של (Split)SelectableButton ושל אמצעי הבקרה של הילד (If7ae8)
  • הוספנו את CheckboxButton ואת SplitCheckboxButton – הרכיבים האלה מפשטים את ה-API הקודם על ידי שילוב של (Split)ToggleButton ושל אמצעי הבקרה של תיבת הסימון הצאצא (Ia8f70)
  • הוספנו את SwitchButton ואת SplitSwitchButton – הרכיבים האלה מפשטים את ה-API הקודם על ידי שילוב של (Split)ToggleButton ושל אמצעי הבקרה של המתג הצאצא (I0d349)
  • עדכנו את המסמכים של AnimatedText כדי להסביר את ההתנהגות של חריגה מהיעד. (Iff30a)
  • הוספנו את ButtonGroupכדי לשלב 2 או 3 לחצנים, כך שלחיצה על לחצנים תיצור אנימציה מתואמת. (Ie27db)
  • הוספנו אנימציה אופציונלית של צורה ללחיצה על IconButton ו-TextButton. (Iffca5)
  • הוספנו וריאנט צבע נוסף, FilledVariant, לצבעים Button, ‏ IconButton, ‏ TextButton, ‏ CompactButton ו-EdgeButton (I65fc3)
  • הוספנו את הפרמטר forcedSize ל-ImageWithScrimPainter, כך שרקעים של תמונות לחצן שומרים עכשיו על גודל הרכיב שלהם כברירת מחדל. ההגדרה של forcedSize = null תאמץ את Painter.instrinsicSize במקום זאת. (Ic57af)
  • הוספנו לחיצה ארוכה ללחצנים (Ib613d)
  • הוספנו תמיכה בלחיצה ארוכה גם ל-IconButton ול-TextButton. (I38891)
  • הוספנו תמיכה בלחיצה ארוכה לכרטיסים. (I305d5)
  • הוספנו את LocalTextMaxLines,‏ LocalTextAlign ו-LocalTextOverflow כ-CompositionLocals והשתמשנו בהם כברירת המחדל של הפרמטרים ב-Text. מעכשיו, רכיבים כמו CheckboxButton, ‏ SwitchButton ו-RadioButton יכולים להשתמש במשתני ה-local של הקומפוזיציה כדי להטמיע הנחיות לגבי חוויית המשתמש, אבל המפתחים יכולים לשנות את הפרמטרים במקרה הצורך. (Iab841)
  • הוספנו את Placeholder כדי לעזור בהסתרת התוכן של רכיבים כמו לחצנים וכרטיסים עד שהנתונים נטענים. (I1a532)
  • הוספנו את IconToggleButtonColors ואת TextToggleButtonColors כדי להחליף את ToggleButtonColors שהוסרה. (Ie0bf1)

תיקוני באגים

  • עדכנו את Button,‏ FilledTonalButton,‏ OutlinedButton,‏ ChildButton ו-CompactButton כך שישתמשו ב-CompositionLocals LocalTextMaxLines,‏ LocalTextAlign ו-LocalTextOverflow החדשים כדי להטמיע הנחיות בנושא חוויית משתמש. אם יש צורך, המפתחים יכולים לשנות את הפרמטרים האלה ישירות בטקסט (Ie51f7)
  • שינינו את ברירת המחדל של עובי הקו של LevelIndicator ל-6dp כדי להבדיל אותו מ-ScrollIndicator, שעומק הקו שלו הוא 4dp. (If6f63)
  • תיקנו בעיה ב-TimeText כדי שתהיה תמיכה בזוויות סנון גדולות יותר. (Ie489f)
  • תוקנה בעיה במהלך הרכבת מחדש של EdgeButton. (I4cdca)
  • תוקנו פריסות של מתגי החלפת מצב מפוצלים כשמסופק מרווח תוכן בהתאמה אישית. (Ia33d3)
  • ערכי התקדמות קטנים מעוגלים כלפי מעלה לפחות לרוחב הקו של אינדיקטור ההתקדמות. (I3bd84)

גרסה 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 כוללת את ההוספות האלה.

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

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

שינויים ב-API

  • עדכנו את Button API כך שישתמש ב-buttonColors כברירת מחדל והסרנו את הערך הכפול filledButtonColors. (I4fe3b)
  • שינינו את דפוסי ברירת המחדל של ButtonColors, ‏ IconButtonColors ו-TextButtonColors על ידי יצירת מכונה ששמורה במטמון באופן פנימי והפחתת השימוש ב-CompositionLocal. (I5f51c)
  • הסרנו את התקורה של rememberUpdatedState בקטגוריות צבע ספציפיות לרכיבים, וסימנו את שיטות הגישה בתוך קטגוריות הצבע כפנימיות. (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, שאפשר להשתמש בו באותם צבעים מלאים, צבעים מלאים טונליים וצורות עם קווים כפי שאפשר להשתמש בהם בתג Button.‏ (I05df0)

שינויים ב-API

  • הוספנו את RadioButton/SplitRadioButton כקונטיינרים לפקדי בחירה, כמו פקד הבחירה. ההבדל בין RadioButton לבין ToggleButton הקיים הוא שאפשר לבחור את RadioButton (והוא פועל בתוך קבוצת בחירה), ואילו את ToggleButton אפשר להפעיל או להשבית (והוא עצמאי). (I61275)
  • אנחנו מסירים את LocalContentAlpha מספריית Wear Compose Material3 כדי לשמור על עקביות עם ספריית Compose Material3. (I49a0a)
  • רכיבי Wear material ו-wear material3 שחשפו MutableInteractionSource ב-API שלהם עודכנו כך שיחשפו עכשיו MutableInteractionSource שאפשר להעביר לו ערך null, וערך ברירת המחדל שלו הוא null. אין כאן שינויים סמנטיים: העברת null פירושה שאתם לא רוצים להעביר את MutableInteractionSource, והוא ייווצר בתוך הרכיב במקרה הצורך. שינוי ל-null מאפשר לרכיבים מסוימים לא להקצות אף פעם MutableInteractionSource, ולרכיבים אחרים ליצור מופע רק באופן עצלני כשהם צריכים, וכך לשפר את הביצועים של הרכיבים האלה. אם אתם לא משתמשים ב-MutableInteractionSource שאתם מעבירים לרכיבים האלה, מומלץ להעביר null במקום זאת. מומלץ גם לבצע שינויים דומים ברכיבים שלכם. (Ib90fc, ‏ b/298048146)
  • הוספה של ממשק API חדש של Ripple בספריות 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)
  • צבעי הרקע של תמונות הלחצנים עודכנו כך שישתמשו באסימונים של עיצוב חדשני תלת-ממדי. (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. כך קל יותר להבחין בין הרכיב ברמת Foundation לבין הרכיב ברמת Material3 SwipeToDismissBox. הקוד האחרון שולף צבעים מה-MaterialTheme לשימוש במסכי ה-scrim ומעביר את שאר ההטמעה ל-BasicSwipeToDismissBox. (Ibecfc)

תיקוני באגים

  • הסרנו את השכבה material-core של Material3 Button כדי לשפר את הביצועים. (I55555)

גרסה 1.0.0-alpha14

18 באוקטובר 2023

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

שינויים ב-API

  • הסרנו את הפרמטר indicatorStyle מ-HorizontalPageIndicator של Material3 – במקום זאת, הוא יתאים לצורת המסך של המכשיר (לינארי או עגול). (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 כך שישתמש באסימונים של עיצוב חדשני תלת-ממדי. (I3f137)
  • עדכנו את IconToggleButton כך שישתמש באסימונים של Material Design. (I7d263)
  • הפכנו את המאפיינים ה-constructor של 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)
  • עדכנו את הגופן והיישור של ListHeader ו-ListSubheader ב-Material3. (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 כניסיוניים, כי פרטי ממשק המשתמש עדיין לא הושלמו. (I84d54)
  • הסרנו את הגדלים ExtraSmall מהסמלים העגולים TextButton ו-TextToggleButton, כי הגודל הזה רלוונטי רק ל-IconButton. (Ibc7d5)

תיקוני באגים

  • עדכנו את ההנחיות בנושא טיפוגרפיה של TextToggleButton כך שייעשה שימוש ב-LabelLarge עבור LargeButtonSize (Ib10fa)
  • עדכנו את ההנחיות בנושא טיפוגרפיה ל-TextButton, כך שייעשה שימוש ב-LabelLarge עבור 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 עבור material3‏ (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 שלנו. (Ibaefe)
  • הוספנו את Material3 SwipeToDismissBox, שמפעיל את Foundation החדש SwipeToDismissBox ומספק ערכי ברירת מחדל של צבעים מהעיצוב שלו. (I275fb)
  • הוספנו את InlineSlider של Material3 ל-Compose ב-Wear. היא מאפשרת למשתמשים לבחור מתוך טווח ערכים. טווח האפשרויות מוצג כסרגל בין הערכים המינימלי והמקסימלי של הטווח, וממנו המשתמשים יכולים לבחור ערך יחיד. InlineSlider אידיאלי להתאמת הגדרות כמו עוצמת קול או בהירות. (I7085f)

שינויים ב-API

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

תיקוני באגים

  • הגובה של הלחצן יותאם עכשיו כך שיכיל תוכן שהתרחב בגלל גופנים גדולים, לצורכי נגישות, במקרה הצורך (Iaf302)
  • עדכנו כמה הדגמות של Button כדי לטפל בבעיות נגישות. (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 מכילה את ההצהרות האלה על ביצוע שינויים (commits).

תכונות חדשות

  • הוספנו את הרכיב Stepper לספרייה של Compose for Wear OS Material 3. הגרסה הזו דומה לגרסה הקודמת של Material, אבל היא שוללת את סמנטיקה של טווחים כברירת מחדל, בהתאם למשוב ממפתחים. אנחנו מספקים את Modifier.rangeSemantics במקרים שבהם נדרשת סמנטיקה של טווח. (Ic39fd)
  • הוספנו את curvedText לספרייה של Compose for 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 לספריית Material3 של Wear Compose. אפשר גם להוסיף ל-AppCard ול-TitleCard קו מתאר באמצעות CardDefaults.outlinedCardColors ו-CardDefaults.outlinedCardBorder(I80e72)

שינויים ב-API

  • העברנו את הפרמטר של תווית הלחצן לסוף כדי לתמוך בסינטקס של פונקציית lambda עם תו אחריו, והסרנו את הפרמטר role (כי אפשר לשנות אותו באמצעות Modifier.semantics). ה-constructors של 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

  • הוספנו את הרכיב Button (לחצן) של Material 3 – זהו הלחצן בצורת אצטדיון, שהיה נקרא בעבר Chip (צ'יפ) בספריית Material של Wear Compose (השם שלו שונה ל-Button כדי לשמור על עקביות עם ספריית Material 3 של Compose). ללחצן ברירת המחדל יש רקע מלא, ויש וריאציות של לחצן ל-FilledTonal (רקע מושתק), ל-Outlined (שקוף עם גבול דק) ול-Child (רקע שקוף ללא גבול, משמש לפעולות משלימות עם מידת הבולטוּת הנמוכה ביותר). לחצנים עגולים לתוכן פשוט של סמלים וטקסט יתווספו במהדורה עתידית.(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 (ההגדרה הנוכחית). כך נוכל לסנכרן את השבתת הוספת רווחים לגופן כברירת מחדל עם ספריות ה-Compose בעתיד (ראו תיקון הוספת רווחים לגופן ב-Compose לרקע). (I7e461)

גרסה 1.0.0-alpha01

22 במרץ 2023

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

תכונות חדשות

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

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

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

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

Wear Compose גרסה 1.5

גרסה 1.5.0-alpha08

15 בינואר 2025

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

שינויים ב-API

  • עדכנו את כל הספריות של Wear Compose למצב 'ממשק API מפורש'. (Iebf9f)
  • הפכנו את הפרמטר של אנימציית הצמדת הדף בחלונית הקריאה לפרמטר של PagerDefaults. (Ifff64)
  • הוספנו פרמטר של אופסט ל-SwipeToDismissBoxState. (I586bd)

תיקוני באגים

  • רטט בפלטפורמה מסתובבת נקרא עכשיו בגרסאות Wear OS אחרי V‏ (Idb03e)

גרסה 1.5.0-alpha07

11 בדצמבר 2024

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

שינויים ב-API

  • עכשיו אפשר להשתמש ב-TransformingLazyColumnState כדי לעקוב אחרי התקדמות הגלילה הנוכחית על סמך אינדקסים של פריטי עוגן. (I72b01)
  • הוספנו אנימציות ל-TransformingLazyColumn כשמוסיפים, מסירים ומזיזים פריטים, אם הם כוללים את Modifier.animateItem החדש. (Iecb9c)
  • עכשיו TransformingLazyColumn חושף ערכים עבור beforeContentPadding ו-afterContentPadding. (Iccd5f)
  • TransformingLazyColumn מספק עכשיו את המאפיין המקומי LocalTransformingLazyColumnItemScope של הקומפוזיציה, שרכיבים (כמו Card ו-Button ב-Material3) יכולים להשתמש בו כדי לבצע טרנספורמציה אוטומטית כשהם ממוקמים בתוך TransformingLazyColumn. מבצעי הקריאה יכולים להשבית את הטרנספורמציה האוטומטית באמצעות המעטפת החדשה TransformExclusion. (I1652f)

תיקוני באגים

  • עדכנו את מהירויות ההזזה המינימליות והמקסימליות של תנועה סיבובית במכשירים שמטרגטים גרסאות U ואילך. (I33559)
  • תיקנו קריסה שהתרחשה אם פריט ב-TransformingLazyColumn לא הכיל רכיבים שניתנים לשילוב (Idb99d)
  • הוספנו תמיכה ב-ScrollFeedbackProvider לחישה רוטורית ב-Android Vanilla ice cream. (Ibc553)
  • הגדלת מרווח הטאץ' בזמן השימוש ב-SwipeToReveal כדי לצמצם את הסיכוי להפעלה בטעות של החלקה בזמן גלילה אנכית. (Ic0672)
  • עדכנו את SwipeDismissableNavHost כך שישתמש ב-PredictiveBackHandler כשהאפשרות הזו זמינה ב-API מגרסה 35 ואילך. במקרה כזה, יוחלו אנימציות חדשות. (I08c11)

גרסה 1.5.0-alpha06

13 בנובמבר 2024

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

שינויים ב-API

  • הפכנו את ScrollInfoProvider לפשוט יותר עבור PagerState על ידי הסרת הפרמטר orientation, שכבר לא נדרש. ההתנהגות החדשה היא ש-TimeText יישאר במקום גם בחלוקה אופקית וגם בחלוקה אנכית לדפים. (I71767)
  • TransformingLazyColumn הוצג בגרסאות קודמות. אנחנו מסירים עכשיו את כתובות האימייל החלופיות של Wear‏ (LazyColumn, שהופנו אל TransformingLazyColumn) לטובת השם החדש TransformingLazyColumn. כמו כן, הסרתנו את המאפיין height של TransformingLazyColumnVisibleItemInfo. במקום זאת, יש להשתמש ב-measuredHeight. (I0ea1e)
  • שינינו את המפרט של PagerDefaults.snapFlingBehavior snapAnimationSpec מ-Tween ל-Spring.‏ (I10d02, ‏ b/349781047, ‏ b/303807950)
  • שדרגנו את LocalReduceMotion CompositionLocal לגרסה יציבה (Ia6f32)

תיקוני באגים

  • עדכנו את Modifier.rotaryScrollable כך שישתמש ב-focusTargetWithSemantics כדי לשפר את התמיכה בסמנטיקה ב-rotary. (Ief0a0)
  • עדכנו את יחסי התלות המינימליים ב-API לגרסה 1.7.4 בספריות Compose. (I88b46)
  • השבתנו את שינוי הרוחב ב-TransformingLazyColumn כפתרון זמני לבאג של חיתוך. (I3dfb8)
  • תיקנו באג שגרם לפריטים להיעלם אחרי גלילה מעבר לקצה המסך עם TransformingLazyColumn (Id7668)
  • הוספנו את LazyLayoutSemantics עבור TransformingLazyColumn. (Ia8f56)

גרסה 1.5.0-alpha05

30 באוקטובר 2024

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

שינויים ב-API

  • הוספנו תמיכה ב-animateScrollTo ב-TransformingLazyColumnState כדי שאפשר יהיה להוסיף אנימציה לגלילה לפריט. (I4097d)
  • הוספנו את requestScrollTo ב-TransformingLazyColumnState כדי לדחות את הגלילה למדידה הבאה. (I20a5e)
  • הוספנו תמיכה ב-contentPadding ב-TransformingLazyColumn. (I3a69c)

תיקוני באגים

  • תיקנו באג ברינדור של TransformingLazyColumn כשגובה התוכן קצר מגובה המסך. (I6c3e1)
  • עכשיו, ScrollInfoProvder של TransformingLazyColumn עוקב אחרי הפריט הראשון בצורה נכונה. (I1e4a3)
  • TransformingLazyColumnState שומר עכשיו את המצב שלו (anchorItemIndex ו-anchorItemScrollOffset). (I3d265)

גרסה 1.5.0-alpha04

16 באוקטובר 2024

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

שינויים ב-API

  • שינינו את השם של Wear Compose Foundation LazyColumn ל-TransformingLazyColumn כדי להבדיל בבירור בינו לבין Compose Foundation LazyColumn. (I0608b)
  • נוספה תמיכה בלחצן מסתובב למכשירי טלפוניה ניידת אופקיים/אנכיים, שמאפשרת למשתמשים לנווט במכשירי טלפוניה ניידת באמצעות התקני קלט מסתובבים. (I9770d)
  • עדכנו את PagerDefaults החדש כדי להבהיר שהמעבר בין דפים יתבצע באופן אוטומטי כברירת מחדל. (Iff7d0)
  • TransformingLazyColumnItemScrollProgress הוא עכשיו סיווג ערך שצפוי לשפר את הביצועים. (Ic399e)
  • TransformingLazyColumn תומך עכשיו ב-rotary מחוץ לקופסה. (I05206)
  • יש עכשיו תמיכה ב-scrollToItem ב-TransformingLazyColumnState. (I507b3)
  • הוסר @ExperimentalWearFoundationApi מ-SwipeToReveal API (I34a66)

גרסה 1.5.0-alpha03

2 באוקטובר 2024

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

שינויים ב-API

  • הוספנו תמיכה בהחלקה דו-כיוונית ב-SwipeToReveal, למקרים נדירים שבהם המסך הנוכחי לא תומך בהחלקה כדי לסגור. . ברירת המחדל עדיין היא החלקה כדי לחשוף רק בהחלקות מימין לשמאל, ומומלץ מאוד לפעול בהתאם לברירת המחדל כדי למנוע התנגשות עם החלקה כדי לסגור. (Ifac04)
  • עדכנו את LazyColumnState כדי לשנות את canScrollForward ו-canScrollBackward – עכשיו הגלילה נעצרת כשהפריט הראשון או האחרון נמצאים בדיוק במרכז המסך. (Ia77d7)
  • הוספנו רכיבים חדשים של HorizontalPager ו-VerticalPager שמטפלים בבעיות נפוצות, כמו טיפול בפוקוס ואינטראקציה עם החלקה במערכת כדי לסגור, שעשויות להתרחש ב-Wear. (I2902b)
  • הוספנו תמיכה ב-LazyColumn כדי לחשוף את key ו-contentType של הלקוח דרך layoutItems. (I1bd9c)

תיקוני באגים

  • עדכנו את האנימציות של הטקסט המעוקל כדי שהן יהיו חלקות יותר, באמצעות דגלים של צביעה. (I73a15)
  • עדכנו את המסמכים של Material Dialog כך שישקפו את העובדה ש-onDismissRequest לא נקרא אחרי שהדגל show מוגדר כ-false. (Ifd8d6)
  • תיקנו באג באנימציית הוויניאט בתיבה המשוחזרת של Material (I126bf)

גרסה 1.5.0-alpha02

18 בספטמבר 2024

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

שינויים ב-API

  • הוספנו תמיכה ב-LazyColumn של Wear Compose באמצעות ScreenScaffold שלנו (והוספנו הטמעה של ScrollInfoProvider ל-LazyColumnState). (Ib8d29)
  • הוספנו את viewportSize ל-LazyColumnLayoutInfo. (I4187f)

תיקוני באגים

  • תיקנו באג כך שגלילה באמצעות לחצן ה-Rotary מושבתת עכשיו ב-ScalingLazyColumn כשהדגל userScrollEnabled מוגדר כ-false. (I490ab, ‏ b/360295825)
  • תיקנו באג שקשור למרווח אנכי בלתי צפוי בטקסט מעוקל. גובה הטקסט המעוגל תואם עכשיו יותר למרחב בפועל שבו הטקסט נמצא. חשוב לדעת שהפעולה הזו עלולה לגרום לכשל בבדיקות של צילומי מסך שכוללים טקסט מעוקל (Iaa6ef)
  • ביטלנו תיקון באג ב-Dialog שבו הופעלה קריאה חוזרת (callback) של onDismissRequest כש-showDialog הוגדר כ-false, כי במקרים מסוימים הקריאה החוזרת של onDismissRequest הופעלה כמה פעמים. (I64656)

גרסה 1.5.0-alpha01

4 בספטמבר 2024

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

שינויים ב-API

  • הוספנו LazyColumn חדש לספריית Wear Compose Foundation עם ממשקי ה-API המשויכים LazyColumnState ו-LazyColumnScope. זהו הבסיס ליצירת אפקטים של התאמה לעומס (scaling) ושל טרנספורמציה (morphing) בהתאמה אישית באמצעות Wear Compose. (Ib3b22)
  • הוספנו גרסה של itemsIndexed שנוספה לאינדקס אל LazyColumnScope כחלק מ-LazyColumn API החדש. (Ib4a57)
  • הוספנו את המשתנים המגבילים LazyColumn כדי לתמוך בהתנהגויות של שינוי קנה מידה וטרנספורמציה. (Ie229a)
  • גרסת HierarchicalFocusCoordinator קודמה לגרסה יציבה. (I31035)
  • הוספנו תמיכה בריווח בין האותיות לטקסט מעוקל. (I3c740)
  • הוספנו פרמטר rotationLocked ל-CurvedLayout.curvedComposable כדי להפסיק את הסיבוב של הרכיבים. (I66898)
  • ה-API הזמני של LocalUseFallbackRippleImplementation מ-wear material ומ-wear material3 הוסר (I62282)
  • המשתמש WearDevices.SQUARE הוסר מהתצוגה המקדימה המשותפת של @WearPreviewDevices (I11c02)

תיקוני באגים

  • SwipeToReveal ממקם עכשיו את הפריטים שנחשפו בחלק הגלוי של המסך. זה עוזר כשמשתמשים ב-SwipeToReveal בתוך רשימה, כך שאפשר תמיד לבצע פעולות עם הפריטים והם אף פעם לא יוצאים מחוץ למסך. (I38929)
  • SwipeToReveal מאפס עכשיו את lastActionType ל-None כשהפעולה animatedTo מסתיימת. (I59b03)
  • שיפרנו את המסמך בנושא הפרמטר החדש rotationLocked ב-curvedComposable. (Ifbd57)
  • תוקנה קריסה במעבר של NaN אל performFling של ScalingLazyColumnSnapFlingBehavior. (Ic13da)
  • תוקן באג במשתנה הגודל של פריסה מעוקלת (I0fedf)
  • הוספנו תמיכה במרווח בין אותיות שצוין ב-'sp'. (I9f6e3)
  • תיקנו באג ב-Material2 Dialog שבו פונקציית ה-callback‏ onDismissRequest לא היתה נקראת כשתיבת הדו-שיח הפכה לא נראית (I64656)
  • השם של LayoutCoordinates.introducesFrameOfReference שונה ל-LayoutCoordinates.introducesMotionFrameOfReference כדי לשקף טוב יותר את המטרה שלו. שינוי השם של פונקציה קשורה כדי לחשב קואורדינטות על סמך הדגל הזה. (I3a330)

גרסה 1.4

גרסה 1.4.0

4 בספטמבר 2024

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

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

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

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

גרסה 1.4.0-rc01

21 באוגוסט 2024

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

  • עדכנו את יחסי התלות של Compose לגרסה 1.7.0-rc01, והצמצמנו את Wear Compose Navigation ל-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 כדי להחליף את השימוש ב-'focusable' ב-'focusTarget', וכך לשפר את הביצועים. (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-beta01 כוללת את ההוספות האלה.

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

  • הוספנו את Modifier.rotaryScrollable, פונקציית שינוי חדשה שמחברת בין אירועים רוטורים לבין קונטיינרים שניתן לגלול בהם, ומאפשרת למשתמשים לגלול באמצעות כתר או מסגרת מסתובבת במכשיר Wear OS. בנוסף, עכשיו יש תמיכה ב-ScalingLazyColumn וב-Picker בקלט רוטורי כברירת מחדל. משתמשים בפרמטר rotaryScrollableBehavior כדי להגדיר את התנהגות הגלילה או הצמדה. לגבי התנהגות הצמדה, מומלץ לספק הצמדה גם דרך הפרמטר 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

  • ביצענו את השינויים הבאים ב-API החדש של Rotary: שינינו את השם של Modifier.rotary ל-Modifier.rotaryScrollable, שינינו את השם של הממשק RotaryBehavior ל-RotaryScrollableBehavior ואת השם של הפונקציה שלו handleScrollEvent ל-performScroll, שינינו את השם של RotaryScrollableAdapter ל-RotaryScrollableLayoutInfoProvider והסרנו את המאפיין scrollableState. (I0c8a6)
  • ביצענו שינויים נוספים ב-API של Rotary: שינינו את השם של RotaryScrollableLayoutInfoProvider ל-RotarySnapLayoutInfoProvider (כי הספק הזה נדרש רק ל-Rotary עם 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, מומלץ לספק snap גם דרך הפרמטר flingBehavior, לגלילה במגע. (I2ef6f)
  • המקורות NestedScroll Drag ו-Fling מוחלפים ב-UserInput וב-SideEffect כדי להתאים להגדרה המורחבת של המקורות האלה, שכוללת עכשיו אנימציות (Side Effect) גלגל עכבר ומקלדת (UserInput). (I40579)
  • הוספנו את הסמלים SelectableChip ו-SplitSelectableChip כדי להבדיל בצורה ברורה יותר בין לחצני החלפת מצב כמו Switch/Checkbox לבין לחצני בקרה לבחירה כמו RadioButton. הפעולה הזו מחליפה את עומסי יתר (overloads) של 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 מכילה את ההוספות האלה.

תיקוני באגים

  • הוספנו טיוטה פנימית של תמיכה בלחצנים מסתובבים, כחלק מהמאמץ הכולל להעביר את ההתנהגות של לחצנים מסתובבים ל-AndroidX מ-Horologist. (I617d1)
  • הוספנו טיוטה פנימית של תמיכה בהפעלה חושית, כחלק מהמאמץ הכולל להעביר את ההתנהגות של Rotary ל-AndroidX מ-Horologist. (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

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

תיקוני באגים

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

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

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

רשימה מלאה יותר של השינויים בגרסה 1.3.0 מופיעה בנתוני הגרסה של beta01.

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

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

גרסה 1.3.0-rc01

10 בינואר 2024

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

תיקוני באגים

  • עדכנו את הצורה הגדולה של MaterialTheme כך שתהיה לה פינות מעוגלות ברדיוס של 26dp. מעכשיו, הצורה הזו תהיה בשימוש ב-Chip וב-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 מכילה את ההצהרות האלה על ביצוע שינויים (commits).

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

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

בעיות מוכרות

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

שינויים ב-API

  • שינינו את השם של רמת הבסיס SwipeToDismissBox ל-BasicSwipeToDismissBox. כך אפשר להבחין בבירור בין הרכיב ברמת הבסיס לבין הרכיב ברמת החומר SwipeToDismissBox. הקוד האחרון שולף צבעים מה-MaterialTheme לשימוש במסכי ה-scrim ומעביר את שאר ההטמעה ל-BasicSwipeToDismissBox. (Ibecfc)
  • סימנו את rememberExpandableStateMapping כניסוי ושפרנו את הביצועים של expandableItem. (I5f6bc)
  • החלפנו את הכיתה SwipeToRevealAction בממשקי ה-API של כרטיסי SwipeToReveal ושבבים של Material בממשק 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 הקודם הוצא משימוש והוא מעביר את הקריאות ל-API החדש. מטעמי ביצועים ועקב עקביות בממשק המשתמש, כשמשתמשים ב-PositionIndicator עם רשימה שאפשר לגלול בה, מומלץ להשבית את הדגלים showFadeInAnimation ו-showPositionAnimation. אם משתמשים ב-PositionIndicator כאינדיקטור עצמאי, למשל לשינוי עוצמת הקול, מומלץ להפעיל את כל 3 האנימציות. (I44294)
  • הוצאנו משימוש את הרכיבים SwipeToDismissBoxState, ‏ SwipeToDismissValue ו-edgeSwipeToDismiss של Material Design בעקבות ההעברה של הפונקציונליות של החלקה כדי לסגור אל wear.compose.foundation. צריך להחליף את הערכים בערכים המקבילים של wear.compose.foundation. (Iee8c9)

תיקוני באגים

  • עדכנו את הפרופילים הבסיסיים של ספריות ה-foundation, ה-material והניווט של Wear Compose. (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 הקודם הוצא משימוש והוא מעביר את הקריאות ל-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 Foundation ו-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 באמצעות הרכיבים הקיימים ב-Material Design ל-Wear. (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, שבו 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)
  • ההגדרה 'הפחתת תנועה' משביתה עכשיו את האפקט של הבהוב ואת התנועה של מחיקה של סמלי placeholder. (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. מפתחות הרקע והתוכן מועברים עכשיו לבלוק remember, כדי שייווצרו משתני אופן פעולה חדשים כשהתוכן או הרקע ישתנו. (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, שמשבית את התכונות 'שינוי גודל' ו'העלמה' ב-ScalingLazyColumn. (I58024)

תיקוני באגים

  • עדכנו את הפרופילים הבסיסיים של ספריות החומרים והבסיס של Wear Compose‏(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 כוללת את ההוספות האלה.

מה חדש ב-Compose 1.2 ל-Wear OS

הגרסה 1.2-beta01 של Compose for 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 שונים.
  • הוספנו ל-Wear Compose את DefaultTextStyle, שמגדיר את ברירת המחדל של נכס PlatformTextStyle.includeFontPadding כ-true (זו ההגדרה הנוכחית). כך נוכל לסנכרן את השבתת הוספת רווחים מסביב לגופן כברירת מחדל עם ספריות Compose בגרסה מוקדמת של 1.3 alpha. מידע נוסף זמין במאמר 1.2.0-alpha10.

תכונות חדשות

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

תיקוני באגים

  • מסמכים משופרים לגבי angularWidthDp ב-CurvedSize.kt (Iab75c)
  • SwipeDismissableNavHost מתעדת עכשיו אזהרה עם סיבות אפשריות ל-backstack ריק. המטרה היא למנוע קריסות בלתי צפויות שנגרמות בגלל IllegalArgumentException שהופעל כש-backstack היה ריק. (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)
  • תיקנו באג ב-Chip וב-CompactChip שבו התפקיד הסמנטי כבר לא הוגדר כ-Role.Button. (I93f91, ‏ b/277326264)

בעיות מוכרות

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

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

טקסט חתוך עם גופן גדול
איור 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 בדמואים של Picker. (If8c19)
  • שיפרנו את מעברי הדיאלוג – מעכשיו המעבר של תחילת הסרטון חלק יותר כדי להתאים למעבר של סוף הסרטון. (Ib5af9)
  • הוספנו ל-Wear Compose את DefaultTextStyle, שמגדיר את ברירת המחדל של נכס PlatformTextStyle.includeFontPadding כ-true (זו ההגדרה הנוכחית). כך נוכל לסנכרן את השבתת הרווח מסביב לגופן כברירת מחדל עם ספריות ה-Compose בעתיד. לרקע, אפשר לעיין במאמר תיקון הרווח מסביב לגופן ב-Compose. (I2aee8)
  • הופרה תלות בתצוגה המקדימה של UpsideDownCake באמצעות activity-compose, שחסמה את פרסום האפליקציות בחנות 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 כתכונה ניסיונית, אבל היא נחשבת כמועמדת להעברה לספריות הליבה של compose, בגלל השימושים הרבים שלה. (I3a768)

תיקוני באגים

  • תוקן באג ב-HierarchicalFocusCoordinator: כשה-lambda שהוענק לפרמטר focusEnabled משתנה, אנחנו משתמשים עכשיו ב-lambda החדש בצורה נכונה. (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 לטיפול בכמה בוררי בחירה יחד באמצעות ה-API של Focus. הוא מטפל בהתמקדות בין הבוררים השונים, מאפשר מרכוז אוטומטי של הבוררים על סמך פרמטרים ומאפשר למפתחים לשנות את המיקוד בין הבוררים השונים בזמן הטיפול באירועים מהקבוצה. במצב TalkBack, הלחצן PickerGroup מטפל במיקוד של TalkBack על ידי העברת המיקוד לבורר שנבחר מהקבוצה. (I60840)

שינויים ב-API

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

תיקוני באגים

  • מתן אפשרות להטמיע את ScalingLazyColumn בדף עם גלילה אופקית (Iec3f8, ‏ b/266555016)
  • שיפור של מסמכי ה-kdocs של Stepper וניפוי של בדיקות 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 והוא טבעי יותר כי הוא לא רכיב Material מוכתב. אנחנו מבצעים את השינוי הזה עכשיו לקראת השקת ספרייה חדשה של Material3, שעליה נעבוד במקביל לספרייה הקיימת של Material. (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 Material. (Ifc42c)
  • עדכנו את ממשקי Dialog API כך שישתמשו ב-ScalingLazyListState מ-Foundation.Lazy והוצאנו משימוש את עומסי יתר שהשתמשו ב-Material ScalingLazyListState (Ic8960)
  • עדכנו את ממשקי ה-API של הבורר כך שישתמשו ב-ScalingParams מ-Foundation.Lazy, והוצאנו משימוש את עומסי יתר שהשתמשו ב-Material 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 Compose יתבצעו מעברים של פריסה לכל פריים בזמן ביצוע הפריים כדי להגיע למצב חוסר פעילות (למשל באמצעות waitForIdle). הדבר עשוי להשפיע על בדיקות שמבצעות טענת נכוֹנוּת (assert) על פריים ספציפי של אנימציות פריסה. (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 כך שהאפקט 'מחיקה' יוחל באופן מיידי כשהתוכן יהיה מוכן, במקום להמתין להתחלת לולאת האנימציה הבאה. בנוסף, ביצענו כמה עדכונים באנימציות של הבהוב והמחיקה. (I5a7f4)

שינויים ב-API

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

תיקוני באגים

  • שינינו את רוחב ההיקף שמוגדר כברירת מחדל ל-OutlinedButton/OutlinedCompactButton מ-2dp ל-1dp, כדי להתאים למפרטי חוויית המשתמש הסופיים. (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 מכילה את ההצהרות האלה על ביצוע שינויים (commits).

תיקוני באגים

  • 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 כך שהאפקט 'מחיקה' יוחל באופן מיידי כשהתוכן יהיה מוכן, במקום להמתין להתחלת לולאת האנימציה הבאה. בנוסף, ביצענו כמה עדכונים באנימציות של הבהוב והמחיקה. (I5a7f4)

תיקוני באגים

  • שינינו את רוחב ההיקף שמוגדר כברירת מחדל ל-OutlinedButton/OutlinedCompactButton מ-2dp ל-1dp, כדי להתאים למפרטי חוויית המשתמש הסופיים. (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)
  • הוספנו מסמך ודוגמה למעקב אחרי מיקומי תוכן כדי להראות את הסדר הנכון של Modifier.placeholder ו-Modifier.placeholderShimmer כשהם חלים על אותו רכיב מורכב. (Ie96f4, ‏ b/256583229)
  • שינינו את רוחב ההיקף שמוגדר כברירת מחדל ל-OutlinedCompactChip/OutlinedChip מ-2dp ל-1dp, כדי להתאים למפרטי חוויית המשתמש הסופיים. (Ib3d8e)
  • תיקנו באג ב-rememberPickerState שבו לא נשמרו קלטות מעודכנות, כך שרכיבי ה-Composable לא התעדכנו אחרי שינויים בקלטות. (I49ff6, ‏ b/255323197)
  • ביצענו כמה עדכונים בממשק המשתמש של הסמנים, 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 כוללת את השמירות האלה.

מה חדש ב-Compose for Wear OS 1.1

הגרסה 1.1.0-beta01 של Compose for Wear OS ציינה שהגרסה הזו של הספרייה כוללת את כל התכונות וה-API נעול.

  • הגרסה 1.1 של Wear Compose כוללת את הפונקציונליות החדשה הבאה:
    • בורר – שיפורים בנגישות של הבורר, כך שאפשר לנווט במסכים עם כמה בוחרים באמצעות קוראי מסך ותיאור התוכן נגיש
    • הפרמטר contentDescription של הבורר משמש עכשיו רק לאפשרות שנבחרה בבורר, ומקבל מחרוזת nullable (בקוד הקודם היה צריך להעביר מיפוי מהאפשרות לתיאור התוכן, אבל המערכת השתמשה רק באפשרות שנבחרה).
    • הפריטים בבורר מותאמים עכשיו תמיד למרכז. תיקון באג שבו הגדרת 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 יוכל לזהות אותם כלחצנים.
    • Scaffold – עכשיו ה-PositionIndicator ממוקם בגודל המתאים כך שהוא תופס רק את המרחב הנדרש. לדוגמה, אם מתווסף לו מידע סמנטי, עכשיו קורא המסך קורא את הגבולות הנכונים של 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. הרקע הזה כולל שלושה אפקטים חזותיים שונים שנועדו לפעול יחד.
    • ראשית, אפקט של מברשת רקע למעקב אחרי מיקום תוכן, שמשמשים בתיבות אחסון כמו צ'יפ וכרטיסים כדי לצייר מעל הרקע הרגיל בזמן ההמתנה לטעינת התוכן.
    • שנית, משתנה (Modifier.placeholder()) לציור ווידג'ט של placeholder בצורת אצטדיון מעל התוכן שנטען.
    • השלישית היא אפקט שינוי של שינוי הדרגתי או הבהוב (Modifier.placeholderShimmer()) שמצויר מעל שאר האפקטים כדי להצביע למשתמשים שאנחנו ממתינים לטעינה של הנתונים.
      • כל האפקטים האלה תוכננו כך שיתאימו זה לזה, ויתנו תחושה של הבהוב והיעלמות בצורה מתואמת.
  • יחסי התלות של Core Compose עודכנו מ-1.2 ל-1.3

שינויים ב-API

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

תיקוני באגים

  • curveText ו-basicCurvedText יפעלו עכשיו כמו שצריך עם TalkBack (יש להם צומת compose-ui בגודל ובמיקום מתאימים (אבל ריק) שמשויך אליהם, והטקסט משמש כתיאור התוכן) (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. הוא כולל שלושה אפקטים חזותיים שונים שנועדו לפעול יחד. ראשית, אפקט של מברשת רקע למעקב אחרי מיקום תוכן, שמשמשים בתיבות אחסון כמו צ'יפ וכרטיסים כדי לצייר מעל הרקע הרגיל בזמן ההמתנה לטעינת התוכן. שנית, משתנה (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 ממוקם בגודל המתאים, כך שהוא תופס רק את המרחב הנדרש. לדוגמה, אם מתווסף לו מידע סמנטי, עכשיו קורא המסך קורא את הגבולות הנכונים של 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 כדי לשפר את הנגישות. לצבעים המקוריים לא הייתה ניגודיות מספקת, ולכן המשתמשים התקשו להבדיל בין הרקעים של הצ'יפים, הכרטיסים והלחצנים לבין צבע הרקע של העיצוב. הצבעים המעודכנים הם surface‏(0xFF202124->0xFF303133), ‏ onPrimary‏(0xFF202124->0xFF303133), ‏ onSecondary‏(0xFF202124->0xFF303133), ‏ primaryVariant‏(0xFF669DF6->0xFF8AB4F8) ו-onError‏(0xFF202124->0xFF000000). השינויים בצבעים, שעדיין לא מורגשים, עשויים להשפיע על בדיקות צילומי המסך הקיימות. (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 כי הוא לא תאם למפרט ממשק המשתמש שלו. במפרט ממשק המשתמש מצוין שצריך להוסיף מרווח של 4dp בין התווית לבין אזור של סמל מתג בגודל 24x24dp, כך שהרוחב הכולל הוא 28dp. עם זאת, ההטמעה נותנת באופן שגוי אזור של מתג החלפת מצב בגודל 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 מכילה את ההוספות האלה.

תכונות חדשות

  • שינינו את יחסי התלות של Compose for Wear OS בספריות הליבה של Compose מ-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 של הבורר משמש עכשיו רק לאפשרות שנבחרה בבורר, והוא מקבל מחרוזת nullable (בעבר היה צריך להעביר מיפוי מהאפשרות לתיאור התוכן, אבל רק האפשרות שנבחרה הייתה בשימוש). (Ife6a7)
  • ביצענו שיפורים בנגישות של Picker, כך שאפשר לנווט במסכים עם כמה בוררים באמצעות קוראי מסך ותיאור התוכן נגיש (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 מכילה את ההצהרות האלה על ביצוע שינויים (commits).

תיקוני באגים

  • תיקון באג לוגי ב-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

  • זוהי הגרסה היציבה הראשונה של Compose ל-Wear OS (מידע נוסף).
  • Compose for Wear OS מבוסס על ספריות הליבה של Compose, ומספק רכיבים נוספים שספציפיים למכשירים לבישים, ובמקרים המתאימים, הטמעות חלופיות של רכיבי הליבה של Compose שמותאמים למכשירים לבישים.
  • רשימה של הרכיבים העיקריים ב-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

  • ממשקים בספריות compose נוצרים עכשיו באמצעות שיטות ברירת המחדל של ממשק 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 כדי לוודא שגודל משטח המגע שלו יהיה לפחות 48dp גובה, בהתאם להנחיות הנגישות של 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 מ-Start ל-CenterHorizontally כדי להבטיח שאם פריטי הרשימה לא ימלאו את כל רוחב העמודה, הם ייטוו כדי לשפר את החשיפה שלהם. כדי לחזור לקבוצת ההתנהגות הקודמת, מזינים horizontalAlignment = Alignment.Start.‏(I9ed4b)

בעיות מוכרות

  • גובה ההקשה/הנגיעה של CompactChip קטן מההנחיות של Material Design בנושא נגישות. הבעיה תתוקן במהדורה הבאה (15 ביוני). אם אתם משתמשים ב-CompactChip, השינוי ישפיע על הפריסות כי ל-CompactChips תהיה עכשיו תוספת של רווח למעלה ולמטה. צריך לשנות ולבדוק את הפריסות או לעיין בתגובות בנושא הבאג כדי למצוא פתרון זמני לשימוש בהתנהגות הקיימת. (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 מכילה את ההצהרות האלה.

תכונות חדשות

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

תיקוני באגים

  • ה-constructor של CurvedTextStyle שמקבל TextStyle מתייחס עכשיו גם ל-fontWeight(יכול להיות שהתכונה הזו תתווסף ל-constructor ול-copy methods בגרסאות עתידיות של ה-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 כוללת את ההצהרות האלה.

מה חדש ב-Compose ל-Wear OS 1.0

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

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

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

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

  • בנוסף, הרכיבים הבאים נכללים מ-Wear Compose Foundation:

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

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

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

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

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

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

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

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

שינויים ב-API

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

תיקוני באגים

  • לחצני ההקטנה וההגדלה בפס ההזזה משותקים עכשיו כשמגיעים למגבלות התחתונות או העליונות (ומחילים את ContentAlpha.disabled על 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, בדומה למקש הזה ב-Compose. אפשר להשתמש באפשרות הזו בצאצאים של curvedRow ו-CurvedLayout (לרוחב) ובצאצאים של curvedColumn (לגובה). (I8abbd)
  • נוספו המשתנים CurvedModifier.size, ‏ .angularSize ו-.radialSize כדי לציין את הגודל של רכיב מעוקל. (I623c7)

שינויים ב-API

  • שינוי הסדר של הפרמטרים כדי לוודא שהרקע מופיע לפני הצבע באופן עקבי ב-Wear Compose API (I43208)
  • הפרמטרים clockwise ו-insideOut הוסרו בכיתות חדשות והוחלפו בערכי קבועים מפורטים יותר. עכשיו אפשר להגדיר את כיוון הפריסה המעוגלת בהתאם ל-LayoutDirection, והוא עובר בירושה אם לא צוין (If0e6a)
  • החלפנו את autoCenter: Boolean ב-autoCenter: AutoCentringParams כדי לפתור בעיה ב-API ב-ScalingLazyColumn. (Ia9c90)
  • שינינו את השמות של iconTintColor ו-toggleControlTintColor ל-iconColor ו-toggleControlColor ב-API כולו (Chip/ToggleChip/Dialog/Slider/Stepper/‎...‎), כי הצבע חל על חריץ הסמל/הלחצן להפעלה/השבתה. (Ied238)
  • כתיבה מחדש של הטיפוס בן המנייה (enum) PageIndicatorStyle כמחלקת ערכים (I2dc72)
  • הוספנו את הערך RowScope/ColumnScope/BoxScope לחלק מהמשבצות ב-Composables שלנו כדי לציין למפתחים מהן ההנחות לגבי הפריסות. כך המפתחים יוכלו להשתמש במודיפיקטורים נוספים בחלק מהתוכן בחריצים, ולא יצטרכו לספק רכיבי פריסה נוספים. בנוסף, ביצענו כמה עדכונים קלים בצבעים של כרטיסי האפליקציה/הכותר, כך שהצבע שמוגדר כברירת מחדל של timeColor ו-appColor הוא contentColor. עדיין אפשר לשנות את כל המאפיינים האלה בנפרד לפי הצורך. (I26b59)
  • הוגדר שהאובייקט SwipeToDismissBoxState.Companion יהיה פרטי (I39e84)
  • מתקנים את סדר הפרמטרים של InlineSlider ושל Stepper. שינוי פשוט בהתאם להנחיות API (I11fec)
  • הסרנו את האובייקט Saver עבור SwipeToDismissBoxState כי לא נעשה בו שימוש. (Ifb54e)
  • עדכנו את CompactChip בהתאם למפרט העדכני ביותר של חוויית המשתמש. המרווחים הוקטנו ל-horizontal = 12.dp ול-vertical = 0.dp. הגופן של התווית השתנה מ-button ל-caption1. הגדלים המומלצים של סמלים הם 20x20 כשמוצגים גם הסמל וגם התווית, ו-24x24 כשמוצג רק סמל בצ'יפ קומפקטי. בתרחיש לדוגמה שבו מוצג רק סמל, הקפדנו גם שהסמל יהיה ממורכז. (Iea2be)
  • הוספנו כמה שדות חדשים ל-ScalingLazyListLayoutInfo כדי לאפשר למפתחים לדעת את הסכום של contentPadding ו-autoCenteringPadding שהוחלו. המפתחות האלה יכולים להיות שימושיים למפתחים בזמן חישוב של תנועה מהירה או גלילה (I7577b)
  • הטמענו מעברים לכניסה/יציאה ל-Dialog. נוסף פרמטר showDialog, ועכשיו תיבת הדו-שיח קובעת את החשיפה שלה (הדבר מאפשר לתיבת הדו-שיח להפעיל את האנימציות של הפתיח והסיום כשהיא מוצגת או מוסתרת). לתשומת ליבכם: אנימציית הסיום לא מופעלת כשהמשתמש יוצא מתיבת הדו-שיח באמצעות החלקה כדי לסגור. הוספנו גם ערך ברירת מחדל למצב (state) ב-overload של SwipeToDismissBox שנוסף לאחרונה. (I682a0)
  • כדי לשפר את התמיכה ב-i18n וב-a11y, שינינו את ToggleChip ו-SplitToggleChip כך שלא תהיה להם יותר ברירת מחדל למיקום toggleControl. שינינו גם את ToggleChipDefaults כך שהשיטות הבאות מחזירות עכשיו ImageVector במקום Icon (שימו לב: מאחר שהן לא מחזירות יותר @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 ל-Scaffold. הוספת PageIndicator ישירות ל-Scaffold תעזור לנו לוודא שהיא תוצג בצורה נכונה במכשירים עגולים. (Ia6042)
  • מסירים את הסמלים שמוגדרים כברירת מחדל מהפרמטרים InlineSlider ו-Stepper. כך המפתחים יוכלו להקפיד יותר על הדרישות בנושא לוקליזציה ונגישות. הדגמות ודוגמאות הראו שימושים בסמלי ברירת המחדל. (I7e6fd)
  • החלפת שמות הפרמטרים Trailing ו-Leading בשמות Start ו-End ב-TimeText (Iaac32)
  • הוספנו עומס יתר של SwipeToDismissBox עם פרמטר onDismissed כדי לתמוך בשימוש הנפוץ של הפעלת אירוע ניווט כשתנועת החלקה מסתיימת. (I50353, ‏ b/226565726)
  • הסרת ההערות של ExperimentalWearMaterialApi מהשימוש ב-TimeText (Ide520)
  • סימנו את ממשקי המידע וההיקף של ScalingLazyList/Column כסגורים, כי הם לא מיועדים להטמעה על ידי מפתחים חיצוניים. כך נוכל להוסיף אליהם חברים חדשים בעתיד בלי שינויים בינאריים שגורמים לשיבושים. (I7d99f)
  • הוספנו ל-Picker מאפיין flingBehaviour חדש ושיטה PickerDefaults.flingBehaviour() כדי לאפשר הגדרה של התנהגות ה-fling, למשל הוספת תמיכה ב-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 (טקסט מעוקל של ה-Foundation) ו-curvedText (טקסט מעוקל מותאם לחומרים של Wear). (Ib776a)
  • מגדירים את הצד של PositionIndicator כניתן להגדרה. עכשיו אפשר להגדיר את המיקום הבסיסי של PositionIndicator כ-End (בהתאם לכיוון הפריסה), כ-OppositeRsb (לוקח בחשבון את סיבוב המסך כדי למקם את הרכיב מול ה-RSB הפיזי) או כ-Left ו-Right (מיקומים מוחלטים). (I2f1f3)
  • עבור SwipeToDismissBox, שינינו את השם של SwipeDismissTarget.Original ל-SwipeToDismissValue.Default ואת השם של SwipeDismissTarget.Dismissal ל-SwipeToDismissValue.Dismissed. כמו כן, הענקנו לדומיינים SwipeToDismissBoxDefaults.BackgroundKey ו-SwipeToDismissBoxDefaults.ContentKey את הכתובות SwipeToDismissKeys.Background ו-SwipeToDismissKeys.Content, בהתאמה. (I47a36)
  • הוספנו למרכז הבחירה מצב קריאה בלבד, למסכים עם כמה מרכזי בחירה שבהם אפשר לערוך רק מרכז בחירה אחד בכל פעם. כשהבורר מוגדר לקריאה בלבד, מוצגת בו האפשרות שנבחרה כרגע ותווית, אם סיפקו אותה. (I879de)
  • SwipeToDismissBoxState עבר שינוי מבני כדי להגביל את ההיקף של ExperimentalWearMaterialApi ל-Modifier.swipeable ול-SwipeableState, שבהם נעשה שימוש פנימי עכשיו. SwipeToDismissBoxState כולל עכשיו את המאפיינים currentValue, ‏ targetValue, ‏ isAnimationRunning ו-snapTo כדי לתמוך בתרחישי שימוש נפוצים. אפשר להודיע לנו אם יש לך צורך במאפיינים נוספים. תוקן גם ההתנהגות של SwipeableState במקרה שבו ההיסט של החלקה נמצא בתוך שגיאת עיגול של עוגן. (I58302)

תיקוני באגים

  • קוד פשוט וקבוע לזיהוי אם אפשר לגלול בתוכן של ScalingLazyColumn (משמש כדי להחליט אם להציג פס גלילה או לא) (I7bce0)
  • תוקנה באג באינדיקטור המיקום כשמשתמשים בו עם יותר ממצב אחד ומחליפים ביניהם (I320b5)
  • עדכנו את הגופנים/הטיפוגרפיה של נושא ברירת המחדל של Compose ל-Wear OS בהתאם להנחיות האחרונות שלנו בנושא חוויית משתמש. חשוב לציין ש-display1‏ (40.sp) ו-display2‏ (34.sp) קטנים עכשיו מהערכים הקודמים שלהם, ושהיו עדכונים קלים נוספים לגובה השורה ולמרווח בין השורות. (Ie3077)
  • הוספנו התנגדות ל-SwipeToDismissBox כדי שהתנועה תתרחש רק כשמחליקים כדי לסגור, ולא בכלל בכיוון ההפוך. (Ifdfb9)
  • שינינו חלק מערכי ברירת המחדל של הפרמטרים לפונקציות CircularProgressIndicator כדי ליישר קו עם ההנחיות של Wear Material Design לממשק המשתמש. בגרסה של Spinner/Indeterminant, הגודל (40->24.dp), indicatorColor (primary->onBackground), השקיפות של trackColor (30%->10%) ורוחבו של הקו (4->3dp) עודכנו. בגרסה Progress/Determinate, השקיפות של trackColor (30%->10%) עודכנה. (I659cc)
  • עדכנו את הפרמטרים של ברירת המחדל להתאמה לערך של ScalingLazyColumn בהתאם למפרט העדכני ביותר של חוויית המשתמש של Material Design ב-Wear. מבחינה חזותית, התוצאה היא שפריטי הרשימה מתחילים להתכווץ קרוב יותר למרכז הרשימה, אבל להתכווץ פחות בקצה הרשימה בהשוואה לעבר. (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

  • כמה שיפורים ב-PositionIndicator: שם הפרמטר ShowResult השתנה ל-PositionIndicatorVisibility. שיפורים מסוימים בביצועים כדי למנוע חישובים חוזרים כשאין צורך בכך (Iaed9d)
  • הצביעה המומלצת של SplitToggleChip עודכנה. ל-SplitToggleChip יש עכשיו רקע בצבע אחיד כשהוא מסומן או לא מסומן, והצבע של ToggleControl הוא האינדיקטור הראשי לכך שהרכיב מסומן או לא. הוספנו ToggleDefaults.splitToggleChipColors() חדש לתמיכה בסכימת הצבעים החדשה. הפשטנו גם את השיטות של toggleChipColors() והסרנו את splitBackgroundOverlayColor (I7e66e)
  • הוספנו את unadjustedSize ל-ScalingLazyListItemInfo כי לא בטוח לחשב את גודל הפריט המקורי באמצעות הגודל המותאם וגורם ההתאמה, בגלל הדיוק של החישובים במתמטיקה של float. (I54657, ‏ b/221079441)
  • מוסיפים את HorizontalPageIndicator. הוא מייצג את המספר הכולל של הדפים ואת הדף שנבחר. יכול להיות לינארי או מעוגל, בהתאם לצורת המכשיר. בנוסף, יש תמיכה בצורת מחוון בהתאמה אישית, שמגדירה את האופן שבו כל מחוון מיוצג באופן חזותי. (Iac898)
  • עדכנו את PickerState כדי שניתן יהיה לעדכן את numberOfOptions. כך אפשר לתמוך בתרחישי שימוש כמו DatePicker, שבהם מספר הימים בחודש משתנה בהתאם לחודש שנבחר. הפרמטר של ה-constructor ל-PickerState השתנה בהתאם ל-initialNumberOfOptions. (Iad066)
  • הסתרת PositionIndicator כשיש סרגל גלילה ולא ניתן לגלול. (Id0a7f)
  • כדי לשמור על עקביות עם Scaffold, עכשיו מוצגים PositionIndicator ו-Vignette ברכיב Dialog במסך מלא. אנחנו משתמשים עכשיו גם ב-ScalingLazyColumn במקום ב-Column, כלומר תוכן התיבת הדו-שיח נמצא עכשיו ב-ScalingLazyListScope (ובדרך כלל צריך להקיף אותו בפריט { /* content */ }). בהתאם, תיבת הדו-שיח תומכת בפרמטר verticalArrangement. (Idea13)
  • שינינו את השם של נכס toggleIcon‏ ToggleChip ו-SplitToggleChip ל-toggleControl כדי להתאים אותו יותר ל-Material Design, וכדי לעזור למעצבים ולמפתחים לנווט ב-API. (If5921, ‏ b/220129803)
  • הוספנו את הכיתוב caption3 למערכת הסיווג של נושאי העיצוב של Wear Material.caption3 הוא גופן קטן שמשמש לכתיבת טקסטים ארוכים במיוחד, כמו טקסטים משפטיים. (I74b13, ‏ b/220128356)

תיקוני באגים

  • מפסיקים את אנימציית הצמדת המסך כשמגיעים אליו. (Idb69d)
  • אנימציה של שינויים ב-PositionIndicator. (I94cb9)
  • על סמך משוב לגבי ממשק המשתמש או חוויית המשתמש, שינינו את ה-autoCentering של ScalingLazyColumn כך שיהיה מספיק מקום רק כדי לוודא שאפשר יהיה לגלול את הפריטים עם המדד ScalingLazyListState.initialCenterItemIndex ומעלה עד למרכז אזור התצוגה. כך המפתחים יכולים למקם בהתחלה פריט אחד או שניים לגבי הפריט במרכז, שלא ניתן לגלול אליהם. המשמעות היא ש-ScalingLazyColumn עם autoCenter לא יוכל לגלול מעל initialCenterItemIndex/initialCenterItemScrollOffset (I22ee2)
  • הוספנו הדגמה לבורר תאריכים ותיקנו באג ב-PickerState שבו האפשרות initiallySelectedOption לא הופעלה עד שהבורר הוצג. (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) כדי להפעיל תמיכה ב-Snap. (I068d3, ‏ b/217377069)
  • הוספנו הדגמות ל-Picker, שמשמשים לבחירת שעה בפורמט של 24 שעות או 12 שעות. (Ie5552)

שינויים ב-API

  • תוקנה בעיה בגופנים ובסגנונות מותאמים אישית של TimeText במכשיר מרובע (Iea76e)
  • ל-ScalingLazyListLayoutInfo יש עכשיו את המאפיינים reverseLayout, ‏ viewportSize ו-orientation שתואמים לאלה של 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. אינדיקטורים של התקדמות מציגים את משך התהליך או את זמן ההמתנה הלא מצוין. תמיכה בפער (חור) ל-TimeText או לרכיבים אחרים אם משתמשים במסך מלא. (Iab8da)

שינויים ב-API

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

תיקוני באגים

  • שינינו את ברירת המחדל של initialCenterItemIndex עבור ScalingLazyListState מ-0 ל-1. המשמעות היא שאם לא תתבצע שינוי במהלך יצירת המצב באמצעות ScalingLazyListState.rememberScalingLazyListState(initialCenterItemIndex =), פריט הרשימה השני (index == 1) יוצב במרכז אזור התצוגה בזמן האינטליקציה, והפריט הראשון (index == 0) יוצב לפניו. כך אפשר ליהנות מאפקט חזותי טוב יותר כברירת מחדל, כי רוב אזור התצוגה יאוכלס בפריטי הרשימה. (I0c623, ‏ b/217344252)
  • כדי לוודא שיש מספיק פריטים ברשימה שאפשר לצייר (גם כשאנחנו מקטינים את הגודל של חלק מהם), הפחתנו את ScalingLazyColumn extraPadding שמוגדרת כברירת מחדל מ-10% ל-5%. כך תוכלו להימנע מהרכבת פריטים נוספים ברשימה שעשויים שלא להופיע בחלון התצוגה. אם נעשה שימוש ב-scalingParams לא סטנדרטיים (למשל, שינוי קיצוני יותר של התצוגה), המפתח יכול לשנות את הרווח הנוסף באמצעות 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 לפרמטרים של התראות ואישורים לפי הצורך. (Ia9014)
  • הסרנו את onSurfaceVariant2 מהצבעים של נושא Material ב-Compose ל-WearOS והחלפנו את השימושים בספרייה ב-onSurfaceVariant. (Icd592)
  • הוספנו שיטה לבחירת אפשרות באופן פרוגרמטי ב-PickerState. אפשר גם לציין את האפשרות שנבחרה בהתחלה כשיוצרים PickerState. (I92bdf)
  • הוספנו תמיכה בהתאמה אישית של התנהגות ה-fling של 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)

  • הוספנו טיפול בלחצן 'הקודם' ל-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 הוסיף יעד להיררכיית Compose לפני שהוא הגיע למצב CREATED במחזור החיים, וכתוצאה מכך נוצר IllegalStateException. התיקון הזה היה תנאי מוקדם לעדכון התלות ב-navigation-compose ל-2.4.0-beta02 ואילך. (I40a2b, ‏ b/207328687)

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

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

  • נוספו דוגמאות ל-SwipeDismissableNavHost בתכונה 'ניווט בזמן כתיבת הודעות' ב-Wear. (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 מכילה את ההוספות האלה.

תכונות חדשות

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

  • הוספנו 2 רכיבים חדשים ליצירת רכיבים מורכבים להצגת תיבות דו-שיח: AlertDialog ממתין לתגובה מהמשתמש ומציג כותרת, סמל, הודעה ואת אחת מהאפשרויות הבאות: א) שני לחצנים לבחירות פשוטות של 'כן' או 'לא', או ב) צ'יפים מוערמים אנכית או צ'יפים של מתגים לבחירות גמישות יותר. ConfirmationDialog מציג אישור עם זמן קצוב לתפוגה. לתיבת הדו-שיח הפשוטה הזו יש משבצות לכותרת ולסמל (אנימציה). (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 וכן כמה משתני אופן פעולה חדשים: fillParentMaxSize/fillParentMaxWidth/fillParentMaxHeight, כדי לאפשר שינוי הגודל של פריטים ברשימה בהתאם לגודל של מאגר הפריטים ההורה. אפשר להגדיר שהפריטים ימלאו את כל הגודל של האב או חלק ממנו. כך אפשר להציג פונקציונליות שכבר זמינה ב-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 ל-Compose ב-Wear. InlineSlider מאפשר למשתמשים לבחור מתוך טווח ערכים. טווח האפשרויות מוצג כסרגל בין הערכים המינימלי והמקסימלי של הטווח, וממנו המשתמשים יכולים לבחור ערך יחיד. (If0148)

  • מומלץ לעיין בCodelab החדש של Compose ל-WearOS.

שינויים ב-API

  • עכשיו ל-Macrobenchmark יש minSdkVersion של 23. (If2655)

תיקוני באגים

  • עדכון טיפול המעבר ב-SwipeDismissableNavHost ב-SideEffect‏ (I04994, ‏ b/202863359)
  • עדכון הטיפול במעברים ב-SwipeDismissableNavHost‏ (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 מכילה את ההוספות האלה.

תכונות חדשות

  • השקנו את גרסת ה-Developer Preview של Compose ב-Wear OS. בפוסט הזה בבלוג אנחנו מפרטים על הרכיבים העיקריים של Compose ומקשרים למשאבים נוספים שיעזרו לכם להתחיל להשתמש בהם.

שינויים ב-API

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

תיקוני באגים

  • נוספו דוגמאות ל-SwipeToDismissBox שמשמרות את המצב (Ibaffe)
  • הוספנו קישורים למדריכים ב-developer.android.com מ-KDocs עבור CurvedText, ‏ TimeText ו-SwipeToDismissBox. (I399d4)
  • SwipeDismissableNavHost מפעיל עכשיו שגיאה אם אין יעד נוכחי (המשמעות היא ש-NavGraph לא נוצר באמצעות פונקציית השירות wear.compose.navigation.composable) (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

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

תיקוני באגים

  • הוספנו קישורים למדריכים ב-developer.android.com מ-KDocs לגבי רכיבים של לחצן, כרטיס, צ'יפ, עיצוב, אינדיקטור מיקום ועמודות 'עיכוב טעינה' עם שינוי קנה מידה. (I22428)
  • תיקון של בעיה שבה לפעמים SwipeToDismissBox ב-WearOS לא מטפל בהחלקות. (I9387e)
  • נוספו דוגמאות ל-Button,‏ CompactButton,‏ Chip,‏ CompactChip,‏ AppCard,‏ TitleCard,‏ ToggleButton,‏ ToggleChip ו-SplitToggleChip (Iddc15)
  • הוספנו בדיקות ביצועים של מיקרו-במכר (microbenchmark) ל-Card, ‏ Chip, ‏ ToggleChip, ‏ 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 מכילה את ההצהרות האלה על ביצוע שינויים (commits).

תכונות חדשות

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

שינויים ב-API

  • נוספו בדיקות ל-TimeText‏ (Idfead)
  • הפיכת ArcPaddingValues לממשק. (Iecd4c)
  • נוספה אנימציה ל-SwipeToDismissBox‏ (I9ad1b)
  • הוספנו את הפרמטר hasBackground ל-API של SwipeToDismissBox כדי שאפשר יהיה להשבית את מחוות החלקה כשאין תוכן רקע להצגה. (I313d8)
  • rememberNavController() מקבל עכשיו קבוצה אופציונלית של מכונות Navigator שיתווספו ל-NavController המוחזר כדי לתמוך טוב יותר בנווטים אופציונליים, כמו אלה מ-Accompanist Navigation Material. (I4619e)
  • הפניה ל-NamedNavArgument מ-navigation-common והסרת העותק מ-wear.compose.navigation. (I43af6)

תיקוני באגים

  • תוקנו בעיות לא עקביות בבדיקת CurvedRow במכשירים קטנים יותר. (If7941)
  • תוקנה בעיה של הבהוב אפשרי ב-CurvedRow כשהתוכן מתעדכן, ולוודא שהשורה המעוקלת נמדדת מחדש (Ie4e06)
  • הפונקציה ChipDefaults.gradientBackgroundChipColors() עודכנה בהתאם לשינויים במפרט חוויית המשתמש. עכשיו, העברה הצבעונית מתחילה ב-MaterialTheme.colors.primary עם אלפא של 32.5% ומסתיימת ב-MaterialTheme.colors.surface עם אלפא של 0% מעל רקע של MaterialTheme.colors.surface עם אלפא של 75%. (Id1548)
  • עדכנו את הצבעים של ToggleChips במצב שנבחר, כך שיתאימו להנחיות העדכניות ביותר לגבי מפרט ממשק המשתמש של Wear Material Design. כאשר מתגים נבחרים, הם כוללים עכשיו רקע עם שיפוע מ-MaterialTheme.color.surface עם אלפא של 0% בפינה הימנית העליונה, ל-MaterialTheme.color.primary עם אלפא של 32% בפינה הימנית התחתונה, מעל רקע של MaterialTheme.color.surface עם אלפא של 75%. כך נוצר הבדל עדין יותר בין מצב מסומן למצב לא מסומן של ToggleChip. (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 – רכיב מורכב ברמה העליונה של האפליקציה שמספק מבנה לטיפול במיקום של אינדיקטורים של מיקום (כמו גלילה או עוצמת קול), אזור בחלק העליון של המסך להצגת השעה וסטטוס האפליקציה, ותמיכה גם בווינייט (Vignette) כדי לטשטש את הקצה העליון והתחתון של המסך עבור תוכן שניתן לגלילה. האזור הראשי של ה-Scaffold הוא המקום שבו מוצבים תוכן האפליקציה. (I5e0bf)
  • נוספה הטמעה של TimeText ל-Wear Compose (I5654c)

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

  • הוספנו את הגרסה הראשונה של ספריית הניווט של Wear Compose, שמספקת שילוב בין ספריות Wear Compose ו-Androidx Navigation. הוא מספק דרך פשוטה לנווט בין פונקציות @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)
  • עדכנו את SwipeToDismissBox כדי לתמוך ב-rememberSaveable (Ie728b)
  • הוספנו תמיכה ב-reverseLayout ל-ScalingLazyColumn. כך אפשר להפוך את כיוון הגלילה ואת הפריסה (I9e2fc)
  • performGesture ו-GestureScope שהוצאו משימוש, והוחלפו ב-performTouchInput וב-TouchInjectionScope. (Ia5f3f, ‏ b/190493367)
  • שינינו את השם של VignetteValue ל-VignettePosition, ואת השם של VignetteValue.Both ל-VignettePosition.TopAndBottom. (I57ad7)
  • שינינו את השם של ScalingLazyColumnState ל-ScalingLazyListState, את השם של ScalingLazyColumnItemInfo ל-ScalingLazyListItemInfo, את השם של ScalingLazyColumnLayoutInfo ל-ScalingLazyListLayoutInfo ואת השם של ScalingLazyColumnScope ל-ScalingLazyListScope, למקרה שנחליט להוסיף הטמעה של ScalingLazyRow בעתיד. (I22734)

תיקוני באגים

  • עדכנו את המסמכים של CompactChip כדי לתאר מה קורה אם לא מציינים סמל או תווית. (I4ba88)
  • ביצענו כמה שינויים ברכיבים של הכרטיסים ב-Wear. (I6b3d0)
    1. המרווח בין הכותרת לגוף בכרטיס הכותרת הופחת מ-8dp ל-2dp.
    2. גופן הכותרת של TitleCard השתנה מ-body ל-title3.
    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

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

תיקוני באגים

  • צמצמנו את הריווח בין הסמל לטקסט ב-Chip וב-ToggleChip כדי להתאים אותם לעדכונים במפרט ממשק המשתמש. (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 מכילה את ההצהרות האלה על ביצוע שינויים.

תכונות חדשות

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

שינויים ב-API

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

תיקוני באגים

  • נוספו חומרי בדיקה ל-SwipeToDismissBox‏ (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, שמספק רכיב רשימה ל-Material ב-Wear, שמציג תצוגת עין הדג שבה תוכן הרשימה קטן ונהיה שקוף ככל שהוא מתקרב לקצה הרכיב. (I7070c)

תיקוני באגים

  • שינינו את צבע ברירת המחדל של התוכן appName בכרטיס האפליקציה בתגובה לעדכון של מפרט חוויית המשתמש. הצבע שמוגדר כברירת מחדל למאפיין 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)
  • הוספנו סמלי החלפת מצב (תיבת סימון, מתג ולחצני בחירה) ל-ToggleChipDefaults כדי להקל על המפתחים להגדיר ToggleChip ו-SplitToggleChips (I7b639)
  • הוספת תוכן לתחילת הצ'יפ ולסופו עודכנה כך שתהיה עקבית ב-14.dp, ללא קשר אם יש לצ'יפ סמל או לא (קודם היה 12.dp אם יש סמל ו-14.dp אם לא) (I34c86)

תיקוני באגים

  • הוספת בדיקות ל-CurvedRow‏ (I93cdb)
  • קישור יחסי התלות של Wear Compose ל-Compose 1.0.0-rc01. (Ie6bc9)
  • שינינו את האופן שבו מתבצע הציור של תמונת הרקע בכרטיסים ובצ'יפים, כך שהתמונה תיחתוך במקום להתמתח כדי לשמור על הפרופורציות שלה. (I29b41)
  • נוספו עוד הדגמות ובדיקות שילוב ל-Button ול-ToggleButton. (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 היא ספרייה מבוססת-Compose ב-Kotlin שתומכת ב-Wear Material Design, תוסף של Material Design למכשירים לבישים של WearOS. הגרסה הראשונה של האלפא כוללת הטמעות פונקציונליות מוקדמות של האפשרויות הבאות:

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

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

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

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

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