יצירת מוזיקה ב-Wear

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

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

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

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

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

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

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

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

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

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

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

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

משוב

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

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

מידע נוסף זמין במאמרי העזרה בנושא Issue Tracker.

גרסה 1.8

גרסה ‎1.8.0-alpha01

‫7 באוקטובר 2026

‫androidx.wear.compose:compose-*:1.8.0-alpha01 מופץ. גרסה ‎1.8.0-alpha01 מכילה את השמירות האלה.

שינויים ב-API

• נוספו עומסים חדשים של AppScaffold ו-ScreenScaffold ללא הפרמטר timeText, כדי להגדיר את הכיוון המומלץ למיגרציה של Wear Compose 1.8 לסרגל המערכת החדש. כשמריצים אותן בגרסאות ישנות יותר בלי סרגל סטטוס מערכת, העומסים החדשים האלה חוזרים לברירת המחדל TimeText. העומסים הקיימים מועברים עכשיו לסרגל סטטוס המערכת כברירת מחדל, אלא אם מסופק timeText מותאם אישית מפורש. (I40a5e)
• נוסף רכיב StatusBarSuppression helper composable כדי להסתיר את שורת הסטטוס של המערכת ברכיבים של מסך מלא ושל שכבת-על. (I387c3)
• הוספנו את Modifier.curveToEdge, שמשתמש ב-shader כדי לעגל רכיב לגבול של מאגר האב סביב המרכז, ותמיד מתייחס למאגר כאל עיגול. בעיות ידועות: הרכיבים שאפשר ללחוץ עליהם יכללו גבולות שגויים שאפשר ללחוץ עליהם, והרכיבים לא יסומנו בצורה נכונה ב-TalkBack. (I8bbaa)
• נוספו PullToRefreshBox ו-PullToRefreshState ל-Wear Compose Material 3, עם מרחקי גרירה וספי עדכון שמותאמים למכשירי Wear OS‏.(Iee9a5)
• העברנו את PullToRefreshBox, PullToRefreshDefaults ו-PullToRefreshState לממשקי API ציבוריים יציבים ב-Wear Compose Material 3. (I079b6)
• הוספנו עומס יתר של SwipeToReveal עם פרמטר טרנספורמציה כדי לתמוך בטרנספורמציות של מאגרי תגים ב-TransformingLazyColumn. (I328ce)
• הספריות מכוונות עכשיו ל-Kotlin 2.2 ונדרש kotlinc 2.2 (I82396, b/498369605)
• הוסר דגל התכונה הניסיונית WearComposeFoundationFlags.isTransformingLazyColumnClickableThresholdEnabled. הסף שניתן ללחיצה ב-TransformingLazyColumn מופעל עכשיו תמיד. (Ib68c8)
• הוסרה התכונה הניסיונית WearComposeFoundationFlags.isTransformingLazyColumnPinnableContainerEnabled. (Ibad2e)

תיקוני באגים

• תוקן באג ב-Wear Compose Foundation HorizontalPager, שבו הטיפול במחוות לא הצליח לתת עדיפות נכונה בין החלקה להעברה לדף הבא לבין החלקה לסגירה. (I54caf)
• הוספנו את Modifier.testTag("time_text") ל-TimeText כדי שאפשר יהיה לזהות אותו בתרחישי בדיקה שבהם שורת הסטטוס של המערכת חוזרת ל-TimeText שניתן להרכבה כברירת מחדל. (Iacb09)
• תוקן באפליקציה IllegalStateException בגרסה OneHandedGestureModifier.updateCompositionLocals באג שנגרם כתוצאה מגישה לצמתים לפני צירוף. (I662271)
• נוספה תמיכה במחוות AlertDialog, כך שגלילה למטה ולחיצות על לחצן Confirm זמינות כברירת מחדל. (I51f81)
• תוקן באפליקציה TimeText מצב ההבזק כשעוברים לסרגל סטטוס שעובר בירושה, על ידי שיפור הלוגיקה של הסתרת הניראות ב-ScreenContent. (I12dd01)
• תוקנה בעיה שבה רכיבים שמסתירים את סרגל סטטוס המערכת (כמו Stepper) חזרו להצגת TimeText בתוך האפליקציה. (I86830)
• תוקן StatusBarSuppression() כך שיכבד את LocalStatusBarEnabled כשסרגל הסטטוס הגלובלי מושבת, וכך נמנעות העברות מיותרות של פריסות בתיבות דו-שיח. (I4f77f6)
• נפתרה בעיה ב-Wear Material3 Scaffold שבה currentScrollInfoProvider לא ירש מסכים בסיסיים כשמסך העליון סיפק ערך null. (I97874)
• הוספנו תמיכה בהסתרת סרגל הסטטוס Dialog וב-ScreenScaffolds מקוננים ב-Wear Material3 Scaffold. (I01772)
• תוקנה בעיה ב-AppScaffold שבה שכבת העל של סרגל הסטטוס הופיעה מחדש בזמן גלילה כשפריט העוגן העליון. (I421b3)
• תוקנה בעיה שגרמה לכך שהריווח העליון ScreenScaffold התכווץ כשפותחים מסכים עם מצב שורת סטטוס מושבת. (I7cf4f)
• נוספה תמיכה בתיאום של סרגל המצב בחלונות מרובים ל-Wear Compose Material3 scaffolds, שמאפשרת לתיבות דו-שיח ולחלונות נפרדים להפעיל את בקרי סרגל המצב שלהם. (Ibf82c)
• שיפרנו את TransformingLazyColumn כך שיהיה עמיד יותר לרווחים שליליים בין פריטים (I99ac7)
• החלפנו את הרקע של מצביע האינדיקטור במשאבים בפונקציות של canvas באמצעות נתיבים, כדי לבצע אופטימיזציה של אינדיקטורים של תנועות. (Iee2b7)
• החלפנו את ה-AVD הראשיים ואת ה-AVD של ההסרה במשאבים בפונקציות של ציור באמצעות נתיבים, כדי לבצע אופטימיזציה של אינדיקטורים של תנועות. (Ib2d05)
• התלות ב-androidx.lifecycle:lifecycle-runtime עודכנה ל-2.10.0. הגרסה הזו נדרשת כדי להריץ בדיקות lint של זמן ריצה של מחזור חיים בחבילה עם AGP בגרסה 9.5.0-alpha04 ואילך. (I99bfd, ‏ b/556807521)
• פרופילי ה-Baseline של הספריות Wear Compose Foundation,‏ Material3 ו-Navigation3 עודכנו. (I9b0a3)

גרסה 1.7

גרסה 1.7.1

‫7 באוקטובר 2026

‫androidx.wear.compose:compose-*:1.7.1 מופץ. גרסה 1.7.1 מכילה את השמירות האלה.

תיקוני באגים

• תיקון הבהוב באנימציה OneHandedGestureHintScrollIndicator (I650c6)
• הסרת נעילת הגלילה מ-OneHandedGestureScrollIndicator וניהול הנראות של האינדיקטור ב-ScreenScaffold באמצעות קומפוזיציה מקומית (I13050)
• תיקון פרטי המוצר IllegalStateException ב-Modifier.oneHandedGesture (I35151)

גרסה 1.7.0

‫23 בספטמבר 2026

‫androidx.wear.compose:compose-*:1.7.0 מופץ. גרסה 1.7.0 מכילה את השמירות האלה.

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

• הוספנו API חדש לתנועות ביד אחת, שכולל רכיבי handler לתנועות של פעולה ראשית (צביטה כפולה) וביטול פעולה (סיבוב של פרק כף היד), וגם אינדיקטורים מונפשים ללחיצה, לגלילה ולמעבר בין דפים שמוצגים כשהתנועות זמינות.
• נוספה תמיכה ב-PinnableContainer ב-TransformingLazyColumn, כדי להחזיק פריט בזיכרון במקום להסיר אותו כשהמשתמש גולל אותו מחוץ לאזור התצוגה.
• ב-TransformingLazyColumn יש עכשיו תמיכה בהנפשת פריטים כשהם יוצאים מאזור התצוגה, כך שהם יכולים להחליק בצורה חלקה אל מחוץ למסך במקום לדהות.
• נוסף firstLayoutItemProvider ל-TransformingLazyColumn כהתאמה אישית אופציונלית לפריט הראשון בפריסת הדף. אם מציינים את המיקום, הספק מגדיר את הפריט ואת הקצה שלו שמשמשים כהפניה למיקום הראשוני. ההגדרה הזו שימושית כדי לשלוט בכיוון של הזזת התוכן כשפריטים מתעדכנים באופן דינמי.
• שיפורים ב-SwipeToReveal כדי לתמוך בגלילה מקוננת, בהטלה מהירה, בתחושה מישושית שנייה במצב של חשיפה חלקית וב-actionContentSpacing למרחק בין התוכן הראשי לבין לחצני הפעולה.
• הוספנו את ההערות @FrequentlyChangingValue ו-@RememberInComposition שמספקות אזהרות של lint כדי למנוע בעיות בביצועים שנגרמות מקריאה של עדכוני מצב בתדירות גבוהה או מאי-שמירה של אובייקטים במהלך ההרכבה.

תיקוני באגים

• התלות ב-androidx.lifecycle:lifecycle-runtime עודכנה ל-2.10.0. הגרסה הזו נדרשת כדי להריץ בדיקות lint של זמן ריצה של מחזור חיים בחבילה עם AGP בגרסה 9.5.0-alpha04 ואילך. (If8e16)

גרסה ‎1.7.0-rc01

‫9 בספטמבר 2026

‫androidx.wear.compose:compose-*:1.7.0-rc01 מופץ. גרסה ‎1.7.0-rc01 מכילה את השמירות האלה.

• בגרסה הזו, גרסה 1.7.0 של Compose for Wear OS עודכנה לגרסת מועמדת להפצה, אבל אין שינויים משמעותיים אחרים לעומת גרסה 1.7.0-beta02.

גרסה ‎1.7.0-beta02

‫26 באוגוסט 2026

‫androidx.wear.compose:compose-*:1.7.0-beta02 מופץ. גרסה ‎1.7.0-beta02 מכילה את השמירות האלה.

תיקוני באגים

• פרופילי ה-Baseline של הספריות Wear Compose Foundation,‏ Material3 ו-Navigation3 עודכנו. (I9b0a3)
• תיקון הבהוב של אנימציית רמז לתנועה ב-OneHandedGestureScrollIndicator. (6e0c1cb)

גרסה ‎1.7.0-beta01

‫12 באוגוסט 2026

‫androidx.wear.compose:compose-*:1.7.0-beta01 מופץ. גרסה ‎1.7.0-beta01 מכילה את השמירות האלה.

הגרסה 1.7.0-beta01 של Compose ל-Wear OS מציינת שהגרסה הזו של הספרייה כוללת את כל התכונות וה-API נעול. גרסה Wear Compose 1.7.0-beta01 כוללת את הפונקציונליות החדשה הבאה:

• תמיכה במחוות ביד אחת, שכוללת אמצעי טיפול במחוות לפעולה ראשית (למשל צביטה כפולה) ולפעולת סגירה (למשל סיבוב של פרק כף היד), ואינדיקטורים מונפשים שמראים מתי המחוות זמינות ברכיבי ממשק משתמש שאפשר ללחוץ עליהם (כמו כפתורים וכרטיסים), ברשימות שאפשר לגלול בהן ובמנגנוני החלפה בין דפים.
• נוספה תמיכה ב-PinnableContainer ב-TransformingLazyColumn, כדי להחזיק פריט בזיכרון במקום להסיר אותו כשהמשתמש גולל אותו מחוץ לאזור התצוגה.
• ב-TransformingLazyColumn יש עכשיו תמיכה בהנפשת פריטים כשהם יוצאים מאזור התצוגה, כך שהם יכולים להחליק בצורה חלקה אל מחוץ למסך במקום לדהות.
• נוסף firstLayoutItemProvider ל-TransformingLazyColumn כהתאמה אישית אופציונלית לפריט הראשון בפריסת הדף. אם מציינים את המיקום, הספק מגדיר את הפריט ואת הקצה שלו שמשמשים כהפניה למיקום הראשוני. ההגדרה הזו שימושית כדי לשלוט בכיוון של הזזת התוכן כשפריטים מתעדכנים באופן דינמי.
• שיפורים ב-SwipeToReveal כדי לתמוך בגלילה מקוננת, בהטלה מהירה, בתחושה מישושית שנייה במצב של חשיפה חלקית וב-actionContentSpacing למרחק בין התוכן הראשי לבין לחצני הפעולה.
• הוספנו את ההערות @FrequentlyChangingValue ו-@RememberInComposition שמספקות אזהרות של lint כדי למנוע בעיות בביצועים שנגרמות מקריאה של עדכוני מצב בתדירות גבוהה או מאי-שמירה של אובייקטים במהלך ההרכבה.

שינויים ב-API

• שינית את השם של GestureAction ל-OneHandedGestureAction, של GesturePriority ל-OneHandedGesturePriority ושל GestureIndicatorSize ל-OneHandedGestureIndicatorSize (Ifc7f4, b/522761843)

