כתיבת אימייל ב-Wear
| העדכון האחרון | גרסה יציבה | גרסה מועמדת להפצה | גרסת בטא | גרסת אלפא |
|---|---|---|---|---|
| 1 ביולי 2026 | 1.6.2 | - | - | 1.7.0-alpha05 |
הצהרה על יחסי תלות
כדי להוסיף תלות ב-Wear, צריך להוסיף את מאגר Google Maven לפרויקט. מידע נוסף זמין במאמר בנושא מאגר Maven של Google.
אתם יכולים להוסיף את יחסי התלות של הארטיפקטים שאתם צריכים בקובץ build.gradle של האפליקציה או המודול:
Groovy
dependencies { implementation "androidx.wear.compose:compose-foundation:1.6.2" // For Wear Material Design UX guidelines and specifications implementation "androidx.wear.compose:compose-material:1.6.2" // For integration between Wear Compose and Androidx Navigation libraries implementation "androidx.wear.compose:compose-navigation:1.6.2" // For Wear preview annotations implementation("androidx.wear.compose:compose-ui-tooling:1.6.2") // NOTE: DO NOT INCLUDE a dependency on androidx.compose.material:material. // androidx.wear.compose:compose-material is designed as a replacement // not an addition to androidx.compose.material:material. // If there are features from that you feel are missing from // androidx.wear.compose:compose-material please raise a bug to let us know. }
Kotlin
dependencies { implementation("androidx.wear.compose:compose-foundation:1.6.2") // For Wear Material Design UX guidelines and specifications implementation("androidx.wear.compose:compose-material:1.6.2") // For integration between Wear Compose and Androidx Navigation libraries implementation("androidx.wear.compose:compose-navigation:1.6.2") // For Wear preview annotations implementation("androidx.wear.compose:compose-ui-tooling:1.6.2") // 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.7
גרסה 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)שינוי השם של
offsetOfAPI ב-RevealStateל-positionOf. (I2675f, b/522387997)הוספנו את הפרמטר
actionContentSpacingל-SwipeToReveal, כדי לאפשר למפתחים להתאים אישית את המרחק בין משבצות הפעולה לבין התוכן. (I2abaf, b/507073912)
תיקוני באגים
- תוקנה בעיה ב-
ScreenScaffoldשבה קומפוזיציות חוזרות יכלו לגרום ל-ScrollInfoProviderשלא נשמר לאפס את מצב מעקב הגלילה. (I98f6d, b/524620765) TransformingLazyColumnצבע סרגל הגלילה זהה לצבע הרקע של אינדיקטור התנועה במהלך האנימציה של האינדיקטור (I353fb, b/524915104)- השינוי של ברירת המחדל
OneHandedGestureIndicatorgestureIndicatorTintל-LocalContentColor(I1abd3, b/524228063) - הגדרת פרמטרים לתיאור התוכן של כלי הבחירה של היום והשנה של
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 בדגלLocalOneHandedGestureEnabledCompositionLocal, שאפשר להשתמש בו כדי להשבית תנועות ביד אחת בהיררכיות של רכיבים. (Ib9240, [b/516777416] - הוצא משימוש
ButtonDefaults.ExtraSmallIconSizeו-ButtonDefaults.SmallIconSize. ערכי ברירת המחדל האלה היו ספציפיים ל-CompactButtonוהועברו ל-CompactButtonDefaults.ExtraSmallIconSizeוגםCompactButtonDefaultsSmallIconSizeבהתאמה. (Id747c, [b/513588028]
תיקוני באגים
- תיקון אנימציה של
EdgeButtonבהטלה מהירה. (I88215, [b/512700520] - פתרון הבעיה
AppScaffoldTimeTextלא מתעדכן בהרכבה מחדש. (Iecea5, [b/512439755] -
ScreenScaffoldצריך להשתמש באופן מפורש ב-PaddingValuesשסופק על ידי ביטוי ה-lambda של התוכן הפנימי. (I20d71, [b/512355364] - הוספנו את ההערות @
FrequentlyChangingValueו- @RememberInCompositionכדי לספק אזהרות של lint ולמנוע בעיות בביצועים שנגרמות מקריאה של עדכוני מצב בתדירות גבוהה או מאי-זכירה של אובייקטים במהלך ההרכבה. (I955f4, [b/409488336] - כשמפעילים תנועת יד אחת עבור רכיבי
Buttoncomposable, חשוב לוודא שאפקט האדווה מתחיל ממרכז הלחצן. (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. התמונות האלה יוצגו עכשיו במסמכי התיעוד של דפי ה-DAC של Wear Compose Material 3, ויספקו למפתחים הקשר חזותי מיידי לכל וריאציה ולכל דוגמה של לחצן. (Ib53ae, b/484905061) - נוספו תצוגות מקדימות של תמונות מוטמעות לכל הדוגמאות ב-Kdoc של Button.kt. התמונות האלה יוצגו עכשיו ישירות במסמכי התיעוד בדפי ה-DAC של Material 3 ב-Wear Compose, ויספקו למפתחים הקשר חזותי מיידי לכל וריאציה ודוגמה של לחצן. (Ie2fb5, b/484905061)
- נוספו תצוגות מקדימות של תמונות בתוך השורה לדוגמאות ב-KDoc ב-
Card.kt, ב-IconButton.kt, ב-LevelIndicator.ktוב-ListHeader.kt. התמונות האלה יוצגו עכשיו בתיעוד של דפי ה-DAC של Wear Compose Material 3. (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. - שיפרנו את הרינדור של טקסט מעוקל, במיוחד עבור גופנים כתביים, באמצעות הצגת עיוות טקסט דרך הפרמטר החדש
CurvedTextStylewarpOffset, שמופעל כברירת מחדל ב-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. - שיפרנו את הרינדור של טקסט מעוקל, במיוחד עבור גופנים כתביים, באמצעות הצגת עיוות טקסט דרך הפרמטר החדש
CurvedTextStylewarpOffset, שמופעל כברירת מחדל ב-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)
תיקוני באגים
- תיקון האינטראקציה בין TLCs
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עודכנה כך שהיא מקבלת פרמטר מסוג floatsnapSensitivity, והפונקציה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
- נוסף פריט מידע שנוצר בתהליך פיתוח (Artifact) של ספרייה
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) - תוקן
SwipeToRevealpadding של פעולת ביטול (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, שבו כפתור האישור הוכרז כ-'כפתור'. 'אישור' במקום 'אישור' הרגיל. כפתור'. (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שלא היה בשימוש בשיטהCircularProgressIndicatordrawCircularProgressIndicator. (Ieeb3c, b/430544552)
תיקוני באגים
- הוספנו תמיכה חסרה ב-
TransformingLazyColumnverticalAlignment– עכשיו יש תמיכה בסידורים סטנדרטיים שמבוססים על מיקום בחלק העליון, התחתון או המרכזי. (I2e630, b/444143326) - שיפור החישוב של רוחב טקסט מעוקל כדי להתחשב ברווחים לפני ואחרי הטקסט (יכול להיות שיהיו בעיות בצילומי מסך שכוללים טקסט מעוקל, במיוחד אם יש לו רקע כמו
TimeText). (I924a4, b/446601899) - בוצע עדכון ב-Compose Foundation
WarpedCurvedTextRendererכדי לבחור באפשרותEmojiCompatInitializerמתוךandroidx.emoji2כדי לתקן שגיאת מחלקה בזמן ריצה. (I589b4, b/444422736) - העדכון של
ScalingLazyColumnמתמקד בצומת שניתן לגלול בה באמצעותCollectionInfo, כדי שהיא תפעל עם חוגה בהקשרים נוספים, כמו ב-Material3AlertDialog. (I6be3c, b/445332360)
גרסה 1.6.0-alpha02
24 בספטמבר 2025
androidx.wear.compose:compose-*:1.6.0-alpha02 מופץ. גרסה 1.6.0-alpha02 מכילה את השמירות האלה.
שינויים ב-API
- שיפרנו את הרינדור של טקסט מעוקל, במיוחד עבור גופנים כתביים, באמצעות הצגת עיוות טקסט באמצעות הפרמטר החדש
CurvedTextStylewarpOffset. (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, שבו כפתור האישור הוכרז כ-'כפתור'. 'אישור' במקום 'אישור' הרגיל. כפתור'. (Ic2381, b/429378202)
גרסה 1.5.3
8 באוקטובר 2025
androidx.wear.compose:compose-*:1.5.3 מופץ. גרסה 1.5.3 מכילה את השמירות האלה.
תיקוני באגים
- הוספנו תמיכה חסרה ב-
TransformingLazyColumnverticalAlignment– עכשיו יש תמיכה בסידורים סטנדרטיים שמבוססים על מיקום בחלק העליון, התחתון או המרכזי. (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 מכילה את השמירות האלה.
תיקוני באגים
- תיקון השימוש בפרמטר של שינוי
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 של רכיב הניווט, צריך לציין את היישור במפורש באמצעותmodifier = Modifier.align(Alignment.BottomCenter)עםHorizontalPageIndicatorו-modifier =Modifier.align(Alignment.CenterEnd)עםVerticalPageIndicator. (I3a0ad) - כיוון ההחלקה ב-
SwipeToRevealעכשיו עקבי גם ב-LTR וגם ב-RTLLayoutDirections. (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כשמופיעreverseLayout = trueב-LazyColumnאו ב-ScalingLazyColumn. (I46a1a) - תוקן באג ב-
ScreenScaffoldשבו התכונה 'גילוי באמצעות מגע' לא פעלה ב-Talkback אם סופקScrollIndicator/PageIndicator. (I6dcee) -
TransformingLazyColumnמאפשר עכשיו מעבר צורה מותאם אישית מ-TransformationSpecעל ידי קריאת הערךitemHeightשסופק על ידיTransformationSpecבכלי לצביעת הרקע. (I6a599) - מעברים מונפשים בין צבעים מופעלים/מושבתים עבור
IconButton, כדי לשמור על עקביות עםIconToggleButton. (Ife10a) - הסרנו את ההגבלה של החלק המינימלי ב-
CircularProgressIndicatorכדי למנוע קפיצה בולטת לגודל הנקודה המינימלי במהלך האנימציה. כחלק מהשינוי הזה, הפרמטרtargetProgressב-drawCircularProgressIndicatorלא נמצא יותר בשימוש. (I33309) - לכלי לבחירת תאריכים יש עכשיו את התפקיד הסמנטי
ValuePickerשאפשר להשתמש בו בקוראי מסך כדי לשפר את הנגישות של הכלי. בנוסף, בבוחר יש עכשיו תוויות קליקים מעודכנות לנגישות, שמבחינות בין שינוי הערך במצב קריאה בלבד לבין בחירת הערך הנוכחי במצבים אחרים. (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) - האנימציה של רכיבי ה-Picker ב-
PickerGroupמתבצעת עכשיו באופן אופקי כשההגדרה 'מרכוז אוטומטי' מופעלת ורכיב ה-Picker שנבחר (ממורכז) משתנה. (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.outlinedButtonBordernow updates following enabled/disabled state changes size(If2ddd) - תוקן באג ב-
EdgeButtonheight שהתרחש במסכים מורכבים עם 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יש עכשיו פרמטרים של שינוי ברכיבי ה-ComposableSuccessIconו-FailureIcon. (Id2ae2)
תיקוני באגים
- שינינו את הסדר שבו אנחנו מחילים את ההשפעה של פרמטרים מסוג
SurfaceTransformation. בעבר, הטרנספורמציות שהוחלו על רכיבי Wear Material3 בוצעו באופן הבא: צביעת הרקע, טרנספורמציה של הקונטיינר, טרנספורמציה של התוכן. עכשיו, 2 הראשונים הפוכים, ואנחנו מחילים ביניהם כל משנה שהועבר, כך שהוא מושפע מהטרנספורמציות של מאגר התגים. התיקון הזה פותר בעיות כמו שימוש באפקט הבהוב של פלייסולדר עם רכיבים ב-TLC באמצעות פרמטר הטרנספורמציה. (I786cf) RevealState.Saverנוסף כדי לשמש לשחזור המצב שלSwipeToRevealכשפעילות או תהליך נוצרים מחדש. הפונקציהrememberRevealStateמשתמשת עכשיו בחיסכון הזה כברירת מחדל. (Ie0ecb)SwipeToRevealכפתורי הפעולות הראשיות והמשניות צריכים להיות מוגדרים כברירת מחדל ל-ButtonDefault.Height(תוקן באג שבו הכפתורים האלה מילאו את הגובה המקסימלי של כפתורים גבוהים יותר). (Ibfba1)- השתנה
SwipeToRevealלאיפוס הרכיב האחרון שהייתה איתו אינטראקציה, כשמבצעים את תנועת ההחלקה שמאלה. (Ia8450) - הערך
SwipeToRevealשונה כך שיוגדר המצבRevealingכאשר מיקום הסיום של ההחלקה הוא בין נקודות העיגון של החשיפה וההסתרה, וקרוב יותר לנקודת העיגון של החשיפה. (If4458) - עכשיו התוכן של
ButtonGroupמוצג בצורה הפוכה כמו שצריך בפריסה מימין לשמאל (Ib378d) -
AnimatedTextתומך עכשיו בכיוון טקסט מימין לשמאל (I4533c) TransformingLazyColumnשינוי הגודל של הפריטים מתבצע עכשיו בצורה נכונה כשמסירים את הפריט התחתון (Idacab)-
TransformingLazyColumnמבצע עכשיו רק מעבר מדידה אחד, וכך משפר את הביצועים על ידי קיצור זמני הפריימים. (I501a1)
גרסה 1.5.0-beta02
20 במאי 2025
androidx.wear.compose:compose-*:1.5.0-beta02 מופץ. גרסה 1.5.0-beta02 מכילה את השמירות האלה.
תיקוני באגים
- עדכנו את פרופילי הבסיס לספריות foundation, material ו-material3. (I53f06)
- תוקן באג ב-
TransformingLazyColumn, שבו הגודל של הפריטים השתנה כשפריט שהיה בתחתית הוסר. (Idacab) - תוקנה באג ב-
TransformingLazyColumn, שגרם לרשימה להיתקע בחלק העליון או התחתון שלה. (I49d00) -
OpenOnPhoneDialogTalkBack צריך להכריז על הטקסט המעוקל, ולא על תיאור התוכן של הסמל. (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כדי להדגיש את משמעות המידע שבו. - רכיבי Pager – הרכיבים
HorizontalPagerScaffold,VerticalPagerScaffoldו-AnimatedPageמתאמים בין אנימציותHorizontalPageIndicatorו-VerticalPagerIndicator. HorizontalPagerו-VerticalPagerזמינים בספריית Wear Compose Foundation. - פלייסהולדרים – מצייר צורת שלד מעל רכיב, במצבים שבהם אין תוכן זמני זמין.
- מחוונים ורכיבי Stepper – גם מחוונים וגם רכיבי Stepper מאפשרים למשתמשים לבחור מתוך טווח ערכים. מחוונים הם קומפקטיים יותר ואפשר לפלח אותם, בעוד שהרכיב Stepper הוא רכיב במסך מלא שבדרך כלל משולב עם
StepperLevelIndicator. -
SwipeToReveal– משמש להוספת פעולות נוספות לרכיב שאפשר להרכיב כשמבצעים החלקה מימין לשמאל.
בנוסף, גרסה Wear Compose Foundation 1.5.0-beta01 כוללת את הרכיבים החדשים הבאים:
-
TransformingLazyColumn– רשימה עצלה עם גלילה אנכית שתומכת בהתאמה לעומס ובאנימציות של שינוי צורה - קבוצות פוקוס היררכיות – משמשות להוספת הערות לרכיבים שניתנים להרכבה באפליקציה, כדי לעקוב אחרי החלק הפעיל של ההרכבה ולתאם את הפוקוס.
- רכיבי Pager – רכיבי
HorizontalPagerו-VerticalPager, שמבוססים על רכיבי Compose Foundation עם שיפורים ספציפיים ל-Wear כדי לשפר את הביצועים ולעמוד בהנחיות של Wear OS.
שינויים ב-API
- עדכון של Hierarchical Focus API – שינוי השם של
Modifier.hierarchicalFocusל-Modifier.hierarchicalFocusGroupוהסרת פרמטר הקריאה החוזרת; הסרת העומס שלModifier.hierarchicalFocusRequesterעם פרמטרFocusRequester; יצירתCompositionLocalחדש,LocalScreenIsActive, כדי שרכיבים יוכלו להודיע ולבדוק איזה מסך פעיל. (I5ff7c). - הוצאנו משימוש את
SwipeToRevealמ-Wear Compose Foundation לטובת ממשקי API ב-Wear Compose Material וב-Wear Compose Material3.SwipeToRevealכדי להמשיך להשתמש בממשקי ה-API, צריך להחליף את הייבוא של Wear FoundationSwipeToRevealבייבוא של 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
SwipeToRevealAPI באופן הבא: הוספנו פרמטרים שלprimaryAction,onFullSwipe,secondaryAction,undoPrimaryAction,undoSecondaryActionו-hasPartiallyRevealedStateל-SwipeToRevealcomposable; הסרנו את האפשרות להתאים אישית אתpositionalThresholdו-animationSpecמ-RevealState; הסרנו אתlastActionType,revealThresholdואת width מ-RevealState; שינינו את ה-constructor שלRevealStateכך שיקבלRevealDirectionבמקום anchors; הסרנו את הפונקציותcreateRevealAnchors, anchors ו-bidirectionalAnchors; הפונקציותSwipeToRevealScopeprimaryAction,secondaryAction,undoPrimaryActionו-undoSecondaryActionשונו לשמותPrimaryActionButton,SecondaryActionButton,UndoActionButtonוהפכו לפונקציות Composable; סימנו אתRevealActionTypeכפנימי. (I885d0). - בוצעו עדכונים נוספים ב-API של
SwipeToReveal: השם שלonFullSwipeשונה ל-onSwipePrimaryAction, השם שלSwipeToRevealNonAnchoredSampleשונה כדי לציין את השימוש בפרמטרhasPartiallyRevealedState,actionButtonHeightהוסר כי ברירת המחדל היא הגובה שמוגדר ללחצן, ואפשר להגדיר גובה גדול יותר באמצעות משנה.SmallActionButtonHeightהוסר מ-SwipeToRevealDefaults, והפרמטר value (ערך) בקונסטרוקטוריםRevealValueו-RevealDirectionהוגדר כפרטי. (I465ce).
תיקוני באגים
- תוקן הטיפול ב-
ScreenScaffoldEdgeButtonכך שאחרי הסרת פריטTransformingLazyColumn, האנימציה שלEdgeButtonתופיע במקום. (I6d366). - עדכנו את יחסי התלות של Wear Compose בספריות Compose לגרסה 1.8.0. (I2ef3f).
- עדכנו את התנועה של מצב ההמתנה
CircularProgressIndicatorכך שהוא לא יחזור אחורה באופן זמני. (Ieddb1). - תוקן באג
SwipeDismissableNavHost– המיקוד לא עבר בצורה נכונה אחרי החלקה אחורה, ולכן לא הייתה אפשרות להשתמש בקלט סיבובי (הבאג הזה היה ב-API 36 ומעלה, שמשתמש בתכונה 'חזרה עם חיזוי'). (Ieddb1). - תיקנו את התיעוד של Hierarchical Focus API (Idf2ff).
- עדכנו את המסמכים של Button ו-Card כדי לציין איך
containerPainterו-disabledContainerPainterמבטלים אתcontainerColorו-disabledContainerColor(I4a453). - בוטל שינוי ב-
TimeTextבגרסה הקודמת, שבו הועברBroadcastReceiverל-worker thread, כי הוא גרם לבעיות באפליקציות שמנהלות את ה-threading שלהן במהלך הניווט. (I34d02). - עדכנו את דוגמאות הקוד של הכלי לבחירת תמונות כדי להסיר קריאות מיותרות ל-remember, ובמקום זאת להשתמש ב-
rememberUpdatedStateבכלי לבחירת תמונות כדי לזכור את פונקציית ה-lambda האחרונה שלcontentDescription. (Icb5b1). - עדכנו את סגנונות הטקסט ב-
TimePickerוב-DatePickerכך ששינויים בגופן לא יגרמו יותר לחיתוך. (I26194). -
ListHeaderו-ListSubHeaderמיישרים את הטקסט למרכז ולצד ימין בהתאמה כברירת מחדל. (I78339). - עדכנו את הדוגמאות ואת ההדגמות של Foundation ו-Material Swipe to Reveal כדי להודיע על פעולות נגישות בהתאמה אישית (צריך להוסיף את הפעולות המותאמות אישית כסמנטיקה בתוכן, ולא ב-
SwipeToRevealcomposable עצמו). (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ב-FoundationSwipeToRevealהועברו לחבילת 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)
תיקוני באגים
- משנים את
SwipeToRevealbidirectionalGestureInclusionכדי להחזיר אובייקט במקום סוג. (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 FoundationPagerStateוהוספו המאפייניםcurrentPage, currentPageOffsetFractionו-pageCount. ממשקGestureInclusionעודכן, והשם של השיטה שונה ל-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. התנהגות ברירת המחדל של FoundationSwipeToRevealהיא עכשיו איסור החלקה כשהתנועה מתחילה מהקצה. ההתנהגות שמוגדרת כברירת מחדל ב-Material3SwipeToRevealהיא שלא ניתן להחליק כשהתנועה מתחילה מהקצה, אםSwipeDirectionמוגדר לכיוון יחיד. (I32ef0) - ב-TLC, כברירת מחדל, נעשה עכשיו שימוש ב-contentPadding ריק במקום להציב את הפריטים הראשונים והאחרונים במרכז. (I77ab7)
תיקוני באגים
- ספריות Wear Compose עודכנו למהדר Kotlin 2.0. (I2de79)
- תוקנה דוגמת
LetterSpacingהמעוקלת בבסיס. (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 של swipe-to-reveal (If5999) - הסרנו את
RevealScopeמה-API של החלקה לחשיפה. (Ie4ad5) - הסרנו את Revealing ו-Revealed מ-
RevealValueב-API של החלקה לחשיפה. (I8dbc5) - שינינו את השם של
SwipeDirectionל-RevealDirectionב-API של החלקה לחשיפה. (I7472f) - שינינו את החתימה של הפרמטר
positionalThresholdבפונקציהrememberRevealStateשלSwipeToReveal. (I29c0a) - הוספנו פרמטר חדש
overscrollEffectאלScalingLazyColumn, אלTransformingLazyColumnואלScreenScaffold. (I0cee8) - כשמשתמשים ב-
PagerDefaults#snapFlingBehaviour, הפרמטרpagerSnapDistanceהוחלף בפרמטר IntmaxFlingPages, שאפשר להשתמש בו כדי לציין את המספר המקסימלי של דפים שניתן להעביר באמצעות Pager. (I8cfc0) - ל-Wear Pager יש עכשיו
PagerScopeמשלו, במקום להשתמש ב-Compose FoundationPagerScope. (I9195b) - הוספנו תמיכה ב-
lineHeightבטקסט מעוקל (I1c936) - הוספנו את
initialAnchorItemIndexואתinitialAnchorItemOffsetאלTransformingLazyColumnStateואתrememberTransformingLazyColumnStateאלTransformationLazyColumnכדי שאפשר יהיה לציין את מיקום הגלילה הראשוני ב-TransformationLazyColumn. (I0a0d5) - הוצאנו משימוש את
runWithTimingDisabledלטובתrunWithMeasurementDisabled, שמתאר בצורה ברורה יותר את ההתנהגות – כל המדדים מושהים. בנוסף, צריך לחשוף את מחלקת העלMicrobenchmarkScopeכי אי אפשר להצהיר מחדש על הפונקציהrunWithMeasurementDisabledכדי לפתוח גישה, כי היא מוטמעת. (I9e23b, b/389149423, b/149979716) - הוספנו את
TransformingLazyColumnItemScrollProgress.Unspecifiedל-API כדי למנוע הצגת מודעות בתוך מסגרת ב-TransformingLazyColumnItemScrollProgress. (I0835d)
תיקוני באגים
- שיפור של Kdoc עבור
CurvedTextStyle(Id45e3) - הפכנו את
SwipeableV2(חלק מההטמעה שלSwipeToReveal) לפנימי במקום לציבורי, אבל הגישה אליו מוגבלת לקבוצת הספרייה. (Idbb94) - הוספנו בדיקות ל-
HierarchicalFocusCoordinator(I1ce54, b/395548918) - ביצענו שיפורים ב-
SwipeToRevealבדוגמאות של wear compose foundation. (I5f307) - תיקון נתונים סמנטיים של ציר הגלילה ב-
verticalScrollAxisRangeב-TransformingLazyColumnלצורך נגישות (I68123) - שיפור הביצועים של משוב הפטי בסיבובי המסגרת ב-Wear4+ על ידי הסרת שרשורים מיותרים ברקע (I39cfe)
- משנים את
SwipeDismissableNavHostכך שישתמש ב-PredictiveBackNavHostרק ב-API 36 ואילך. (I59bed) - הוספנו אמצעי הגנה מפני קריסה כשניגשים להגדרה 'הפחתת תנועה'. (I01e2c)
- יישמנו שליפה מראש (prefetching) של
TransformingLazyColumnכדי לצמצם את הבעיה של קפיצות (jank) (Icca88)
גרסה 1.5.0-alpha09
29 בינואר 2025
androidx.wear.compose:compose-*:1.5.0-alpha09 מופץ. גרסה 1.5.0-alpha09 מכילה את השמירות האלה.
שינויים ב-API
- ב-
CurvedTextStyle, חילקנו את הריווח בין האותיות לריווח בין האותיות בכיוון השעון ולריווח בין האותיות נגד כיוון השעון. הסיבה לכך היא שהאותיות בכיוון השעון מתרחבות מקו הבסיס, ואילו האותיות נגד כיוון השעון מתרחבות פנימה (ולכן נדרש מרווח גדול יותר בין האותיות) (I4b848) - הפונקציה
CompositionLocalLocalReduceMotionפשוטה יותר עכשיו, והיא מחזירה ערך בוליאני במקום אובייקט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)
- הפכנו את הפרמטר של אנימציית ההצמדה של רכיב ה-pager לחלק מ-
PagerDefaults. (Ifff64) - הוספנו פרמטר offset ל-
SwipeToDismissBoxState. (I586bd)
תיקוני באגים
- הרטט של פלטפורמת החוגה נקרא עכשיו בגרסאות Wear OS אחרי V (Idb03e)
גרסה 1.5.0-alpha07
11 בדצמבר 2024
androidx.wear.compose:compose-*:1.5.0-alpha07 מופץ. גרסה 1.5.0-alpha07 מכילה את השמירות האלה.
שינויים ב-API
TransformingLazyColumnStateמספקת עכשיו דרך לצפות בהתקדמות הגלילה הנוכחית על סמך אינדקסים של פריטי עוגן. (I72b01)- הוספנו אנימציות ל-
TransformingLazyColumnכשמוסיפים, מסירים או מעבירים פריטים, אם יש להם אתModifier.animateItemהחדש. (Iecb9c) - ב-
TransformingLazyColumnמוצגים עכשיו ערכים שלbeforeContentPaddingו-afterContentPadding. (Iccd5f) -
TransformingLazyColumnמספק עכשיו את הקומפוזיציה המקומיתLocalTransformingLazyColumnItemScopeשרכיבים (כמוCardו-Buttonב-Material3) יכולים להשתמש בה כדי לעבור שינוי צורה אוטומטי כשהם ממוקמים בתוךTransformingLazyColumn. המתקשרים יכולים להשבית את ההמרה האוטומטית באמצעות העטיפה החדשהTransformExclusion. (I1652f)
תיקוני באגים
- עדכנו את המהירויות המינימליות והמקסימליות של ההטלה לסיבוב במכשירים שמטרגטים גרסה U ואילך. (I33559)
- תיקנו קריסה שהתרחשה אם פריט ב-
TransformingLazyColumnלא הכיל רכיבים שאפשר להרכיב (Idb99d) - הוספנו תמיכה ב-
ScrollFeedbackProviderבתחושות מישוש סיבוביות ב-Android Vanilla ice cream. (Ibc553) - הגדלנו את מרחק ההחלקה הנדרש כשמשתמשים ב-
SwipeToRevealכדי להקטין את הסיכוי להפעיל בטעות החלקה כשגוללים אנכית. (Ic0672) - עדכנו את
SwipeDismissableNavHostכך שישתמש ב-PredictiveBackHandlerכשהוא זמין ב-API 35 ואילך. במקרה כזה, יחולו אנימציות חדשות. (I08c11)
גרסה 1.5.0-alpha06
13 בנובמבר 2024
androidx.wear.compose:compose-*:1.5.0-alpha06 מופץ. גרסה 1.5.0-alpha06 מכילה את השמירות האלה.
שינויים ב-API
- פישטנו את
ScrollInfoProviderעבורPagerStateוהסרנו את הפרמטרorientation, שכבר לא נדרש. ההתנהגות החדשה היא שTimeTextיישאר במקום גם כשמגלגלים את הדפים אופקית וגם כשמגלגלים אותם אנכית. (I71767) - התכונה
TransformingLazyColumnהושקה בגרסאות קודמות. אנחנו מסירים עכשיו את הכינויים של Wear (LazyColumnשהופנו אלTransformingLazyColumn) ומחליפים אותם בשם החדשTransformingLazyColumn. הסרנו גם את המאפייןTransformingLazyColumnVisibleItemInfo'sheight– במקומו צריך להשתמש ב-measuredHeight. (I0ea1e) - שינינו את
PagerDefaults.snapFlingBehaviorsnapAnimationSpecממפרטTweenלמפרטSpring.(I10d02, b/349781047, b/303807950) - קידמנו את
LocalReduceMotionCompositionLocalלגרסה יציבה (Ia6f32)
תיקוני באגים
- עדכנו את
Modifier.rotaryScrollableכך שישתמש ב-focusTargetWithSemanticsכדי לשפר את התמיכה בסמנטיקה בסיבוב. (Ief0a0) - עדכנו את תלות ה-API המינימלית ל-1.7.4 בספריות Compose. (I88b46)
- השבתנו את שינוי הרוחב ב-
TransformingLazyColumnכפתרון זמני לבאג של חיתוך. (I3dfb8) - תיקנו באג שגרם לפריטים להיעלם אחרי גלילה מעבר לקצה עם
TransformingLazyColumn(מזהה 7668) - הוספנו את
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 FoundationLazyColumnיהיה ברור יותר. (I0608b) - הוספנו תמיכה בסיבוב של רכיבי החלפה אופקיים או אנכיים בין דפים, כדי לאפשר למשתמשים לנווט ברכיבי החלפה בין דפים באמצעות מכשירי קלט סיבוביים. (I9770d)
- עדכנו את הרכיב החדש
PagerDefaultsכדי להבהיר שברירת המחדל היא שהרכיב של החלפת הדפים יתמקם אוטומטית בדף. (Iff7d0) -
TransformingLazyColumnItemScrollProgressהוא עכשיו סיווג ערך, ולכן הביצועים צפויים להשתפר. (Ic399e) - מעכשיו יש תמיכה ב-
TransformingLazyColumnבשימוש בחוגה. (I05206) -
TransformingLazyColumnStateתומך עכשיו ב-scrollToItem. (I507b3) - הוסר
@ExperimentalWearFoundationApiמ-SwipeToRevealAPI (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שבו הפונקציהonDismissRequestcallback נקראה כש-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כחלק מ-LazyColumnAPI החדש. (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הוא משנה חדש שמקשר בין אירועים של סיבוב לבין מאגרי מידע שאפשר לגלול בהם, ומאפשר למשתמשים לגלול באמצעות כפתור או מסגרת מסתובבת במכשיר WearOS. -
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) - מקורות
NestedScrollDrag 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, שמחליף את ה-APIrememberRippleשהוצא משימוש. בנוסף, נוסףCompositionLocalזמני,LocalUseFallbackRippleImplementation, כדי להחזיר את השימוש ברכיבי Material לממשקיrememberRipple/RippleThemeAPI שהוצאו משימוש. האפשרות הזו תוסר בגרסה היציבה הבאה, והיא נועדה רק כעזר זמני להעברה במקרים שבהם אתם מספקיםRippleThemeמותאם אישית. מידע על המעבר ומידע נוסף על הרקע של השינוי הזה זמינים באתר developer.android.com. (af92b21) - עדכנו את
ColorSchemeכך שהוא לא ניתן לשינוי, ולכן עדכוני צבעים בודדים פחות יעילים, אבל השימוש הנפוץ יותר בצבעים יעיל יותר. הסיבה לשינוי הזה היא שברוב האפליקציות, עדכון של צבעים בודדים לא נחשב לתרחיש שימוש מרכזי. האפשרות הזו עדיין קיימת, אבל הקומפוזיציה תהיה שונה מבעבר. כתוצאה מכך, נצמצם באופן משמעותי את מספר המינויים למצב בכל קוד החומר, וזה ישפיע על עלות האתחול ועל עלות זמן הריצה של תרחישי שימוש סטנדרטיים יותר. (f5c48b7) - רכיבי Wear material ו-Wear material3 שחושפים
MutableInteractionSourceב-API שלהם עודכנו כך שהם חושפים עכשיוMutableInteractionSourceשניתן להגדיר כ-nullable, וערך ברירת המחדל שלו הוא 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. השינוי הזה נדרש כדי לתמוך בהתאמות של הגובה כשצריך גובה נוסף כדי להציג גדלי פונט גדולים – אחרת, הצורה הקיימת של האצטדיון חותכת חלק מתוכן הטקסט.איור 1: טקסט שנחתך בפינות. איור 2: הטקסט לא נחתך. השינוי הזה עלול לגרום לבעיות בבדיקות של צילומי מסך. (I2e6ae)
גרסה 1.3.0-beta02
13 בדצמבר 2023
androidx.wear.compose:compose-*:1.3.0-beta02 מופץ. גרסה 1.3.0-beta02 מכילה את השמירות האלה.
תיקוני באגים
- שחזרנו את תנועת ההחלקה המיועדת ב-
BasicSwipeToDismissBox. בגרסה קודמת, השינוי הזה בוצע כך שחלק המעבר של השקף התרחש בזמן שהאצבע נגעה במסך. (Id8e76)
גרסה 1.3.0-beta01
15 בנובמבר 2023
androidx.wear.compose:compose-*:1.3.0-beta01 מופץ. גרסה 1.3.0-beta01 מכילה את השמירות האלה.
גרסה 1.3-beta01 של Compose for 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. כך קל יותר להבחין בין הרכיב ברמת הבסיס לבין הרכיב ברמת החומרSwipeToDismissBox. האחרון שולף צבעים מ-MaterialThemeלשימוש בשכבות אטומות למחצה, ומעביר את שאר ההטמעה ל-BasicSwipeToDismissBox. (Ibecfc) - סימנו את
rememberExpandableStateMappingכניסיוני ושיפרנו את הביצועים שלexpandableItem. (I5f6bc) - החלפנו את המחלקה
SwipeToRevealActionבממשקי ה-API של MaterialSwipeToRevealCard ו-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) - הוצאנו משימוש את הרכיבים Material
SwipeToDismissBoxState, SwipeToDismissValueו-edgeSwipeToDismissאחרי שהעברנו את הפונקציונליות של החלקה כדי לסגור ל-wear.compose.foundation. צריך להחליף אותם במקביליםwear.compose.foundation. (Iee8c9)
תיקוני באגים
- עדכנו את פרופילי הבסיס של ספריות wear compose foundation, material ו-navigation. (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באמצעות כרטיסים וצ'יפים. הפונקציות האלה ניתנות להרכבה ועומדות בהנחיות המומלצות לגבי חוויית המשתמש ברכיב, וכך הן מקלות על המפתחים להטמיע את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, ההטמעה של MaterialSwipeToDismissBoxמועברת עכשיו ל-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) - תיקנו חוסר עקביות בפרמטרים של ברירת המחדל של
SwipeToDismissBoxcontentScrimColor. (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 מכילה את השמירות האלה.
תכונות חדשות
- הוספנו את המשתנה הניסיוני החדש
LocalReduceMotionCompositionLocalשמשבית את השינוי של הגודל וההחלשה שלScalingLazyColumn. (I58024)
תיקוני באגים
- עדכנו את פרופילי הבסיס של ספריות ה-Wear Compose Foundation ו-Material(I4725d)
- תיקנו חוסר עקביות בערכי ברירת המחדל של פרמטרים
SwipeToDismissBoxcontentScrimColor(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 for Wear OS מציינת שהגרסה הזו של הספרייה כוללת את כל התכונות וה-API נעול (אלא אם מצוין אחרת). Wear Compose 1.2 כולל את הפונקציות החדשות הבאות:
-
expandableItemו-expandableItemsהם שני רכיביFoundationחדשים שתומכים בהרחבת פריטים בתוךScalingLazyColumn. משתמשים ב-expandableItemלפריט יחיד שניתן להרחבה, כמו טקסט שבו מספר השורות. משתמשים ב-expandableItemsלקבוצה של פריטים שניתן להרחיב, וב-expandableButtonכדי לפשט את יצירת הלחצן שמתכווץ אחרי הרחבת התוכן. -
HierarchicalFocusCoordinator– רכיב ניסיוני שאפשר להשתמש בו כדי לסמן עצי משנה של הקומפוזיציה ככאלה שאפשר להתמקד בהם או ככאלה שאי אפשר להתמקד בהם. -
Picker– ה-API כולל עכשיו אתuserScrollEnabledכדי לקבוע אם הכלי לבחירת תמונות פעיל בזמן שהמשתמש גולל. -
PickerGroup– רכיב חדש שאפשר להוסיף לאפליקציה כדי לטפל בכמה רכיבי בחירה ביחד. הוא מטפל בהעברת המיקוד בין כלי הבחירה באמצעותHierarchicalFocusCoordinatorAPI ומאפשר מרכוז אוטומטי של פריטים בכלי הבחירה. -
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כדי לצמצם את הבעיות שקשורות ל-jank. (I35e92) - תיקנו באג בצ'יפ וב-
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ל-CurvedModifierAPI להגדרת רוחב זוויתי ב-DP (I89a52)
תיקוני באגים
- תיקנו בעיות נגישות בהדגמות של כלי בחירת הזמן שלנו(Id0eb7)
גרסה 1.2.0-alpha08
5 באפריל 2023
androidx.wear.compose:compose-*:1.2.0-alpha08 מופץ. גרסה 1.2.0-alpha08 מכילה את השמירות האלה.
שינויים ב-API
- שינינו את השם של
ExpandableItemsStateל-ExpandableState. (If85ea) - הוספנו את
expandableButtonכדי לפשט את יצירת הלחצן שמתכווץ כשהתוכן מורחב, ועדכנו גם את הדוגמאות של הרכיבים הניתנים להרחבה. (Iae309)
תיקוני באגים
- שיפרנו את הדוגמאות שניתן להרחיב כדי להציג יותר אפשרויות. האנימציה של
expandableItemשונתה כדי שהתוכן שלה יישאר במרכז במהלך האנימציה. (I2f637) - בוצע עדכון של
ToggleControlsכדי למנוע קומפוזיציות חוזרות מיותרות כשמבצעים אנימציה של הצבעים באופן ידני באמצעות State. (I5d319)
גרסה 1.2.0-alpha07
22 במרץ 2023
androidx.wear.compose:compose-*:1.2.0-alpha07 מופץ. גרסה 1.2.0-alpha07 מכילה את השמירות האלה.
שינויים ב-API
- העברנו את רכיבי הפריטים הניתנים להרחבה (נוספו בגרסה 1.2.0-alpha06) מ-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) - הוספנו את ההערות המותאמות אישית הבאות לתצוגה מקדימה של פונקציות composable במסכי Wear:
WearPreviewSmallRoundמציגה תצוגה מקדימה של פונקציית ה-composable במכשיר קטן ועגול, WearPreviewLargeRoundמציגה תצוגה מקדימה של פונקציית ה-composable במכשיר גדול ועגול, WearPreviewSquareמציגה תצוגה מקדימה של פונקציית ה-composable במכשיר מרובע. בנוסף, יש את ההערות הבאות לתצוגה מקדימה של כמה רכיבים: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
- עדכנו את
PickerGroupAPI כדי לאפשר העברה של האילוצים המינימליים לרכיב שאפשר להרכיב, כאפשרות. כשהיא מוגדרת כ-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 על ידי העברת המיקוד לרכיב Picker שנבחר מתוך הקבוצה. (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:
- הוצאנו משימוש את ממשקי ה-API שמטרגטים את Material
ScalingLazyColumn. צריך לעדכן ל-Foundation.Lazy ScalingLazyColumn.PositionIndicatorבנוסף, השדהanchorTypeנוסף ל-ScalingLazyListLayoutInfo. (I29d95) -
ScalingLazyColumnסומן כהוצאה משימוש בחבילת Wear Compose Material (I16d34) - עדכנו את ה-modifier
ScrollAwayכך שישתמש ב-ScalingLazyListStateמ-Wear ComposeFoundation.Lazyוהוצאנו משימוש את ה-overload שקיבלScalingLazyListStateמ-Wear Compose Material. (Ifc42c) - עדכנו את ממשקי ה-API של Dialog כך שישתמשו ב-
ScalingLazyListStateמ-Foundation.Lazyוהוצאנו משימוש את העומסים העודפים שהשתמשו ב-MaterialScalingLazyListState(Ic8960) - עדכנו את Picker APIs כך שישתמשו ב-
ScalingParamsמ-Foundation.Lazyוהוצאנו משימוש את העומסים העודפים שהשתמשו ב-MaterialScalingParams. (Idc3d8)
תיקוני באגים
- תיקנו באג שגרם להרכבות מחדש מיותרות ב-
ScalingLazyListState.centerItemIndex. עכשיו המערכת מעבירה עדכונים רק כשהערך משתנה בפועל (Ia9f38) - שיפרנו את הביצועים של
SwipeToDismissBox(I3933b) - נוספו בדיקות השוואה לשוק עבור
ScalingLazyColumnב-Wear Compose Foundation (Ie00f9) - עדכנו כמה שיטות של מחלקות פנימיות של
ScalingLazyColumnב-Material כך שישתמשו במקבילות שלהן מ-Foundation.Lazy(I38aab) - תיקנו כמה בעיות בבדיקות של כלי הבחירה והוספנו עוד בדיקות לבדיקת גלילה עם היסט (I6ac34)
- העברנו את
ScalingLazyColumnIntegration Demos כך שיסתמכו עלFoundation.Lazyבמקום על MaterialScalingLazyColumn(Ic6caa) - הוספנו פרמטרים אופציונליים
fromDate/toDateלהדגמהDatePickerשלנו (I961cd)
גרסה 1.2.0-alpha02
11 בינואר 2023
androidx.wear.compose:compose-*:1.2.0-alpha02 מופץ. גרסה 1.2.0-alpha02 מכילה את השמירות האלה.
שינויים ב-API
- בדיקות ממשק משתמש של Android Compose יפעילו עכשיו מעברים בפריסה לכל פריים כשמבצעים פריים כדי להגיע למצב סרק (למשל באמצעות
waitForIdle). יכול להיות שהשינוי הזה ישפיע על בדיקות שמתבצעות בפריים ספציפי של אנימציות פריסה. (I8ea08, b/222093277) - הפרמטר
minLinesנוסף ל-Wear Text כדי ליצור התנהגות עקבית עםBasicText(I24874) -
CompactChipTapTargetPaddingהוגדר כציבורי כדי שיופיע במסמכי התיעוד (If1e70, b/234119038)
תיקוני באגים
- השבתת בנייה מולטי-פלטפורמית לחבילות
wear.compose(Iad3d7) - תיקון קובצי kdocs עבור
scrollToOption(I6f9a0) - העדכון של
PlaceholderState.rememberPlaceholderState()מאפשר להשתמש ב-rememberUpdatedStateכדי שהמצב יעודכן אםonContentReadylambda. (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
- הוספנו
HierarchicalFocusCoordinatorcomposable כדי לאפשר סימון של עצי משנה בהרכב ככאלה שאפשר להתמקד בהם או ככאלה שאי אפשר להתמקד בהם.(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כדי שהמצב יעודכן אםonContentReadylambda. (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) - ביצענו כמה עדכונים בממשק המשתמש של ה-placeholders: 1) שינינו את שיפוע האפקט המנצנץ ל-1.5x מגודל המסך, 2) הוספנו אפקט easing (עקומת בזייה מעוקבת) להתקדמות האפקט המנצנץ ו-3) הגברנו את מהירות האנימציה של המחיקה (250ms). (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 for Wear OS צוין שהגרסה הזו של הספרייה כוללת את כל התכונות וה-API נעול.
- הגרסה Wear Compose 1.1 כוללת את הפונקציות החדשות הבאות:
- כלי הבחירה – שיפורים בנגישות של כלי הבחירה כדי שאפשר יהיה לנווט במסכים של כלי הבחירה המרובה באמצעות קוראי מסך, ושהתיאור של התוכן יהיה נגיש
- הפרמטר Picker
contentDescriptionמשמש עכשיו רק לאפשרות Picker שנבחרה, והוא מקבל מחרוזת שניתן להגדיר כ-nullable (ב-commit הקודם היה צריך להעביר מיפוי מאפשרות לתיאור התוכן, אבל נעשה שימוש רק באפשרות שנבחרה). - הפריטים בכלי לבחירת תאריכים תמיד מיושרים למרכז. כך נפתרה בעיה שבה הגדרת
gradientRatioלאפס גרמה לשינוי ביישור. -
Chip/ToggleChip– עדכנו את הגרדיאנטים שמוגדרים כברירת מחדל ב-Chip/ToggleChipכדי להתאים אותם למפרט ה-UX העדכני. ב-ChipDefaults.gradientBackgroundChipColors, הגרדיאנט מתחיל מ-50% מהצבע הראשי במקום מ-32.5%. -
Chip/ToggleChip– נוספו עומסים יתרים לשינוי צורות של צ'יפים Chip/Button/ToggleButton– נוסף סגנון חדש של מתאר ל-Chips ול-Buttons, ונוספו רכיביOutlinedChipו-OutlinedButtoncomposable חדשים שמספקים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 internalScalingLazyColumnכדי לוודא שאפשר לגלול את האפשרות הראשונה למרכז התצוגה. (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(קודם הוא היה בפיקסלים). בנוסף, בוצע refactoring של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של הכלי לבחירת קבצים משמש עכשיו רק לאפשרות שנבחרה בכלי, והוא מקבל מחרוזת שאפשר להגדיר כ-nullable (בעבר היה צריך להעביר מיפוי מהאפשרות לתיאור התוכן, אבל רק האפשרות שנבחרה הייתה בשימוש). (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ההאצה וההאטה של התנועה כשהפריטים מגיעים לקצה המסך, כדי להתאים לעדכונים במפרט חוויית המשתמש. ערכים ישנים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שמקבלTextStyleמכבד עכשיו גם אתfontWeight(יכול להיות שזה יתווסף לקונסטרוקטור ולשיטות ההעתקה בגרסאות עתידיות של ה-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 מכילה את השמירות האלה.
מה כולל Compose ל-Wear OS 1.0
ההשקה של 1.0.0-beta01 של Compose ל-Wear OS היא ציון דרך חשוב, כי הספרייה כוללת את כל התכונות וה-API נעול.
הרכיבים של Wear Compose Material בגרסה 1.0 כוללים:
- Material Theme – משמש כתחליף ל-Compose for Mobile
MaterialTheme, ומספק את הצבעים, הצורות והטיפוגרפיה לבניית רכיבים במכשירי Wearable שמטמיעים את הנחיות 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' שבהמשך מפורט מידע נוסף עלCurvedLayoutועלCurvedModifier(התפקיד שלהם דומה לזה של משנים בעולם הלא מעוגל, והם מאפשרים להגדיר היבטים שונים של פריסה, מרווחים פנימיים, מעברי צבעים וכו'). - תיבת דו-שיח, התראה ואישור – תיבת דו-שיח מוצגת במסך מלא, בשכבה מעל כל תוכן אחר, ויש אפשרות להחליק כדי לסגור אותה. הוא מקבל משבצת אחת שאמורה להיות תוכן של תיבת דו-שיח עם דעה בנושא 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הוא לא lambda שאפשר להרכיב ממנו lambda אחר – אלא שפה ספציפית לדומיין (DSL). כל הרכיבים ב-DSL של CurvedLayout תומכים בפרמטר אופציונלי של שינוי, שנוצר מ-CurvedModifier.basicCurvedText – רכיב ב-
CurvedLayoutDSL,basicCurvedTextשמאפשר למפתחים לכתוב בקלות טקסט מעוקל בהתאם לקימור של מעגל (בדרך כלל בקצה של מסך עגול). אפשר ליצור אתbasicCurvedTextרק בתוךCurvedLayoutכדי להבטיח את חוויית השימוש הטובה ביותר, למשל היכולת לציין את המיקום ולהשתמש ב-CurvedModifiers. חשוב לדעת שברוב המקרים כדאי להשתמש במקום זאת ב-curvedText, כי הוא משתמש בערכות נושא של Material.curvedComposable – עוטף תוכן קומפוזבילי רגיל כדי שאפשר יהיה להשתמש בו עם
CurvedLayout. אם יש כמה רכיבים בתוך התגcurvedComposable, הם יוצגו אחד על גבי השני (כמו תיבה). כדי להציב כמה רכיבים שאפשר להרכיב לאורך עקומה, עוטפים כל אחד מהם ב-curvedComposable.curvedRow ו-curvedColumn – בדומה לרכיבים Row ו-Column, אפשר לקנן את הרכיבים
curvedRowו-curvedColumnבתוך הרכיבCurvedLayoutכדי להציג את הרכיבים לפי הצורך. ב-curvedRowאפשר לציין את כיוון הפריסה הזוויתי ואת היישור הרדיאלי. במקרה שלcurvedColumn, אפשר לציין את היישור הזוויתי ואת הכיוון הרדיאלי.CurvedModifier – כל הרכיבים המעוקלים מקבלים פרמטר של שינוי שאפשר ליצור באמצעות
CurvedModifier. יש תמיכה בפרמטרים: background, size, weight ו-padding.הרכיב הבא כלול גם בספריית הניווט של Wear Compose:
SwipeDismissableNavHost – מספק מקום בהיררכיית Compose לניווט עצמאי, עם ניווט אחורה באמצעות תנועת החלקה. התוכן מוצג בתוך
SwipeToDismissBox, ומוצגת רמת הניווט הנוכחית. במהלך תנועת החלקה לסגירה, רמת הניווט הקודמת (אם יש כזו) מוצגת ברקע.לפרטים נוספים על מה שסופק, אפשר לעיין בהערות המוצר הקודמות של גרסאות האלפא השונות.
שינויים ב-API
- נוספו
CurvedModifier.padding*פונקציות. הם משמשים לציון רווח נוסף שיוסף מסביב לרכיב מעוקל. (I4dbb4) - הוסרה כיתה פנימית
CompositionLocal(I42490) - הוספנו ערכים קבועים לגדלים של הסמלים
Button,CompactButtonו-ToggleButton, כהנחיה (I57cab) - מוסיפים את הפרמטר enabled ל-
AppCardול-TitleCard. עכשיו יש להם API דומה ל-androidx.compose.materialCards. אם הפרמטר מוגדר כ-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/...) כי הצבע מוחל על המשבצת של הסמל או של לחצן ההחלפה. (Ied238) - שכתוב
PageIndicatorStyleenum למחלקת ערכים (I2dc72) - הוספנו את
RowScope/ColumnScope/BoxScopeלחלק מהמיקומים ברכיבי ה-Composable שלנו כדי לציין למפתחים מהן הנחות ברירת המחדל לגבי הפריסות. כך מפתחים יוכלו להשתמש במאפייני שינוי נוספים בחלק מהתוכן של המשבצות, ולא יצטרכו לספק רכיבי פריסה נוספים. בנוסף, ביצענו כמה עדכונים קלים בצבעים של AppCard ו-TitleCard כך שברירת המחדל שלtimeColorו-appColorהיאcontentColor. עדיין אפשר לשנות את כל המאפיינים האלה בנפרד אם צריך. (I26b59) - הגדרת האובייקט
SwipeToDismissBoxState.Companionכפרטי (I39e84) - תיקון סדר הפרמטרים של
InlineSliderושלStepper. שינוי פשוט כדי לפעול בהתאם להנחיות בנושא API (I11fec) - הסרנו את אובייקט החיסכון עבור
SwipeToDismissBoxStateכי הוא לא היה בשימוש. (Ifb54e) - עדכנו את
CompactChipבהתאם למפרט העדכני של חוויית המשתמש. המרווח הפנימי צומצם ל-12dp אופקי ו-0dp אנכי. הגופן של התווית השתנה מלחצן ל-caption1. הגדלים המומלצים של סמלים הם 20x20 אם יש גם סמל וגם תווית, ו-24x24 אם יש רק סמל בצ'יפ קומפקטי. במקרה השימוש של סמל בלבד, דאגנו גם שהסמל יהיה מיושר למרכז. (Iea2be) - הוספנו מספר שדות חדשים ל-
ScalingLazyListLayoutInfoכדי לאפשר למפתחים לדעת את הכמות שלcontentPaddingושלautoCenteringPaddingשהוקצתה. הם יכולים להיות שימושיים למפתחים כשמחשבים תנועת החלקה או גלילה (I7577b) - הטמענו מעברים פנימה/החוצה ב-Dialog. נוסף פרמטר
showDialogוחלון הדו-שיח שולט עכשיו בנראות שלו (הפרמטר הזה מאפשר להפעיל את אנימציות הפתיחה והסיום כשחלון הדו-שיח מוצג או מוסתר). שימו לב: אנימציית הסיום לא מופעלת כשהמשתמש יוצא מתיבת הדו-שיח באמצעות החלקה לסגירה. הוספנו גם ערך ברירת מחדל למצב בעומס היתרSwipeToDismissBoxשנוסף לאחרונה. (I682a0) - כדי לשפר את התמיכה ב-i18n וב-a11y, שינינו את
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)
- תיקון באג בכתובת 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) - החלפת השמות של פרמטרים מובילים ופרמטרים נגררים בשמות Start ו-End ב-TimeText (Iaac32)
- הוספנו
SwipeToDismissBoxoverload עם פרמטרonDismissedכדי לתמוך בשימוש הנפוץ בהפעלת אירוע ניווט כשתנועת ההחלקה מסתיימת. (I50353, b/226565726) - הוסרו
ExperimentalWearMaterialApiהערות מהשימוש ב-TimeText(Ide520) - סימנו את הממשקים
ScalingLazyList/Columnscope ו-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) - ב-
SwipeToDismissBox, שינינו את השם שלSwipeDismissTarget.Original ל-SwipeToDismissValue.Defaultואת השם שלSwipeDismissTarget.Dismissalל-SwipeToDismissValue.Dismissed. העברנו גם אתSwipeToDismissBoxDefaults.BackgroundKeyואתSwipeToDismissBoxDefaults.ContentKeyאלSwipeToDismissKeys.BackgroundוSwipeToDismissKeys.Contentבהתאמה. (I47a36) - הוספנו מצב קריאה בלבד לכלי לבחירת קבצים, למסכים עם כמה כלים לבחירת קבצים שרק אחד מהם ניתן לעריכה בכל פעם. כשבוחר האפשרויות הוא לקריאה בלבד, הוא מציג את האפשרות שנבחרה כרגע, ותווית אם סופקה כזו. (I879de)
- בוצע רפקטורינג ב-
SwipeToDismissBoxStateכדי להגביל את ההיקף שלExperimentalWearMaterialApiל-Modifier.swipeableול-SwipeableState, שמשמשים עכשיו באופן פנימי. ל-SwipeToDismissBoxStateיש עכשיוcurrentValue, targetValue, isAnimationRunningו-snapToחברים כדי לתמוך בתרחישי שימוש נפוצים. נשמח לדעת אם יש מאפיינים נוספים שאתם רוצים שיהיו זמינים. תוקן גם אופן הפעולה שלSwipeableStateבמקרה שבו ההיסט של ההחלקה נמצא בטווח של שגיאת עיגול של עוגן. (I58302)
תיקוני באגים
- קוד פשוט ומתוקן לזיהוי האפשרות לגלול את התוכן של
ScalingLazyColumn(משמש להחלטה אם להציג פס גלילה או לא) (I7bce0) - תוקנה באג באינדיקטור המיקום כשמשתמשים בו עם יותר ממצב אחד ועוברים ביניהם (I320b5)
- עדכנו את ברירת המחדל של העיצוב של Compose ל-Wear OS, כך שהטיפוגרפיה והגופנים יתאימו להנחיות העדכניות שלנו לגבי חוויית משתמש. שימו לב: הגדלים של display1 (40.sp) ו-display2 (34.sp) קטנים יותר מהערכים הקודמים שלהם, ובוצעו עדכונים קלים נוספים במרווח בין השורות ובמרווח בין המילים. (Ie3077)
- הוספנו התנגדות ל
SwipeToDismissBoxכדי שהתנועה תתרחש רק כשמחליקים כדי לסגור את ההתראה, ולא בכיוון ההפוך. (Ifdfb9) - שינינו חלק מערכי ברירת המחדל של הפרמטרים של הפונקציות
CircularProgressIndicatorכדי להתאים אותם להנחיות של Wear Material Design 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, כשמספר הימים בחודש משתנה בהתאם לחודש שנבחר. פרמטר הבנאי של PickerState השתנה בהתאם ל-initialNumberOfOptions. (Iad066) - הסתרת
PositionIndicatorכשהוא פס גלילה ואי אפשר לגלול. (Id0a7f) - כדי לשמור על עקביות עם Scaffold, רכיב הדו-שיח במסך מלא מציג עכשיו את הסמלים
PositionIndicatorו-Vignette. בנוסף, אנחנו משתמשים עכשיו ב-ScalingLazyColumnבמקום ב-Column, כלומר התוכן של תיבת הדו-שיח נמצא עכשיו ב-ScalingLazyListScope(ובדרך כלל צריך להוסיף אותו בין הפריטים { /* content */ }). תיבת הדו-שיח תומכת בפרמטר verticalArrangement בהתאם. (Idea13) - שינינו את השם של המאפיין toggleIcon של
ToggleChipושלSplitToggleChipל-toggleControl כדי להתאים יותר לעיצוב Material Design, וכך לעזור למעצבים ולמפתחים לנווט ב-API. (If5921, b/220129803) - הוספנו כיתוב חדש, Caption3, לטיפוגרפיה של ערכת העיצוב Wear Material.Caption3 הוא גופן קטן שמשמש לכתיבה ארוכה במיוחד, כמו טקסטים משפטיים. (I74b13, b/220128356)
תיקוני באגים
- להפסיק את אנימציית ההצמדה כשהגענו לשם. (Idb69d)
- אנימציה של שינויים ב-PositionIndicator. (I94cb9)
- על סמך משוב על ממשק המשתמש וחוויית המשתמש, שינינו את
ScalingLazyColumnautoCentering כך שהוא יספק רק מספיק מקום כדי לוודא שאפשר לגלול את הפריטים עם האינדקסScalingLazyListState.initialCenterItemIndexומעלה למרכז אזור התצוגה. כך המפתחים יכולים להציב פריט אחד או שניים על הפריט מלכתחילה במרכז, ולא ניתן לגלול אותם לאמצע. המשמעות היא שלא תהיה אפשרות לגלול מעלinitialCenterItemIndex/initialCenterItemScrollOffset(I22ee2) אם מוגדרתScalingLazyColumnautoCenter. - הוספנו הדגמה של חלונית לבחירת תאריך ותיקנו באג ב-
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. אינדיקטורים של התקדמות מציגים את משך התהליך או זמן המתנה שלא צוין. תומך ברווח (cutout) עבור TimeText או רכיבים אחרים אם משתמשים במסך מלא. (Iab8da)
שינויים ב-API
- לרכיבי הבחירה יש עכשיו פרמטר
flingBehavior. ערך ברירת המחדל גורם להם להיצמד לאפשרות הקרובה ביותר כשגוללים או מעבירים במהירות. (I09000) - API נוסף של מספרים שלמים לרכיבים InlineSlider ו-Stepper (I1b5d6)
תיקוני באגים
- שינינו את ברירת המחדל של initialCenterItemIndex עבור
ScalingLazyListStateמ-0 ל-1. כלומר, אלא אם יש ביטול בהגדרת המצב עםScalingLazyListState.rememberScalingLazyListState(initialCenterItemIndex =), הפריט השני ברשימה (index == 1) יוצב במרכז אזור התצוגה בזמן האתחול, והפריט הראשון (index == 0) יוצב לפניו. כך אפשר לקבל אפקט חזותי טוב יותר כברירת מחדל, כי רוב אזור התצוגה יתמלא בפריטים של הרשימה. (I0c623, b/217344252) - הקטנו את
ScalingLazyColumnברירת המחדלextraPaddingשמוצגת כדי לוודא שיש מספיק פריטים ברשימה שאפשר לבחור מתוכם (גם כשאנחנו מקטינים חלק מהם) מ-10% ל-5%. כך לא תצטרכו ליצור פריטים נוספים לרשימה שלא יופיעו באזור התצוגה. אם נעשה שימוש ב-scalingParams לא סטנדרטיים (למשל, שינוי קנה מידה קיצוני יותר), המפתח יכול לשנות את הריווח הנוסף באמצעותviewportVerticalOffsetResolver. (I76be4) - תוקנה בעיה שקשורה ל-TimeText בכמה שורות במכשיר מרובע (Ibd3fb)
- שינינו את
ScalingLazyColumnכך שהוא לא ימלא יותר את כל השטח ברכיב האב שלו. במקום זאת, הגודל שלו ייקבע לפי גודל התוכן שלו. כך שההתנהגות תהיה עקבית עם ההתנהגות שלLazyColumn. אם רוצים להחזיר את ההתנהגות הקודמת, צריך להעביר אתModifier.fillMaxSize()אלScalingLazyColumn– הערה: השינוי הזה לא הושלם והוא יטופל בשינוי המשך בגרסת האלפא הבאה. (I3cbfa)
גרסה 1.0.0-alpha15
26 בינואר 2022
התכונות androidx.wear.compose:compose-foundation:1.0.0-alpha15, androidx.wear.compose:compose-material:1.0.0-alpha15 וגם androidx.wear.compose:compose-navigation:1.0.0-alpha15 מושקות. גרסה 1.0.0-alpha15 מכילה את השמירות האלה.
שינויים ב-API
- הוספנו את הנכס החדש
autoCenteringאלScalingLazyColumn. אם הערך הוא True (ברירת המחדל), כל הפריטים, כולל הראשון והאחרון, יוצגו במרכז אזור התצוגה של הרשימה. שימו לב: אם משתמשים במרכוז אוטומטי, כדאי להגדיר את הריווח הפנימי של התוכן האנכי ל-0.dp. אם מספקים גם autoCentering וגם vertical content padding, שניהם יגרמו לכך שיהיה יותר מקום לפני הפריט הראשון ואחרי הפריט האחרון ברשימה, כך שאפשר יהיה לגלול אותם עוד יותר. (I2a282, b/214922490) - הוספנו רכיב
Dialogשמאפשר לכל רכיב שניתן להרכבה להפעיל תיבת דו-שיח במסך מלא שמוצגת מעל תוכן אחר. כשחלון הדו-שיח מוצג, אפשר להחליק כדי לסגור אותו, ובמהלך ההחלקה מוצג התוכן של רכיב ההורה ברקע. התוכן של הדו-שיח צפוי להיותAlertאוConfirmation(שמות חדשים לרכיביםAlertDialogו-ConfirmationDialogהקודמים) –Alert,Confirmationו-Dialogנמצאים כולם בחבילהandroidx.wear.compose.material.dialog. אפשר להשתמש בהתראה ובאישור כיעדים לניווט. בנוסף, הוספתי ColumnScope לפרמטרים של Alert ו-Confirmation לפי הצורך. (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)הוספנו ל-
SwipeDismissableNavHosthandler של כפתור החזרה, כך שלחיצה על הכפתור הזה תעביר אתכם לרמה הקודמת בהיררכיית הניווט. (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 הוא אמצעי בקרה במסך מלא עם לחצני הגדלה והקטנה בחלק העליון והתחתון, ומשבצת באמצע (שצפויה להכיל רכיב Chip או Text). אפשר להתאים אישית את סמלי הלחצנים אם רוצים. (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 compose. הרכיב InlineSlider מאפשר למשתמשים לבחור מתוך טווח ערכים. טווח הבחירה מוצג כסרגל בין ערכי המינימום והמקסימום של הטווח, שהמשתמשים יכולים לבחור ערך מתוכו. (If0148)
כדאי לנסות את ה-Codelab החדש בנושא Compose ל-WearOS.
שינויים ב-API
- ל-Macrobenchmark יש עכשיו
minSdkVersionשל23. (If2655)
תיקוני באגים
- עדכון של הטיפול במעברים ב-SwipeDismissableNavHost ב-SideEffect (I04994, b/202863359)
- עדכון של הטיפול במעברים ב-SwipeDismissableNavHost (I1cbe0, b/202863359)
גרסה 1.0.0-alpha09
27 באוקטובר 2021
התכונות androidx.wear.compose:compose-foundation:1.0.0-alpha09, androidx.wear.compose:compose-material:1.0.0-alpha09 וגם androidx.wear.compose:compose-navigation:1.0.0-alpha09 מושקות. גרסה 1.0.0-alpha09 מכילה את השמירות האלה.
תכונות חדשות
- השקנו את גרסת ה-Developer Preview של Compose ב-Wear OS. בפוסט בבלוג שלנו מפורטות הפונקציות העיקריות של Compose ויש בו קישורים למקורות מידע נוספים שיעזרו לכם להתחיל להשתמש בהן.
שינויים ב-API
- הוספנו תמיכה במפתחים כדי שיוכלו להתאים אישית את כל הצבעים בעיצוב הצבעים של Wear Material Design. (I4759b, b/199754668)
תיקוני באגים
- נוספו דוגמאות של SwipeToDismissBox ששומרות את המצב (Ibaffe)
- הוספנו קישורים למדריכים ב-developer.android.com מ-KDocs עבור CurvedText, TimeText ו-SwipeToDismissBox. (I399d4)
- הקומפוננטה SwipeDismissableNavHost מוציאה עכשיו חריגה אם אין יעד נוכחי (מציין שה-NavGraph לא נוצר באמצעות פונקציית כלי השירות wear.compose.navigation.composable) (I91403)
- נוספו מסמכים ודוגמאות נוספים לשימוש במקור זמן ב-TimeText (I4f6f0)
גרסה 1.0.0-alpha08
13 באוקטובר 2021
התכונות androidx.wear.compose:compose-foundation:1.0.0-alpha08, androidx.wear.compose:compose-material:1.0.0-alpha08 וגם androidx.wear.compose:compose-navigation:1.0.0-alpha08 מושקות. גרסה 1.0.0-alpha08 מכילה את השמירות האלה.
שינויים ב-API
- שינינו את השם של המאפיינים AppCard ו-TitleCard ל- והעברנו אותם לסוף רשימת המאפיינים כדי לאפשר להגדיר אותם כביטוי למבדא (trailing lambda).
bodycontentבנוסף, שינינו את השם של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שמוחזר כדי לתמוך טוב יותר ברכיבי ניווט אופציונליים כמו אלה של Accompanist Navigation Material. (I4619e) - Reference NamedNavArgument from navigation-common and remove copy from 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 (כמו Scroll או Volume), אזור בחלק העליון של המסך להצגת השעה וסטטוס האפליקציה, ותומך גם ב-Vignette כדי לטשטש את הקצה העליון והתחתון של המסך לתוכן שאפשר לגלול בו. באזור הראשי של ה-Scaffold ממוקם התוכן של האפליקציה. (I5e0bf)
- נוספה הטמעה של TimeText ל-Wear Compose (I5654c)
ספריית הניווט של Wear Compose
הוספנו את הגרסה הראשונה של ספריית הניווט Wear Compose, שמספקת שילוב בין הספריות Wear Compose ו-Androidx Navigation. הוא מספק דרך פשוטה לנווט בין פונקציות @Composable כיעדים באפליקציה.
הגרסה הראשונית הזו כוללת:
- רכיב
SwipeDismissableNavHostשאפשר להוסיף לו רכיבים אחרים, שמארח תרשים ניווט ומספק ניווט אחורה באמצעות תנועות החלקה NavGraphBuilder.composableתוסף שיעזור לכם ליצור תרשימי ניווט-
rememberSwipeDismissableNavController()כדי לאפשר העלאת רמה של מצב
- רכיב
דוגמה לשימוש שבו אנחנו יוצרים שני מסכים ועוברים ביניהם:
val navController = rememberSwipeDismissableNavController() SwipeDismissableNavHost( navController = navController, startDestination = "start" ) { composable("start") { Column( horizontalAlignment = Alignment.CenterHorizontally, verticalArrangement = Arrangement.Center, modifier = Modifier.fillMaxSize(), ) { Button(onClick = { navController.navigate("next") }) { Text("Go") } } } composable("next") { Column( horizontalAlignment = Alignment.CenterHorizontally, verticalArrangement = Arrangement.Center, modifier = Modifier.fillMaxSize(), ) { Text("Swipe to go back") } } }Wear Compose 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)
- הריווח בין הכותרת לבין הטקסט בכרטיס הכותרת צומצם מ-8dp ל-2dp.
- הגופן של הכותרת של כרטיס הכותרת השתנה מ-body ל-title3.
- השתנה הגרדיאנט של הרקע של הכרטיס כדי שהרקע ייראה כהה יותר.
גרסה 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 אחרי שהשינוי בגודל בוצע. תיקנו גם באג שקשור לאופן שבו בוצע חישוב של שינוי הגודל כשנעשה שימוש ב-padding של התוכן העליון ב-ScalingLazyColumn. (I27c07)
שינויים ב-API
- מוסיפים את המחלקה CurvedTextStyle כדי לציין את סגנון הטקסט המעוקל אפשרויות. בדומה ל-TextStyle, אבל עכשיו יש תמיכה רק בצבע, בגודל הגופן וברקע. בעתיד נוסיף עוד אפשרויות עיצוב. (I96ac3)
- הוספנו את הממשקים ScalingLazyColumnItemInfo ו-ScalingLazyColumnLayoutInfo למחלקה ScalingLazyColumnState כדי לאפשר למפתחים לדעת את המיקומים והגדלים בפועל של פריטים ב-ScalingLazyColumn אחרי שהשינוי בגודל בוצע. תיקנו גם באג שקשור לאופן שבו בוצע חישוב של שינוי הגודל כשנעשה שימוש ב-padding של התוכן העליון ב-ScalingLazyColumn. (I27c07)
- הוספנו את
@ExperimentalWearMaterialApiלרשימת הערכים האפשרייםSwipeDismissTarget, שהיא חלק מ-SwipeToDismissBoxAPI. (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)
- העדכון של הריווח הפנימי של תוכן הצ'יפים בהתחלה ובסוף מאפשר להגדיר אותו באופן עקבי ל-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.
בנוסף, תהיה תמיכה בתכונות ספציפיות אחרות למכשירים לבישים, כמו פריסות וטקסט מעוקלים, וגם תמיכה בפיגומים שיקלו על מפתחים ליצור אפליקציות או שכבות-על למכשירים לבישים.
ספריית Wear Compose Material מבוססת על אותם עקרונות כמו ספריית Compose Material, אבל היא מיועדת למכשירים לבישים. כשמפתחים אפליקציות למכשירים לבישים, צריך להשתמש בספריית Wear Compose Material במקום בספריית Compose Material.
שתי ספריות ה-Material הן בלעדיות, ואין לערב ביניהן באותה אפליקציה. אם מפתחים מוצאים את עצמם כוללים את ספריית ה-Compose Material בתלות שלהם, זה מצביע על כך ש-א) יש רכיבים שחסרים בספריית ה-Wear Compose Material, ואנחנו מבקשים שתעדכנו אותנו מה אתם צריכים, או ב) הם משתמשים ברכיב שאנחנו לא ממליצים להשתמש בו במכשיר לביש.