‫Wear Compose Material 3

  
אתם יכולים לכתוב אפליקציות Jetpack Compose למכשירי Wear OS על ידי הוספת פונקציונליות לתמיכה בגדלים שונים של מכשירים ובמחוות ניווט באמצעות מערכת העיצוב Material 3 Expressive.
העדכון האחרון גרסה יציבה גרסה מועמדת להפצה גרסת בטא גרסת אלפא
‫27 באוגוסט 2025 1.5.0 - - -

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

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

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

מגניב

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

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

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

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

Kotlin

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

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

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

    // NOTE: DO NOT INCLUDE dependencies on androidx.wear.compose:compose-material
    // or androidx.compose.material:material.
    // androidx.wear.compose:compose-material3 is designed as a replacement,
    // not an addition, to both of these other libraries.
    // If there are features from that you feel are missing from
    // androidx.wear.compose:compose-material3, please raise a bug to let us know.
}

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

משוב

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

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

מידע נוסף זמין במאמרי העזרה בנושא כלי המעקב אחר בעיות.

‫Wear Compose Material3 גרסה 1.5

גרסה 1.5.0

‫27 באוגוסט 2025

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

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

הגרסה הראשונה של ספריית Wear Compose Material 3, שתומכת במערכת העיצוב החדשה Material 3 Expressive. הגרסה הזו כוללת:

  • עודכנו MaterialTheme ועיצוב דינמי של צבעים.
  • רכיבים חדשים של AppScaffold, ScreenScaffold,‏ HorizontalPagerScaffold ו-VerticalPagerScaffold כדי להגדיר את מבנה המסך ולתאם בין אנימציות של ScrollIndicator,‏ TimeText,‏ HorizontalPageIndicator ו-VerticalPageIndicator.
  • שינוי צורה IconButton, TextButton, IconToggleButton ו-TextToggleButton, עם וריאציות שמונפשות כשלוחצים עליהן או מסמנים אותן.
  • EdgeButton, שיש לו צורה מיוחדת שמיועדת לחלק התחתון של המסך.
  • ‫ButtonGroup הטמעה של קבוצת לחצנים עם אנימציה, בשורה שמשנה את הצורה שלה כשנוגעים בה.
  • ‫AlertDialog ו-ConfirmationDialog עם וריאציות לתוכן נוסף בתיבת הדו-שיח.
  • הרכיבים TimePicker ו-DatePicker.
  • אינדיקטורים של התקדמות כוללים את CircularProgressIndicator (עם וריאציה מפולחת), ArcProgressIndicator ו-LinearProgressIndicator.

בנוסף, Wear Compose Foundation 1.5.0 כולל את התכונות הבאות:

  • ‫TransformingLazyColumn, רשימה עצלה עם גלילה אנכית שתומכת בהנפשות של שינוי גודל ושינוי צורה.
  • תמיכה בהחלפת דפים ב-Wear Compose Foundation עם HorizontalPager ו-VerticalPager.
  • קבוצות פוקוס היררכיות – משמשות להוספת הערות לרכיבים שניתנים להרכבה באפליקציה כדי לעקוב אחרי החלק הפעיל של ההרכבה ולתאם את הפוקוס.

מידע נוסף על Material 3 Expressive ל-Wear OS

גרסה 1.5.0-rc02

‫13 באוגוסט 2025

androidx.wear.compose:compose-*:1.5.0-rc02 משוחרר. גרסה 1.5.0-rc02 מכילה את הקומטים האלה.

תיקוני באגים

  • תוקן באג ב-TimePicker שבו מחרוזות ארוכות ובינלאומיות של התקופה (לפני הצהריים/אחרי הצהריים) יכלו לשבש את הפריסה. (I0fa81)

גרסה 1.5.0-rc01

‫30 ביולי 2025

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

תיקוני באגים

  • התצוגה של TimePicker מבוססת עכשיו באופן מלא על הלוקאל של המשתמש, באמצעות DateFormat.getBestDateTimePattern כדי לקבוע את הסדר והתוכן של כלי הבחירה והמפרידים. העדכון הזה מתקן סדר שגוי של עמודות בשפות CJK, פותר בעיות בפריסת RTL בשפות כמו ערבית, משתמש במפרידים מותאמים לשוק המקומי ותומך בפורמטים של שעות 0-11 ו-1-12 על סמך הלוקאל (I5d543)
  • ‫DatePicker מציג עכשיו חודש מספרי באזורים מסוימים, כמו CJK, כדי למנוע ערבוב של פורמטים מספריים ופורמטים לשוניים (לדוגמה, ‫2025 | 07 | 02 במקום 2025 | 7月 | 02). השינוי הזה כולל היוריסטיקה שבודקת אם הלוקאל משתמש בסיומות לשוניות לשנה, ואם כן, משנה את פורמט החודש מטקסטואלי (MMM) למספרי (MM) כדי לשמור על עקביות. (Ia93fe)
  • המרחב האנכי של הכותרת ברכיב Picker הוא עכשיו קבוע, וכך נמנעת תזוזה נראית לעין כשבוחרים עמודה ב-Picker, במיוחד במצב Talkback. (I7f8b7)
  • תוקן באג שקשור לנגישות שנגרם כתוצאה מהצגה של HorizontalPageIndicator ו-VerticalPageIndicator במסך מלא. האינדיקטורים של הדף לא מוצגים יותר במסך מלא, והם ימוקמו באופן אוטומטי כשמשתמשים בהם עם HorizontalPagerScaffold או VerticalPagerScaffold. כשלא משתמשים ב-scaffold של פייג'ר, צריך לציין את היישור במפורש באמצעות modifier = Modifier.align(Alignment.BottomCenter) עם HorizontalPageIndicator ו-modifier =Modifier.align(Alignment.CenterEnd) עם VerticalPageIndicator. (I3a0ad)
  • כיוון ההחלקה ב-SwipeToReveal עכשיו עקבי גם ב-LTR וגם ב-RTL LayoutDirections. (I6d427)
  • החזרנו את האפשרות SwipeToReveal למרכוז אנכי של פעולות. אם hasPartiallyRevealedState = true, RevealState צריך להתאפס ל-RevealValue.Covered על ידי המתקשר כשמתבצעת גלילה. ‫(I6473d)
  • ‫SwipeDismissableNavHost מעכשיו, התוכן נחתך בצורה נכונה בגרסה 36 של API ואילך. (Ib9a44)

גרסה 1.5.0-beta06

‫16 ביולי 2025

androidx.wear.compose:compose-*:1.5.0-beta06 משוחרר. גרסה 1.5.0-beta06 מכילה את הקומטים האלה.

תיקוני באגים

  • תיקון אנימציה של EdgeButton כש-LazyColumn או ScalingLazyColumn כוללים reverseLayout = true. (I46a1a)
  • תוקן באג ב-ScreenScaffold שבו התכונה 'גילוי באמצעות מגע' לא פעלה ב-Talkback אם סופק ScrollIndicator/PageIndicator. (I6dcee)
  • ‫TransformingLazyColumn מאפשר עכשיו מעבר צורה מותאם אישית מ-TransformationSpec על ידי קריאת הערך itemHeight שסופק על ידי TransformationSpec בכלי לצביעת הרקע. (I6a599)
  • מעברים מונפשים של צבעים מופעלים או מושבתים עבור IconButton, כדי לשמור על עקביות עם IconToggleButton. (Ife10a)
  • הסרנו את ההצמדה המינימלית של החלק ב-CircularProgressIndicator כדי למנוע קפיצה בולטת לגודל הנקודה המינימלי במהלך האנימציה. כחלק מהשינוי הזה, הפרמטר targetProgress ב-drawCircularProgressIndicator לא נמצא יותר בשימוש. (I33309)
  • עכשיו יש לרכיב Picker את התפקיד הסמנטי ValuePicker שאפשר להשתמש בו בקוראי מסך כדי לשפר את הנגישות של רכיבי Picker. בנוסף, בבוחר יש עכשיו תוויות נגישות מעודכנות לקליקים, שמבדילות בין שינוי הערך במצב קריאה בלבד לבין בחירת הערך הנוכחי במצבים אחרים. (I33309)

