Wear Compose Material 3

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

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

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

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

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

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

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

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

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

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

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

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

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

Wear Compose Material3 גרסה 1.5

גרסה 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. (Id2ae2)

תיקוני באגים

• שינינו את הסדר שבו אנחנו מחילים את ההשפעה של הפרמטרים SurfaceTransformation. בעבר, הטרנספורמציות שהוחלו על רכיבי Wear Material3 בוצעו באופן הבא: ציור רקע, טרנספורמציה של קונטיינר, טרנספורמציה של תוכן. עכשיו, 2 הפריטים הראשונים הופכים, ואנחנו מחילים כל שינוי שעבר ביניהם, כך שהוא מושפע מהטרנספורמציות של הקונטיינר. כך ניתן לפתור בעיות כמו שימוש באפקט שיזוף של placeholder עם רכיבים ב-TLC באמצעות פרמטר הטרנספורמציה. (I786cf)
• השדה RevealState.Saver נוסף כדי לשמש לשחזור המצב של SwipeToReveal כשיוצרים מחדש את הפעילות או התהליך. הפונקציה rememberRevealState משתמשת עכשיו ב-Saver הזה כברירת מחדל. (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 השתפרו, בעקבות אופטימיזציה של החישוב של ScrollProgress בשיעור של 30%. (I4c4cb)

גרסה 1.5.0-beta01

7 במאי 2025

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

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

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

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

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

• TransformingLazyColumn – רשימה עם גלילה אנכית עצלה שתומכת בהתאמה לעומס ובאנימציות של טרנספורמציה
• קבוצות פוקוס היררכיות – משמשות להוספת הערות לרכיבים שניתנים לשילוב באפליקציה, כדי לעקוב אחרי החלק הפעיל של ההרכבה ולתאם את המיקוד.
• Pagers – רכיבים של 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 של SwipeToReveal ב-Wear Compose Material וב-Wear Compose Material3. כדי להמשיך להשתמש בממשקי ה-API, צריך להחליף את הייבוא של SwipeToReveal ב-Wear Foundation בייבוא של Wear Compose Material או Wear Compose Material3. (Ia147d).
• יחסי התלות של SwipeToReveal ב-Foundation ב-Wear Compose Material3 הועברו לחבילת material3, למשל RevealValue, ‏ RevealDirection, ‏ RevealActionType, ‏ RevealState, ‏ rememberRevealState. המפתחים צריכים לשנות את הייבוא של הכיתות והפונקציות האלה מ-androidx.wear.compose.foundation ל-androidx.wear.compose.material3. (I640e6).
• עדכנו את ממשק ה-API SwipeToReveal של Wear Compose Material3 באופן הבא: הוספנו את הפרמטרים primaryAction,‏ onFullSwipe,‏ secondaryAction,‏ undoPrimaryAction,‏ undoSecondaryAction ו-hasPartiallyRevealedState ל-composable‏ SwipeToReveal. הסרנו את היכולת להתאים אישית את positionalThreshold ו-animationSpec מ-RevealState. הסרנו את lastActionType,‏ revealThreshold והרוחב מ-RevealState. שינינו את המבנה של RevealState כך שיקבל RevealDirection במקום עוגנים. הסרנו את createRevealAnchors, את העוגנים ואת הפונקציות bidirectionalAnchors. הפונקציות SwipeToRevealScope‏ primaryAction,‏ secondaryAction,‏ undoPrimaryAction ו-undoSecondaryAction שונו לשמות PrimaryActionButton,‏ SecondaryActionButton,‏ UndoActionButton והפכו לפונקציות Composable. סימנו את RevealActionType כפנימית. (I885d0).
• עדכנו את ה-API של SwipeToReveal באופן הבא: שינינו את השם של onFullSwipe ל-onSwipePrimaryAction, שינינו את השם של SwipeToRevealNonAnchoredSample כדי לציין את השימוש בפרמטר hasPartiallyRevealedState, הסרנו את actionButtonHeight כי ברירת המחדל היא הגובה שמוגדר כברירת מחדל ל-Button, וניתן להגדיר גובה גדול יותר באמצעות שינוי (modifier). הסרנו את SmallActionButtonHeight מ-SwipeToRevealDefaults, והפכנו את פרמטר הערך ב-RevealValue וב-RevealDirection למשתנה פרטי (private) ב-constructors. (I465ce).

תיקוני באגים

• תוקנה הטיפול ב-EdgeButton של ScreenScaffold, כך שאחרי הסרת פריט 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 לשרשור עבודה, כי הוא גרם לבעיות באפליקציות שמנהלות את השרשור שלהן בזמן הניווט. (I34d02).
• עדכנו את הדוגמאות ל-Picker כדי להסיר קריאות מיותרות ל-remember, ובמקום זאת להשתמש ב-rememberUpdatedState ב-Picker כדי לזכור את פונקציית הלמבדה האחרונה של contentDescription. (Icb5b1).
• עדכנו את סגנונות הטקסט ב-TimePicker וב-DatePicker, כך ששינויים בגופן לא יגרמו יותר לקיצוץ. (I26194).
• עכשיו ברירת המחדל של ListHeader ו-ListSubHeader היא יישור טקסט למרכז ולהתחלה, בהתאמה. (I78339).
• עדכנו את הדוגמאות והדמואים של Foundation ו-Material לגבי החלקה כדי לחשוף, כדי להודיע על פעולות מותאמות אישית של נגישות (צריך להוסיף את הפעולות בהתאמה אישית כסמנטיקה בתוכן, ולא ברכיב ה-SwipeToReveal עצמו). (Ie92a3).
• עדכנו את ברירת המחדל של MaxLines שמוגדרת בתוכן EdgeButton בהתאם לגודל שלו – עכשיו הערך הוא 1 לתוכן בגודל 'קטן במיוחד', 2 לתוכן בגודל 'קטן' ו'בינוני' ו-3 לתוכן בגודל 'גדול'. (Ie35f6).
• LocalReduceMotion פשוט יותר, כך שהמשתמש המתבונן נרשם רק פעם אחת, כדי לשפר את הביצועים. (Ib1979).
• צמצמנו את מספר הציורים מחדש ב-ScrollIndicator כדי לשפר את הביצועים. (Ia7a67).
• תוקן באג ב-TransformingLazyColumn, שבו הפריט העליון שגלוי ברשימה לא השתנה כראוי כש-EdgeButton הגיע לגובה המלא שלו. (I30580).

Wear Compose Material3 גרסה 1.0

גרסה 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)
• הוחלפו רכיבי ה-composables של ImageButton ו-ImageCard ב-overloads של Button ו-Card/TitleCard, בהתאמה. השם של imageButtonColors השתנה ל-buttonWithContainerPainterColors והשם של imageCardColors השתנה ל-cardWithContainerPainterColors. הוספו ButtonDefaults.scrimBrush ו-CardDefaults.scrimBrush כקהלים גלויים לכולם. השם של הלחצן imageBackgroundGradientStartColor ו-imageBackgroundGradientEndColor השתנה ל-scrimGradientStartColor ו-scrimGradientEndColor. שינית את השם של CardDefaults.ImageContentPadding ל-CardDefaults.CardWithContainerPainterContentPadding (I7b8b6)
• הפונקציות Picker ו-PickerGroup מקבלות עכשיו את contentDescription כפונקציית lambda כדי למנוע קומפוזיציות מחדש מיותרות. (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. וגם שינויים דומים לגבי כרטיס. הציירים יוסרו מ-ButtonColors ומ-CardColors. (I8c6a1)
• מצייני מיקום עודכנו כדי לפשט את ה-API. עכשיו יש לנו שני מודיפיקרים: 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, ונדרשת לה גרסה 2.0.0 ואילך של KGP. (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. השם של פרמטר הדף ב-AnimatedPage השתנה ל-pageIndex. (I701f2)
• השמות של SurfaceTransformation ב-TransformingLazyColumn עודכנו – 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, כך שהאנימציה של העמעום וההבהרה פועלת כאנימציית Spring אחת. (I68963)
• אופטימיזציה של PagerScaffold על ידי הימנעות מהקריאה של currentPageOffsetFraction ב-composable של AnimatedPage. (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 – במקום זאת, צריך לספק אותו באמצעות ה-Composable של content. AnimatedPage ו-snapWithSpringFlingBehaviour גלויים עכשיו לכולם, וניתן להשתמש בהם יחד עם Wear Foundation Pager כדי לקבל את ההתנהגות הקודמת של PagerScaffold ב-M3. (ראו דוגמאות מעודכנות). (Ia4724)
• עודכן PagerState, והוסרו ממנו PagerState של Compose Foundation ככיתה הבסיסית, והתווספו המאפיינים currentPage,‏ currentPageOffsetFraction ו-pageCount. עדכנו את הממשק של GestureInclusion ושינו את שם השיטה ל-ignoreGestureStart. (I4ae07)
• הפרמטרים של זווית הסנון LevelIndicator מסומנים עכשיו בתווית FloatRange(0, 360) (I7e636)
• הוספנו את CurvedModifier.clearAndSetSemantics כדי לספק דרך להשבית את הסמנטיקה המעוקלת. CurvedText ממשיך להגדיר כברירת מחדל את תיאור התוכן כטקסט, אבל timeTextCurvedText ו-timeTextSeparator לא מכריזים עכשיו על התוכן שלהם. (I4b568)
• נוספו פרמטרים של צבע רקע וצבע תוכן ברירת מחדל ל-AppScaffold. (I56652)
• שם ברירת המחדל של הטיפול בתנועות החלקה ב-HorizontalPager השתנה ל-PagerDefaults.gestureInclusion. התנהגות ברירת המחדל היא עכשיו להתעלם רק מתנועות החלקה שמתחילות בקצה הימני של הדף הראשון, ורק כש-TalkBack מושבת. במקרים אחרים, התנהגות ברירת המחדל היא שהמעברון לא יתעלם מתנועות החלקה, כך שהן לא יהיו זמינות למטפלים בתנועות החלקה לסגירה. (Iee486)
• הוספנו את הפרמטר SurfaceTransformation לרכיבי כפתור, כרטיס וכותרת רשימה, כדי שיוכלו להחיל טרנספורמציות שונות של רקע ותוכן כשהם משמשים בקונטיינרים שמשתנים את מראה הפריטים בהתאם למיקום שלהם, כמו TransformingLazyColumn. (Iabe3f)
• כדי למנוע הטמעה של הערכים, עדכנו את המאפיינים 'public const val' ב-Wear Compose Material3 API ל-'public val'. (Ib0f32)
• הוספנו תמיכה באזור לסחיטה מהקצה ל-SwipeToReveal. ברירת המחדל של Foundation SwipeToReveal היא עכשיו לא לאפשר החלקה כשהתנועה מתחילה מהקצה. התנהגות ברירת המחדל של SwipeToReveal’ ב-Material3 היא עכשיו לא לאפשר החלקה כשהתנועה מתחילה מהקצה, אם SwipeDirection מוגדר לכיוון יחיד. (I32ef0)
• נוספה האפשרות להוסיף FadingExpandingLabel, שמאפשרת להציג טקסט עם אנימציה של הופעה בהדרגה שורה אחר שורה. (Ic60fa)
• TransformingLazyColumn משתמש עכשיו ב-contentPadding ריק כברירת מחדל במקום להציב את הפריטים הראשון והאחרון במרכז. (I77ab7)
• הוסר rememberRevealState של SwipeToReveal מספריית Wear Compose Material3. (I8c0e0)

תיקוני באגים

• ספריות Wear Compose עודכנו למהדורת 2.0 של Kotlin. (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 ברכיבי התשתית ל-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 ב-composable. לכן, הסרנו את השיטה pickerGroupItem מ-PickerGroupScope והוספנו במקום זאת את השיטה @Composable PickerGroupItem, שצריך להשתמש בה כדי להוסיף Picker ל-PickerGroup. כמו כן, עדכנו את הסוג של הפרמטר 'content' (תוכן) ב-PickerGroup ל-@Composable PickerGroupScope.() -> Unit. (Ic6aec)
• הוספנו עומס יתר של LevelIndicator לערכים עשרוניים והוספנו קידומת Stepper לעומסי יתר שכוללים פרמטר טווח (שמתאים לשימוש עם הרכיב Stepper). (If4234)
• הוספנו את TransformationSpec של TransformingLazyColumn ל-API, שמאפשר להגדיר את הטרנספורמציות המדויקות שמתרחשות לפריטים בזמן הגלילה ב-TLC. (I21856)
• עדכנו את IconButtonShapes, ‏ IconToggleButtonShapes, ‏ TextButtonShapes ו-TextToggleButtonShapes כך שיתאימו לכיתות compose/material3 (I5a081)
• הוספנו פרמטר overscrollEffect ל-ScalingLazyColumn, ל-TransformingLazyColumn ול-ScreenScaffold. (I0cee8)
• שינינו את השם של הפרמטר swipeDirection ל-revealDirection ב-rememberRevealState. (I7472f)
• ל-Wear Pager יש עכשיו PagerScope משלו במקום להשתמש ב-Compose PagerScope. (I9195b)
• הסרנו את הרכיב הניתן לקישור LinearProgressIndicatorContent. יש להשתמש ישירות ב-LinearProgressIndicator כדי שהשינויים בערכים יתבצעו עם אנימציה כברירת מחדל. (I2c4ad)
• הסרנו את CircularProgressIndicatorStatic הניתנת ליצירה והוספנו פונקציית DrawScope ציבורית drawCircularProgressIndicator עם אותה פונקציונליות. מומלץ להשתמש ב-CircularProgressIndicator ישירות כדי שהשינויים יהיו עם אנימציה כברירת מחדל, אבל אם אתם צריכים אנימציות בהתאמה אישית, תוכלו ליצור רכיב מורכב משלכם מ-drawCircularProgressIndicator. (Ie762f)
• שינינו את סדר הפרמטרים ב-DrawScope.drawCircularProgressIndicator כדי להזיז את הפרמטר targetProgress למעלה. (I8ab92)
• ממשק ה-API של OpenOnPhoneDialog עודכן כדי לשפר את הבהירות והעקביות שלו ביחס לממשקי Dialog אחרים. השם של הפרמטר 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. השינוי הזה כולל גם אחסון ב-cache של צורות כדי לצמצם את מספר ההקצאות. (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. לבסוף, שינינו את השם של הפרמטר show של תיבת הדו-שיח ל'גלוי' כדי לשמור על עקביות עם עדכונים אחרים שבוצעו לאחרונה בתיבת הדו-שיח. (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 החדש, ה-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)
• הוספנו אנימציה של טרנספורמציה של צורה ללחצנים ברכיב ה-Stepper (Id6ed3)

גרסה 1.0.0-alpha30

11 בדצמבר 2024

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

שינויים ב-API

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

תכונות חדשות

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

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

תכונות חדשות

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