תיקוני באגים

• תוקנה בעיה ב-ScrollInfoProvider שגרמה ל-TimeText להבהב או להיעלם כשפריטים ברשימה השתנו או שגודלם שונה. (Ief762, ‏ b/537433564)

גרסה ‎1.7.0-alpha07

‫29 ביולי 2026

‫androidx.wear.compose:compose-*:1.7.0-alpha07 מופץ. גרסה ‎1.7.0-alpha07 מכילה את השמירות האלה.

שינויים ב-API

• בוצע רפקטורינג של ממשקי ה-API‏ OneHandedGesture, והוחלף מצב האינדיקטור הבוליאני (שדרש איפוס אחרי הצגת האינדיקטור) בפונקציית השהיה להפעלת האנימציה. לכל סוג של אינדיקטור יש עכשיו מחלקה משלו של מצב האינדיקטור, שמכילה את לוגיקת האנימציה של האינדיקטור הזה. השם שונה מ-key ל-gestureId ב-GestureConfiguration. ‫(I7974f, ‏ b/522761843)
• הוספת CompactButton עומס יתר של תוכן במשבצת אחת (Idaffc, ‏ b/527889640)
• הוספת תמיכה ב-PinnableContainer ל-TransformingLazyColumn (Id3dc9, ‏ b/492418172)

תיקוני באגים

• נוספו עדכונים לתיעוד ברמת המודול של Wear Compose Foundation,‏ Material 3 ו-Navigation 3. (I111d7, b/498153783)
• תוקנה בעיה ב-ScreenScaffold שבה קומפוזיציות חוזרות יכלו לגרום ל-ScrollInfoProvider שלא נשמרו לאפס את מצב המעקב אחר הגלילה. (I8be02, b/524620765)
• שגיאה בכתובת IllegalArgumentException: maxWidth must be >= than minWidth שנגרמת בגלל מרווחים אופקיים גדולים (I014e8, ‏ b/531192734)
• תיקון אנימציית EdgeButton בהטלה מהירה. (I9657f, ‏ b/512700520)

גרסה ‎1.7.0-alpha06

‫15 ביולי 2026

‫androidx.wear.compose:compose-*:1.7.0-alpha06 מופץ. גרסה ‎1.7.0-alpha06 מכילה את השמירות האלה.

שינויים ב-API

• העברה של רכיבי ה-Composable‏ ButtonContent, ‏ AppCardContent ו-TitleCardContent ל-Material3 לאובייקטים ButtonDefaults ו-CardDefaults בהתאמה. (I8d589, ‏ b/527889640)
• הסרת ערך ברירת המחדל מהפרמטר Modifier.oneHandedGesture gestureLabel (‏Ica100, ‏b/527068051)
• משנים את השם של gestureLabel ל-onGestureLabel ב-Modifier.oneHandedGesture והופכים אותו ל-nullable, כדי לשמור על עקביות עם פרמטרים אחרים של contentDescription (I952a8, b/527068051)
• הוספנו את OneHandedGestureIndicatorState כדי לתאם את הנראות והאנימציה בין Modifier.oneHandedGesture() לבין אינדיקטורים של תנועות. כדי לשפר את השליטה במחזור החיים, מחליפים את InteractionSource בגישה הזו שמבוססת על מצב. כדי לשמור על עקביות עם פונקציות אחרות של גלילה בתנועות ברירת מחדל, מוסיפים את הפרמטר wrapAround ל-OneHandedGestureDefaults.scrollToNextPage. (I9e1e3, b/522761843)

תיקוני באגים

• Clarify interactionSource documentation for Modifier.oneHandedGesture to state which interactions are emitted (I2dc8d)
• התמיכה במחוות ביד אחת ב-AlertDialog הוסרה זמנית כברירת מחדל, בגלל בעיות בתלות ב-Wear SDK בצרכנים שלא משתמשים ב-Wear SDK או במחוות ביד אחת. (Ib19e0, b/503841738)
• שיפרנו את TransformingLazyColumn כדי לתמוך באנימציות של מיקום פריטים שיוצאים מאזור התצוגה, כך שהם יגלשו אל מחוץ למסך במקום לדהות. תוקנה גם בעיה חזותית של הצמדה, שבה פריטים שגודלם שונה באופן דינמי היו נצמדים באופן מיידי לגובה היעד שלהם במהלך אנימציות של מיקום (I89d84, b/525071281)
• בשדה firstVisibleItemLayoutItemInfo צריך למלא סוג של ItemInfo שמבוסס על אינדקס. (I256e3, b/527881678)
• תוקן אופן הפעולה של אנימציה TimePicker כשההגדרה 'תנועה מופחתת' מופעלת. (Ic9150, ‏ b/467288916)

גרסה ‎1.7.0-alpha05

‫1 ביולי 2026

‫androidx.wear.compose:compose-*:1.7.0-alpha05 מופץ. גרסה ‎1.7.0-alpha05 מכילה את השמירות האלה.

שינויים ב-API

• הוספנו את הממשק TransformingLazyColumnFirstLayoutItemProvider ב-Foundation כדי לאפשר התאמה אישית של תוכן שמשנה כיוון במהלך עדכוני תוכן, יחד עם הטמעות מוכנות לשימוש של rememberTransformingLazyColumnFirstLayoutItemProvider ו-rememberTransformingLazyColumnFirstVisibleItemProvider ב-Material3. (I54814, ‏ b/503353428)

• השם של פרמטר ברירת המחדל שונה מ-current ל-centerItem ב-TransformingLazyColumnFirstLayoutItemProvider. נוספו TransformingLazyColumnState תוספים firstVisibleItemLayoutItemInfo ו-layoutItemInfoOf, ו-rememberTransformingLazyColumnFirstLayoutItemProvider עודכן כדי להשתמש ב-lambda נקי שמבוסס על פרמטרים. ‫(I9a8d9, ‏ b/503353428)

• הוספת עומסים יתרים לתוכן של לחצן וכרטיס Material3 עם כמה משבצות, לשימוש במחוות ביד אחת. (I74ccb, ‏ b/515718015, ‏ b/490343658)

• הוספת תמיכה בנגישות לתנועות ביד אחת. (I0054d, ‏ b/519085906)

• שינוי השם של OneHandedGestureDefaults.scrollToNextItem() ל-OneHandedGestureDefaults.scrollDownToNextItem והוספת הפרמטר wrapAround לפונקציות הגלילה OneHandedGestureDefaults (I940ce, ‏ b/509639667)

• מוסיפים את Modifier.oneHandedGesture() אם המפתח לא ניתן להרכבה והמפתח רוצה לספק אותו באופן ידני. (I191e1, b/504712626)

• שינוי השם של offsetOf API ב-RevealState ל-positionOf. ‫(I2675f, ‏ b/522387997)

• הוספנו את הפרמטר actionContentSpacing ל-SwipeToReveal, כדי לאפשר למפתחים להתאים אישית את המרחק בין משבצות הפעולה לבין התוכן. (I2abaf, b/507073912)

תיקוני באגים

• תוקנה בעיה ב-ScreenScaffold שבה קומפוזיציות חוזרות יכלו לגרום ל-ScrollInfoProvider שלא נשמרו לאפס את מצב המעקב אחר הגלילה. (I98f6d, b/524620765)
• TransformingLazyColumn צבע פס הגלילה משתנה בהתאם לצבע הרקע של אינדיקטור התנועה במהלך האנימציה של האינדיקטור (I353fb, b/524915104)
• התפקיד של OneHandedGestureIndicator שונה על ידי gestureIndicatorTint (I1abd3, b/524228063). התפקיד החדש הוא LocalContentColor
• הגדרת פרמטרים לתיאור התוכן של כלי לבחירת יום ושנה DatePicker כדי לתמוך בלוקליזציה. (I5dcd9, b/430563857)
• הוספנו ל-GestureIndicators תדירויות תצוגה דינמיות, בהתאם למיקום העיבוד של האינדיקטור – בתוך רכיב ממשק המשתמש המארח או מחוצה לו. (Ic618f, b/515071642)
• תוקנה בעיה של שימוש בו-זמני בתכונה כשמפעילים מחוות ביד אחת (I7b95f, b/512086558)

גרסה ‎1.7.0-alpha04

‫3 ביוני 2026

‫androidx.wear.compose:compose-*:1.7.0-alpha04 מופץ. גרסה ‎1.7.0-alpha04 מכילה את השמירות האלה.

שינויים ב-API