גרסה 1.5.0-beta05

‫2 ביולי 2025

androidx.wear.compose:compose-*:1.5.0-beta05 משוחרר. גרסה 1.5.0-beta05 מכילה את הקומטים האלה.

תיקוני באגים

  • העדפנו את התיעוד כדי להבהיר את השימוש ב-Modifier.edgeSwipeToDismiss (I78cb5)
  • תוקן באג שבו מספר פריטים שנחשפו יכלו להופיע עם SwipeToReveal ברשימות עצלות (I1d4f6)
  • צורות של מאגדים ב-TransformingLazyColumn עוברות עכשיו שינוי גודל כדי למנוע חיתוך של התוכן. ‫(I9221a)
  • התווית TimePicker ו-DatePicker לשעה/דקה/שנייה או לשנה/חודש/יום כוללת עכשיו סמנטיקה של כותרות לקוראי מסך (I77d8b)
  • הוסרה ההפסקה בין הלולאות ב-indeterminate CircularProgressIndicator (Iaf0bb)
  • תוקנה שגיאת אנימציה ב-TransformingLazyColumn כשפריטים מוסרים. (I73034)
  • תוקן הטיפול בפריטי עוגן ב-TransformingLazyColumn כשפריטים מוסרים. (I841a8)
  • האנימציה של רכיבי הבחירה PickerGroup מוצגת עכשיו בצורה אופקית כשההגדרה 'מרכוז אוטומטי' מופעלת ורכיב הבחירה שנבחר (ממורכז) משתנה. (Ic82c4)

גרסה 1.5.0-beta04

‫18 ביוני 2025

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

תיקוני באגים

  • תוקן באג בפריסה ב-TransformingLazyColumn, שבו תוכן שמתאים למסך מיושר עכשיו בצורה נכונה מהחלק העליון של המסך (I80115)
  • תוקנה בעיה ב-TransformingLazyColumn שבה הפריט התחתון עבר שינוי גודל שגוי כשגללו לתחתית הרשימה עם EdgeButton. ההתקדמות בגלילה מתבצעת עכשיו לפי שיטת הגרדיאנט היורד כשמשחזרים את הפריסה. (Iea375)
  • ‫TransformingLazyColumn קורא עכשיו את גובה הפריט בתוך כלי הצביעה ברקע, מה שמאפשר ל-TransformationSpecs מותאם אישית להטמיע שינוי צורה. (I022f0)
  • ‫SwipeToReveal ממורכזות עכשיו בצורה אנכית הפעולות שמוצגות. (I4419b)
  • תוקן באג ב-SwipeToReveal שגרם לכך שהאפשרות 'החלקה לסגירה' לא פעלה בצורה תקינה אם גם התצוגות וגם הכתיבה היו בשימוש במסך. (I5dc0e)
  • תוקן באג שגרם לכך שפעולות SwipeToReveal הוצגו עם היסט אנכי בזמן גלילה. (I29444)
  • הערכים AlertDialog,‏ ConfirmationDialog,‏ OpenOnPhoneDialog ו-SwipeToReveal מעוגלים עכשיו כלפי מעלה, והם מייצגים את השוליים והגודל שמחושבים כאחוז מגודל המסך. (I76367)
  • ‫ButtonDefaults.outlinedButtonBorder now updates following enabled/disabled state changes size(If2ddd)
  • תוקן באג בגובה EdgeButton שהתרחש במסכים מורכבים עם רכיב Pager ו-ScreenScaffold. (I946e3)
  • תוקנה בעיית תזמון שגרמה להפסקת האנימציות של הפלייסהולדר. (I53530)
  • שיפור הביצועים של HorizontalPageIndicator ושל VerticalPageIndicator על ידי ציור בלוח הציור. (Ifae1e)
  • שיפרנו את הצורה של EdgeButton כדי להחליק את המעברים בין שלוש הנקודות לבין העיגולים שמרכיבים את המתאר. (I7721e)
  • תוקן באג ב-LevelIndicator שגרם לאנימציות להפסיק לפעול בגלל קומפוזיציות מחדש מיותרות. (I45d08)

גרסה 1.5.0-beta03

‫4 ביוני 2025

androidx.wear.compose:compose-*:1.5.0-beta03 משוחרר. גרסה 1.5.0-beta03 מכילה את הקומטים האלה.

שינויים ב-API

  • ‫OpenOnPhoneDialog מכריז עכשיו רק על הטקסט של ההודעה ב-TalkBack, ומדלג על הסמנטיקה של הסמל. בוצע עדכון של OpenOnPhoneDialogDefaults כדי להסיר את הפרמטרים iconContentDescription ו-contentDescription מ-icon(). בנוסף, ל-ConfirmationDialogDefaults יש עכשיו פרמטרים של משנים ברכיבי SuccessIcon ו-FailureIcon composable. (Id2ae2)

תיקוני באגים

  • שינינו את הסדר שבו אנחנו מחילים את ההשפעה של פרמטרים מסוג SurfaceTransformation. בעבר, הטרנספורמציות שהוחלו על רכיבי Wear Material3 בוצעו באופן הבא: צביעת הרקע, טרנספורמציה של הקונטיינר, טרנספורמציה של התוכן. עכשיו, 2 הראשונים הפוכים, ואנחנו מחילים כל משנה שהועבר ביניהם, כך שהוא מושפע מהטרנספורמציות של מאגר התגים. התיקון הזה פותר מקרים כמו שימוש באפקט הבהוב של placeholder עם רכיבים ב-TLC באמצעות פרמטר הטרנספורמציה. (I786cf)
  • RevealState.Saver נוסף כדי לשמש לשחזור המצב של SwipeToReveal כשפעילות או תהליך נוצרים מחדש. הפונקציה rememberRevealState משתמשת עכשיו בחיסכון הזה כברירת מחדל. (Ie0ecb)
  • SwipeToReveal לחצני פעולה ראשיים ומשניים צריכים להיות מוגדרים כברירת מחדל ל-ButtonDefault.Height (תוקן באג שבו הלחצנים האלה מילאו את הגובה המקסימלי של לחצנים גבוהים יותר). (Ibfba1)
  • השתנה SwipeToReveal לאיפוס הרכיב האחרון שהייתה איתו אינטראקציה, כשמבצעים את תנועת ההחלקה ימינה. (Ia8450)
  • השינוי SwipeToReveal בוצע כדי להגדיר את המצב Revealing כשמיקום הסיום של ההחלקה הוא בין נקודות העיגון של החשיפה וההסתרה, וקרוב יותר לנקודת העיגון של ההסתרה. (If4458)
  • עכשיו התוכן של ButtonGroup מוצג בצורה הפוכה כמו שצריך בפריסה מימין לשמאל (Ib378d)
  • ‫AnimatedText תומך עכשיו בכיוון טקסט מימין לשמאל (I4533c)
  • TransformingLazyColumn עכשיו, כשמסירים את הפריט התחתון, הגודל של הפריטים משתנה בצורה נכונה (Idacab)
  • ‫TransformingLazyColumn מבצע עכשיו רק מעבר מדידה אחד, וכך משפר את הביצועים על ידי הפחתת זמני הפריימים. (I501a1)

גרסה 1.5.0-beta02

‫20 במאי 2025

androidx.wear.compose:compose-*:1.5.0-beta02 משוחרר. גרסה 1.5.0-beta02 מכילה את הקומטים האלה.

תיקוני באגים

  • פרופילי הבסיס של ספריות foundation, ‏ material ו-material3 עודכנו. (I53f06)
  • תוקן באג ב-TransformingLazyColumn, שגרם לשינוי הגודל של פריטים כשפריט תחתון הוסר. (Idacab)
  • תוקן באג שקשור ל-TransformingLazyColumn, שגרם לרשימה להיתקע בחלק העליון או התחתון שלה. (I49d00)
  • OpenOnPhoneDialog, קורא המסך TalkBack צריך להקריא את הטקסט המעוקל ולא את תיאור התוכן של הסמל. (I4efe8)
  • תוקן באג ב-SwipeToReveal שגרם לדיווח על עוגן שגוי ב-RevealState.currentValue כש-hasPartiallyRevealedState הוגדר כ-false. (I9c7cf)
  • כפתורי הביטול SwipeToReveal מוגדרים עכשיו כButtonDefaults.Height כברירת מחדל. (I1f6c8)
  • BasicSwipeToDismissBox שיפרנו את הביצועים על ידי ביטול השימוש ב-Canvas לציור מסכי הצללה. (I68f2c)
  • תוקן באג בנגישות ברכיב Slider, שבו האחוז שהוכרז לא תאם לערך אחרי העדכונים (I91146)
  • תוקן באג בהטמעה של placeholderShimmer. (Iee39b
  • הביצועים של TransformingLazyColumn השתפרו בעקבות אופטימיזציה של החישוב ב-30%.ScrollProgress (I4c4cb)

גרסה 1.5.0-beta01

‫7 במאי 2025

androidx.wear.compose:compose-*:1.5.0-beta01 משוחרר. גרסה 1.5.0-beta01 מכילה את הקומטים האלה.

הגרסה 1.5.0-beta01 של Compose ל-Wear OS מציינת שהגרסה הזו של הספרייה כוללת את כל התכונות וה-API נעול (אלא אם מצוין אחרת).

‫Wear Compose 1.5.0-beta01 כולל את הספרייה Wear Compose Material3, שתומכת במערכת העיצוב החדשה של ממשק המשתמש שנקראת Material 3 Expressive. מומלץ לשדרג מ-Material ל-Material3 כדי ליהנות מהעיצוב החזותי החדש באפליקציות, ומהרכיבים החדשים הבאים:

  • MaterialTheme כדי לקבל ערכות צבעים, טיפוגרפיה וצורות מעודכנות ומורחבות, שיעניקו לעיצובים שלכם עומק ומגוון.
  • ערכות צבעים דינמיות שיוצרות באופן אוטומטי ערכת צבעים לאפליקציה שתתאים לצבעים של תצוגת השעון.
  • רכיבים חדשים מותאמים אוטומטית כברירת מחדל לגדלים גדולים יותר של מסכים
  • שינוי צורה – רכיבי לחצנים עגולים כמו IconButton, TextButton, IconToggleButton ו-TextToggleButton תומכים בווריאציות שמונפשות כשלוחצים עליהן או מסמנים אותן.
  • ‫EdgeButton – כפתור חדש שצמוד לקצה המסך עם צורה מיוחדת שמיועד לחלק התחתון של המסך.
  • ‫Scaffolds – הוספנו את הרכיבים AppScaffold ו-ScreenScaffold כדי להגדיר את מבנה המסך ולתאם בין האנימציות של ScrollIndicator ו-TimeText.
  • לחצנים – יש תמיכה בלחצנים רבים בצורת אצטדיון, עם מאגרי תגים גמישים של משבצת אחת ווריאציות של כמה משבצות ללחצנים עם סמלים ותוויות. הסמלים CheckboxButton ו-SwitchButton מסופקים כשנדרשים לחצני מעבר, ואילו RadioButton הוא לחצן הבחירה הזמין (מסופקות גם וריאציות של לחצני המעבר והבחירה עם פיצול).
  • ‫ButtonGroup – הטמעה של קבוצת לחצנים בעלי מראה ייחודי בשורה, שמשנים את הצורה שלהם כשנוגעים בהם.
  • וריאציות של AlertDialog תומכות בלחצני אישור/ביטול או ב-EdgeButton.
  • ‫ConfirmationDialog זמין להצגת הודעה עם פסק זמן, ותומך באנימציות מיוחדות לגרסאות של הצלחה, כישלון ופתיחה בטלפון.
  • רכיבי בחירה – נתמכות וריאציות של TimePicker ושל DatePicker, וגם הרכיבים Picker ו-PickerGroup ליצירת מסכי בחירה משלכם.
  • ‫ProgressIndicators – נתמכים אינדיקטורים של התקדמות מעגלית ולינארית (ל-CircularProgressIndicator יש וריאציות מפולחות ובלתי מוגדרות).
  • כרטיסים – יש כמה וריאציות של כרטיסים, כולל TitleCard שכולל פריסות ספציפיות לכרטיסים עם כותרת, שעה, כתוביות או משבצות תוכן. אפשר גם להוסיף לרקע של כרטיס תמונה כדי להמחיש את משמעות המידע שבו.TitleCard
  • רכיבי פייג'ר – הרכיבים HorizontalPagerScaffold, VerticalPagerScaffold ו-AnimatedPage מתאמים בין אנימציות של HorizontalPageIndicator ו-VerticalPagerIndicator. ‫HorizontalPager ו-VerticalPager יוצאים לאור בספריית Wear Compose Foundation.
  • פלייסהולדרים – מצייר צורה של שלד מעל רכיב, במקרים שבהם אין תוכן זמני זמין.
  • מחוונים ורכיבי Stepper – גם מחוונים וגם רכיבי Stepper מאפשרים למשתמשים לבחור מתוך טווח ערכים. מחוונים הם קומפקטיים יותר ואפשר לפלח אותם, בעוד שרכיב ה-Stepper הוא רכיב במסך מלא שבדרך כלל משויך לStepperLevelIndicator.
  • ‫SwipeToReveal – משמש להוספת פעולות נוספות לרכיב שאפשר להרכיב כשמחליקים אותו מימין לשמאל.

בנוסף, Wear Compose Foundation 1.5.0-beta01 כולל את הרכיבים החדשים הבאים:

  • ‫TransformingLazyColumn – רשימה עצלה עם גלילה אנכית שתומכת בהתאמה לעומס ובאנימציות של שינוי צורה
  • קבוצות פוקוס היררכיות – משמשות להוספת הערות לרכיבים שניתנים להרכבה באפליקציה, כדי לעקוב אחרי החלק הפעיל של ההרכבה ולתאם את הפוקוס.
  • רכיבי Pager – רכיבי HorizontalPager ו-VerticalPager, שמבוססים על רכיבי Compose Foundation עם שיפורים ספציפיים ל-Wear כדי לשפר את הביצועים ולעמוד בהנחיות של Wear OS.

שינויים ב-API

  • עדכנו את Hierarchical Focus API – שינינו את השם של Modifier.hierarchicalFocus ל-Modifier.hierarchicalFocusGroup והסרנו את פרמטר הקריאה החוזרת (callback); הסרנו את העומס של Modifier.hierarchicalFocusRequester עם פרמטר FocusRequester; יצרנו CompositionLocal חדש, LocalScreenIsActive, כדי שהרכיבים יוכלו לדווח ולבדוק איזה מסך פעיל. (I5ff7c).
  • הוצאנו משימוש את SwipeToReveal מ-Wear Compose Foundation לטובת ממשקי API ב-Wear Compose Material וב-Wear Compose Material3.SwipeToReveal כדי להמשיך להשתמש בממשקי ה-API, צריך להחליף את הייבוא של Wear Foundation SwipeToReveal בייבוא של Wear Compose Material או Wear Compose Material3. (Ia147d).
  • ההסתמכויות של Wear Compose Material3 SwipeToReveal על Foundation הועברו לחבילה material3, לדוגמה: RevealValue, ‏ RevealDirection, ‏ RevealActionType, ‏ RevealState, ‏ rememberRevealState. המפתחים צריכים לשנות את הייבוא של המחלקות והפונקציות האלה מ-androidx.wear.compose.foundation ל-androidx.wear.compose.material3. ‫(I640e6).
  • עדכנו את Wear Compose Material3 SwipeToReveal API באופן הבא: הוספנו פרמטרים primaryAction, onFullSwipe, secondaryAction, undoPrimaryAction, undoSecondaryAction ו-hasPartiallyRevealedState ל-SwipeToReveal composable; הסרנו את האפשרות להתאים אישית את positionalThreshold ו-animationSpec מ-RevealState; הסרנו את lastActionType, revealThreshold ואת width מ-RevealState; שינינו את ה-constructor של RevealState כך שיקבל RevealDirection במקום anchors; הסרנו את הפונקציות createRevealAnchors, anchors ו-bidirectionalAnchors; הפונקציות SwipeToRevealScope primaryAction, secondaryAction, undoPrimaryAction ו-undoSecondaryAction שונו לשמות PrimaryActionButton, SecondaryActionButton, UndoActionButton והפכו לפונקציות Composable; סימנו את RevealActionType כפנימי. (I885d0).
  • בוצעו עדכונים נוספים ב-API של SwipeToReveal באופן הבא: השם של onFullSwipe שונה ל-onSwipePrimaryAction, השם של SwipeToRevealNonAnchoredSample שונה כדי לציין את השימוש בפרמטר hasPartiallyRevealedState, actionButtonHeight הוסר כי ברירת המחדל היא גובה ברירת המחדל של הלחצן ואפשר להגדיר גובה גדול יותר באמצעות משנה, SmallActionButtonHeight הוסר מ-SwipeToRevealDefaults, והפרמטר value בבוני RevealValue ו-RevealDirection הוגדר כפרטי. (I465ce).

תיקוני באגים

  • תוקן הטיפול ב-ScreenScaffold של EdgeButton כך שאחרי הסרת פריט TransformingLazyColumn, האנימציה של EdgeButton מוצגת במקום. (I6d366).
  • עדכנו את יחסי התלות של Wear Compose בספריות Compose לגרסה 1.8.0. (I2ef3f).
  • עדכנו את התנועה של CircularProgressIndicator הלא מוגדר כך שהוא לא יחזור אחורה באופן זמני. (Ieddb1).
  • תוקן באג SwipeDismissableNavHost – המיקוד לא עבר בצורה נכונה אחרי החלקה אחורה, ולכן לא הייתה אפשרות להשתמש בקלט סיבובי (הבאג הזה היה ב-API 36 ומעלה, שמשתמש בתכונה 'חזרה עם חיזוי'). (Ieddb1).
  • תיקנו את מאמרי העזרה של Hierarchical Focus API‏ (Idf2ff).
  • עדכנו את התיעוד של Button ו-Card כדי להסביר איך containerPainter ו-disabledContainerPainter מבטלים את containerColor ו-disabledContainerColor (I4a453).
  • בוטל שינוי ב-TimeText בגרסה הקודמת, שהעביר את BroadcastReceiver ל-worker thread, כי הוא גרם לבעיות באפליקציות שמנהלות את ה-threading שלהן במהלך הניווט. (I34d02).
  • עדכנו את הדוגמאות של הכלי לבחירת תמונות כדי להסיר קריאות מיותרות לזכירה, ובמקום זאת השתמשנו ב-rememberUpdatedState בכלי לבחירת תמונות כדי לזכור את פונקציית ה-lambda האחרונה של contentDescription. ‫(Icb5b1).
  • עדכנו את סגנונות הטקסט ב-TimePicker וב-DatePicker כך ששינויים בגופן לא יגרמו יותר לחיתוך. (I26194).
  • ListHeader ו-ListSubHeader מיישרים את הטקסט למרכז ולצד ימין בהתאמה כברירת מחדל. (I78339).
  • עדכנו את הדוגמאות ואת ההדגמות של Foundation ו-Material Swipe to Reveal כדי להודיע על פעולות נגישות מותאמות אישית (צריך להוסיף את הפעולות המותאמות אישית כסמנטיקה בתוכן, ולא ב-SwipeToReveal composable עצמו). (Ie92a3).
  • העדכנו את ברירת המחדל MaxLines שמוגדרת בתוכן EdgeButton בהתאם לגודל שלו – עכשיו היא 1 למידה קטנה במיוחד, 2 למידות קטנה ובינונית ו-3 למידה גדולה. (Ie35f6).
  • פשוט יותר LocalReduceMotion כך שהצופה נרשם רק פעם אחת, כדי לשפר את הביצועים. (Ib1979).
  • צמצמנו את מספר הציורים מחדש ב-ScrollIndicator כדי לשפר את הביצועים. (Ia7a67).
  • תוקן באג ב-TransformingLazyColumn, שבו הפריט העליון ברשימה לא שינה את הגודל שלו בצורה נכונה כש-EdgeButton הגיע לגובה המלא שלו. (I30580).

גרסה 1.0 של Wear Compose Material3

גרסה 1.0.0-alpha37

‫23 באפריל 2025

androidx.wear.compose:compose-material3:1.0.0-alpha37 משוחרר. גרסה 1.0.0-alpha37 מכילה את הקומטים האלה.

שינויים ב-API

  • הוסר scrollTransform מ-API ציבורי. אם אתם צריכים לקבל את אותה הפונקציונליות, אתם יכולים להשתמש בשילוב של משני המאפיינים transformedHeight ו-graphicsLayer. (Ie181d)
  • הפונקציות ImageButton ו-ImageCard הוחלפו בפונקציות Button ו-Card/TitleCard בהתאמה. השם של imageButtonColors שונה ל-buttonWithContainerPainterColors ושל imageCardColors ל-cardWithContainerPainterColors. נוספו ButtonDefaults.scrimBrush וCardDefaults.scrimBrush גלויים לכולם. השם של הלחצן imageBackgroundGradientStartColor ושל imageBackgroundGradientEndColor שונה ועכשיו הוא scrimGradientStartColor ו-scrimGradientEndColor. השם של CardDefaults.ImageContentPadding שונה לCardDefaults.CardWithContainerPainterContentPadding (I7b8b6)
  • ‫Picker ו-PickerGroup מקבלים עכשיו את contentDescription כביטוי למדא כדי למנוע הרכבות מחדש מיותרות. (I002dd)

תיקוני באגים

  • תוקנה בעיה שבה CircularProgressIndicator לא מוגדר היה מתנדנד במהלך אנימציה אם הרוחב לא היה שווה לגובה. (I76bfe)
  • תוקנה בעיה בפריסת לחצני הקצה בגודל לא תקין. עכשיו המערכת מונעת עדכון של הפריסה של לחצן הקצה כשהגובה הוא NaN. (I32b93)
  • הגדלנו את זווית הסריקה המקסימלית ב-OpenOnPhoneDialog כדי שהטקסט 'לחיצה לבדיקת הטלפון' שמוגדר כברירת מחדל לא ייחתך בגודל הגופן הגדול ביותר. (I90af9)

גרסה 1.0.0-alpha36

‫9 באפריל 2025

androidx.wear.compose:compose-material3:1.0.0-alpha36 משוחרר. גרסה 1.0.0-alpha36 מכילה את הקומטים האלה.

שינויים ב-API

  • הטקסט ButtonDefaults.imageBackgroundButtonColors הוחלף בטקסט ImageButton, ButtonDefaults.imageButtonColors, ButtonDefaults.containerPainter ו-ButtonDefaults.disabledContainerPainter. שינויים דומים גם ב-Card. הציירים הוסרו מ-ButtonColors ומ-CardColors. (I8c6a1)
  • מצייני המיקום עודכנו כדי לפשט את ה-API. עכשיו אנחנו מספקים שני משנים (Modifiers): Modifier.placeholderShimmer כדי להחיל אפקט נצנוץ ברמת הרכיב, ו-Modifier.placeholder כדי להחיל מסכה על תוכן שלא נטען (Iaee7a)

תיקוני באגים

  • שילבנו את הגלילה מעבר לקצה ב-ScrollIndicator. (Icfb7f)
  • טיפלנו בבעיות של רקעים ריקים ושל תיבות דו-שיח חסרות כשמפעילים תיבות דו-שיח של Material3. (Ice597)
  • תוקנו בעיות ב-FadingExpandingLabel כשקטעי טקסט משתרעים על כמה שורות. (I04eb7)
  • עודכן המרווח הפנימי בין התוויות הראשיות והמשניות בלחצנים. (I99b7b)
  • הערך של ArcLarge ירד מ-20sp ל-18sp, והרווחים בין האותיות ב-ArcLarge וב-ArcSmall עודכנו. ‫ConfirmationDialog/OpenOnPhoneDialog משתמשים עכשיו בברירת המחדל ArcLarge במקום להחליף אותה ב-18sp. (Id39a8)

עדכונים של יחסי תלות

  • הספרייה הזו מטרגטת עכשיו את רמת השפה Kotlin 2.0 ונדרשת KGP 2.0.0 או גרסה חדשה יותר. (Idb6b5)

גרסה 1.0.0-alpha35

‫26 במרץ 2025

androidx.wear.compose:compose-material3:1.0.0-alpha35 משוחרר. גרסה 1.0.0-alpha35 מכילה את הקומטים האלה.

שינויים ב-API

  • AlertDialog כברירת מחדל, הריווח העליון מצטמצם עכשיו כשמספקים סמל – כך מנצלים בצורה הטובה ביותר את גודל המסך הזמין. (Ief06c)
  • השם של PagerScaffoldDefaults.FadeOutAnimation שונה ל-PagerScaffoldDefaults.FadeOutAnimationSpec. הפרמטר page בדף AnimatedPage עודכן לשם pageIndex. (I701f2)
  • השם של TransformingLazyColumn SurfaceTransformation עודכן – applyTransformation פוצל ל-applyContainerTransformation ול-applyContentTransformation, והשם של createBackgroundPainter שונה ל-createContainerPainter. עדכונים נוספים בשמות של TransformationSpec ו-ResponsiveTransformationSpec. (I1c534)
  • השם של AppScaffold backgroundColor השתנה ל-containerColor. (I4e63f)

תיקוני באגים

  • תוקנה בעיה ב-FadingExpandingLabel שבה הטקסט לא תמיד התרחב בצורה נכונה. (I0e773)
  • הגודל של ArcLarge קטן מ-20sp ל-18sp, והרווחים בין האותיות ב-ArcLarge וב-ArcSmall עודכנו. ConfirmationDialog/OpenOnPhoneDialog עכשיו משתמשים בברירת המחדל ArcLarge במקום להגדיר אותה כ-18sp. (Id39a8)
  • עדכנו את אנימציית הכותרת של DatePicker ושל TimePicker כך שאנימציית ההתעמעמות וההתבהרות תפעל כאנימציית קפיצה אחת. (I68963)
  • האופטימיזציה PagerScaffold מתבצעת על ידי הימנעות מקריאה של currentPageOffsetFraction ב-AnimatedPage composable. (I433ef)
  • כל סולמות הטיפוגרפיה עודכנו כך שברירת המחדל היא ספרות יחסיות, כי זהו תרחיש השימוש הנפוץ ביותר, והגדרת ברירת המחדל כספרות טבלאיות הובילה לרווחים גדולים מדי בין צירופים מסוימים של מספרים. TimePicker ו-DatePicker ממשיכים לחול על FontFeatureSetting=tnum עבור ספרות טבלאיות. (I88929)
  • תוקן המיקוד הראשוני של קלט ה-RSB עבור TimePicker ו-DatePicker. (I1c773)
  • הטקסט שמוצג כברירת מחדל ב-OpenOnPhoneDialog עודכן ל'כדאי לבדוק את הטלפון'. (I00a3f)
  • המשקלים של ArcLarge ושל ArcMedium עודכנו מ-600 ל-599 כדי לעקוף בעיה שבה משקל 600 נחשב כמשקל מודגש (I2a51d)
  • עדכון SwipeToReveal המרווחים הפנימיים בין התוכן לבין הלחצנים של הפעולות, וגם המרווח הפנימי בין הסמל לטקסט של הלחצנים של הפעולות. (Ic46cb)

גרסה 1.0.0-alpha34

‫12 במרץ 2025

androidx.wear.compose:compose-material3:1.0.0-alpha34 משוחרר. גרסה 1.0.0-alpha34 מכילה את הקומטים האלה.

שינויים ב-API

  • ‫PagerScaffold כבר לא פולט רכיב Pager – במקום זאת, צריך לספק אותו באמצעות content Composable. הספריות AnimatedPage ו-snapWithSpringFlingBehaviour הן עכשיו ציבוריות, ואפשר להשתמש בהן יחד עם Wear Foundation Pager כדי להשיג את ההתנהגות הקודמת של M3 PagerScaffold. (ראו דוגמאות מעודכנות). (Ia4724)
  • עודכן PagerState, הוסרה המחלקה הבסיסית Compose Foundation PagerState והוספו המאפיינים currentPage, currentPageOffsetFraction ו-pageCount. ממשק GestureInclusion עודכן, והשם של השיטה שונה ל-ignoreGestureStart. (I4ae07)
  • פרמטרים של זווית הסריקה LevelIndicator מסומנים עכשיו בתווית FloatRange(0, 360) (I7e636)
  • הוספנו את CurvedModifier.clearAndSetSemantics כדי לספק אמצעי להשבתת הסמנטיקה המעוקלת. CurvedText ממשיך להגדיר כברירת מחדל את תיאור התוכן לטקסט, אבל timeTextCurvedText ו-timeTextSeparator לא מכריזים על התוכן שלהם. (I4b568)
  • נוספו פרמטרים של רקע וצבע תוכן ברירת מחדל ל-AppScaffold. (I56652)
  • השם של טיפול ברירת המחדל במחוות החלקה ב-HorizontalPager השתנה ל-PagerDefaults.gestureInclusion. ההתנהגות שמוגדרת כברירת מחדל היא להתעלם רק מתנועות החלקה שמתחילות בקצה השמאלי של הדף הראשון, ורק כשהתכונה Talkback מושבתת. במקרים אחרים, ההתנהגות שמוגדרת כברירת מחדל היא שהרכיב Pager לא יתעלם מתנועות החלקה, ולכן הן לא יהיו זמינות לטיפול בהחלקה לסגירה. (Iee486)
  • נוסף פרמטר SurfaceTransformation לרכיבים של לחצנים, כרטיסים וכותרות של רשימות, כדי שאפשר יהיה להחיל עליהם טרנספורמציות שונות של רקע ותוכן כשמשתמשים בהם במאגרי תגים שמשנים את המראה של הפריטים בהתאם למיקום שלהם, כמו TransformingLazyColumn. (Iabe3f)
  • עדכנו את המאפיינים 'public const val' ב-API של Wear Compose Material3 ל-'public val', כדי למנוע את ההטמעה של הערכים. (Ib0f32)
  • נוספה תמיכה באזור להחלקה מהקצה אל SwipeToReveal. ההתנהגות שמוגדרת כברירת מחדל ב-Foundation SwipeToReveal היא עכשיו איסור החלקה כשהתנועה מתחילה מהקצה. התנהגות ברירת המחדל של Material3 SwipeToReveal’היא עכשיו לא לאפשר החלקה כשהתנועה מתחילה מהקצה, אם SwipeDirection מוגדר לכיוון יחיד. (I32ef0)
  • נוסף FadingExpandingLabel composable, שמאפשר להוסיף אפקט הדרגתי של טקסט עם אנימציה שמופיע שורה אחר שורה. (Ic60fa)
  • ‫TransformingLazyColumn משתמש עכשיו ב-contentPadding ריק כברירת מחדל, במקום להציב את הפריטים הראשונים והאחרונים במרכז. (I77ab7)
  • הוסר SwipeToReveal’s rememberRevealState מהספרייה Wear Compose Material3. (I8c0e0)

תיקוני באגים

  • ספריות Wear Compose עודכנו לקומפיילר Kotlin 2.0. (I2de79)
  • הוסרה התמיכה ב-ScrollIndicator ו-PageIndicator שאינם מעוגלים ב-Material3. בנוסף, התמיכה במסכים מרובעים לא נכללת יותר בדרישות של Wear OS. מידע נוסף זמין במדריך לתחילת העבודה. (I9a852)
  • הגופן CurvedTextStyle שבו נעשה שימוש ב-ConfirmationDialogDefaults וב-OpenOnPhoneDialogDefaults עודכן לגופן ArcLarge בגודל 18sp ובריווח אותיות 1.8sp. (Ic9ced)
  • ‫Card, ListHeader, RadioButton, CheckboxButton, SwitchButton כבר לא מגבילים את הגובה של התוכן שלהם כברירת מחדל. במקרים שבהם צריך, אפשר להשתמש ב-Modifier.height(IntrinsicSize.Min) כדי לשחזר את ההתנהגות הקודמת. (I80bb8)
  • עדכנו את צבעי ברירת המחדל TimeText ו-ScrollIndicator כך שיכללו יותר גוונים של אפור, כי השימוש בצבע OnBackground (לבן) ישירות נשא משקל ויזואלי רב מדי כשהוא מתחרה בתוכן אחר במסך, כמו כותרות. (I8b36f)
  • קיצרנו את הזמן הקצוב לתפוגה של האנימציה של TimeText ו-ScrollIndicator ברכיבי ה-scaffold ל-2 שניות. (I52021)
  • עדכנו את התנועה של תיבת הדו-שיח כך שהקנה מידה של הרקע של תיבת הדו-שיח מסונכרן עם ההחלקה לסגירה. (I925a9)
  • תוסיף הדגמה של M3 SwipeToReveal באמצעות הערך המקדם edgeSwipeToDismiss. (I02b07)
  • הוספנו כותרת ל-DatePicker ול-TimePicker ב-TalkBack כדי שהמשתמש יקבל מידע על גלילה להגדרת התאריך והשעה. (Id738d)
  • האנימציה של AnimatedText פועלת עכשיו בהתאם להגדרה של תנועה מופחתת. (Ib6578)
  • השיפורים שבוצעו באופטימיזציה של השימוש ב-AppScaffold להצגת תוכן בתיבת דו-שיח מאפשרים להציג כמה תיבות דו-שיח אחת על השנייה (I1209c)

גרסה 1.0.0-alpha33

‫26 בפברואר 2025

androidx.wear.compose:compose-material3:1.0.0-alpha33 משוחרר. גרסה 1.0.0-alpha33 מכילה את הקומטים האלה.

שינויים ב-API

  • הסרנו את פרמטר התווית מה-primaryAction ומה-secondaryAction של SwipeToRevealScope. המפתחים צריכים להוסיף את הסמנטיקה של הפעולות המותאמות אישית ישירות לתוכן של רכיב SwipeToReveal. (Ia67f3)
  • הסרנו את הקידומות Button (כפתור) מהפונקציות של הגדלים, סגנונות הטקסט והצבעים ב-IconToggleButtonDefaults וב-TextToggleButtonDefaults (I5471d)
  • הסרנו את התכונה הניסיונית LocalMinimumInteractiveComponentEnforcement (I4ad8a)
  • החלפנו את PickerGroupScope DSL בקומפוזיציה. לכן, הסרנו את השיטה pickerGroupItem מ-PickerGroupScope, ובמקומה הוספנו את השיטה @Composable PickerGroupItem שבה צריך להשתמש כדי להוסיף רכיב לבחירת פריטים ל-PickerGroup. עדכנו גם את הסוג של הפרמטר PickerGroup content ל-@Composable PickerGroupScope.() -> Unit. (Ic6aec)
  • הוספנו עומס יתר (overload) של LevelIndicator לערכים חלקיים, והוספנו קידומת Stepper לאותם עומסי יתר שכוללים פרמטר טווח (שמתאים לשימוש עם רכיב Stepper). (If4234)
  • הוספנו את TransformingLazyColumn’s TransformationSpec ל-API, שמאפשר להגדיר את השינויים המדויקים שמתרחשים בפריטים בזמן הגלילה ב-TLC. (I21856)
  • עדכנו את IconButtonShapes, IconToggleButtonShapes, TextButtonShapes ו-TextToggleButtonShapes כך שיהיו עקביים עם המחלקות של כתיבה/material3 ‏ (I5a081)
  • הוספנו פרמטר overscrollEffect ל-ScalingLazyColumn, ‏ TransformingLazyColumn ו-ScreenScaffold. (I0cee8)
  • שינינו את השם של הפרמטר swipeDirection ל-revealDirection ב-rememberRevealState. (I7472f)
  • ל-Wear Pager יש עכשיו PagerScope משלו במקום להשתמש ב'כתיבה' PagerScope. (I9195b)
  • הסרנו את הקומפוזיציה LinearProgressIndicatorContent. עכשיו צריך להשתמש ישירות ב-LinearProgressIndicator כדי שהשינויים בערכים יונפשו כברירת מחדל. (I2c4ad)
  • הסרנו את הפונקציה CircularProgressIndicatorStatic composable והוספנו פונקציה ציבורית DrawScope drawCircularProgressIndicator עם אותה פונקציונליות. מומלץ להשתמש ישירות ב-CircularProgressIndicator כדי שהשינויים יונפשו כברירת מחדל, אבל אפשר ליצור קומפוזיציה משלכם מ-drawCircularProgressIndicator אם נדרשות אנימציות מותאמות אישית. (Ie762f)
  • שינינו את הסדר של הפרמטרים ב-DrawScope.drawCircularProgressIndicator כדי להעלות את הפרמטר targetProgress. (I8ab92)
  • ה-API‏ OpenOnPhoneDialog עודכן כדי שיהיה ברור יותר ועקבי יותר עם דיאלוגים אחרים. הפרמטר show שונה ל-visible, ועכשיו הערך של curvedText מסופק על ידי המתקשר במקום להיות ערך ברירת מחדל. (Idec2d)
  • שינינו את השם של openOnPhoneCurvedText ל-openOnPhoneDialogCurvedText (I65bdd)
  • הוספנו את ScrollIndicatorColors כדי לספק צבעים בהתאמה אישית ל-ScrollIndicator. (I9eb8c)
  • מאפשרת להגדיר את הצבע שמשמש לציור רקע מאחורי TimeText. (I9f5d9)
  • הגופנים של ArcLarge, ArcMedium ו-ArcSmall עודכנו ל-CurvedTextStyle (Iffc41)
  • הסרנו את ScreenScaffoldDefaults.contentPaddingWithEdgeButton. (Ia923e)
  • הוספנו את errorDim אל ColorScheme, עבור שגיאות בעדיפות גבוהה או פעולות חירום כמו התראות בטיחות, שכבות-על של דיאלוג שנכשלו או לחצני עצירה. (I70998)

תיקוני באגים

  • הצמדנו את wear.compose.material3 לגרסה 1.15.0 של androidx.core.core (I132e9)
  • שיפרנו את הביצועים של Dialog באמצעות AppScaffold כדי להציג תיבות דו-שיח בשכבות מעל תוכן אחר במסך (I1b9a4)
  • צמצום המרווח הפנימי האנכי של EdgeButton. (I1a5bb)
  • הוספנו סמנטיקה של לחצנים ללחצני החלקה. (I80cc6)

גרסה 1.0.0-alpha32

‫29 בינואר 2025

androidx.wear.compose:compose-material3:1.0.0-alpha32 משוחרר. גרסה 1.0.0-alpha32 מכילה את הקומטים האלה.

שינויים ב-API

  • ב-CurvedTextStyle, חילקנו את הריווח בין האותיות לריווח בין האותיות בכיוון השעון ולריווח בין האותיות נגד כיוון השעון. הדרישה הזו נובעת מכך שכשכותבים משמאל לימין, האותיות מתרחבות מהקו הבסיסי, וכשכותבים מימין לשמאל, האותיות מתרחבות אל הקו הבסיסי (לכן נדרש מרווח גדול יותר בין האותיות) (I4b848)
  • עדכנו את IconButtonShapes, IconToggleButtonShapes, TextButtonShapes וTextToggleButtonShapes כדי לשפר את העקביות בספריות Material3. בנוסף, השינוי הזה כולל שמירת צורות במטמון כדי לצמצם את מספר ההקצאות. (I049fc)
  • הסרנו את הפרמטר pressedShapeCornerSizeFraction מהשיטה variantAnimatedShape ב-IconToggleButton וב-TextToggleButton (I58a65)
  • אנחנו משיקים שיפורים ברינדור של טקסט מעוקל (כולל TimeText), שלא תואמים למסכים לא עגולים. בנוסף, התמיכה במסכים לא עגולים לא נכללת יותר בדרישות של Wear OS. למידע נוסף, אפשר לעיין במדריך לתחילת העבודה. (I1cc1c)
  • עדכנו את ButtonGroupScope של ButtonGroup, והחלפנו את ButtonGroupItem מבוסס ה-DSL ב-Modifier.weight, ב-Modifier.minWidth וב-Modifier.enlargeOnPress. (I16c3c)
  • ב-API של ButtonGroup, עדכנו את ButtonGroupScope החדש שמבוסס על משנים: enlargeOnPress נקרא עכשיו animateWidth, והוא מקבל InteractionSource במקום MutableInteractionSource כי אין צורך לשנות אותו. הוספנו גם את הקבוע הציבורי ButtonGroupDefaults.DefaultMinWidth, שהוא רוחב ברירת המחדל המינימלי של לחצנים ב-ButtonGroup. (Ie27ec)
  • עדכנו את ListHeaderDefaults.contentColor כך שיתחיל באות קטנה כי זה מאפיין שאפשר להרכיב (I125a5)
  • הוספנו פרמטר של תיאור תוכן ל-SliderDefaults.DecreaseIcon ול-SliderDefaults.IncreaseIcon, עם ערכי ברירת מחדל מתאימים (I2e1a7)
  • שינינו את השם של הפרמטר spacing ב-Picker וב-PickerGroup ל-verticalSpacing (Ib75cc)
  • הסרנו את ConfirmationDialogDefaults.successText ואת failureText כי אנחנו מצפים שהמתקשרים של ConfirmationDialog יספקו מחרוזות עם יותר הקשר. שינית גם את השם של confirmationCurvedText ועכשיו הוא confirmationDialogCurvedText. בסוף, שינינו את השם של הפרמטר Dialog show ל-visible כדי לשמור על עקביות עם עדכונים אחרים שבוצעו לאחרונה בתיבות דו-שיח. (I10074)
  • IconButton שינה את השם של disabledImageOpacity ל-DisabledImageOpacity. (I5f94a)

תיקוני באגים

  • תיקנו באג באנימציה EdgeButton כך שהגודל הנכון ישמש בכל פריים (Id3b58)
  • תוקנה בעיה שבה animateContentSize לא פעל עם Button. (Ib18a0)
  • שינינו את סולם הסוגים של הכותרת הגדולה כך שגודל הגופן יהיה 18dp (Ic9d52)
  • עדכנו את הריווח AlertDialog ואת גודל הסמל (Iac28c)
  • תיקנו אי-התאמות בנקודות עצירה למסכים גדולים (מסכים בגודל 225dp ומעלה נחשבים למסכים גדולים) (I36474)
  • תוקן באג קל במיקום הכפתור (I952c2)

גרסה 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 החדש, הערך EdgeButton של size מועבר רק אל EdgeButton, והפרמטר edgeButtonSpacing של ScreenScaffold משמש לציון הרווח בין 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)
  • שיפרנו את SwipeToReveal ה-API כדי לקבל פרמטר של משבצת טקסט לתוויות של הפעולות (חוץ מפעולה משנית) וכדי להסיר פרמטרים של תוויות מפעולת הביטול (I5b3db)