• נוספו הפונקציות RevealState.drag(), SwipeToRevealDragScope, ונחשף flingBehavior מותאם אישית ב-SwipeToReveal כדי לאפשר שליטה פרוגרמטית בתנועות החלקה, בהיסטים ובאנימציות של התייצבות. (Ibfe56, [b/484185090]
• ההרחבה OneHandedGestureIndicator תומכת עכשיו גם בפעולות ראשיות וגם בפעולות סגירה, והארכיטקטורה שלה הועברה ל-InteractionSource לצורך ניהול אוטומטי של מחזור החיים. (I7e893, [b/512836472]
• נוספה גלילה חדשה שמבוססת על מחוות לרכיבים שמבוססים על ScalingLazyColumn ולתיבות דו-שיח של התראות. העדכון הזה כולל גלילה של 50% מהמסך כברירת מחדל כדי לשפר את יכולת החיזוי, וגם מצב אופציונלי של הצמדה לפריט לניווט מדויק. (Ie9cfb, [b/509639667]
• מחליפים את הדגל isOneHandedGesturesInAlertDialogEnabled של Wear Compose Material3 בדגל LocalOneHandedGestureEnabled CompositionLocal, שאפשר להשתמש בו כדי להשבית תנועות ביד אחת בהיררכיות של רכיבים. (Ib9240, [b/516777416]
• הוצא משימוש ButtonDefaults.‫ExtraSmallIconSize ו-ButtonDefaults.SmallIconSize. ברירות המחדל האלה היו ספציפיות ל-CompactButton והועברו ל-CompactButtonDefaults.‫ExtraSmallIconSize וגם CompactButtonDefaults‫SmallIconSize בהתאמה. (Id747c, [b/513588028]

תיקוני באגים

• תיקון אנימציית EdgeButton בהטלה מהירה. (I88215, [b/512700520]
• תיקון של AppScaffold TimeText שלא מתעדכן בהרכבה מחדש. (Iecea5, [b/512439755]
• ‫ScreenScaffold צריך להשתמש באופן מפורש ב-PaddingValues שסופק על ידי ביטוי ה-lambda של התוכן הפנימי. (I20d71, [b/512355364]
• הוספנו את ההערות @FrequentlyChangingValue ו-@RememberInComposition כדי לספק אזהרות של lint ולמנוע בעיות בביצועים שנגרמות מקריאה של עדכוני סטטוס בתדירות גבוהה או מאי-זכירה של אובייקטים במהלך ההרכבה. (I955f4, [b/409488336]
• כשמפעילים תנועת יד אחת עבור רכיבי Button composable, חשוב לוודא שאפקט האדווה מתחיל ממרכז הלחצן. (Ie61ec, [b/514600304]
• נפתרה בעיה של התנגשות מפתחות ב-Modifier.oneHandedGesture על ידי שילוב של פעולת תנועה ועדיפות במפתח שנוצר אוטומטית. (I49760, [b/517045657]

גרסה ‎1.7.0-alpha03

‫19 במאי 2026

‫androidx.wear.compose:compose-*:1.7.0-alpha03 מופץ. גרסה ‎1.7.0-alpha03 מכילה את השמירות האלה.

שינויים ב-API

• מוסיפים את Modifier.oneHandedGesture() אם המפתח לא ניתן להרכבה והמפתח רוצה לספק אותו באופן ידני. (I191e1, b/504712626)
• הסרת אינדיקטורים של תנועות מ-OneHandedGestureDefaults והוספת תמיכה בצבעים לתנועות של יד אחת (I7934f, ‏ b/505009712, ‏ b/504712626)
• הוספנו טיפול מפורש בתנועות של יד אחת לסגירת האפליקציה בגרסה AlertDialog. (Id71e8, b/509675781)
• ‫DeferredTargetAnimation כבר לא ניסיוני, צריך להסיר את ההסכמה. (I1e4ae, b/500030165)

תיקוני באגים

• תוקנה בעיה של שימוש בו-זמני בתכונה כשמפעילים מחוות ביד אחת (I7b95f, b/512086558)
• תוקנה בעיה שבה אינדיקטורים של מחוות ביד אחת משתקפים על סמך כיוון היד ולא על סמך LayoutDirection. (I6db5d, ‏ b/512003346)
• תיקון שרטוט הגבול בפריטים של TLC ‏ (I0c3c1, ‏ b/510772213)
• נוספו תצוגות מקדימות של תמונות בתוך השורה לדוגמאות ב-Kdoc עבור SurfaceTransformation.kt, ‏ SwitchButton.kt ו-TextButton.kt. התמונות האלה יוצגו עכשיו במסמכי התיעוד של דפי Wear Compose Material 3 DAC, ויספקו למפתחים הקשר חזותי מיידי לכל וריאציה ולכל דוגמה של לחצן. (Ib53ae, ‏ b/484905061)
• נוספו תצוגות מקדימות של תמונות מוטמעות לכל הדוגמאות ב-Kdoc של Button.kt. התמונות האלה יוצגו עכשיו ישירות במסמכי התיעוד בדפי ה-DAC של Material 3 ב-Wear Compose, ויספקו למפתחים הקשר חזותי מיידי לכל וריאציה ודוגמה של לחצן. (Ie2fb5, ‏ b/484905061)
• הוספנו תצוגות מקדימות של תמונות בתוך הטקסט לדוגמאות ב-KDoc ב-Card.kt, ב-IconButton.kt, ב-LevelIndicator.kt וב-ListHeader.kt. התמונות האלה יוצגו עכשיו במסמכים של דפי Wear Compose Material 3 DAC. (I371bc, ‏ b/484905061)
• הוספנו תצוגות מקדימות של תמונות בתוך הטקסט לדוגמאות ב-KDoc עבור Picker,‏ SegmentedCircularProgressIndicator,‏ Slider ו-Stepper. התמונות האלה יוצגו עכשיו במסמכי התיעוד של דפי Wear Compose Material 3 DAC, ויספקו למפתחים הקשר חזותי מיידי לגבי הרכיבים והדוגמאות האלה. (I6c6ef, ‏ b/484905061)
• נוספו תצוגות מקדימות של תמונות בתוך השורה לדוגמאות ב-KDoc עבור CheckboxButton,‏ SplitCheckboxButton,‏ CircularProgressIndicator,‏ ConfirmationDialog,‏ SuccessConfirmationDialog,‏ FailureConfirmationDialog ו-curvedText. התמונות האלה יוצגו עכשיו במסמכי התיעוד של דפי Wear Compose Material 3 DAC, ויספקו למפתחים הקשר חזותי מיידי לגבי הרכיבים והדוגמאות האלה. ‫(Ie4662, ‏ b/484905061)
• Fix AlertDialogScreenshotTest test (I9be58, b/508678506)
• הוספנו תצוגות מקדימות של תמונות בתוך השורה לדוגמאות ב-KDoc עבור NonClickableCard,‏ OpenOnPhoneDialog,‏ VerticalPageIndicator,‏ VerticalPagerScaffold ו-RadioButton. התמונות האלה יוצגו עכשיו במסמכי התיעוד של דפי Wear Compose Material 3 DAC, ויספקו למפתחים הקשר חזותי מיידי לגבי הרכיבים והדוגמאות האלה. (I2aa2d, ‏ b/484905061)

גרסה ‎1.7.0-alpha02

‫6 במאי 2026

‫androidx.wear.compose:compose-*:1.7.0-alpha02 מופץ. גרסה ‎1.7.0-alpha02 מכילה את השמירות האלה.

תיקוני באגים

• מידה קבועה של GestureIndicator בAlertDialogs (I0c16e, ‏ b/504912009)
• בוצעו התאמות ב-LeftRevealed/RightRevealed עוגנים של SwipeToReveal למיקום מודעות שמוצגות מחוץ לגבולות. (Id84ff, ‏ b/498681589)
• הוספת תיאור של המדינה ל-Checkbox ול-Switch (Iba12e, ‏ b/485098874)
• תוקן באג ויזואלי ב-FadingExpandingLabel שגרם לטקסט ישן להבהב כשמספר השורות קטן. (Ia40c9, ‏ b/503709020)
• הוספת תמיכה בתנועות ביד אחת כברירת מחדל ל-Material3 AlertDialog (I5848e, b/479098589)
• הוסרה לוגיקת הניראות המובנית במצב הפעלה ביד אחת (I8c602, b/502903320)

גרסה ‎1.7.0-alpha01

‫8 באפריל 2026

‫androidx.wear.compose:compose-*:1.7.0-alpha01 מופץ. גרסה ‎1.7.0-alpha01 מכילה את השמירות האלה.

שינויים ב-API

• הוספנו API חדש לתנועות ביד אחת, שבו אפשר לרשום קריאות חוזרות עם עדיפות לפעולות ראשיות ולפעולות של סגירה. המערכת מזהה באופן אוטומטי את היעד הרלוונטי ביותר במסך כדי לוודא שהמחוות והאינדיקטורים שלהן מופעלים רק עבור רכיבים שהמשתמש יכול לראות ולקיים איתם אינטראקציה. מוסיפים את Modifier.oneHandedGesture לקומפוזבילי שמשויך למחוות (למשל, Button) ומשתמשים ב-OneHandedGestureDefaults.GestureIndicator כדי לציין למשתמש מתי פעולת המחוות זמינה. אפשר להפעיל גלילה וחלוקה לדפים גם באמצעות תנועת ברירת המחדל, ומומלץ להשתמש ב-OneHandedGestureDefaults.scrollDown וב-OneHandedGestureDefaults.scrollToNextPage בקריאות החוזרות (callback). המאפיינים OneHandedGestureDefaults.ScrollGestureIndicator ו-OneHandedGestureDefaults.VerticalPageGestureIndicator מסופקים כחלופות למאפיינים ScrollIndicator ו-PageIndicator בהתאמה, כדי להציג למשתמש באופן זמני אינדיקטור של תנועה. (Ic6324, ‏ b/479098447, ‏ b/485488443)
• נוספה התכונה requestAnchorItem ל-TransformingLazyColumnState והוצגה התכונה TransformingLazyColumnAnchorType כדי לספק למפתחים שליטה מדויקת בכיוון ההרחבה של הפריט ובעיגון הפריסה. (I0c1e6, b/494301025)
• נוסף הדגל isSwipeToRevealDualFlingThresholdEnabled, שמופעל כברירת מחדל, אבל אפשר להשבית אותו אם תיקוני באגים בהתנהגות ההחלקה ב-SwipeToReveal בגרסה הזו גורמים לרגרסיה (במקרה כזה, צריך לדווח על באג בהקדם האפשרי) (Ie6db6, ‏ b/497743775).

תיקוני באגים

• שיפרנו את SwipeToReveal כדי לתמוך בהטלה מהירה, וכך לאפשר למשתמשים לחשוף פעולות באופן מלא בלי קשר למרחק ההחלקה (אפשר להשבית את השינוי הזה על ידי השבתת הדגל isSwipeToRevealDualFlingThresholdEnabled). ‫(I833fd, ‏ b/490728860)
• תוקן SwipeToReveal כדי להפעיל את ההחלקה המלאה כשמחליקים מעל 75% מרוחב המסך (אפשר להשבית את השינוי הזה על ידי השבתת הדגל isSwipeToRevealDualFlingThresholdEnabled). (Id5604, b/490728860)
• הוספנו משוב הפטי שני ל-SwipeToReveal כשההחלקה מגיעה למצב של חשיפה חלקית (אפשר להשבית את השינוי הזה על ידי השבתת הדגל isSwipeToRevealDualFlingThresholdEnabled). ‫(Ic27e3, ‏ b/492273799)
• תוקנה בעיה ב-TransformingLazyColumn שגרמה להפסקת הפעולה של אנימציות של פריטים (Modifier.animateItem). (I904ec, ‏ b/493167084)
• תוקן באג ב-PickerGroup (ולכן גם ב-DatePicker) כדי למנוע מצב שבו כמה נגיעות גורמות לגלילה לא מכוונת בעמודות של כלי הבחירה שלא נבחרו (Id76c5, b/378646798)

גרסה 1.6 של Wear Compose

גרסה 1.6.2

‫19 במאי 2026

‫androidx.wear.compose:compose-*:1.6.2 מופץ. גרסה 1.6.2 מכילה את השמירות האלה.

תיקוני באגים

• תיקון של ציור גבולות בפריטים מסוג TransformingLazyColumn (I0c3c1, b/510772213)

• צריך לתקן את ההקצאה של itemSpacing בשיטת המדידה של תוכן עם ריווח פנימי TransformingLazyColumn (I12d2f, ‏ b/498137919)

גרסה 1.6.1

‫8 באפריל 2026

‫androidx.wear.compose:compose-*:1.6.1 מופץ. גרסה 1.6.1 מכילה את השמירות האלה.

תיקוני באגים

• תוקנה בעיה שבה אנימציות של פריטים (באמצעות Modifier.animateItem) הפסיקו לפעול ב-TransformingLazyColumn. (I904ec, ‏ b/493167084)

גרסה 1.6.0

‫25 במרץ 2026

‫androidx.wear.compose:compose-*:1.6.0 מופץ. גרסה 1.6.0 מכילה את השמירות האלה.

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

• השקנו את ספריית Wear Compose Navigation3, שמשתלבת עם הרכיבים NavDisplay ו-SceneStrategy של ספריית Navigation 3, ומוסיפה לוגיקה של החלקה לסגירה שספציפית ל-Wear באמצעות SwipeDismissableSceneStrategy החדש שלנו.
• נוסף תמיכה ב-TransformingLazyColumn עבור reverseLayout, הצמדה באמצעות TransformingLazyColumnDefaults.snapFlingBehavior ו-Modifier.minimumVerticalContentPadding, שמאפשרת להגדיר מרווח פנימי מועדף לתוכן של פריטים ברשימה כשהם נמצאים בקצוות העליונים או התחתונים.
• נוספו עומסים חדשים ל-AlertDialog שמשתמשים ב-TransformingLazyColumn כדי לשמור על עקביות עם גלילה במסכים אחרים של Material3.
• שיפרנו את הרינדור של טקסט מעוקל, במיוחד בגופנים כתביים, באמצעות פרמטר חדש של עיוות טקסט, CurvedTextStyle warpOffset, שמופעל כברירת מחדל ב-API מגרסה 34 ואילך.
• הוספנו את LocalAmbientModeManager, CompositionLocal חדש שתומך בהגדרת ממשק משתמש והתנהגות שונים למצבים אינטראקטיביים ולמצבי סביבה.
• רשימה מלאה יותר של התכונות שהושקו בגרסה 1.6.0 זמינה בהערות על גרסת beta01

גרסה ‎1.6.0-rc01

‫11 במרץ 2026

‫androidx.wear.compose:compose-*:1.6.0-rc01 מופץ. גרסה ‎1.6.0-rc01 מכילה את השמירות האלה.

• בגרסה הזו, גרסת Compose for Wear OS 1.6.0 עודכנה לגרסה מועמדת להפצה, אבל אין שינויים משמעותיים אחרים לעומת גרסה 1.6.0-beta01.

גרסה ‎1.6.0-beta01

‫25 בפברואר 2026

‫androidx.wear.compose:compose-*:1.6.0-beta01 מופץ. גרסה ‎1.6.0-beta01 מכילה את השמירות האלה.

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

• ספריית Wear Compose Navigation3, שמשולבת עם רכיבי NavDisplay ו-SceneStrategy של ספריית Navigation 3, ומוסיפה לוגיקה של החלקה לסגירה שספציפית ל-Wear באמצעות SwipeDismissableSceneStrategy החדש שלנו.
• נוסף תמיכה ב-TransformingLazyColumn עבור reverseLayout, הצמדה באמצעות TransformingLazyColumnDefaults.snapFlingBehavior ו-Modifier.minimumVerticalContentPadding, שמאפשרת להגדיר מרווח פנימי מועדף לתוכן של פריטים ברשימה כשהם נמצאים בקצוות העליונים או התחתונים.
• נוספו עומסים חדשים ל-AlertDialog שמשתמשים ב-TransformingLazyColumn כדי לשמור על עקביות עם גלילה במסכים אחרים של Material3.
• שיפרנו את הרינדור של טקסט מעוקל, במיוחד בגופנים כתביים, באמצעות פרמטר חדש של עיוות טקסט, CurvedTextStyle warpOffset, שמופעל כברירת מחדל ב-API מגרסה 34 ואילך.
• הוספנו את LocalAmbientModeManager, CompositionLocal חדש שתומך בהגדרת ממשק משתמש והתנהגות שונים למצבים אינטראקטיביים ולמצבי סביבה.
• העדכון של TimePicker כולל תמיכה בסוג חדש של MinutesSeconds ופרמטר חדש של initialSelection שמאפשר לציין את רכיב הזמן שנבחר בהתחלה.
• עומסים חדשים בכרטיסים כדי לספק וריאציות לא ניתנות לקליק, שבהן הכרטיסים הם רק להצגה ולא מיועדים להגיב לקליקים של משתמשים.
• נוספה התכונה LocalRippleConfiguration כדי לשלוט במראה של האפקט.
• הוספנו את הפרמטר snapSensitivity ל-RotaryScrollableDefaults.snapBehavior, ועכשיו PagerScaffoldDefaults כולל את ערכי ברירת המחדל המומלצים ל-SnapPositionalThreshold ול-HighSnapPositionalThreshold לשימוש עם PagerDefaults.snapFlingBehavior.

שינויים ב-API

• שינינו את השם של ערכי ברירת המחדל המומלצים של Modifier.minimumVerticalContentPadding מ-minimumListVerticalContentPadding ל-minimumVerticalListContentPadding כדי להדגיש שהריווח הפנימי הזה מתייחס לרשימה, ועדכנו את התיעוד שקשור לכך. ‫(I496ca, ‏ b/426154225)
• מעכשיו, טקסט מעוקל עובר עיוות כברירת מחדל, מה שמשפר את הרינדור של טקסט מעוקל, במיוחד בגופנים כתביים. (I6979d, ‏ b/450526792, ‏ b/481617443)

תיקוני באגים

• תיקון האינטראקציה בין רכיבי TLC‏ animateItem ו-minimumVerticalContentPadding. (Ia865c, b/483663045)
• ההגדרה 'הזחה מעוותת לטקסט מעוקל' מופעלת עכשיו כברירת מחדל רק ב-API מגרסה 34 ואילך, בגלל תלות ב-PathIterator מהספרייה androidx.graphics.path שלא זמינה לבדיקות של מפתחים ב-Robolectric לפני API מגרסה 34 (ולכן היא פוגעת בבדיקות קיימות של מפתחים). (Ie5bae, ‏ b/484319336)
• שיפור של טקסט מעוקם. (If2b34, ‏ b/483390353)
• בוצע עדכון ב-ConfirmationDialogDefaults.SuccessIcon כדי להתעלם מכיוון הפריסה מימין לשמאל, כך שסימן הווי לא יתהפך. (Ic6add, ‏ b/481966029)

גרסה ‎1.6.0-alpha10

‫11 בפברואר 2026

‫androidx.wear.compose:compose-*:1.6.0-alpha10 מופץ. גרסה ‎1.6.0-alpha10 מכילה את השמירות האלה.

שינויים ב-API

• השם של Modifier.responsiveVerticalPadding השתנה ל-Modifier.minimumVerticalContentPadding, עם פרמטרים של ריווח פנימי בתור Dp, במקום הממשק ResponsiveVerticalPadding. העברנו את ברירות המחדל המומלצות מ-ResponsiveVerticalPaddingDefaults לאובייקטים של ברירות מחדל ספציפיות לרכיבים, כמו ButtonDefaults,‏ CardDefaults וכן הלאה (Icaab2,‏ b/426154225)
• נוסף WearComposeFoundationFlags.isTransformingLazyColumnClickableThresholdEnabled כדי לשלוט בפונקציונליות החדשה שהושקה ב-TransformingLazyColumn. עכשיו המערכת מתעלמת מקליקים מעבר לסף של 20dp בחלק העליון והתחתון של הפריסה, כדי למנוע הקשות מקריות במקרים שבהם הפריט גלוי רק באופן חלקי. בנוסף, עדכנו את השינוי כך שהוא יחול רק על קליקים על פריטים בקצה באירועים שנמצאים בתוך אזור המגע, כדי למנוע התעלמות מתנועות גרירה. (I1ba28, ‏ b/480910891)
• ‫rememberAmbientModeManager משתמש עכשיו ב-LocalActivity בהטמעה שלו כדי לקבל את הפעילות הנוכחית, במקום לקבל את הפעילות כפרמטר (Idf114, ‏ b/473603258)
• הוספנו את האפשרות להרחבה של AmbientMode (I92cc3, b/473603258)
• בוצע עדכון של rememberSwipeDismissableSceneStrategyState כדי להסיר את הפרמטר swipeToDismissBoxState, כי זהו פרט הטמעה רק עד API 35 ‏ (I5907c, ‏ b/476105162)
• ‫[TLC] נוסף Modifier.responsiveVerticalPadding ל-TransformingLazyColumn, שמאפשר התאמות אוטומטיות של מרווחים פנימיים בתוכן בהתאם להנחיות העיצוב של Material 3 ב-Wear OS. (Ia7e73, b/426154225)

תיקוני באגים

• עדכון TransformingLazyColumn התנאי של אחזור מראש כדי שהדחיפות תחושב על סמך קצוות אזור התצוגה ללא ריווח פנימי (I48d85, ‏ b/476420552)
• ‫Picker תומך עכשיו בשקיפות חלקה ברקעים מותאמים אישית כמו מעברי צבע או תמונות, על ידי העברת Color.Unspecified כ-gradientColor של הכלי לבחירת צבעים. ב-TimePicker וב-DatePicker, אפשר להשיג את ההשפעה הזו על ידי שינוי מקומי של MaterialTheme.colorScheme.background ל-Color.Unspecified. (Icc476, b/458429791, b/458429791)
• הוספנו סף של 20dp ללחיצה על פריטים TransformingLazyColumn בחלק העליון והתחתון של המסך, כדי למנוע הקשות מקריות כשהפריטים מוסתרים ברובם. (I2c9cb, ‏ b/443285887)
• שיפור הטיפול בתנועה מופחתת ב-OpenOnPhoneDialog. (Ib1d12, b/48558283)

גרסה ‎1.6.0-alpha09

‫28 בינואר 2026

‫androidx.wear.compose:compose-*:1.6.0-alpha09 מופץ. גרסה ‎1.6.0-alpha09 מכילה את השמירות האלה.

שינויים ב-API

• שינוי השם של PagerScaffoldDefaults.SnapPositionalThreshold לLowSnapPositionalThreshold ושל RotaryScrollableDefaults.SnapSensitivity לLowSnapSensitivity (I157ee, ‏ b/449949891)
• הוסר משנה מ-SwipeDismissableSceneStrategy. ‫(Iff30f, ‏ b/449949891)

תיקוני באגים

• תיקון של השהיית אנימציה של גלילה מעבר לקצה בסיבוב בהתנהגות של הצמדה (I7db89, b/474016470)
• תיקון של SwipeDismissableSceneStrategy חסימת המערכת בגרסה 36 ואילך של API‏ (Icf20b, ‏ b/476105162)
• תיקון האנימציה SwitchButton כך שהיא תתבצע כשינוי גודל או כהדהייה של צורה שלמה (I7a7eb, ‏ b/378644361)
• שיפור CheckboxButton אנימציית המעבר של סמל הסימון (I89944, b/378646769)

גרסה ‎1.6.0-alpha08

‫14 בינואר 2026

‫androidx.wear.compose:compose-*:1.6.0-alpha08 מופץ. גרסה ‎1.6.0-alpha08 מכילה את השמירות האלה.

שינויים ב-API

• הפונקציה RotaryScrollableDefaults.snapBehavior עודכנה כך שהיא מקבלת פרמטר מסוג float‏ snapSensitivity, והפונקציה PagerScaffoldDefaults מפרסמת עכשיו את ערכי ברירת המחדל המומלצים SnapPositionalThreshold ו-HighSnapPositionalThreshold לשימוש עם PagerDefaults.snapFlingBehavior. (I7e11c, b/449949891)
• הוספנו תמיכה בהצמדה ל-TransformingLazyColumn גם לקלט מגע וגם לחוגה להזנת נתונים. כשמגדירים את ההצמדה, מומלץ לספק גם את flingBehavior באמצעות TransformingLazyColumnDefaults.snapFlingBehavior וגם את rotaryScrollableBehavior באמצעות RotaryScrollableDefaults.snapBehavior כדי להבטיח חוויה עקבית. ‫(I5326f, ‏ b/422455104)
• הוספנו את LocalAmbientModeManager, קומפוזבילי חדש שמאפשר להגדיר בקלות ממשקי משתמש והתנהגויות שונים למצבים אינטראקטיביים ולמצבי סביבה. (I00161, ‏ b/427724331)

תיקוני באגים

• תוקנה בעיה שבה רשימות עם התנהגות של הצמדה סיבובית לא קפצו חזרה אחרי גלילה מעבר לקצה. ‫(I05216, ‏ b/470317969)
• תוקנה בעיה באפקט האדווה של הלחצנים להגדלה ולהקטנה ברכיב Material3 Slider. אפקט האדווה מתרחב עכשיו לרוחב המלא של רכיב פס ההזזה. (I8c0c4, b/378658409)

גרסה ‎1.6.0-alpha07

‫17 בדצמבר 2025

‫androidx.wear.compose:compose-*:1.6.0-alpha07 מופץ. גרסה ‎1.6.0-alpha07 מכילה את השמירות האלה.

שינויים ב-API

• נוסף ארטיפקט של ספרייה wear-compose:compose-navigation3 (‏I01b5c, ‏b/427463127)
• נוסף SwipeDismissableSceneStrategy לשילוב עם Wear‏ עם Navigation3. אפשר להשתמש בו עם NavDisplay כדי להציג תוכן של Wear Compose. ‫(I7aa08, ‏ b/427463127)
• השקנו את ResponsiveTransformingLazyColumn, רכיב חדש של Material3 שמבוסס על TransformingLazyColumn מ-wear compose foundation. הרכיב מחשב ומחיל באופן אוטומטי ריווח אנכי דינמי בהתאם לסוג התוכן של הרשימה. (I102f4, b/426154225)

תיקוני באגים

• תוקנה בעיה שגרמה לכך ש-PageIndicator לא נמשך מחדש כמו שצריך כשאינדקס הדף הנוכחי בתוך PagerState השתנה (למשל, על ידי קריאה ל-scrollToPage() או שימוש ב-animateScrollToPage() עם תנועה מופחתת). (I97150, ‏ b/465669950)
• תיקון סמנטיקה של TransformingLazyColumn חישוב scrollOffset (Idec30, ‏ b/417941554)
• תוקן הרווח הפנימי של פעולת הביטול SwipeToReveal (I770f8, ‏ b/382259843)
• הוטמעה PredictiveBackScene כדי לטפל ב-Navigation3 ב-API36 ומעלה. (Idedf6, ‏ b/427463127)

גרסה ‎1.6.0-alpha06

‫3 בדצמבר 2025

‫androidx.wear.compose:compose-*:1.6.0-alpha06 מופץ. גרסה ‎1.6.0-alpha06 מכילה את השמירות האלה.

שינויים ב-API

• נוספה האפשרות LocalRippleConfiguration לשליטה במראה של האדווה (I9e0fa, b/382336566)
• נוספו עומסים חדשים ל-AlertDialog שמשתמשים ב-TransformingLazyColumn כדי לספק שליטה מתקדמת באנימציות של גלילת פריטים. שיפורים בפריסה למסכים גדולים יותר. (I862ff, ‏ b/438468382)
• נוסף פרמטר טרנספורמציה ל-ButtonGroup, לשימוש עם מאגרי תגים שמשתנים באופן דינמי כמו TransformingLazyColumn. (I8743b, ‏ b/453710565)

תיקוני באגים

• תיקון בעיה שגורמת להצגה של הכותרת AlertDialog והלחצנים 'אישור' או 'ביטול' כמה פעמים בכתיבת הודעה (I8e1b0, b/463955367)
• הופכים את הקוד TimeText ליציב יותר כשמאזינים לשינויים ב-TimeZone. (I1c276, b/457909952)
• שיפור הביצועים של SplitRadioButton ושל SplitCheckboxButton על ידי הפחתת מספר ההרכבות מחדש. ‫(I3ddc9, ‏ b/455845192)

גרסה ‎1.6.0-alpha05

‫19 בנובמבר 2025

‫androidx.wear.compose:compose-*:1.6.0-alpha05 מופץ. גרסה ‎1.6.0-alpha05 מכילה את השמירות האלה.

שינויים ב-API

• הוספנו את RotarySnapSensitivity להתנהגות של הצמדה סיבובית ואת PagerSensitivity להתנהגות של העברת דפים, כדי לאפשר לאפליקציות לשנות את רמת הרגישות של התנהגות סיבובית והעברת דפים, במיוחד עבור מכשירי פייג'ר. (Ic3a83, b/449949891)
• שינויים פשוטים ב-rememberTransformingLazyColumnState שבוצעו עם ההשקה של פריסה הפוכה ל-TransformingLazyColumn, איחוד לפונקציה אחת ושימוש בערך sentinel כדי להשתמש באינדקס ברירת המחדל של העוגן. ‫(I09302, ‏ b/453731755)
• נוסף ערך ברירת מחדל חדש GenericFailureIcon לשימוש ב-FailureConfirmationDialog, שכולל סמל שגיאה גנרי. השם של FailureIcon שונה ל-ConnectionFailureIcon. (I8e965, b/453730430)

תיקוני באגים

• שיפרנו את TimePicker כך שהוא ינתח דפוסים מורכבים של לוקאל בצורה טובה יותר. (I7b169, ‏ b/456538838)
• תוקן הפריסה הראשונית של TransformingLazyColumn כש-verticalArrangement הוא Arrangement.Center. ‫(Id18ef, ‏ b/451481233)
• התאמה של ה-constructor‏ TransformingLazyColumnState לפונקציה rememberTransformingLazyColumnState (I36d6a, ‏ b/453731755)
• הסמל של סימן הוי ב-CheckboxButton עודכן לצורה מעוגלת. (Ie645e, ‏ b/378645751)
• הסמל של סימן הוי ב-SwitchButton עודכן לצורה מעוגלת. ‫(I31fbf, ‏ b/378642590)
• תוקן היסט scrollToItem ב-TransformingLazyColumn שגרם להיפוך כיוון הגלילה. ‫(Ib2c93, ‏ b/451481233)
• שיפור הביצועים של SwitchButton ושל SplitSwitchButton. (I708de, b/448781327)

גרסה ‎1.6.0-alpha04

‫22 באוקטובר 2025

‫androidx.wear.compose:compose-*:1.6.0-alpha04 מופץ. גרסה ‎1.6.0-alpha04 מכילה את השמירות האלה.

שינויים ב-API

• הטמעה של reverseLayout עבור TransformingLazyColumn (I19f9e, ‏ b/352513793)
• הוספנו את ConfirmationDialogDefaults.VariantFailureIcon לשימוש ב-FailureConfirmationDialog. יכול להיות שבמקרים מסוימים עדיף להשתמש בסמל השגיאה הגנרי החדש הזה, במקום בסמל ConfirmationDialogDefaults.FailureIcon שמראה חיבור לא תקין לטלפון. (Ifc851, ‏ b/443115305)

תיקוני באגים

• שיפרנו את הביצועים של הכלי לבחירת קבצים על ידי שינוי מבנה הקוד של השימוש ב-LaunchedEffect. ‫(I94519, ‏ b/418192973)
• תוקן באג ב-SwipeDismissableNavHost ב-API36 ומעלה, שבו לחיצה על הכפתור "הקודם" במהלך אנימציית חיזוי החזרה קטעה את האנימציה והפעילה אותה מחדש. ההטמעה משתמשת עכשיו ב-SeakableTransitionState.animateTo במקום ב-Animatable, מה שמשפר מעט את הביצועים. ‫(I2241f, ‏ b/428156670)
• תוקן באג שקשור לסדר ההכרזות על נגישות ב-AlertDialog, שבו כפתור האישור הוכרז כ-'Button'. 'אישור' במקום 'אישור' הרגיל. כפתור'. ‫(Ic2381, ‏ b/429378202)
• שיפור הנראות של המספר TimePicker במסכים קטנים. (I68386, ‏ b/447625365)
• הסרנו את הפיצול של Lazy Layout מ-Wear Compose Foundation – המשמעות היא ש-TransformingLazyColumn משתמשת עכשיו בהטמעה של Lazy Layout ב-Compose Foundation, כולל אחזור מראש, ונהנית משיפור בביצועים של תזמוני פריימים ברוב המקרים. (Idd743, ‏ b/445911630)

גרסה ‎1.6.0-alpha03

‫8 באוקטובר 2025

‫androidx.wear.compose:compose-*:1.6.0-alpha03 מופץ. גרסה ‎1.6.0-alpha03 מכילה את השמירות האלה.

שינויים ב-API

• נוסף הפרמטר ל-TimePicker כדי לציין את רכיב הזמן שהמיקוד מועבר אליו בהתחלה. ברירת המחדל היא הרכיב הראשון שזמין על סמך הלוקאל וTimePickerType. (Ie5dfe, b/437015874)
• הוסר הפרמטר targetProgress שלא היה בשימוש בשיטה CircularProgressIndicator drawCircularProgressIndicator. ‫(Ieeb3c, ‏ b/430544552)

תיקוני באגים

• הטמענו תמיכה חסרה ב-TransformingLazyColumn verticalAlignment – עכשיו יש תמיכה בפריסות רגילות שמבוססות על מיקום בחלק העליון, התחתון או המרכזי. (I2e630, b/444143326)
• שיפור החישוב של רוחב הטקסט המעוקל כדי להתחשב ברווחים לפני ואחרי הטקסט (יכול להיות שיהיו בעיות בצילומי מסך שכוללים טקסט מעוקל, במיוחד אם יש לו רקע כמו TimeText). (I924a4, ‏ b/446601899)
• בוצע עדכון ב-Compose Foundation‏ WarpedCurvedTextRenderer כדי לבחור באפשרות EmojiCompatInitializer מתוך androidx.emoji2, במטרה לתקן שגיאת מחלקה בזמן ריצה. ‫(I589b4, ‏ b/444422736)
• העדכון בוצע בתאריך ScalingLazyColumn כדי להתמקד בצומת שניתן לגלילה באמצעות CollectionInfo, כך שהתכונה תפעל עם חוגה בהקשרים נוספים, כמו ב-Material3 AlertDialog. ‫(I6be3c, ‏ b/445332360)

גרסה ‎1.6.0-alpha02

‫24 בספטמבר 2025

‫androidx.wear.compose:compose-*:1.6.0-alpha02 מופץ. גרסה ‎1.6.0-alpha02 מכילה את השמירות האלה.

שינויים ב-API

• שיפור ברינדור של טקסט מעוקל, במיוחד בגופנים כתביים, עם הצגת עיוות טקסט באמצעות הפרמטר החדש CurvedTextStyle warpOffset. (If5dcb)

תיקוני באגים

• אופטימיזציה של שמירת אנימציות של פריטים במטמון במהלך גלילה ב-TransformingLazyColumn. (I62ae8)
• הווריאציות OpenOnPhoneDialog ו-ConfirmationDialog עודכנו כדי להגדיר את FLAG_KEEP_SCREEN_ON, כך שהאנימציות יפעלו עד הסוף והתיבות יוסתרו באופן אוטומטי כמו שרצינו. (Iad7d4)
• תוקן באג שגרם לקריסה של Modifier.edgeSwipeToDismiss כשמשתמשים בו עם SwipeDismissableNavHost ב-API 36 ואילך. (Ifc13d)
• עדכנו את התיעוד והתגובות שמשויכים לפרמטר החדש CurvedTextStyle warpOffset כדי להתייחס בצורה נכונה למקרה של 'לא צוין'. (I41aa5)

גרסה ‎1.6.0-alpha01

‫10 בספטמבר 2025

‫androidx.wear.compose:compose-*:1.6.0-alpha01 מופץ. גרסה ‎1.6.0-alpha01 מכילה את השמירות האלה.

שינויים ב-API

• נוספו וריאציות לא אינטראקטיביות של Card, TitleCard, OutlinedCard ו-AppCard (I509bb, ‏ b/406690146)
• הוסר הפרמטר interactionSource מממשקי API חדשים של כרטיסים שלא ניתן ללחוץ עליהם. (If0c7a, ‏ b/440323280)
• נוסף סוג MinutesSeconds חדש לרכיב TimePicker, שבו מוצגות רק עמודות של דקות ושניות, והעמודה של השעות מושמטת (Ia9e94, b/438004664)

תיקוני באגים

• תיקון השימוש בפרמטר של שינוי HorizontalPagerScaffold כך ש-HorizontalPager לא יאבד את מחוון הדף אם מוסיפים Modifier.fillMaxSize() (I07ae1, ‏ b/441682601)
• התאמה של כיוון ScrollIndicator לכיוון פריסת התוכן כברירת מחדל. (I0da0f, ‏ b/441489028)
• נפתרה הבעיה ב-ScrollAway כשמשתמשים בו עם TransformingLazyColumn. הגלילה ב-TimeText לא פעלה בצורה תקינה אחרי מעבר למסך אחר וחזרה. ‫(Ic0ef1, ‏ b/433549148)
• תוקן TransformingLazyColumn הדיווח על SCROLL_BACKWARDS ועל SCROLL_FORWARDS סמנטיקה למקרים קיצוניים בחלק העליון או התחתון של המסך. ‫(I5c28d, ‏ b/405205994)
• תיקון באג ב-SwipeDismissableNavHost שגרם לכך שהעברות בתהליך לא סומנו כהושלמו אחרי החלקה אחורה ב-API 36. (Ife72e, ‏ b/441089689)
• כדי למנוע קיטוע של חלק מהתרגומים של 'כדאי לבדוק את הטלפון', צריך לעדכן את ברירת המחדל OpenOnPhoneMaxSweepAngle ל-200 מעלות. (Ib2e4c, b/428243902)

גרסה 1.5 של Wear Compose

גרסה 1.5.6

‫3 בדצמבר 2025

‫androidx.wear.compose:compose-*:1.5.6 מופץ. גרסה 1.5.6 מכילה את השמירות האלה.

תיקוני באגים

• אופטימיזציה של שמירת אנימציות של פריטים במטמון במהלך גלילה ב-TransformingLazyColumn. ‫(I62ae8, b/441701460)
• הווריאציות OpenOnPhoneDialog ו-ConfirmationDialog עודכנו כדי להגדיר את FLAG_KEEP_SCREEN_ON, כך שהאנימציות יפעלו עד הסוף והתיבות יוסתרו באופן אוטומטי כמו שרצינו. ‫(Iad7d4, ‏ b/437986990)
• תוקן באג שגרם לקריסה של Modifier.edgeSwipeToDismiss כשמשתמשים בו עם SwipeDismissableNavHost ב-API 36 ואילך. (Ifc13d, ‏ b/441901722)

גרסה 1.5.5

‫5 בנובמבר 2025

‫androidx.wear.compose:compose-*:1.5.5 מופץ. גרסה 1.5.5 מכילה את השמירות האלה.

תיקוני באגים

• שיפור הנראות של מספר TimePicker במסכים קטנים (I70fbe)

גרסה 1.5.4

‫22 באוקטובר 2025

‫androidx.wear.compose:compose-*:1.5.4 מופץ. גרסה 1.5.4 מכילה את השמירות האלה.

תיקוני באגים

• שיפרנו את הביצועים של הכלי לבחירת קבצים על ידי שינוי מבנה הקוד של השימוש ב-LaunchedEffect. ‫(I94519, ‏ b/418192973)
• תוקן באג ב-SwipeDismissableNavHost ב-API36 ומעלה, שבו לחיצה על הכפתור "הקודם" במהלך אנימציית חיזוי החזרה קטעה את האנימציה והפעילה אותה מחדש. ההטמעה משתמשת עכשיו ב-SeakableTransitionState.animateTo במקום ב-Animatable, מה שמשפר מעט את הביצועים. ‫(I2241f, ‏ b/428156670)
• תוקן באג שקשור לסדר ההכרזות על נגישות ב-AlertDialog, שבו כפתור האישור הוכרז כ-'Button'. 'אישור' במקום 'אישור' הרגיל. כפתור'. ‫(Ic2381, ‏ b/429378202)

גרסה 1.5.3

‫8 באוקטובר 2025

‫androidx.wear.compose:compose-*:1.5.3 מופץ. גרסה 1.5.3 מכילה את השמירות האלה.

תיקוני באגים

• הטמענו תמיכה חסרה ב-TransformingLazyColumn verticalAlignment – עכשיו יש תמיכה בפריסות רגילות שמבוססות על מיקום בחלק העליון, התחתון או המרכזי. (I2e630, b/444143326)

גרסה 1.5.2

‫24 בספטמבר 2025

‫androidx.wear.compose:compose-*:1.5.2 מופץ. גרסה 1.5.2 מכילה את השמירות האלה.

תיקוני באגים

• שיפור האופטימיזציה של שמירת אנימציות של פריטים במטמון במהלך גלילה ב-TransformingLazyColumn. (I62ae8)
• הגרסאות OpenOnPhoneDialog ו-ConfirmationDialog עודכנו כדי להגדיר את FLAG_KEEP_SCREEN_ON, כך שהאנימציות יפעלו עד הסוף והתיבות יוסתרו באופן אוטומטי כמו שרצינו. (Iad7d4)
• תוקן באג שגרם לקריסה של Modifier.edgeSwipeToDismiss כשמשתמשים בו עם SwipeDismissableNavHost ב-API 36 ואילך. (Ifc13d)
• עדכנו את התיעוד והתגובות שמשויכים לפרמטר החדש CurvedTextStyle warpOffset כדי להתייחס בצורה נכונה למקרה של 'לא צוין'. (I41aa5)

גירסה 1.5.1

‫10 בספטמבר 2025

‫androidx.wear.compose:compose-*:1.5.1 מופץ. גרסה 1.5.1 מכילה את השמירות האלה.

תיקוני באגים

• תוקן השימוש בפרמטר modifier של HorizontalPagerScaffold כדי ש-HorizontalPager לא יאבד את מחוון הדף אם מוסיפים Modifier.fillMaxSize() (I07ae1, ‏ b/441682601)
• התאמה של כיוון ScrollIndicator לכיוון פריסת התוכן כברירת מחדל. (I0da0f, ‏ b/441489028)
• נפתרה הבעיה ב-ScrollAway כשמשתמשים בו עם TransformingLazyColumn. הגלילה ב-TimeText לא פעלה בצורה תקינה אחרי מעבר למסך אחר וחזרה. ‫(Ic0ef1, ‏ b/433549148)
• תוקן TransformingLazyColumn הדיווח על SCROLL_BACKWARDS ועל SCROLL_FORWARDS סמנטיקה למקרים קיצוניים בחלק העליון או התחתון של המסך. ‫(I5c28d, ‏ b/405205994)
• תיקון באג ב-SwipeDismissableNavHost שגרם לכך שהעברות בתהליך לא סומנו כהושלמו אחרי החלקה אחורה ב-API 36. (Ife72e, ‏ b/441089689)
• כדי למנוע קיטוע של חלק מהתרגומים של 'כדאי לבדוק את הטלפון', צריך לעדכן את ברירת המחדל OpenOnPhoneMaxSweepAngle ל-200 מעלות. (Ib2e4c, b/428243902)

גרסה 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 זמינה בהערות על גרסת beta01.

גרסה ‎1.5.0-rc02

‫13 באוגוסט 2025

‫androidx.wear.compose:compose-*:1.5.0-rc02 מופץ. גרסה ‎1.5.0-rc02 מכילה את השמירות האלה.

תיקוני באגים

• תוקן באג ב-TimePicker שבו מחרוזות ארוכות ובינלאומיות של התקופה (AM/PM) יכלו לשבור את הפריסה. (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 של pager, צריך לציין את היישור במפורש באמצעות modifier = Modifier.align(Alignment.BottomCenter) עם HorizontalPageIndicator ו-modifier =Modifier.align(Alignment.CenterEnd) עם VerticalPageIndicator. (I3a0ad)
• עכשיו כיוון ההחלקה ב-SwipeToReveal זהה גם ב-LayoutDirections וגם ב-LayoutDirections. (I6d427)
• החזרנו את האפשרות SwipeToReveal למרכוז אנכי של פעולות. אם hasPartiallyRevealedState = true, RevealState צריך להתאפס ל-RevealValue.Covered על ידי המתקשר כשמתבצעת גלילה. (I6473d)
• ‫SwipeDismissableNavHost מעכשיו, התוכן נחתך בצורה נכונה ב-API מגרסה 36 ואילך. (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)
• הוסרה ההפסקה בין הלולאות ב-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 מעכשיו מתעדכן אחרי שינויים במצב המופעל/מושבת של הגודל(If2ddd)
• תוקן באג ב-EdgeButton height שהתרחש במסכים מורכבים עם 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 composables. (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 מכילה את השמירות האלה.

תיקוני באגים

• פרופילים מעודכנים של Baseline לספריות 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 ל-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 הוא רכיב במסך מלא שבדרך כלל משולב עם 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 של SwipeToReveal ב-Wear Compose Material וב-Wear Compose Material3. כדי להמשיך להשתמש בממשקי ה-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 והרוחב מ-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 ל-Thread עובד, כי הוא גרם לבעיות באפליקציות שמנהלות את ה-threading שלהן במהלך הניווט. ‫(I34d02).
• עדכנו את דוגמאות ה-Picker כדי להסיר קריאות מיותרות ל-remember, ובמקום זאת להשתמש ב-rememberUpdatedState ב-Picker כדי לזכור את פונקציית ה-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.5.0-alpha14

‫23 באפריל 2025

‫androidx.wear.compose:compose-*:1.5.0-alpha14 מופץ. גרסה ‎1.5.0-alpha14 מכילה את השמירות האלה.

שינויים ב-API

• כל התלויות של Material SwipeToReveal ב-Foundation SwipeToReveal הועברו לחבילת Material, למשל RevealValue, ‏ RevealDirection, ‏ RevealActionType, ‏ RevealState, ‏ rememberRevealState. מפתחים צריכים לשנות את הייבוא של המחלקות והפונקציות האלה מ-androidx.wear.compose.foundation ל-androidx.wear.compose.material. (Ib7cb8)
• ה-API של HierarchicalFocusCoordinator עודכן כך שיהיה משנה במקום קומפוזיציה.
• הערות לגבי ההעברה:
  • אפשר להחליף את HierarchicalFocusCoordinator(function, content) בהוספת Modifier.hierarchicalFocus(function()) ל-content או לרכיב הניתן להרכבה שמכיל אותו.
  • אפשר להחליף את ActiveFocusListener { if (it) focusRequester.requestFocus() } על ידי הוספת Modifier.hierarchicalFocusRequester(focusRequester)
  • במקרים נדירים אחרים של שימוש ב-ActiveFocusListener, אפשר להשתמש בפרמטר החדש ב-Modifier.hierarchicalFocus
  • אפשר להחליף את focusRequester(rememberActiveFocusRequester()) ב-hierarchicalFocusRequester()
  • אפשר להחליף את val focusRequester = rememberActiveFocusRequester() ב-remember { FocusRequester() } ולהוסיף את Modifier.hierarchicalFocusRequester(focusRequester). (Ie319a)

תיקוני באגים

• הסף של מהירות התנועה שצריך לעבור כדי להפעיל שינוי מצב במחוות החלקה הוגדל ברכיבים הבאים: SwipeToReveal, BasicSwipeToDismissBox ו-SwipeDismissableNavHost (רק ב-API מגרסה 35 ומטה עבור SwipeDismissableNavHost). (If47bf)
• תוקנה בעיה באנימציה כשפריטים חדשים נוספים ל-TransformingLazyColumn. (I589b2)

גרסה ‎1.5.0-alpha13

‫9 באפריל 2025

‫androidx.wear.compose:compose-*:1.5.0-alpha13 מופץ. גרסה ‎1.5.0-alpha13 מכילה את השמירות האלה.

שינויים ב-API

• כדי להשתמש בפרויקטים שפורסמו עם Kotlin 2.0, צריך KGP 2.0.0 או גרסה חדשה יותר (Idb6b5)
• הוספת נכס targetPage אל PagerState (I4de8b)

תיקוני באגים

• למנוע רה-קומפוזיציה מיותרת במהלך חיזוי החזרה. (Iecd6d)
• תוקן הנכס isScrollable של ScrollInfoProvider כך שיחזיר את הערך הנוכחי. (Icbfb8)

גרסה ‎1.5.0-alpha12

‫26 במרץ 2025

‫androidx.wear.compose:compose-*:1.5.0-alpha12 מופץ. גרסה ‎1.5.0-alpha12 מכילה את השמירות האלה.

שינויים ב-API

• שיפור ההטמעה של SwipeToReveal כברירת מחדל של gestureInclusion כך שיתעלמו מתנועות רק אם מצב הרכיב הוא Covered. (I7e3d6)
• ב-SwipeToReveal, הפכנו את bidirectionalGestureInclusion לערך במקום לפונקציה והוספנו את @FloatRange לפרמטר edgeZoneFraction ב-gestureInclusion. (Ica7c3)

תיקוני באגים

• משנים את SwipeToReveal bidirectionalGestureInclusion כדי להחזיר אובייקט במקום מחלקה. (I29597)
• השבתת השימוש בתחושות מישוש בזמן הרצת בדיקות ב-RoboElectric. (I58bd1)
• עדכון SwipeToReveal של שוליים פנימיים בין התוכן לבין לחצני הפעולה, וגם של השוליים הפנימיים בין הסמל לטקסט של לחצני הפעולה. (Ic46cb)

גרסה ‎1.5.0-alpha11

‫12 במרץ 2025

‫androidx.wear.compose:compose-*:1.5.0-alpha11 מופץ. גרסה ‎1.5.0-alpha11 מכילה את השמירות האלה.

שינויים ב-API

• עודכן PagerState, הוסרה Compose Foundation PagerState כמחלקה בסיסית והוספו המאפיינים currentPage, ‏ currentPageOffsetFraction ו-pageCount. ממשק GestureInclusion עודכן, והשם של ה-method שונה ל-ignoreGestureStart. (I4ae07)
• הוספת requireOffset ל-SwipeToDismissBoxState היא הדרך המומלצת לקבל קיזוז של SwipeToDismissBoxState. (I21042)
• נוספה התכונה CurvedModifier.semantics, שתומכת בהתחלה בתיאור תוכן ובאינדקס מעקב (I0b093)
• הוספנו את CurvedModifier.clearAndSetSemantics כדי לספק אמצעי להשבתת הסמנטיקה המעוקלת. CurvedText ממשיך להגדיר כברירת מחדל את תיאור התוכן לטקסט, אבל timeTextCurvedText ו-timeTextSeparator לא מכריזים עכשיו על התוכן שלהם. (I4b568)
• השם של טיפול ברירת המחדל בתנועות החלקה ב-HorizontalPager השתנה ל-PagerDefaults.gestureInclusion. ההתנהגות שמוגדרת כברירת מחדל היא להתעלם רק ממחוות החלקה שמתחילות בקצה הימני של הדף הראשון, ורק כשההגדרה Talkback מושבתת. במקרים אחרים, ההתנהגות שמוגדרת כברירת מחדל היא שהרכיב Pager לא יתעלם ממחוות החלקה, ולכן הן לא יהיו זמינות לטיפול בהחלקה לסגירה. (Iee486)
• נוספה גלילה סיבובית ב-API של rotaryScrollable. הוספנו גלילה מעבר לקצה וגלילה מקוננת להתנהגות של תנועת ההטלה ב-rotaryScrollable. השינוי הזה אמור להביא לפונקציונליות שווה של גלילה מעבר לקצה וגלילה מקוננת בין גלילה במגע לגלילה סיבובית. (I71926)
• הוספנו תמיכה באזור להחלקה מהקצה אל SwipeToReveal. ההתנהגות שמוגדרת כברירת מחדל ב-Foundation SwipeToReveal היא עכשיו שלא לאפשר החלקה כשהתנועה מתחילה מהקצה. התנהגות ברירת המחדל של Material3 SwipeToRevealהיא עכשיו לא לאפשר החלקה כשהתנועה מתחילה מהקצה, כשההגדרה SwipeDirection היא כיוון יחיד. (I32ef0)
• ב-TLC, ברירת המחדל היא עכשיו contentPadding ריק, במקום להציב את הפריטים הראשונים והאחרונים במרכז. (I77ab7)

תיקוני באגים

• ספריות Wear Compose עודכנו למהדר Kotlin 2.0. (I2de79)
• תוקנה הדוגמה המעוקלת LetterSpacing ב-Foundation. (Iebf7c)

גרסה ‎1.5.0-alpha10

‫26 בפברואר 2025

‫androidx.wear.compose:compose-*:1.5.0-alpha10 מופץ. גרסה ‎1.5.0-alpha10 מכילה את השמירות האלה.

שינויים ב-API

• הופכים את SwipeToRevealDefaults לגלוי לכולם. (I0c34c)
• החלפנו את הפרמטר swipeToDismissEdgeZoneFraction בפרמטר HorizontalPager. במקום זאת, נוסף פרמטר חדש, gestureInclusion, שאפשר להשתמש בו כדי להשיג את ההתנהגות הנדרשת של החלקה לסגירה. ‫gestureInclusion מקבל מופע של GestureInclusion שקובע אם אירוע הגלילה הבא צריך להתבצע או לא. המשמעות של אישור תנועה היא שה-Pager משתמש בה – אחרת, היא תטופל במקום אחר, למשל על ידי handler של החלקה לסגירה. התנהגות ברירת המחדל החדשה היא לא לאפשר מחוות בקצה השמאלי ביותר של הדף הראשון בכלי להחלפת דפים, וכך לאפשר החלקה כדי לסגור את האזור הזה. בכל הדפים האחרים, רכיב ה-Pager יאפשר שימוש בכל המחוות, כלומר לא ניתן להפעיל את האפשרות 'החלקה לסגירה' מהם. כדי להשיג התנהגות של החלקה לסגירה בכל הדפים, פשוט מספקים מופע מותאם אישית של GestureInclusion (ראו PagerDefaults.disableLeftEdgeOnFirstPage) שמתעלם מהדף הנוכחי. שינוי משמעותי נוסף שהוספנו כאן הוא שהרכיב Pager לא מוצג יותר במסך מלא כברירת מחדל. במקום זאת, צריך להוסיף Modifier.fillMaxSize() כדי להשיג את ההתנהגות הזו. (I9d3aa)
• שינינו את השם של createAnchors ל-createRevealAnchors ב-API של החלקה לחשיפה(If5999)
• הסרנו את RevealScope מה-API של החלקה לחשיפה. (Ie4ad5)
• הסרנו את האפשרויות 'חשיפה' ו'נחשף' מ-RevealValue ב-API של החלקה לחשיפה. (I8dbc5)
• שינינו את השם של SwipeDirection ל-RevealDirection ב-API של החלקה לחשיפה. (I7472f)
• שינינו את החתימה של הפרמטר positionalThreshold בפונקציה SwipeToReveal של rememberRevealState. (I29c0a)
• הוספנו פרמטר חדש overscrollEffect ל-ScalingLazyColumn, ל-TransformingLazyColumn ול-ScreenScaffold. (I0cee8)
• כשמשתמשים ב-PagerDefaults#snapFlingBehaviour, הפרמטר pagerSnapDistance מוחלף בפרמטר Int‏ maxFlingPages, שאפשר להשתמש בו כדי לציין את המספר המקסימלי של הדפים שניתן להעביר באמצעות Pager. (I8cfc0)
• ל-Wear Pager יש עכשיו PagerScope משלו במקום להשתמש ב-Compose Foundation PagerScope. (I9195b)
• הוספנו תמיכה ב-lineHeight בטקסט מעוקל (I1c936)
• הוספנו את initialAnchorItemIndex ואת initialAnchorItemOffset אל TransformingLazyColumnState ואת rememberTransformingLazyColumnState אל TransformationLazyColumn כדי שאפשר יהיה לציין את מיקום הגלילה הראשוני ב-TransformationLazyColumn. (I0a0d5)
• הוצאנו משימוש את runWithTimingDisabled לטובת runWithMeasurementDisabled, שמתאר בצורה ברורה יותר את ההתנהגות – כל המדדים מושהים. בנוסף, צריך לחשוף את מחלקת העל MicrobenchmarkScope כי אי אפשר להצהיר מחדש על הפונקציה runWithMeasurementDisabled כדי לפתוח גישה, כי היא מוטבעת. (I9e23b, ‏ b/389149423, ‏ b/149979716)
• הוספנו את TransformingLazyColumnItemScrollProgress.Unspecified ל-API כדי למנוע מצב של boxing ב-TransformingLazyColumnItemScrollProgress. (I0835d)

תיקוני באגים

• שיפור של Kdoc עבור CurvedTextStyle (Id45e3)
• הפכנו את SwipeableV2 (חלק מההטמעה של SwipeToReveal) לפנימי במקום לציבורי, אבל הגבלנו אותו לקבוצת הספרייה. (Idbb94)
• הוספנו בדיקות ל-HierarchicalFocusCoordinator (I1ce54, ‏ b/395548918)
• ביצענו שיפורים ב-SwipeToReveal בדוגמאות הבסיסיות של Wear Compose. (I5f307)
• תיקון נתונים סמנטיים של ציר הגלילה ב-verticalScrollAxisRange ב-TransformingLazyColumn לצורך נגישות (I68123)
• שיפור הביצועים של משוב הפטי בתנועה סיבובית ב-Wear4+‎ על ידי הסרת שרשורים מיותרים ברקע (I39cfe)
• משנים את SwipeDismissableNavHost כך שישתמש ב-PredictiveBackNavHost רק ב-API 36 ואילך. (I59bed)
• הוספנו אמצעי הגנה מפני קריסה כשניגשים להגדרה 'הפחתת תנועה'. (I01e2c)
• הטמענו שליפה מראש (prefetching) עבור TransformingLazyColumn כדי לצמצם את הבעיה של קפיצות בתצוגה (Icca88)

גרסה ‎1.5.0-alpha09

‫29 בינואר 2025

‫androidx.wear.compose:compose-*:1.5.0-alpha09 מופץ. גרסה ‎1.5.0-alpha09 מכילה את השמירות האלה.

שינויים ב-API

• ב-CurvedTextStyle, חילקנו את הריווח בין האותיות לריווח בין האותיות בכיוון השעון ולריווח בין האותיות נגד כיוון השעון. הדרישה הזו קיימת כי האותיות בכיוון השעון מתרחבות מקו הבסיס, ואילו האותיות נגד כיוון השעון מתרחבות פנימה (ולכן נדרש ריווח גדול יותר בין האותיות) (I4b848)
• הפונקציה CompositionLocal LocalReduceMotion פשוטה יותר עכשיו, והיא מחזירה ערך בוליאני במקום אובייקט ReduceMotion. הממשק של ReduceMotion הוצא משימוש. אפשר להחליף קריאות קודמות כמו LocalReduceMotion.current.enabled() בקריאות קוד כמו LocalReduceMotion.current (I4937f)
• ב-PagerDefaults, השם של snapAnimationSpec השתנה לשם SnapAnimationSpec. (I20c9a)

גרסה ‎1.5.0-alpha08

‫15 בינואר 2025

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

שינויים ב-API

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

תיקוני באגים

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

גרסה ‎1.5.0-alpha07

‫11 בדצמבר 2024

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

שינויים ב-API

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

תיקוני באגים

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

גרסה ‎1.5.0-alpha06

‫13 בנובמבר 2024

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

שינויים ב-API

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

תיקוני באגים

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

גרסה ‎1.5.0-alpha05

‫30 באוקטובר 2024

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

שינויים ב-API

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

תיקוני באגים

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

גרסה ‎1.5.0-alpha04

‫16 באוקטובר 2024

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

שינויים ב-API

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

גרסה ‎1.5.0-alpha03

‫2 באוקטובר 2024

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

שינויים ב-API

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

תיקוני באגים

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

גרסה ‎1.5.0-alpha02

‫18 בספטמבר 2024

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

שינויים ב-API

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

תיקוני באגים

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

גרסה ‎1.5.0-alpha01

‫4 בספטמבר 2024

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

שינויים ב-API

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

תיקוני באגים

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

גרסה 1.4

גרסה 1.4.1

‫12 בפברואר 2025

‫androidx.wear.compose:compose-*:1.4.1 מופץ. גרסה 1.4.1 מכילה את השמירות האלה.

תיקוני באגים

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

גרסה 1.4.0

‫4 בספטמבר 2024

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

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

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

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

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

גרסה ‎1.4.0-rc01

‫21 באוגוסט 2024

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

• עדכנו את יחסי התלות של Compose לגרסה 1.7.0-rc01 וקיבענו את Wear Compose Navigation ל-androidx.lifecycle 2.8.3

גרסה ‎1.4.0-beta03

‫12 ביוני 2024

‫androidx.wear.compose:compose-*:1.4.0-beta03 מופץ. גרסה ‎1.4.0-beta03 מכילה את השמירות האלה.

תיקוני באגים

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

גרסה ‎1.4.0-beta02

‫29 במאי 2024

‫androidx.wear.compose:compose-*:1.4.0-beta02 מופץ. גרסה ‎1.4.0-beta02 מכילה את השמירות האלה.

תיקוני באגים

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

גרסה ‎1.4.0-beta01

‫14 במאי 2024

‫androidx.wear.compose:compose-*:1.4.0-beta01 מופץ. גרסה ‎1.4.0-beta01 מכילה את השמירות האלה.

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

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

תיקוני באגים

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

גרסה ‎1.4.0-alpha08

‫1 במאי 2024

‫androidx.wear.compose:compose-*:1.4.0-alpha08 מופץ. גרסה ‎1.4.0-alpha08 מכילה את השמירות האלה.

שינויים ב-API

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

תיקוני באגים

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

גרסה ‎1.4.0-alpha07

‫17 באפריל 2024

‫androidx.wear.compose:compose-*:1.4.0-alpha07 מופץ. גרסה ‎1.4.0-alpha07 מכילה את השמירות האלה.

שינויים ב-API

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

גרסה ‎1.4.0-alpha06

‫3 באפריל 2024

‫androidx.wear.compose:compose-*:1.4.0-alpha06 מופץ. גרסה ‎1.4.0-alpha06 מכילה את השמירות האלה.

תיקוני באגים

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

גרסה ‎1.4.0-alpha05

‫20 במרץ 2024

‫androidx.wear.compose:compose-*:1.4.0-alpha05 מופץ. גרסה ‎1.4.0-alpha05 מכילה את השמירות האלה.

שינויים ב-API

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

תיקוני באגים

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

גרסה ‎1.4.0-alpha04

6 במרץ 2024

‫androidx.wear.compose:compose-*:1.4.0-alpha04 מופץ. גרסה ‎1.4.0-alpha04 מכילה את השמירות האלה.

שינויים ב-API

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

גרסה ‎1.4.0-alpha03

‫21 בפברואר 2024

‫androidx.wear.compose:compose-*:1.4.0-alpha03 מופץ. גרסה ‎1.4.0-alpha03 מכילה את השמירות האלה.

שינויים ב-API

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

תיקוני באגים

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

גרסה ‎1.4.0-alpha02

‫7 בפברואר 2024

‫androidx.wear.compose:compose-*:1.4.0-alpha02 מופץ. גרסה ‎1.4.0-alpha02 מכילה את השמירות האלה.

תיקוני באגים

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

גרסה ‎1.4.0-alpha01

‫24 בינואר 2024

‫androidx.wear.compose:compose-*:1.4.0-alpha01 מופץ. גרסה ‎1.4.0-alpha01 מכילה את השמירות האלה.

תכונות חדשות

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

שינויים ב-API

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

תיקוני באגים

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

גרסה 1.3

גרסה 1.3.1

‫3 באפריל 2024

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

תיקוני באגים

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

גרסה 1.3.0

‫24 בינואר 2024

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

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

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

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

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

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

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

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

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

גרסה ‎1.3.0-rc01

‫10 בינואר 2024

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

תיקוני באגים

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

  

  

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

גרסה ‎1.3.0-beta02

‫13 בדצמבר 2023

‫androidx.wear.compose:compose-*:1.3.0-beta02 מופץ. גרסה ‎1.3.0-beta02 מכילה את השמירות האלה.

תיקוני באגים

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

גרסה ‎1.3.0-beta01

‫15 בנובמבר 2023

‫androidx.wear.compose:compose-*:1.3.0-beta01 מופץ. גרסה ‎1.3.0-beta01 מכילה את השמירות האלה.

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

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

בעיות מוכרות

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

שינויים ב-API

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

תיקוני באגים

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

גרסה ‎1.3.0-alpha08

‫18 באוקטובר 2023

‫androidx.wear.compose:compose-*:1.3.0-alpha08 מופץ. גרסה ‎1.3.0-alpha08 מכילה את השמירות האלה.

שינויים ב-API

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

תיקוני באגים

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

גרסה ‎1.3.0-alpha07

‫4 באוקטובר 2023

‫androidx.wear.compose:compose-*:1.3.0-alpha07 מופץ. גרסה ‎1.3.0-alpha07 מכילה את השמירות האלה.

שינויים ב-API

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

תיקוני באגים

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

גרסה ‎1.3.0-alpha06

‫20 בספטמבר 2023

‫androidx.wear.compose:compose-*:1.3.0-alpha06 מופץ. גרסה ‎1.3.0-alpha06 מכילה את השמירות האלה.

תיקוני באגים

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

גרסה ‎1.3.0-alpha05

‫6 בספטמבר 2023

‫androidx.wear.compose:compose-*:1.3.0-alpha05 מופץ. גרסה ‎1.3.0-alpha05 מכילה את השמירות האלה.

תיקוני באגים

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

גרסה ‎1.3.0-alpha04

‫23 באוגוסט 2023

‫androidx.wear.compose:compose-*:1.3.0-alpha04 מופץ. גרסה ‎1.3.0-alpha04 מכילה את השמירות האלה.

תכונות חדשות

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

שינויים ב-API

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

תיקוני באגים

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

גרסה ‎1.3.0-alpha03

‫9 באוגוסט 2023

‫androidx.wear.compose:compose-*:1.3.0-alpha03 מופץ. גרסה ‎1.3.0-alpha03 מכילה את השמירות האלה.

שינויים ב-API

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

תיקוני באגים

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

גרסה ‎1.3.0-alpha02

26 ביולי 2023

‫androidx.wear.compose:compose-*:1.3.0-alpha02 מופץ. גרסה ‎1.3.0-alpha02 מכילה את השמירות האלה.

שינויים ב-API

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

תיקוני באגים

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

גרסה ‎1.3.0-alpha01

‫21 ביוני 2023

‫androidx.wear.compose:compose-*:1.3.0-alpha01 מופץ. גרסה ‎1.3.0-alpha01 מכילה את השמירות האלה.

תיקוני באגים

• כפי שפורסם ב1.2.0-alpha07 וב1.2.0-alpha10, אנחנו משנים עכשיו את DefaultTextStyle כדי להשבית את הוספת הריווח לגופנים, כדי ליצור עקביות בפלטפורמת Android. השינוי הזה יפתור בעיות של חיתוך טקסט בגדלים גדולים של גופן, ויכול להיות שהוא ישפיע גם על פריסות מסך, כך שיהיה צורך לעדכן את בדיקות צילומי המסך. לדוגמה, כאן רואים חיתוך של טקסט (Ic6a86)

• הוא לא מופיע יותר כשמשביתים את הריווח הפנימי של הגופן:

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

בעיות מוכרות

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

גרסה 1.2

גרסה 1.2.1

‫18 באוקטובר 2023

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

תיקוני באגים

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

גרסה 1.2.0

‫9 באוגוסט 2023

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

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

• גרסה יציבה של Compose ל-Wear OS‏ 1.2.0 (מידע נוסף)
• רשימת השינויים העיקריים ב-Wear Compose 1.2 מופיעה בנתוני הגרסה של (Compose for Wear OS 1.2 Beta01)

גרסה ‎1.2.0-rc01

26 ביולי 2023

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

תיקוני באגים

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

גרסה ‎1.2.0-beta02

‫7 ביוני 2023

‫androidx.wear.compose:compose-*:1.2.0-beta02 מופץ. גרסה ‎1.2.0-beta02 מכילה את השמירות האלה.

תכונות חדשות

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

תיקוני באגים

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

גרסה ‎1.2.0-beta01

‫24 במאי 2023

‫androidx.wear.compose:compose-*:1.2.0-beta01 מופץ. גרסה ‎1.2.0-beta01 מכילה את השמירות האלה.

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

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

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

תכונות חדשות

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

תיקוני באגים

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

גרסה ‎1.2.0-alpha10

‫10 במאי 2023

‫androidx.wear.compose:compose-*:1.2.0-alpha10 מופץ. גרסה ‎1.2.0-alpha10 מכילה את השמירות האלה.

תכונות חדשות

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

שינויים ב-API

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

תיקוני באגים

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

בעיות מוכרות

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

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

• הוא לא מופיע יותר כשמשביתים את הריווח הפנימי של הגופן:

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

גרסה ‎1.2.0-alpha09

‫19 באפריל 2023

‫androidx.wear.compose:compose-*:1.2.0-alpha09 מופץ. גרסה ‎1.2.0-alpha09 מכילה את השמירות האלה.

שינויים ב-API

• הוספת angularSizeDp ל-CurvedModifier api להגדרת רוחב זוויתי ב-DP (I89a52)

תיקוני באגים

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

גרסה ‎1.2.0-alpha08

‫5 באפריל 2023

‫androidx.wear.compose:compose-*:1.2.0-alpha08 מופץ. גרסה ‎1.2.0-alpha08 מכילה את השמירות האלה.

שינויים ב-API

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

תיקוני באגים

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

גרסה ‎1.2.0-alpha07

‫22 במרץ 2023

‫androidx.wear.compose:compose-*:1.2.0-alpha07 מופץ. גרסה ‎1.2.0-alpha07 מכילה את השמירות האלה.

שינויים ב-API

• העברנו את הרכיבים Expandable Item (נוספו בגרסה 1.2.0-alpha06) מ-material ל-foundation, כי לא הייתה להם הפניה משמעותית ל-MaterialTheme. (Ib0525)

תיקוני באגים

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

גרסה ‎1.2.0-alpha06

‫8 במרץ 2023

‫androidx.wear.compose:compose-*:1.2.0-alpha06 מופץ. גרסה ‎1.2.0-alpha06 מכילה את השמירות האלה.

שינויים ב-API

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

תיקוני באגים

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

גרסה ‎1.2.0-alpha05

‫22 בפברואר 2023

‫androidx.wear.compose:compose-*:1.2.0-alpha05 מופץ. גרסה ‎1.2.0-alpha05 מכילה את השמירות האלה.

שינויים ב-API

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

תיקוני באגים

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

גרסה ‎1.2.0-alpha04

‫8 בפברואר 2023

‫androidx.wear.compose:compose-*:1.2.0-alpha04 מופץ. גרסה ‎1.2.0-alpha04 מכילה את השמירות האלה.

תכונות חדשות

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

שינויים ב-API

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

תיקוני באגים

• אפשר להטמיע את ScalingLazyColumn בדף עם גלילה אופקית (Iec3f8, ‏ b/266555016)
• שיפור של Stepper kdocs וניקוי של בדיקות StepperTest. (Ic118e)
• התלות ב-androidx.navigation עודכנה לגרסה 2.5.3 (If58ed)

גרסה ‎1.2.0-alpha03

‫25 בינואר 2023

‫androidx.wear.compose:compose-*:1.2.0-alpha03 מופץ. גרסה ‎1.2.0-alpha03 מכילה את השמירות האלה.

שינויים ב-API

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

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

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

תיקוני באגים

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

גרסה ‎1.2.0-alpha02

‫11 בינואר 2023

‫androidx.wear.compose:compose-*:1.2.0-alpha02 מופץ. גרסה ‎1.2.0-alpha02 מכילה את השמירות האלה.

שינויים ב-API

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

תיקוני באגים

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

גרסה ‎1.2.0-alpha01

‫7 בדצמבר 2022

‫androidx.wear.compose:compose-*:1.2.0-alpha01 מופץ. גרסה ‎1.2.0-alpha01 מכילה את השמירות האלה.

תכונות חדשות

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

שינויים ב-API

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

תיקוני באגים

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

גרסה 1.1

גרסה 1.1.2

‫8 בפברואר 2023

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

תיקוני באגים

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

גרסה 1.1.1

‫11 בינואר 2023

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

תיקוני באגים

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

גרסה 1.1.0

‫7 בדצמבר 2022

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

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

• גרסה יציבה של Compose ל-Wear OS 1.1.0 (מידע נוסף).
• רשימת השינויים העיקריים ב-Wear Compose 1.1 מופיעה בנתוני הגרסה של (Compose for Wear OS 1.1 Beta01).

תכונות חדשות

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

תיקוני באגים

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

גרסה ‎1.1.0-rc01

‫9 בנובמבר 2022

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

תיקוני באגים

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

גרסה ‎1.1.0-beta01

‫24 באוקטובר 2022

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

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

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

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

שינויים ב-API

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

תיקוני באגים

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

גרסה ‎1.1.0-alpha07

‫5 באוקטובר 2022

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

תכונות חדשות

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

שינויים ב-API

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

גרסה ‎1.1.0-alpha06

‫21 בספטמבר 2022

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

תכונות חדשות

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

תיקוני באגים

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

גרסה ‎1.1.0-alpha05

‫7 בספטמבר 2022

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

תיקוני באגים

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

גרסה ‎1.1.0-alpha04

‫24 באוגוסט 2022

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

שינויים ב-API

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

תיקוני באגים

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

גרסה ‎1.1.0-alpha03

‫10 באוגוסט 2022

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

תכונות חדשות

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

שינויים ב-API

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

תיקוני באגים

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

גרסה ‎1.1.0-alpha02

‫27 ביולי 2022

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

תכונות חדשות

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

שינויים ב-API

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

תיקוני באגים

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

גרסה ‎1.1.0-alpha01

29 ביוני 2022

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

שינויים ב-API

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

תיקוני באגים

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

גירסה 1.0

גרסה 1.0.2

‫7 בספטמבר 2022

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

תיקוני באגים

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

גרסה 1.0.1

‫24 באוגוסט 2022

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

תיקוני באגים

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

גרסה 1.0.0

‫27 ביולי 2022

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

התכונות העיקריות בגרסה 1.0.0

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

תיקוני באגים

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

גרסה ‎1.0.0-rc02

‫22 ביוני 2022

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

תיקוני באגים

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

גרסה ‎1.0.0-rc01

‫15 ביוני 2022

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

שינויים ב-API

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

תיקוני באגים

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

גרסה ‎1.0.0-beta03

‫1 ביוני 2022

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

תכונות חדשות

• הוספנו תמיכה ב-ScalingLazyColumn במצב Compose @Preview. (I3b3b6, b/232947354)

שינויים ב-API

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

בעיות מוכרות

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

תיקוני באגים

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

גרסה ‎1.0.0-beta02

‫18 במאי 2022

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

תכונות חדשות

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

תיקוני באגים

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

גרסה ‎1.0.0-beta01

‫11 במאי 2022

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

מה כוללת גרסה 1.0 של Compose ל-Wear OS

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

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

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

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

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

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

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

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

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

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

• הרכיב הבא כלול גם בספריית הניווט של Wear Compose:

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

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

שינויים ב-API

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

תיקוני באגים

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

גרסה ‎1.0.0-alpha21

‫20 באפריל 2022

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

תכונות חדשות

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

שינויים ב-API

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

תיקוני באגים

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

גרסה ‎1.0.0-alpha20

‫6 באפריל 2022

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

תכונות חדשות

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

שינויים ב-API

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

תיקוני באגים

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

גרסה ‎1.0.0-alpha19

‫23 במרץ 2022

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

שינויים ב-API

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

תיקוני באגים

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

גרסה ‎1.0.0-alpha18

9 במרץ 2022

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

שינויים ב-API

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

תיקוני באגים

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

גרסה ‎1.0.0-alpha17

‫23 בפברואר 2022

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

תכונות חדשות

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

שינויים ב-API

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

תיקוני באגים

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

גרסה ‎1.0.0-alpha16

‫9 בפברואר 2022

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

תכונות חדשות

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

שינויים ב-API

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

תיקוני באגים

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

גרסה ‎1.0.0-alpha15

‫26 בינואר 2022

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

שינויים ב-API

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

גרסה ‎1.0.0-alpha14

‫12 בינואר 2022

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

תכונות חדשות

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

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

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

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

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

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

גרסה ‎1.0.0-alpha13

‫15 בדצמבר 2021

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

שינויים ב-API

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

תיקוני באגים

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

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

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

• נוספו דוגמאות ל-SwipeDismissableNavHost ב-Wear Compose Navigation. (I85f06)

גרסה ‎1.0.0-alpha12

1 בדצמבר 2021

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

תכונות חדשות

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

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

שינויים ב-API

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

גרסה ‎1.0.0-alpha11

17 בנובמבר 2021

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

תכונות חדשות

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

שינויים ב-API

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

תיקוני באגים

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

גרסה ‎1.0.0-alpha10

‫3 בנובמבר 2021

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

תכונות חדשות

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

• כדאי לעיין ב-WearOS Codelab החדש בנושא Compose.

שינויים ב-API

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

תיקוני באגים

• עדכון הטיפול במעברים ב-SwipeDismissableNavHost ב-SideEffect (I04994, b/202863359)
• עדכון הטיפול במעברים ב-SwipeDismissableNavHost (I1cbe0, b/202863359)

גרסה ‎1.0.0-alpha09

‫27 באוקטובר 2021

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

תכונות חדשות

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

שינויים ב-API

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

תיקוני באגים

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

גרסה ‎1.0.0-alpha08

‫13 באוקטובר 2021

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

שינויים ב-API

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

תיקוני באגים

• הוספנו קישורים למדריכים ב-developer.android.com מ-KDocs לרכיבים button, card, chip, theme, position indicator ו-scaling lazy column. (I22428)
• תיקנו בעיה שבה לפעמים לא ניתן להשתמש בתכונה SwipeToDismissBox ב-WearOS כדי להחליק כדי לסגור את התיבה. (I9387e)
• נוספו דוגמאות ל-Button, ‏ CompactButton,‏ Chip, ‏ CompactChip, ‏ AppCard, ‏ TitleCard,‏ ToggleButton, ‏ ToggleChip, ‏ SplitToggleChip ‏ (Iddc15)
• הוספנו בדיקות ביצועים של מיקרו-בנצ'מרק ל-Card, ‏ Chip, ‏ ToggleChip, ‏ TimeText ו-ScalingLazyColumn. (If2fe9)

גרסה ‎1.0.0-alpha07

‫29 בספטמבר 2021

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

תכונות חדשות

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

שינויים ב-API

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

תיקוני באגים

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

גרסה ‎1.0.0-alpha06

‫15 בספטמבר 2021

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

תכונות חדשות

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

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

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

• הגרסה הראשונית הזו כוללת:

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

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

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

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

שינויים ב-API

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

תיקוני באגים

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

גרסה ‎1.0.0-alpha05

‫1 בספטמבר 2021

‫androidx.wear.compose:compose-foundation:1.0.0-alpha05 וגם androidx.wear.compose:compose-material:1.0.0-alpha05 מופצים. גרסה ‎1.0.0-alpha05 מכילה את השמירות האלה.

שינויים ב-API

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

תיקוני באגים

• צמצמנו את המרווח בין הסמל לטקסט ב-Chip וב-ToggleChip כדי להתאים אותם לעדכונים במפרט חוויית המשתמש. (I83802)

גרסה ‎1.0.0-alpha04

‫18 באוגוסט 2021

‫androidx.wear.compose:compose-foundation:1.0.0-alpha04 וגם androidx.wear.compose:compose-material:1.0.0-alpha04 מופצים. גרסה ‎1.0.0-alpha04 מכילה את השמירות האלה.

תכונות חדשות

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

שינויים ב-API

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

תיקוני באגים

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

גרסה ‎1.0.0-alpha03

‫4 באוגוסט 2021

‫androidx.wear.compose:compose-foundation:1.0.0-alpha03 וגם androidx.wear.compose:compose-material:1.0.0-alpha03 מופצים. גרסה ‎1.0.0-alpha03 מכילה את השמירות האלה.

שינויים ב-API

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

תיקוני באגים

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

גרסה ‎1.0.0-alpha02

‫21 ביולי 2021

‫androidx.wear.compose:compose-foundation:1.0.0-alpha02 וגם androidx.wear.compose:compose-material:1.0.0-alpha02 מופצים. גרסה ‎1.0.0-alpha02 מכילה את השמירות האלה.

תכונות חדשות

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

שינויים ב-API

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

תיקוני באגים

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

גרסה ‎1.0.0-alpha01

‫1 ביולי 2021

‫androidx.wear.compose:compose-foundation:1.0.0-alpha01 וגם androidx.wear.compose:compose-material:1.0.0-alpha01 מופצים. גרסה 1.0.0-alpha01 מכילה את השמירות האלה.

תכונות חדשות

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

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

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

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

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

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