תיקוני באגים

  • תיקנו באג שגרם להפעלת משוב הפטי יותר מפעם אחת ב-LongPress,‏ Button,‏ Card,‏ IconButton,‏ TextButton (Ia8b0f)
  • שינויים בחוויית המשתמש של AlertDialog – במסכים גדולים, הלחצנים לאישור ולביטול קטנים יותר עכשיו. בנוסף, המרווח מתחת ללחצני האישור והסגירה גדל. (I4f066)
  • שינינו את מפרטי האנימציה של תווית לחצן הפעולה של הרכיב SwipeToReveal. (Ib87fb)
  • השתנה SwipeToReveal כדי להרחיב את המאגר בו-זמנית עם הצגת הטקסט. (I44cf8)
  • שיפרנו את SwipeToReveal כדי לספק משוב הפטי כשמבצעים החלקה מעבר לסף שבו מתבצעת הפעולה הראשית. (I23efe)
  • עדכנו את SwipeToReveal כך שיוצגו שלוש נקודות במקרים של גלישת טקסט כברירת מחדל, עבור פעולות ראשיות ופעולות ביטול. (I71f5a)
  • תיקנו בעיה שגרמה לריצוד באנימציות של ButtonGroup. (I63f8f)
  • הוספנו סמנטיקה של טקסט ל-AnimatedText (I6063c)
  • תיבת הדו-שיח מאפסת עכשיו את שינוי הגודל של הרקע כשהיא מוסרת מהקומפוזיציה (בלי התיקון הזה, יכול להיות שהמסך שמוצג בהפעלה היה נשאר במצב מוקטן) (Id24ac)
  • הוספנו אנימציה של שינוי צורה ללחצנים ברכיב Stepper (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)
  • עדכנו את Stepper API כדי לספק משבצות increaseIcon ו-decreaseIcon – אפשר ליצור את התוכן שלהן כרגיל מהרכיב Icon composable. (Id35da)
  • עדכנו את dynamicColorScheme והסרנו את הפרמטר האופציונלי defaultColorScheme. עכשיו הפונקציה מחזירה ערך ColorScheme שניתן לאיפוס. כלומר, המתקשר צריך לטפל במקרה החלופי באופן מפורש אם לא מסופקת ערכת צבעים דינמית. (I6d62e)
  • עדכנו את גדלי הסמלים ב-ButtonDefaults לשימוש עם CompactButton. אם רכיב CompactButton מכיל רק סמל, צריך להשתמש ב-ButtonDefaults.SmallIconSize = 24.dp. אם רכיב CompactButton מכיל גם סמל וגם טקסט, צריך להשתמש ב-ButtonDefaults.ExtraSmallIconSize = 20.dp. מומלץ להגדיר את CompactButton כך שהתוכן שלו יתאים לרוחב (במקום למלא את הרוחב המקסימלי), והדוגמאות עודכנו בהתאם. (I0582c)
  • הוספנו EdgeButtonDefaults עם גדלים מומלצים של סמלים ל-4 EdgeButtonSizes השונים. בנוסף, עדכנו את הפריסה של EdgeButton כך שהמרווח הפנימי התחתון גדול קצת יותר מהמרווח הפנימי העליון, מה שמשפר את המראה של תוכן מסוג סמל וטקסט. (Id772a)
  • הוספנו תנועה ל-LinearProgressIndicator וחשפנו את LinearProgressIndicatorContent שמספק את התוכן החזותי ללא אנימציות. (Idee99)
  • הוספנו רכיב חדש CircularProgressIndicatorContent שאפשר להרכיב ממנו תצוגה של התוכן החזותי של CircularProgressIndicator בלי אנימציות. (Ie33d4)
  • ‫TransformingLazyColumn newly provides the composition local LocalTransformingLazyColumnItemScope which Cards, Buttons and ListHeaders now use to automatically morph when placed inside a 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. רכיבים ב-Wear Compose שאפשר ללחוץ עליהם לחיצה ארוכה, כמו Button, IconButton, TextButton ו-Card, מפעילים עכשיו את הרטט LONG_PRESS כשמסופק handler של לחיצה ארוכה. (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)
  • הפכנו את רכיבי ה-Composable‏ AlertDialogContent ו-Dialog שמרכיבים את AlertDialog API לזמינים לציבור, כדי שיהיה אפשר להוסיף התאמה אישית אם יש צורך (למשל, התאמה אישית של האנימציה של AlertDialog תוך שמירה על פריסת התוכן המומלצת). בנוסף, הוספנו את הפרמטרים Modifier ו-Color לחברים EdgeButton, ConfirmButton ו-DismissButton של AlertDialogDefaults. (I4eb71)
  • עדכנו את Placeholder API באופן הבא: שינינו את השם של 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 למחלקת ערכים. (Ieef15)
  • שינינו את החשיפה של copy() ל'גלוי לכולם' בשיעורי הצבעים של wear material3 ‏ (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)
  • הפרמטר EdgeButton של preferredHeight שונה ל-buttonSize, והערך שלו יכול להיות רק אחת מ-4 קבועים במחלקה החדשה של הערכים EdgeButtonSize. (Icdd70)
  • שינינו את השם של ListSubheader ל-ListSubHeader והוספנו ערכי ברירת מחדל שזמינים לכולם עבור ListHeader ו-ListSubHeader. (I96730)
  • הוספנו רכיבים חדשים של HorizontalPagerScaffold ושל VerticalPagerScaffold ל-Wear, שמספקים אנימציות חדשות ותיאום בין רכיבי הטקסט של השעה לבין רכיבי מחוון הדף. (Iff7d0)
  • הוספנו תמיכה בסיבוב ל-HorizontalPagerScaffold ול-VerticalPagerScaffold, כדי לאפשר למשתמשים לנווט במנגנוני החלפה בין דפים באמצעות מכשירי קלט סיבוביים. (I9770d)
  • ביצענו שינויים ב-API כדי לפשט את השימוש ולשפר את העקביות.MotionScheme הוסרו פונקציות מוטבעות של remember והועברו Motion Schemes מובנים לאובייקט ייעודי של MotionScheme. שם האפשרות standardMotionScheme ושם האפשרות expressiveMotionScheme שונו ל'רגיל' ו'מובלט'. (I5fd45)
  • הוספנו תמיכה בערכת צבעים דינמית שמבוססת על צבעי המערכת. (I073e9)
  • עדכנו את רכיב ה-Stepper בהתאם למפרט העדכני של חוויית המשתמש. (I622bb)

תיקוני באגים

  • עדכנו את הטיפוגרפיה והריווחים ברכיבי הכרטיסים. (I3ae48)
  • שינינו את הריווח הפנימי ב-AlertDialog בין הלחצנים 'אישור' ו'ביטול' לבין שאר התוכן מ-8dp ל-12dp בהתאם למפרטי UX (Ie55f0)
  • עדכנו את האטימות של הצבע ברכיב Slider (פס הזזה). (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 ל-Wear Material 3‏ (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)
  • עדכנו את הצבעים ואת הפריסה של רכיב ה-Slider. (Ic3eec)

תיקוני באגים

  • עדכנו את האנימציה של הסמל openOnPhone (I66f85)
  • אנחנו משתמשים עכשיו בסמלים של Google Symbols ב-Slider, ב-TimePicker וב-DatePicker. (I46c7c)
  • עדכנו את המרווחים הפנימיים ב-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% (overflow) גם ב-CircularProgressIndicator וגם ב-SegmentedCircularProgressIndicator. אם ההתקדמות תהיה מעל 1.0, היא תסומן בצבע החדש overflowTrack. (Iaaa3d)
  • העיגולים IconToggleButton ו-TextToggleButton תומכים עכשיו באנימציה חדשה של צורות, שבה צורות שונות מייצגות מצבים של סימון, ביטול סימון ולחיצה. התמיכה בגרסה הקודמת של צורת האנימציה למצב של לחיצה על המקש נמשכת. (I29f03)
  • הסרנו את התמיכה בשימוש ב-EdgeButton עם Column, כי צריך לציין את הגובה של EdgeButton באופן מפורש ב-ScreenScaffold. (Ie353d)
  • הוספנו תמיכה ב-Wear Compose LazyColumn עם ScreenScaffold (והוספנו הטמעה של ScrollInfoProvider ל-LazyColumnState). (Ib8d29)
  • שילבנו את LocalTextMaxLines, ‏LocalTextAlign ו-LocalTextOverflow בקומפוזיציה מקומית אחת של LocalTextConfiguration כדי לספק פתרון שניתן להרחבה בעתיד. (I5edbc)
  • הוספנו את arc-large כסולם סוגים נוסף, ששמור למחרוזות קצרות של טקסט בכותרת העליונה או התחתונה של המסך, כמו בשכבות-על של אישור. ‫(I60e3e)
  • הוספנו ערכי ברירת מחדל לרכיב Button לגבי גדלים מומלצים של סמלים גדולים וגדולים במיוחד, וריווח פנימי של התוכן. (I84675)

תיקוני באגים

  • עדכנו את הצבעים של IconButton ושל TextButton. (I48324)
  • שינינו את העומסים העודפים של לחצן הבסיס כך שיהיו מיושרים למרכז באופן אנכי, כדי לשמור על עקביות עם עומסים עודפים אחרים. כדי לשחזר את ההתנהגות הקודמת, משתמשים ב-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)
  • הוספנו רכיבים של AppScaffold ו-ScreenScaffold לספריית Material3, שכוללים פונקציונליות לתיאום השכבות והמעברים של TimeText ו-ScrollIndicator. ‫AppScaffold מספק רמה עליונה של רכיבי scaffold שמוצבים מעל כל המסכים. לכן, אם מוסיפים את 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. הגרסה המופרדת מציגה ערך התקדמות יחיד בכל הפלחים או מציגה כל פלח כפעיל או לא פעיל. (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)
  • הוספנו פרמטר משקל לפונקציה TimeText של text. במקרים שבהם 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 כדי להטמיע הנחיות לגבי חוויית המשתמש, אבל מפתחים יכולים לבטל את הפרמטרים אם יש צורך בכך. ‫(Iab841)
  • הוספנו את Placeholder כדי לעזור בהסתרת התוכן של רכיבים כמו לחצנים וכרטיסים עד לטעינת הנתונים. (I1a532)
  • הוספנו את IconToggleButtonColors ואת TextToggleButtonColors כדי להחליף את ToggleButtonColors שהוסר. (Ie0bf1)

תיקוני באגים

  • עדכנו את Button, ‏ FilledTonalButton, ‏ OutlinedButton, ‏ ChildButton, ‏ CompactButton כדי להשתמש בCompositionLocals LocalTextMaxLines, ‏ LocalTextAlign, ‏ LocalTextOverflow החדשים כדי להטמיע הנחיות לגבי חוויית המשתמש. המפתחים יכולים לבטל את הפרמטרים האלה ישירות ב-Text אם יש צורך בכך (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

  • עדכנו את Material3 ColorScheme. (I7b2b8)
  • עדכנו את המתג Material3 – בנוסף לשינויים בצבעים, סימן ה-V תואם עכשיו לסימן ה-V שמשמש לתיבת הסימון. (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 מכילה את הקומיטים האלה.

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

תיקוני באגים

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

גרסה 1.0.0-alpha15

‫15 בנובמבר 2023

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

שינויים ב-API

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

תיקוני באגים

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

גרסה 1.0.0-alpha14

‫18 באוקטובר 2023

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

שינויים ב-API

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

גרסה 1.0.0-alpha13

‫4 באוקטובר 2023

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

שינויים ב-API

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

גרסה 1.0.0-alpha12

‫20 בספטמבר 2023

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

שינויים ב-API

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

גרסה 1.0.0-alpha11

‫6 בספטמבר 2023

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

תיקוני באגים

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

גרסה 1.0.0-alpha10

‫23 באוגוסט 2023

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

תכונות חדשות

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

שינויים ב-API

  • מעדכנים את הקוד של הלחצנים כדי להשתמש בטוקנים של עיצוב Material3. (I92fe4)
  • הכרזה על ממשקי Wear Material 3 Stepper ו-Slider API כניסיוניים, כי הפרטים של ממשק המשתמש עדיין נמצאים בשלבי סיום. (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)
  • הוספנו את Material3 InlineSlider ל-Wear Compose. היא מאפשרת למשתמשים לבחור מתוך טווח של ערכים. טווח הבחירות מוצג כסרגל בין ערכי המינימום והמקסימום של הטווח, שהמשתמשים יכולים לבחור ערך מתוכו. ‫InlineSlider הוא אידיאלי להתאמת הגדרות כמו עוצמת קול או בהירות. (I7085f)

שינויים ב-API

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

תיקוני באגים

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

גרסה 1.0.0-alpha07

‫21 ביוני 2023

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

תכונות חדשות

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

תיקוני באגים

  • עדכנו את wear.compose.foundation כך שיהיה תלוי ב-API של wear.compose.material3 (I72004, ‏ b/285404743)

גרסה 1.0.0-alpha06

‫7 ביוני 2023

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

תיקוני באגים

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

גרסה 1.0.0-alpha05

‫24 במאי 2023

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

תכונות חדשות

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

שינויים ב-API

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

גרסה 1.0.0-alpha04

‫10 במאי 2023

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

תכונות חדשות

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

גרסה 1.0.0-alpha03

‫19 באפריל 2023

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

שינויים ב-API

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