פיתוח נייטיב עם Wear
העדכון האחרון | גרסה יציבה | מועמד לפרסום | גרסת בטא | גרסת אלפא |
---|---|---|---|---|
4 בספטמבר 2024 | 1.4.0 | - | - | 1.5.0-alpha01 |
הצהרה על יחסי תלות
כדי להוסיף תלות ב-Wear, צריך להוסיף את מאגר Google Maven פרויקט. למאגר Maven של Google אפשר לקבל מידע נוסף.
מוסיפים את יחסי התלות של פריטי המידע הנדרשים בקובץ build.gradle
בשביל
האפליקציה או המודול שלך:
מגניב
dependencies { implementation "androidx.wear.compose:compose-foundation:1.4.0" // For Wear Material Design UX guidelines and specifications implementation "androidx.wear.compose:compose-material:1.4.0" // For integration between Wear Compose and Androidx Navigation libraries implementation "androidx.wear.compose:compose-navigation:1.4.0" // For Wear preview annotations implementation("androidx.wear.compose:compose-ui-tooling:1.4.0") // NOTE: DO NOT INCLUDE a dependency on androidx.compose.material:material. // androidx.wear.compose:compose-material is designed as a replacement // not an addition to androidx.compose.material:material. // If there are features from that you feel are missing from // androidx.wear.compose:compose-material please raise a bug to let us know. }
Kotlin
dependencies { implementation("androidx.wear.compose:compose-foundation:1.4.0") // For Wear Material Design UX guidelines and specifications implementation("androidx.wear.compose:compose-material:1.4.0") // For integration between Wear Compose and Androidx Navigation libraries implementation("androidx.wear.compose:compose-navigation:1.4.0") // For Wear preview annotations implementation("androidx.wear.compose:compose-ui-tooling:1.4.0") // NOTE: DO NOT INCLUDE a dependency on androidx.compose.material:material. // androidx.wear.compose:compose-material is designed as a replacement // not an addition to androidx.compose.material:material. // If there are features from that you feel are missing from // androidx.wear.compose:compose-material please raise a bug to let us know. }
למידע נוסף על יחסי תלות, אפשר לעיין במאמר הוספת יחסי תלות של build.
משוב
המשוב שלך עוזר לנו לשפר את Jetpack. נשמח לשמוע אם גילית בעיות חדשות או אם יש לך רעיונות לשיפור הספרייה הזו. מומלץ לעיין בעיות קיימות בספרייה הזו לפני שיוצרים ספר חדש. אפשר להוסיף את ההצבעה שלך לבעיה קיימת על ידי לחיצה על לחצן הכוכב.
מקורות מידע בנושא מעקב אחר בעיות אפשר לקבל מידע נוסף.
גרסה 1.0 של Wear Compose Material3
גרסה 1.0.0-alpha24
4 בספטמבר 2024
androidx.wear.compose:compose-material3:1.0.0-alpha24
משוחרר. גרסה 1.0.0-alpha24 מכילה את התחייבויות אלה.
שינויים ב-API
- הוספנו סכמה של תנועה לעיצוב Material3. הרכיבים האלה ישמשו את הרכיבים השונים בספרייה כדי להפעיל מפרטי אנימציה, כמו קפיצים, לתנועה אקספרסיבית. (I54ff3)
- הוספנו רכיבי
AppScaffold
ו-ScreenScaffold
לספריית Material3, שכוללים פונקציונליות של תיאום שכבות ומעברים ביןTimeText
ו-ScrollIndicator
.AppScaffold
מספק רמה עליונה של רכיבי פיג'מות שנמצאים מעל כל המסכים. לכן, הוספה שלTimeText
אלAppScaffold
מאפשרת לו להישאר במקומו בזמן החלקה בין מסכים. המסכים יכולים בעצמם לשנות או להסתיר את טקסט השעה.ScreenScaffold
מספק מקום ל-ScrollIndicator
ואנימציה של אינדיקטור הגלילה בזמן גלילה, כולל זמן קצוב להסתרת מחוון הגלילה לאחר חוסר פעילות. (I047d6) - הוספנו
ScrollIndicator
עם העיצוב החדש Material3. יש לו גודל אגודל קבוע המבוסס על תוכן הרשימה הראשוני, כדי להימנע משינויים במידות כאשר תוכן עצלני נטען לרשימה. (Ic228d) - שינינו את ה-API של
ScrollAway
כך ש-ScreenStage
יהיה סיווג ערך במקום מחלקה enum, כדי לאפשר הוספה של שלבים נוספים בהמשך לפי הצורך. (I48c93) - הוספנו את
EdgeButton
, לחצן ייחודי ספציפי ל-Wear עם צורה שמתאימה לקיעור בחלק התחתון של המסך (I16369) - הוספנו משבצת חדשה ל-
ScreenScaffold
עבור לחצן תחתון (כמוEdgeButton
), שיוצג ושגודלו ישתנה בהתאם לתוכן הגלילה (I032eb) - הוספנו את
Modifier.scrollTransform
ואתModifier.targetMorphingHeight
כדי להוסיף אפקטים של תנועה מסוג Material3 לפריטים שבLazyColumn
. (Ie229a) - הוספנו את
SegmentedCircularProgressIndicator
כווריאציה שלCircularProgressIndicator
. בווריאציה המפולחת מוצג ערך התקדמות יחיד בכל הפלחים, או שכל פלח מוצג כמופעל/מושבת. (I6e059) - הוספנו את
LinearProgressIndicator
כחלופה ל-CircularProgressIndicator
הקיים. (I89182) - הוספנו את
AlertDialog
, שמספק פריסות להצגת הנחיות חשובות למשתמש. המוצר כולל וריאציות עבור זוג לחצני אישור/סגירה או לחצן תחתון יחיד (בדרך כלל לחצן Edge) מתחת למקבץ של אפשרויות. בשתי הווריאציות יש מקומות בסמל, לכותרת ולטקסט נוסף כדי לספק פרטים נוספים. (Ieb873) - הוספנו את התוסף
OpenOnPhoneDialog
, שישמש לציון פעולה שתמשיך בטלפון של המשתמש.OpenOnPhoneDialog
נסגר אחרי שעבר הזמן הקצוב לתפוגה שהוגדר. (I978fd) - הוספנו את הרכיב
Confirmation
, רכיב של תיבת דו-שיח עם משבצות לסמל וגם לטקסט מעוקל או ליניארי. ניתנות וריאציות ספציפיות להודעות הכשל או הצלחה. אישורים מבוטלים באופן אוטומטי אחרי שעבר הזמן הקצוב לתפוגה. (Ib43e8) - הוספנו רקע אל
TimeText
כדי לצמצם בעיות שבהן קיימת חפיפה בין התוכן הבסיסי לביןTimeText
, וחיפשנו את הזמן. (Ia11fd) - הוספנו את הרכיב
LevelIndicator
, שמציג את הערך של הגדרה כמו עוצמת קול, ואפשר להשתמש בו עם הרכיבStepper
הקיים כדי ליצור מסך עוצמת קול.LevelIndicator
דומה ל-ScrollIndicator
, אבל מוצג בצד הנגדי של המסך ורוחב קווים רחב יותר וצבע אינדיקטור שונה כברירת מחדל. (I8a4ac) - הוספנו את התוסף
TimePicker
, עם פריסות ל-24 שעות (עם או בלי שניות) או לשעות של 12 שעות עם אפשרות ל-am/pm. (Ia5124) - הוספנו את הערך
DatePicker
, עם הגדרה של סדר העמודות (כלומר יום-חודש, חודש-חודש או שנה-חודש-יום), ותאריכי מינימום/מקסימום אופציונליים. (Ibf13b) - הוספנו פרמטר של משקל לפונקציה
text
שלTimeText
. במקרים שבהם TimeText מורכב מיותר מרכיב טקסט אחד, אפשר לשלוט באופן החלוקה של המרחב. (I36700) - הוספנו את
RadioButton
ואתSplitRadioButton
– הרכיבים האלה מפשטים את ה-API הקודם על ידי שילוב של פקד הרדיו (מפוצל)SelectableButton
עם פקד הרדיו המשני (If7ae8) - הוספנו את
CheckboxButton
ואתSplitCheckboxButton
– הרכיבים האלה מפשטים את ה-API הקודם על ידי שילוב של פקד תיבת הסימון (מפוצל)ToggleButton
ותיבת הסימון הצאצא (Ia8f70) - הוספנו את
SwitchButton
ואתSplitSwitchButton
– הרכיבים האלה מפשטים את ה-API הקודם על ידי שילוב של אמצעי הבקרה(Split)ToggleButton
עם פקד הצאצא של המתג (I0d349) - עדכנו את התיעוד של
AnimatedText
כדי להסביר התנהגות של חריגה מהמסגרת. (Iff30a) - הוספנו את
ButtonGroup
כדי לשלב בין שני לחצנים או שלושה לחצנים, כך שלחיצות על לחצנים יוצרות אנימציה מתואמת. (Ie27db) - הוספנו אנימציית צורה אופציונלית עבור
IconButton
ו-TextButton
בעת הלחיצה. (Iffca5) - הוספנו גרסת צבע נוספת,
FilledVariant
, ל-Button
, ל-IconButton
, ל-TextButton
, ל-CompactButton
ול-EdgeButton
(I65fc3) - הוספנו את הפרמטר
forcedSize
ל-ImageWithScrimPainter
, כך שרקעים של תמונות לחצן שומרים עכשיו את גודל הרכיבים שלהם כברירת מחדל. אם מגדירים אתforcedSize = null
, תתבצע במקום זאת הגדרה שלPainter.instrinsicSize
. (Ic57af) - הוספנו את האפשרות 'לחיצה ארוכה ללחצנים' (Ib613d)
- תמיכה בלחיצה ארוכה נוספה גם ל
IconButton
ולTextButton
. (I38891) - תמיכה בלחיצה ארוכה נוספה לכרטיסים. (I305d5)
- הוספנו את הפרמטרים
LocalTextMaxLines
,LocalTextAlign
,LocalTextOverflow
בתורCompositionLocals
, והשתמשנו בהם כברירות המחדל של הפרמטרים ב-Text
. עכשיו אפשר להשתמש בהגדרות המקומיות של היצירה באמצעות רכיבים כמוCheckboxButton
,SwitchButton
ו-RadioButton
כדי להטמיע הנחיות לחוויית המשתמש, אבל מפתחים יכולים לשנות את הפרמטרים האלה במקרה הצורך. (Iab841) - הוספנו את
Placeholder
כדי לעזור באנונימיזציה של התוכן של רכיבים כמו לחצנים & כרטיסים, עד שהנתונים נטענים. (I1a532) - הוספנו את
IconToggleButtonColors
ואתTextToggleButtonColors
כדי להחליף אתToggleButtonColors
שהוסרו. (Ie0bf1)
תיקוני באגים
- עדכנו את
Button
,FilledTonalButton
,OutlinedButton
,ChildButton
,CompactButton
והוספנו את העיצוביםCompositionLocals
LocalTextMaxLines
,LocalTextAlign
ו-LocalTextOverflow
החדשים להטמעת ההנחיות לשיפור חוויית המשתמש – מפתחים יכולים לשנות את הפרמטרים האלה ישירות בטקסט (Ie51f7) - שינינו את רוחב הקווים שמוגדר כברירת מחדל ל-
LevelIndicator
ל-6dp
כדי להבדיל אותו מ-ScrollIndicator
עם רוחב הקווים4dp
. (If6f63) - תיקנו בעיה ב-
TimeText
כך שיש תמיכה בזוויות סריקה גדולות יותר. (Ie489f) - תוקנה בעיה במהלך יצירה מחדש של
EdgeButton
. (I4cdca) - פריסות מתוקנות של לחצני החלפת מצב מפוצלים כשמוגדר מרווח פנימי מותאם אישית של תוכן. (Ia33d3)
- עיגול ערכי התקדמות קטנים לפחות לרוחב הקו של מחוון ההתקדמות. (I3bd84)
גרסה 1.0.0-alpha23
14 במאי 2024
androidx.wear.compose:compose-material3:1.0.0-alpha23
משוחרר. גרסה 1.0.0-alpha23 מכילה את התחייבויות אלה.
שינויים ב-API
- עדכנו את ממשקי ה-API של
ToggleButton
ו-RadioButton
, כך שאפשר להגדיר צבעים מושבתים. (If13a7) - הוספנו
CircularProgressIndicator
חדש ל-Material3. (Ib3bd7)
תיקוני באגים
- תיקנו באג שבו הוכרזו לחצנים שניתנים לבחירה בהקשה כפולה כדי להחליף מצב כאשר הם כבר נבחרו. (I7ed88)
גרסה 1.0.0-alpha22
1 במאי 2024
androidx.wear.compose:compose-material3:1.0.0-alpha22
משוחרר. גרסה 1.0.0-alpha22 מכילה את התחייבויות אלה.
שינויים ב-API
- עדכנו את
ColorScheme
של Material3. (I7b2b8) - עדכנו את מתג Material3 – וגם כמה שינויי צבע, הסימן תואם עכשיו לתיבת הסימון. (Icac7b)
תיקוני באגים
- צריך לעדכן את כל הדגמות השילוב כדי להשתמש במגביל החדש של
rotaryScrollable
. (I25090)
גרסה 1.0.0-alpha21
17 באפריל 2024
androidx.wear.compose:compose-material3:1.0.0-alpha21
משוחרר. גרסה 1.0.0-alpha21 מכילה את התחייבויות אלה.
- הגרסה הזו הופעלה עקב בעיה טכנית בגרסה הקודמת, שגרמה לכך שהיו חסרים צנצנות מקור. אין ההתחייבויות חדשות בגרסה הזו.
גרסה 1.0.0-alpha20
3 באפריל 2024
androidx.wear.compose:compose-material3:1.0.0-alpha20
משוחרר. גרסה 1.0.0-alpha20 מכילה את התחייבויות אלה.
תיקוני באגים
- שינינו את שלבי האלפא של המצב הלחץ והמיקוד של 'הדים' לצורך ניגודיות. (I59f0a)
- הוספנו ריווח בין התוויות הראשיות והמשניות ב-
Button
, ב-ToggleButton
וב-RadioButton
, בעקבות השינויים האחרונים בסגנונות הטיפוגרפיה ובגובהי השורות. (I2c0ba)
גרסה 1.0.0-alpha19
6 במרץ 2024
androidx.wear.compose:compose-material3:1.0.0-alpha19
משוחרר. גרסה 1.0.0-alpha19 מכילה את התחייבויות אלה.
שינויים ב-API
- הוספנו את
TimeText
לספרייה של Wear Compose Material3. הרכיב הזה מציג את השעה הנוכחית (והסטטוס הנוסף) בחלק העליון של המסך. ה-Material3 API החדש והתמציתי מונע כפילויות בין תוכן לינארי ותוכן מעוקל. (I4d7c3) - עדכנו את שמות הפרמטרים מ-
onSelected
ל-onSelect
עבורRadioButton
. (I1a971) - יצירת אסימון של
RadioButton
ו-SplitRadioButton
וגם ארגון מחדש של השיטות הקיימות כדי לצמצם את כמות החיפושCompositionLocal
על ידי הוספת מופעים של צבעים שנשמרו במטמון ויצירת שיטות שלRadioButtonColors
ו-SplitRadioButtonColors
לשימוש פנימי. (I02b33)
גרסה 1.0.0-alpha18
21 בפברואר 2024
androidx.wear.compose:compose-material3:1.0.0-alpha18
משוחרר. גרסה 1.0.0-alpha18 מכילה את התחייבויות אלה.
שינויים ב-API
- חיברנו מחדש את תבניות ברירות המחדל של
CardColors
,ToggleButtonColors
ו-SplitToggleButtonColors
על ידי יצירת מכונות שנשמרו במטמון באופן פנימי וצמצום השימוש ב-CompositionLocal
. (If3fec)
גרסה 1.0.0-alpha17
7 בפברואר 2024
androidx.wear.compose:compose-material3:1.0.0-alpha17
משוחרר. גרסה 1.0.0-alpha17 מכילה את התחייבויות אלה.
שינויים ב-API
- עדכנו את ה-button API כך שישתמש ב-
buttonColors
כברירת מחדל והסרנו את הכפילויות ב-filledButtonColors
. (I4fe3b) - חיברנו מחדש את דפוסי ברירת המחדל של
ButtonColors
,IconButtonColors
ו-TextButtonColors
על ידי יצירת מכונה ששמורה במטמון באופן פנימי וצמצום השימוש ב-CompositionLocal
. (I5f51c) - הסרנו את התקורה של
rememberUpdatedState
בקטגוריות צבעים ספציפיות לרכיבים וסימנו methods של רכיב גישה בתוך סיווגי הצבעים כפנימיות. (If6571)
תיקוני באגים
- עדכנו את
Modifier.minimumInteractiveComponentSize
לשימוש שלModifier.node
. (Iba6b7)
גרסה 1.0.0-alpha16
24 בינואר 2024
androidx.wear.compose:compose-material3:1.0.0-alpha16
משוחרר. גרסה 1.0.0-alpha16 מכילה את התחייבויות אלה.
תכונות חדשות
- הוספנו את המאפיין
CompactButton
, שיכול להשתמש באותם צבעים מלאים וממלאים עם קווי מתאר וצבעים כמו לחצן.(I05df0)
שינויים ב-API
- הוספנו את
RadioButton
/SplitRadioButton
כמאגרים לפקדים לבחירה, כמו פקד הרדיו. בניגוד למה שקייםToggleButton
הקיים, אפשר לבחור את השדהRadioButton
(ופועל בתוך קבוצה נבחרת), ואילוToggleButton
ניתן להחליף מצב (והוא עצמאי). (I61275) - אנחנו מסירים את
LocalContentAlpha
מספריית Wear Compose Material3 כדי לשמור על עקביות עם הספרייה Compose Material3. (I49a0a) - רכיבים של פריטי Wear ופריטי לבוש שחושפים
MutableInteractionSource
ב-API עודכנו ועכשיו הם חושפיםMutableInteractionSource
אפסי (null) כברירת מחדל. אין כאן שינויים סמנטיים: העברת ערך null פירושה שלא רוצים להניף את ה-MutableInteractionSource
, והוא ייווצר בתוך הרכיב במקרה הצורך. שינוי ל-null מאפשר לרכיבים מסוימים לא להקצות אף פעםMutableInteractionSource
, ומאפשר לרכיבים אחרים ליצור מכונה באופן מדורג רק כשהם צריכים. פעולה זו משפרת את הביצועים ברכיבים האלה. אם אתם לא משתמשים בMutableInteractionSource
שאתם מעבירים לרכיבים האלה, מומלץ להעביר במקום זאת ערך null. מומלץ גם לבצע שינויים דומים ברכיבים שלכם. (Ib90fc, b/298048146) - הוספת ממשק API חדש של Ripple API בספריות
wear:compose-material
ו-wear:compose-material3
שמחליף אתrememberRipple
שהוצא משימוש. בנוסף, מתווסףCompositionLocal
,LocalUseFallbackRippleImplementation
זמני, כדי להחזיר רכיבי Material לשימוש בממשקי ה-API שלrememberRipple/RippleTheme
שהוצאו משימוש. האפשרות הזו תוסר בגרסה היציבה הבאה, והיא נועדה לשמש כאמצעי עזר זמני בלבד להעברה במקרים שבהם בחרת לספקRippleTheme
בהתאמה אישית. בכתובת developer.android.com ניתן למצוא מידע על ההעברה ומידע נוסף על רקע השינוי. (af92b21) - ביצענו שיפורים קלים ב-API של
HorizontalPageIndicator
ובתיעוד שלו. (I60efc) - עדכנו את
ColorScheme
כך שלא יהיה ניתן לשנות את ההגדרות שלו, כך שעדכוני צבעים נפרדים יהיו פחות יעילים, אבל תייעל את השימוש בצבעים. הסיבה לשינוי הזה היא שברוב האפליקציות לא יהיה עדכון של צבעים ספציפיים כתרחיש לדוגמה העיקרי. זה עדיין אפשרי, אבל הוא יבנה מחדש את הנתונים מבעבר, וכתוצאה מכך נצמצם משמעותית את מספר המינויים לפי מדינות באמצעות כל הקודים המהותיים, מה שישפיע על האתחול ועל עלות זמן הריצה של תרחישים יותר רגילים לדוגמה. (Ibc2d6) - ממשקי ה-API של
ToggleButton
ו-SplitToggleButton
עודכנו כדי לאפשר התאמה אישית של צבעים מושבתים. בנוסף, אסימונים של Material Design משמשים עכשיו לערכי צבעים וטיפוגרפיה. (If087c) - צבעי הרקע של תמונת הלחצן עודכנו לשימוש באסימונים בעיצוב Material Design. (Iba215)
- שינינו את הרכיבים
Checkbox
,Switch
ו-RadioButton
לתצוגה בלבד על ידי הסרת הטיפול בקליקים. הרכיבים האלה צפויים להיות בשימוש ב-(Split)ToggleButton
שמטפל בלחיצה, לכן הרכיבים מצוינים עכשיו באופן ברור יותר כרכיבים לרשת המדיה בלבד (ולא מיועדים לשימוש עצמאי ב-Wear). (I2322e)
תיקוני באגים
- הוספנו אסימונים לערכי תנועה של משך זמן וההתאמות ב-Wear Compose Material 3. (I437cd)
- תיקנו באג ב-
ToggleButton
, ב-SplitToggleButton
, ב-Checkbox
, ב-Switch
וב-RadioButton
כך שהודעות בנושא נגישות לא יחזרו על עצמן (בעבר, התפקידים הסמנטיים שוכפלו). (Ica281) - הסרנו את שכבת ה-Materialcore של
CompactButton
כדי לשפר את הביצועים. 7902858
גרסה 1.0.0-alpha15
15 בנובמבר 2023
androidx.wear.compose:compose-material3:1.0.0-alpha15
משוחרר. גרסה 1.0.0-alpha15 מכילה את התחייבויות אלה.
שינויים ב-API
- שינינו את השם של רמת הבסיס
SwipeToDismissBox
לשםBasicSwipeToDismissBox
. כך ההבחנה ברורה יותר בין הרכיב ברמת הבסיס לבין רמת Material3SwipeToDismissBox
. הכלי הזה שולף צבעים מ-MaterialTheme
כדי להשתמש בהם ליצור מיפויים ומאציל את ההטמעה הנותרת ל-BasicSwipeToDismissBox
. (Ibecfc)
תיקוני באגים
- הסרנו את שכבת הליבה של החומר עבור הלחצן Material3 כדי לשפר את הביצועים. (I55555)
גרסה 1.0.0-alpha14
18 באוקטובר 2023
androidx.wear.compose:compose-material3:1.0.0-alpha14
משוחרר. גרסה 1.0.0-alpha14 מכילה את התחייבויות אלה.
שינויים ב-API
- הסרנו את הפרמטר
indicatorStyle
מה-Material3HorizontalPageIndicator
– במקום זאת, הוא יופיע בצורת המסך של המכשיר (לינארי או עגול). (I83728) - יצרנו הפרדה בין הצבעים של
SplitToggleButton
לבין הצבעים שלToggleButton
על ידי הוספת מחלקה חדשה מסוגSplitToggleButtonColors
. (I78bee)
גרסה 1.0.0-alpha13
4 באוקטובר 2023
androidx.wear.compose:compose-material3:1.0.0-alpha13
משוחרר. גרסה 1.0.0-alpha13 מכילה את התחייבויות אלה.
שינויים ב-API
- הוספנו שדה 'כתוביות' אופציונלי ל-
TitleCard
. (Ifc45a) - הוספנו אסימונים צבעוניים של Material Design עבור
TextButton
. (I769dc)
גרסה 1.0.0-alpha12
20 בספטמבר 2023
androidx.wear.compose:compose-material3:1.0.0-alpha12
משוחרר. גרסה 1.0.0-alpha12 מכילה את התחייבויות אלה.
שינויים ב-API
- עדכנו את
IconButton
כך שישתמשו באסימונים של Material Design. (I3f137) - עדכנו את
IconToggleButton
כך שישתמשו באסימונים של עיצוב Material Design. (I7d263) - הפכנו לציבור את הבנאים של
CheckboxColors
,RadioButtonColors
,SwitchColors
. (I82b73)
גרסה 1.0.0-alpha11
6 בספטמבר 2023
androidx.wear.compose:compose-material3:1.0.0-alpha11
משוחרר. גרסה 1.0.0-alpha11 מכילה את התחייבויות אלה.
תיקוני באגים
- עדכנו את הטיפוגרפיה של כרטיסים של Material3 ל-
TitleMedium
. (I597bd) - עדכנו את הטיפוגרפיה ואת ההתאמה ל-Material3
ListHeader
ו-ListSubheader
. (Ib5ceb)
גרסה 1.0.0-alpha10
23 באוגוסט 2023
androidx.wear.compose:compose-material3:1.0.0-alpha10
משוחרר. גרסה 1.0.0-alpha10 מכילה את התחייבויות אלה.
תכונות חדשות
- הוספת
HorizontalPageIndicator
בספרייה של Wear Material3. (Ifee99)
שינויים ב-API
- עדכון קוד הלחצנים כדי להשתמש באסימוני עיצוב של Material3. (I92fe4)
- אנחנו מצהירים על ממשקי ה-API של Wear Material 3 Stepper ו-Slider כניסיוניים כשהפרטים של ממשק המשתמש עדיין נמצאים בשלבי סיום. (I84d54)
- הסרנו את המידות של
ExtraSmall
מהעיגוליםTextButton
ולTextToggleButton
כי הגודל הזה רלוונטי רק למידותIconButton
. (Ibc7d5)
תיקוני באגים
- עדכנו את ההנחיות לגבי הטיפוגרפיה עבור TextToggleButton לשימוש ב-LabelL for LargeButtonSize (Ib10fa)
- עדכנו את ההנחיות לטיפוגרפיה עבור TextButton לשימוש ב-LabelL for LargeButtonSize (I8f3a7)
- הגדרנו את יעד המגע המינימלי של הכרטיס כ-48dp לנגישות. (Ieb9b1)
- הוספת AppCard עם הדגמת תמונה, על ידי הסרת AppCard עם הדגמת רקע (Id735f)
- תיקון באג בלחצנים עגולים שבהם תנאי הצירוף לא קושרו בצורה נכונה. (I5e162)
גרסה 1.0.0-alpha09
9 באוגוסט 2023
androidx.wear.compose:compose-material3:1.0.0-alpha09
משוחרר. גרסה 1.0.0-alpha09 מכילה את התחייבויות אלה.
תכונות חדשות
- הוספנו את המאפיין
ToggleButton
עבור content3 (I6bed6)
שינויים ב-API
- הפעלנו את ההערה
FloatRange
בתור אילוצי API , שצוינו בעבר בתגובות. (Icb401) - עדכנו את הטיפוגרפיה של Wear Material3 בהתאם להנחיות האחרונות בנושא Material3. (I1bad6)
תיקוני באגים
- עדכנו את הצבעים של
Button
,IconButton
ו-TextButton
בהתאם לעיצוב Material3. (Ib2495) - תיקנו את אפשרות החשיפה של סימני הסימון בתיבות סימון במצבים מושבתים. (Ib25bf)
גרסה 1.0.0-alpha08
26 ביולי 2023
androidx.wear.compose:compose-material3:1.0.0-alpha08
משוחרר. גרסה 1.0.0-alpha08 מכילה את התחייבויות אלה.
תכונות חדשות
- הוספנו את פקדי הבחירה הבאים עבור Material3 –
Switch
,Checkbox
,RadioButton
. (Ib918c) - הוספנו את
IconToggleButton
ו-TextToggleButton
ל-Material3, לחצן מתג עגול עם חריץ יחיד לסמל ולטקסט בהתאמה. למידות שונות שלToggleButton
, מומלץ להשתמש במאפייןModifier.touchTargetAwareSize
עם המידות שמופיעות בלחצני החלפת המצב המתאימים. (I9f015) - הוספנו את
ListHeader
ואתListSubheader
לרכיבי Material3. (איביפה) - הוספנו את Material3
SwipeToDismissBox
, שקוראת ל-בסיסיSwipeToDismissBox
החדש ומספק ערכי ברירת מחדל של צבעים מהעיצוב. (I275fb) - הוספנו את Material3
InlineSlider
ל-Wear Compose. הם מאפשרים למשתמשים לבחור מתוך מגוון ערכים. טווח הבחירה מוצג כעמודה בין ערכי המינימום והמקסימום של הטווח, מתוכו משתמשים יכולים לבחור ערך יחיד.InlineSlider
אידיאלי להתאמת הגדרות כמו עוצמת הקול או הבהירות. (I7085f)
שינויים ב-API
- עדכנו את הצורות בעיצוב של Wear Material 3, ועכשיו הן מבוססות על
RoundedCornerShape
במקום על shape. (Idb133) - הפכנו את קבועי הגובה של לחצן כציבוריים (Idbfde)
- קובצי API מעודכנים כדי להוסיף הערות על ביטול תאימות (I8e87a, b/287516207)
- עדכנו את
InlineSliderColors
ב-Wear Compose Material 3 כך שיהיו בו נכסים ציבוריים ונכסים ציבוריים. (I6b632) - עדכנו את כל סיווגי הצבעים ב'חומר הלימוד של Wear Compose' כך שיהיו בהם בנאים ציבוריים ונכסים ציבוריים. (I17702)
- הפכנו את קבועי המרווח הפנימי האופקי והאנכי של הלחצן כציבוריים. (Ieeaf7)
תיקוני באגים
- הלחצן יכוונן עכשיו את הגובה שלו כך שיתאים לתוכן שגדל בגלל גופנים גדולים של נגישות, כשנדרש (Iaf302)
- עדכנו כמה הדגמות של לחצנים כדי לפתור בעיות נגישות. (I61ce9)
Stepper
ו-InlineSlider
תומכים עכשיו בקליקים חוזרים בלחיצה ארוכה, כך שאפשר להגדיל או להקטין במהירות את הערך שלStepper
ושלInlineSlider
על ידי לחיצה על הלחצנים + או - (I27359)
גרסה 1.0.0-alpha07
21 ביוני 2023
androidx.wear.compose:compose-material3:1.0.0-alpha07
משוחרר. גרסה 1.0.0-alpha07 מכילה את התחייבויות אלה.
תכונות חדשות
- הוספנו את הרכיב
Stepper
לספרייה שלנו לכתיבה עבור Wear OS Material 3. הגרסה הזו דומה לגרסה הקודמת של Material, אבל היא לא סובלת מהסמנטיקה של הטווח כברירת מחדל, בעקבות משוב מהמפתחים. אנחנו מספקיםModifier.rangeSemantics
מקרים שבהם נדרשת סמנטיקה של טווח. (Ic39fd) - הוספנו את
curvedText
לספרייה שלנו לכתיבה עבור Wear OS Material 3. (Ia8ae3)
תיקוני באגים
- העדכון של
wear.compose.foundation
הוגדר כתלות ב-API שלwear.compose.material3
(I72004, b/285404743)
גרסה 1.0.0-alpha06
7 ביוני 2023
androidx.wear.compose:compose-material3:1.0.0-alpha06
משוחרר. גרסה 1.0.0-alpha06 מכילה את התחייבויות אלה.
תיקוני באגים
- עדכנו את
TextButton
כך שישתמש בפונקציית התוסףtoDisabledColor
לקביעת ערכי אלפא שהושבתו בצורה נכונה. (I814c8)
גרסה 1.0.0-alpha05
24 במאי 2023
androidx.wear.compose:compose-material3:1.0.0-alpha05
משוחרר. גרסה 1.0.0-alpha05 מכילה את התחייבויות אלה.
תכונות חדשות
- הוספנו את
TextButton
ל-Material3, לחצן עגול עם חריץ יחיד לטקסט. לגדלים שונים שלTextButton
, מומלץ להשתמש ב-Modifier.touchTargetAwareSize
וב-ExtraSmallButtonSize
,SmallButtonSize
,DefaultButtonSize
ו-LargeButtonSizeIcon
שסופקו ב-TextButtonDefaults
. כברירת המחדל,TextButton
, ללא גבול ורקע שקוף לפעולות עם הדגשה נמוכה. לפעולות שדורשות הדגשה גבוהה, יש להשתמש ב-filledTextButtonColors
. לצורך הדגשה בינונית, קוויתTextButton
, הגדירו את הגבול ל-ButtonDefaults.outlinedButtonBorder
; לשטח אמצעי בין קווי אורך ורוחב, יש להשתמש ב-filledTonalTextButtonColors
. (I667e4) - הוספנו את
Card
,OutlinedCard
,AppCard
ואתTitleCard
לספרייה של Wear Compose Material3. אפשר גם לתת ל-AppCard
ול-TitleCard
את המראה עם קווי מתאר באמצעותCardDefaults.outlinedCardColors
ו-CardDefaults.outlinedCardBorder
(I80e72)
שינויים ב-API
- העברנו את הפרמטר של תווית הלחצן לסוף כדי לתמוך בתחביר lambda בסוף, והסרנו את פרמטר התפקיד (מכיוון שאפשר לשנות את ההגדרה הזו באמצעות
Modifier.semantics
). הבנאים שלButtonColors
הם ציבוריים עכשיו. (Ie1b6d)
גרסה 1.0.0-alpha04
10 במאי 2023
androidx.wear.compose:compose-material3:1.0.0-alpha04
משוחרר. גרסה 1.0.0-alpha04 מכילה את התחייבויות אלה.
תכונות חדשות
- הוספנו את
IconButton
ל-Material3, לחצן עגול עם מיקום יחיד לסמל/תמונה. קיימות ארבע וריאציות:IconButton
,FilledIconButton
,FilledTonalIconButton
ו-OutlinedIconButton
. לגדלים שונים שלIconButton
, מומלץ להשתמש ב-Modifier.touchTargetAwareSize
וב-ExtraSmallButtonSize
,SmallButtonSize
,DefaultButtonSize
ו-LargeButtonSizeIcon
שסופקו ב-IconButtonDefaults
. אנחנו מספקים גםIconButtonDefaults.iconSizeFor
כדי לקבוע את גודל הסמל המומלץ עבור גודל לחצן נתון. (I721d4)
גרסה 1.0.0-alpha03
19 באפריל 2023
androidx.wear.compose:compose-material3:1.0.0-alpha03
משוחרר. גרסה 1.0.0-alpha03 מכילה את התחייבויות אלה.
שינויים ב-API
- הוספנו את רכיב Material 3 – הלחצן הזה בצורת אצטדיון ונקרא בעבר צ'יפ בספריית Material Compose (חומר שנקרא 'לחצן' כדי לשמור על עקביות עם הספרייה Material 3). לחצן ברירת המחדל הוא רקע מלא ויש וריאציות ללחצנים הבאים:
FilledTonal
(רקע מושתק), עם קווי מתאר (שקוף עם מסגרת דקה) וסימן צאצא (רקע שקוף וללא שוליים), המשמשים לפעולות משלימות עם מידת הבולטוּת הנמוכה ביותר. לחצנים עגולים לתוכן פשוט של סמל וטקסט יופיעו בגרסה עתידית.(Ia6942)
גרסה 1.0.0-alpha02
5 באפריל 2023
androidx.wear.compose:compose-material3:1.0.0-alpha02
משוחרר. גרסה 1.0.0-alpha02 מכילה את התחייבויות אלה.
תיקוני באגים
- הוספנו
DefaultTextStyle
ל-Wear Compose Material 3, שמגדיר אתPlatformTextStyle.includeFontPadding
כ-true (ההגדרה הנוכחית) כברירת מחדל. כך נוכל לסנכרן את ביטול המרווח הפנימי של הגופנים כברירת מחדל עם ספריות הכתיבה בעתיד (מידע נוסף זמין במאמר תיקון מרווח פנימי של גופנים בכתיבה ברקע). (I7e461)
גרסה 1.0.0-alpha01
22 במרץ 2023
androidx.wear.compose:compose-material3:1.0.0-alpha01
משוחרר. גרסה 1.0.0-alpha01 מכילה את התחייבויות אלה.
תכונות חדשות
Material 3 הוא הפיתוח הבא של Material Design, והוא כולל עיצוב עיצוב ורכיבים מעודכנים. 'חומר לימוד' 3 ב-Wear Compose נועד להיות אחיד עם ספריית Material 3 Compose ב-Android. גרסת האלפא הראשונה הזו כוללת הטמעות פונקציונליות מוקדמות של הרכיבים הבאים:
אנחנו נמשיך לפתח במקביל את Wear Material (
androidx.wear.compose:compose-material
) ואת Wear Material 3 (androidx.wear.compose:compose-material3
). בגרסאות חדשות של חומר 3 יורחבו הווידג'ט שהוגדר כך שיכלול רכיבים מוכרים אחרים מ'פיתוח נייטיב' ל-Wear OS, כמו לחצנים, בוחרים ופסי ההזזה.הספריות 'Wear Material' ו-'Wear Material 3' הן בלעדיות ואין לשלב אותן באותה האפליקציה, בעיקר כי הן מפנות לנושאים שונים שעלולים להוביל לחוסר עקביות בלתי צפוי.
גרסה 1.5 של Wear Compose
גרסה 1.5.0-alpha01
4 בספטמבר 2024
androidx.wear.compose:compose-*:1.5.0-alpha01
משוחרר. גרסה 1.5.0-alpha01 מכילה את התחייבויות אלה.
שינויים ב-API
- הוספנו
LazyColumn
חדש לספרייה של Wear Compose Foundation עם ממשקי ה-API המשויכים שלLazyColumnState
ו-LazyColumnScope
. הפלטפורמה הזו משמשת כבסיס ליצירת אפקטים להתאמה אישית של התאמה לעומס (scaling) ושל מורפינג באמצעות Wear Compose. (Ib3b22) - הוספנו ל-
LazyColumnScope
גרסה שלitemsIndexed
שנוספה לאינדקס, כחלק מה-API החדש שלLazyColumn
. (Ib4a57) - הוספנו מגבילי
LazyColumn
כדי לתמוך בהתנהגויות של התאמה לעומס (scaling) ושל מורפינג. (Ie229a) - המכשיר
HierarchicalFocusCoordinator
קוּדם ליציבות. I31035 - הוספנו תמיכה ברווחים בין אותיות לטקסט מעוקל. (I3c740)
- הפרמטר
rotationLocked
נוסף ל-CurvedLayout.curvedComposable
כדי להפסיק את הרוטציה של הרכיבים. (I66898) - ה-API הזמני
LocalUseFallbackRippleImplementation
מחומר בלבוש ומחומר לבוש הוסר (I62282) - התמונה
WearDevices.SQUARE
הוסרה מהתצוגה המקדימה@WearPreviewDevices
(I11c02)
תיקוני באגים
- התכונה
SwipeToReveal
ממקמת עכשיו את הפריטים שנחשפו בחלק הגלוי של המסך. זה עוזר כשנעשה שימוש ב-SwipeToReveal
בתוך רשימה, כך שהפריטים תמיד מקיימים אינטראקציה והם אף פעם לא נמצאים מחוץ למסך. (I38929) - הפונקציה
SwipeToReveal
מאפסת עכשיו את הערך 'lastActionType
' ל'ללא' אחרי השלמת הפעולהanimatedTo
. (I59b03) - שיפרנו את התיעוד לפרמטר
rotationLocked
החדש ב-curvedComposable
. (Ifbd57) - תוקנה קריסה במהלך העברת
NaN
אלperformFling
שלScalingLazyColumnSnapFlingBehavior
. (Ic13da) - תוקן באג בשינוי הגודל של פריסה מעוקלת (I0ifiedf)
- הוספנו תמיכה ברווחים בין אותיות שמצוין ב-'sp'. (I9f6e3)
- תיקנו באג ב-Material2 Dialog שבו לא בוצעה קריאה לקריאה החוזרת של
onDismissRequest
כאשר תיבת הדו-שיח הפכה לבלתי נראית (I64656) - כדי לשקף טוב יותר את המטרה של הקובץ, השם
LayoutCoordinates.introducesFrameOfReference
שונה. השם החדש הואLayoutCoordinates.introducesMotionFrameOfReference
. שינו את השם של הפונקציה הקשורה כדי לחשב קואורדינטות על סמך הדגל הזה. (I3a330)
גרסה 1.4
גרסה 1.4.0
4 בספטמבר 2024
androidx.wear.compose:compose-*:1.4.0
משוחרר. גרסה 1.4.0 כוללת את ההתחייבויות האלה.
שינויים חשובים מאז 1.3.0
- ב-
ScalingLazyColumn
וב-Picker
יש עכשיו תמיכה בקלט חוגה כברירת מחדל – מומלץ להסיר את הסיבוב המפורשת של המכשיר ולעכב את התנהגות ברירת המחדל של המערכת. במקרה הצורך, אפשר להשתמש בפרמטרrotaryScrollableBehavior
כדי להגדיר התנהגות גלילה או הצמדה - מומלץ להשתמש בפרמטרflingBehavior
כדי לבצע פעולות הצמדה. - התכונה
Modifier.rotaryScrollable
היא תכונה חדשה שמחברת בין אירועים סיבוביים לבין מאגרים שניתן לגלול, ומאפשרת למשתמשים לגלול באמצעות כתר או מסגרת מסתובבת במכשיר Wear OS. - עכשיו יש ב-
SwipeDismissableNavHost
אנימציית כניסה למעברים בתוך האפליקציה. PositionIndicator
מוצג עכשיו כברירת מחדל כשמסך מסוים מוצג בפעם הראשונה.
שינויים נוספים
- כדי לקבל מידע מקיף יותר על השינויים שהושקו בגרסה 1.3.0, אפשר לעיין בנתוני הגרסה של בטא01.
גרסה 1.4.0-rc01
21 באוגוסט 2024
androidx.wear.compose:compose-*:1.4.0-rc01
משוחרר. גרסה 1.4.0-rc01 מכילה את ההתחייבויות האלה.
- עדכנו את יחסי התלות של כתיבה ל-1.7.0-rc01 והצמדנו את הניווט ב-Wear Compose ל-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
כדי להחליף את השימוש ב-'התמקדות' ב-'Target' כדי לשפר את הביצועים. (Id294b) - תיקנו בעיה שבה
ProgressIndicator
חזר על ההודעה שלו במסגרתTalkBack
. (I94563) - עדכנו את הפרופילים הבסיסיים של הספרייה ב-Wear Compose. (I3cbc3)
גרסה 1.4.0-beta02
29 במאי 2024
androidx.wear.compose:compose-*:1.4.0-beta02
משוחרר. גרסה 1.4.0-beta02 כוללת את ההתחייבויות האלה.
תיקוני באגים
- הגדלנו את רוחב הגבולות שמועבר לקוראי מסך מטקסט מעוקל כדי לטפל בבעיות בחיתוך (Id865f).
- הגבלנו את הגבול של
HorizontalPageIndicator
שהועבר לקוראי מסך – בעבר, המדד הופיע במסך מלא (Id8d7a).
גרסה 1.4.0-beta01
14 במאי 2024
androidx.wear.compose:compose-*:1.4.0-beta01
משוחרר. גרסה 1.4.0-בטא01 מכילה את ההתחייבויות האלה.
בגרסת 1.4-בטא01 של 'כתיבה מהירה' ל-Wear OS, נראה שהגרסה הזו של הספרייה הושלמה ושה-API נעול (אלא אם הוא מסומן כניסיוני). Wear Compose 1.4 כולל את הפונקציונליות החדשה הבאה:
- הוספנו את
Modifier.rotaryScrollable
, תכונה חדשה שמחברת בין אירועים עם חוגה לקונטיינרים שאפשר לגלול, ומאפשרת למשתמשים לגלול באמצעות כתר או מסגרת מסתובבת במכשיר Wear OS. בנוסף,ScalingLazyColumn
ו-Picker
תומכים עכשיו בקלט חוגה כברירת מחדל. משתמשים בפרמטרrotaryScrollableBehavior
כדי להגדיר התנהגות גלילה או הצמדה. להתנהגות הצמדה, מומלץ לספק הצמדה (Snap) גם באמצעות הפרמטר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
- ביצענו את השינויים הבאים ב-Rotary API החדש: השם של
Modifier.rotary
שונה ל-Modifier.rotaryScrollable
; שינה את השם של הממשקRotaryBehavior
ל-RotaryScrollableBehavior
והפונקציהhandleScrollEvent
ל-performScroll
. שינה את השם שלRotaryScrollableAdapter
לשםRotaryScrollableLayoutInfoProvider
והסיר את הנכסscrollableState
. (I0c8a6) - ביצענו שינויים נוספים ב-Rotary API: לשנות את השם של
RotaryScrollableLayoutInfoProvider
ל-RotarySnapLayoutInfoProvider
(כי הספק הזה נדרש רק לחוגה עם Snap). שינינו את סוג הפרמטרsnapOffset
ב-RotaryScrollableDefaults.snapBehavior snapOffset
מ-Int ל-Dp. (Iddebe) - שינינו את השם של הפרמטר
clickInteractionSource
ב-SplitSelectableChip
ל-containerInteractionSource
. (Ia8f84) - עדכנו את שמות הפרמטרים של קריאה חוזרת לקליק עבור
SplitSelectableChip
– מ-onClick
ל-onSelectionClick
ומ-onBodyClick
ל-onContainerClick
. (I32237)
תיקוני באגים
- עדכנו את המרווח הפנימי האופקי של
PositionIndicator
ל-2dp (הוא היה 5dp), כדי לתקן באג שבוPositionIndicator
(סרגל הגלילה) חופף לתוכן שאפשר לגלול. חשוב לדעת: השינוי הזה צפוי לגרום לשיבושים בצילומי המסך הקיימים שכוללים אתPositionIndicator
, בגלל השינוי במרווח הפנימי. (I57472) - שיפרנו את התיעוד של ה-API החוגה החדש על ידי תיאור ההבדלים בין מכשירים עם חוגה ברזולוציה נמוכה וברזולוציה גבוהה. (I63abe)
- טיפלנו בחריגה מחוץ לטווח ב-
SwipeDismissableNavHost
שעלולה להיות מופעלת כשערכי אלפא אינטרפולטיביים היו נמוכים מאפס. (Ib75a1, b/335782510)
גרסה 1.4.0-alpha07
17 באפריל 2024
androidx.wear.compose:compose-*:1.4.0-alpha07
משוחרר. גרסה 1.4.0-alpha07 מכילה את התחייבויות אלה.
שינויים ב-API
- הוספנו את
Modifier.rotary
, תכונה חדשה שמחברת בין אירועים עם חוגה לקונטיינרים שאפשר לגלול, ומאפשרת למשתמשים לגלול באמצעות כתר או מסגרת מסתובבת במכשיר Wear OS. בנוסף,ScalingLazyColumn
ו- Picker תומכים עכשיו בקלט חוגה כברירת מחדל, עם עומסי יתר חדשים שכוללים את הפרמטרrotaryBehavior
לציון ההגדרה של גלילה או הצמדה. אם הפרמטרrotaryBehavior
מוגדר להצמדה (Snap), מומלץ לספק הצמדה גם דרך הפרמטרflingBehavior
, לגלילה במגע. (I2ef6f) NestedScroll
מקורות 'גרירה והיפוך' מוחלפים ב-UserInput
וב-SideEffect
כדי להתאים להגדרה המורחבת של המקורות האלה, שכוללים עכשיו אנימציות (אפקט צד) וגלגל העכבר ומקלדת (קלט משתמש). 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 מכילה את התחייבויות אלה.
תיקוני באגים
- הוספנו טיוטה פנימית של תמיכה בחוגה, כחלק מהמאמץ הכולל של העברת ההתנהגות של Rotary מ-Horology ל-AndroidX. (I617d1)
- הוספנו טיוטה פנימית של תמיכה במשוב הפיזי, כחלק מהמאמץ הרחב של העברת ההתנהגות של Rotary מ-Horology ל-AndroidX. (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
- ה-wrapper של
Modifier.inspectable
הוצא משימוש. ה-API הזה יגרום ליותר פסילות של השינוי שלך מהצורך, ולכן לא מומלץ להשתמש בו עכשיו. אנחנו ממליצים למפתחים להטמיע את השיטהinspectableProperties()
ב-ModifierNodeElement
אם הם רוצים לחשוף מאפייני התאמה לכלים. (Ib3236)
תיקוני באגים
- תיקנו באג בתיעוד של
WearPreview*
הערות. (Id526d)
גרסה 1.4.0-alpha02
7 בפברואר 2024
androidx.wear.compose:compose-*:1.4.0-alpha02
משוחרר. גרסה 1.4.0-alpha02 מכילה את התחייבויות אלה.
תיקוני באגים
- תיקנו באג בהחלקה לצורך חשיפה, כך שאפשר היה לבצע אינטראקציה עם פריט אחד (ולבטל) פעולה שמחויבות על ידי התחלת החלקה של פריט אחר.(Ide059)
- עדכנו את השדה
ListHeader
כדי לתמוך בשינויי גובה במקרים שבהם נדרש שינוי לגובה של התוכן כדי להתאים לגופנים גדולים. (I7290c, b/251166127)
גרסה 1.4.0-alpha01
24 בינואר 2024
androidx.wear.compose:compose-*:1.4.0-alpha01
משוחרר. גרסה 1.4.0-alpha01 מכילה את התחייבויות אלה.
תכונות חדשות
- הוספנו אנימציית רשומה ל-
SwipeDismissableNavHost
עבור מעברים בתוך האפליקציה.(cfeb79a) PositionIndicator
מוצג עכשיו כברירת מחדל כשמסך מסוים מוצג בפעם הראשונה. הטמענו את השינוי הזה כדי לעזור לכם לעמוד בהנחיות האיכות של Wear. לצערנו, יהיה צורך לעדכן בדיקות של צילומי מסך במסכים שכוללים אתPositionIndicator
, כי ה-PositionIndicator
לא היה מוצג בעבר. (419cef7)
שינויים ב-API
- הוספנו ממשק API חדש של Ripple API בספריות
wear:compose-material
ו-wear:compose-material3
, שמחליף אתrememberRipple
שהוצא משימוש. בנוסף, מתווסףCompositionLocal
,LocalUseFallbackRippleImplementation
זמני, כדי להחזיר רכיבי Material לשימוש בממשקי ה-API שלrememberRipple/RippleTheme
שהוצאו משימוש. האפשרות הזו תוסר בגרסה היציבה הבאה, והיא נועדה לשמש כאמצעי עזר זמני בלבד להעברה במקרים שבהם בחרת לספקRippleTheme
בהתאמה אישית. בכתובת developer.android.com ניתן למצוא מידע על ההעברה ומידע נוסף על רקע השינוי. (af92b21) - עדכנו את
ColorScheme
כך שלא יהיה ניתן לשנות את ההגדרות שלו, כך שעדכוני צבעים נפרדים יהיו פחות יעילים, אבל תייעל את השימוש בצבעים. הסיבה לשינוי הזה היא שברוב האפליקציות לא יהיה עדכון של צבעים ספציפיים כתרחיש לדוגמה העיקרי. זה עדיין אפשרי, אבל הוא יבנה מחדש את הנתונים מבעבר, וכתוצאה מכך נצמצם משמעותית את מספר המינויים במדינות השונות באמצעות כל הקוד המהותי, מה שישפיע על האתחול ועל עלות זמן הריצה של תרחישים יותר רגילים לדוגמה. (f5c48b7) - רכיבי Wear מהותי (חומר) של Wear ורכיבי Wear שחושפים
MutableInteractionSource
ב-API שלהם עודכנו, ועכשיו הם כולליםMutableInteractionSource
ערך ריק (null) שמוגדר כברירת מחדל כ-null. אין כאן שינויים סמנטיים: העברת ערך null פירושה שלא רוצים להניף את ה-MutableInteractionSource
, והוא ייווצר בתוך הרכיב במקרה הצורך. שינוי ל-null מאפשר לרכיבים מסוימים לא להקצות אף פעםMutableInteractionSource
, ומאפשר לרכיבים אחרים ליצור מכונה באופן מדורג רק כשהם צריכים. פעולה זו משפרת את הביצועים ברכיבים האלה. אם אתם לא משתמשים בMutableInteractionSource
שאתם מעבירים לרכיבים האלה, מומלץ להעביר במקום זאת ערך null. מומלץ גם לבצע שינויים דומים ברכיבים שלכם. (f8fa920) - עדכנו את
rememberExpandableState
כדי לשמור מצב מתרחב. כך תבטיחו שהנתונים יאוחסנו כשמנווטים למסך אחר וישוחזרו כשתחזרו למסך המקורי. (5c80095)
תיקוני באגים
- עדכנו את ההגדרה
ReduceMotion
לשימוש ב-listener המודע למחזור החיים. (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
משתמשים ברדיוס הפינות החדש הזה כדי למנוע חיתוך תוכן בפינות של צ'יפ ו-ToggleChip
.- רוב
Chips
ו-ToggleChips
לא השתנו, בהינתן גובה ברירת המחדל שלהם: 52 dp. עם זאת, אובייקטים מסוגChip
ו-ToggleChip
שמכילים מספר שורות של טקסט של תווית ראשית או משנית, או שהגובה שלהם שונה, עלולים לגרום לשיבושים בבדיקות המסך.
- רוב
שינויים נוספים
כדי לקבל מידע מקיף יותר על השינויים שהושקו בגרסה 1.3.0, אפשר לעיין בנתוני הגרסה של בטא01.
המלצות להטמעה
- אם האפליקציה מאפשרת למשתמשים לנוע על פני התוכן במסך, למשל באפליקציה מבוססת-מפה, כדי להשבית את הטיפול בהחלקה על ידי הגדרה של
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, והיא תשמש עכשיו את צ'יפ ואתToggleChip
. השינוי הזה נדרש כדי לתמוך בהתאמות גובה כשבתוכן נדרש גובה נוסף כדי להתאים לגופנים גדולים. אחרת, המבנה הקיים מחלק חלק מתוכן הטקסט.השינוי הזה עלול לגרום לשיבושים בבדיקות של צילומי המסך. (I2e6ae)
גרסה 1.3.0-beta02
13 בדצמבר 2023
androidx.wear.compose:compose-*:1.3.0-beta02
משוחרר. גרסה 1.3.0-beta02 מכילה את התחייבויות אלה.
תיקוני באגים
- שחזרנו את תנועת ההחלקה הרצויה ב
BasicSwipeToDismissBox
. זה השתנה בגרסה קודמת, כך שהחלק של השקף במעבר התרחש בזמן שהאצבע נגעה במסך. (Id8e76)
גרסה 1.3.0-beta01
15 בנובמבר 2023
androidx.wear.compose:compose-*:1.3.0-beta01
משוחרר. גרסה 1.3.0-beta01 מכילה את התחייבויות אלה.
לפי גרסת 1.3-בטא01 של 'כתיבה מהירה' ל-Wear OS, הגרסה הזו של הספרייה הושלמה ושה-API נעול (אלא אם הוא סומן כניסיוני). Wear Compose 1.3 כולל את הפונקציונליות החדשה הבאה:
SwipeToDismissBoxState
,SwipeToDismissValue
ו-Modifier.edgeSwipeToDismiss
הועברו מ-androidx.wear.compose.material
ל-androidx.wear.compose.foundation
, יחד עם ההטמעה הבסיסית של החלקה לסגירה ב-BasicSwipeToDismissBox
. כך ניתן להשתמש בטיפול באמצעות תנועות של החלקה לסגירה בנפרד מהעיצוב מהותי, למשל, מ-SwipeDismissableNavHost
ב-androidx.wear.compose.navigation
. עדיין מומלץ להשתמש ב-SwipeToDismissBox
מ-androidx.wear.compose.material
עם Material Design, כי הוא שולף צבעים מה-MaterialTheme
ואז מקצה את שאר ההטמעה ל-BasicSwipeToDismissBox
.- ב-
SwipeDismissableNavHost
יש עכשיו תמיכה בפרמטרuserSwipeEnabled
חדש, כדי שאפשר יהיה להשבית את הטיפול בהחלקה במסכים שבהם הוא לא נדרש. BasicSwipeToDismissBox
שופר טיפול ממוקד באמצעותHierarchicalFocusCoordinator
.- ב-
SwipeToReveal
יש תכנים קומפוזביליים חדשים שלSwipeToRevealCard
ו-SwipeToRevealChip
ב'חומר' שעומדים בהנחיות המומלצות לגבי חוויית המשתמש ב-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 של הכרטיסים והצ'יפים ב-MaterialSwipeToReveal
ב-API מבוסס-משבצות באמצעות תכנים קומפוזביליים שלSwipeToRevealPrimaryAction
,SwipeToRevealSecondaryAction
ו-SwipeToRevealUndoAction
. קוד לדוגמה כולל דוגמאות לשימוש בממשק ה-API החדש. (Ia8943) - החלפנו את דגלי האנימציה
PositionIndicator
בפרמטרים מסוגAnimationSpec
. אפשר להשבית את האנימציות הנפרדות על ידי העברתsnap
בתורAnimationSpec
. I6c523
תיקוני באגים
- תיקנו באג שהופעל על ידי טקסט מעוקל מוגבל כשהגודל מוגבל (I50efe)
- טיפלנו בקריסה פוטנציאלית של NaN שקשורה ל-
curvedComposable
(I970eb) - החזרנו את הסרת האנימציה של ההדגשה של שינוי המיקום בתאריך
PositionIndicator
. (Ieb424) - כדי לשפר את הביצועים, הסרנו את שכבת הליבה של החומר לצ'יפ החומר. (If2dcb)
גרסה 1.3.0-alpha08
18 באוקטובר 2023
androidx.wear.compose:compose-*:1.3.0-alpha08
משוחרר. גרסה 1.3.0-alpha08 מכילה את התחייבויות אלה.
שינויים ב-API
- הוספנו דגלים בודדים לעומסי יתר של
PositionIndicator
, כדי לשלוט באנימציות שונות:showFadeInAnimation
,showFadeOutAnimation
ו-showPositionAnimation
. ה-API הקודם הוצא משימוש ומעביר קריאות לממשק החדש. מטעמי ביצועים ולשמירה על עקביות בחוויית המשתמש, כשמשתמשים ב-PositionIndicator
עם רשימה שניתן לגלול, מומלץ להשבית את הדגליםshowFadeInAnimation
ו-showPositionAnimation
. אםPositionIndicator
משמש כאינדיקטור עצמאי, למשל לשינוי עוצמת הקול, מומלץ להפעיל את כל 3 האנימציות. (I44294) - הוצאנו משימוש את התכנים
SwipeToDismissBoxState
,SwipeToDismissValue
ו-edgeSwipeToDismiss
לאחר ההעברה של הפונקציונליות 'החלקה לסגירה' אלwear.compose.foundation
. צריך להחליף אותם בwear.compose.foundation
המקבילים. (Iee8c9)
תיקוני באגים
- עדכנו את הפרופילים הבסיסיים של ספריות הרכיבים, החומרים והניווט ב-Wear. (Idb060)
- שחזרנו שינוי התנהגותי ב-
PositionIndicator
שנכלל ב-CL הקודם, כך שהאנימציה שלPositionIndicator
הופעלה כשמסך הוצג לראשונה. אנחנו מתכוונים לבצע שינוי דומה בגרסת אלפא מוקדמת של 1.4, כך ש-PositionIndicator
יוצג בהתחלה, אבל ללא אנימציה. (I41843) - טיפלנו בכמה בעיות בביצועים ב-
PositionIndicator
. (I1c654, b/302399827) - שיפרנו את הביצועים של הטמעת ברירת המחדל של ספק מצב הגילוי באמצעות מגע, כך שההסתמכות על
State<Boolean>
במקום על המצב הנגזרת מתבצעת. (Ieec4d) - הגדרנו מלבנים מסוג
systemGestureExclusion
ל-Android מגרסה 13 ואילך. (Ib1f4b)
גרסה 1.3.0-alpha07
4 באוקטובר 2023
androidx.wear.compose:compose-*:1.3.0-alpha07
משוחרר. גרסה 1.3.0-alpha07 מכילה את התחייבויות אלה.
שינויים ב-API
- הוספנו דגלים נפרדים ל-
PositionIndicator
כדי לשלוט באנימציות שונות:showFadeInAnimation
,showFadeOutAnimation
ו-showPositionAnimation
. ה-API הקודם הוצא משימוש ומעביר קריאות לממשק החדש. מטעמי ביצועים ולשמירה על עקביות בחוויית המשתמש, כשמשתמשים ב-PositionIndicator
עם רשימה שניתן לגלול, מומלץ להשבית את הדגליםshowFadeInAnimation
ו-showPositionAnimation
. אםPositionIndicator
משמש כאינדיקטור עצמאי, למשל לשינוי עוצמת הקול, מומלץ להפעיל את כל 3 האנימציות. (Ia2d63)
תיקוני באגים
- ביצענו שיפורים בהחלקה כדי לחשוף תנועה על ידי הוספת אנימציית עמעום לטקסט של הפעולה הראשית, והדרגתיות של הפעולה המשנית או שינוי גודל הסמלים בהרחבת החלקה מלאה. (Ib7223)
- מומלץ שפעולות 'החלקה להצגה' יהיו נגישות, והוספנו פעולות נגישות מותאמות אישית לדוגמאות של 'החלקה להצגה'. (I42224)
- שיפרנו את הביצועים של
SwipeToDismissBox
, כולל ארגון מחדש כדי להבטיח שהלוגיקה הראשונית לא מפעילה הרכבה מחדש. השדהSwipeToDismissBox
משורטט עכשיו כגודל המסך המלא. (Ie0aa2) - תיקנו באג כשה-
PositionIndicator
נעלם בטעות. (I2091a) - שיפרנו את הביצועים של
PositionIndicator
על ידי אופטימיזציה של הרכבים מחדש. נוספו לאחר מכן סימונים חדשים לשליטה באנימציות (fadeIn
,fadeOut
ו-positionChange
) (ראו שינויים ב-API) (Ifac7d) - הוספנו בדיקות Microbenchmark עבור
PositionIndicator
(Idf875)
גרסה 1.3.0-alpha06
20 בספטמבר 2023
androidx.wear.compose:compose-*:1.3.0-alpha06
משוחרר. גרסה 1.3.0-alpha06 מכילה את התחייבויות אלה.
תיקוני באגים
- הוספנו תמיכה ב
Modifier.edgeSwipeToDismiss
עםSwipeToReveal
. (I95774, b/293444286) - הוספנו דוגמאות עבור 'חומר'
SwipeToRevealChip
ו-SwipeToRevealCard
. (Ieb974) - עדכנו את הפרופילים הבסיסיים בספריות של Wear Compose Fundamentals ו-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) - ההגדרה של צמצום התנועה משביתה עכשיו את אפקט הנצנוץ ואת תנועת המחיקה ב-placeholders. (I91046)
Stepper
ו-InlineSlider
תומכים עכשיו בקליקים חוזרים בלחיצה ארוכה, כדי שאפשר יהיה להגדיל או להקטין במהירות את הערך שלStepper
ושלInlineSlider
על ידי לחיצה על הלחצנים + או -. (I27359)
גרסה 1.3.0-alpha01
21 ביוני 2023
androidx.wear.compose:compose-*:1.3.0-alpha01
משוחרר. גרסה 1.3.0-alpha01 מכילה את התחייבויות אלה.
תיקוני באגים
- כפי שהודענו ב-
1.2.0-alpha07
וב-1.2.0-alpha10
, אנחנו משנים עכשיו אתDefaultTextStyle
כדי להשבית את המרווח הפנימי של הגופן כך שיהיה עקבי בכל פלטפורמת Android. הפעולה הזו תטפל במקרים מסוימים של חיתוך טקסט בגופנים גדולים ויכולה להשפיע גם על פריסות המסך, כך שיהיה צורך לעדכן את הבדיקות של צילומי המסך. לדוגמה, אפשר לראות כאן חיתוך טקסט (Ic6a86)
- הוא לא מופיע יותר כשהמרווח הפנימי של הגופן מושבת:
- עדכנו את
wear.compose.foundation
כך שתהיה תלות ב-API שלwear.compose.material
(I72004, b/285404743) - תיקנו באג ב-
SwipeToDismissBox
. מפתחות הרקע ומפתחות התוכן מועברים עכשיו לבלוק הזכירה, כדי שייווצרו מגבילים חדשים כשהתוכן או הרקע משתנים. (Ib876c, b/280392104) - עדכנו את השפה של
TimeText
כך שייעשה שימוש במיקום בעת בחירת הפורמט לפרק זמן של 12 או 24 שעות. (If4a3d) - תיקנו חוסר עקביות בפרמטרים של ברירת המחדל
SwipeToDismissBox
contentScrimColor
. (I2d70f) - שיפרנו את הטיפול בתנועה ב
SwipeToReveal
. (I28fb7)
בעיות מוכרות
- דרישת נגישות היא של תמיכה בגדלים של גופנים בהגדרת המשתמש. אנחנו יודעים שצ'יפים מרובי שורות יכולים לגרום לחיתוך טקסט כשהם מוצגים בגופנים גדולים, ולכן אנחנו נעדכן את צ'יפ בגרסת אלפא של 1.3 ומטה כדי לבצע התאמות גובה במקרים האלה.
גרסה 1.2
גרסה 1.2.1
18 באוקטובר 2023
androidx.wear.compose:compose-*:1.2.1
משוחרר. גרסה 1.2.1 כוללת את ההתחייבויות האלה.
תיקוני באגים
- תוקן באג כשהמאפיין
PositionIndicator
נעלם בטעות. (7a167f)
גרסה 1.2.0
9 באוגוסט 2023
androidx.wear.compose:compose-*:1.2.0
משוחרר. גרסה 1.2.0 כוללת את ההתחייבויות האלה.
שינויים חשובים מאז 1.1.0
- גרסה יציבה של 'כתיבה' ל-Wear OS 1.2.0 (למידע נוסף)
- רשימה של השינויים העיקריים ב-Wear Compose 1.2 אפשר למצוא בנתוני הגרסה של (כתיבה ל-Wear OS 1.2 Beta01)
גרסה 1.2.0-rc01
26 ביולי 2023
androidx.wear.compose:compose-*:1.2.0-rc01
משוחרר. גרסה 1.2.0-rc01 מכילה את שמירות האלה.
תיקוני באגים
- סיימנו את תהליך ההגדרה הבסיסי של הפרופילים בגרסה 1.2 (Id5740)
גרסה 1.2.0-beta02
7 ביוני 2023
androidx.wear.compose:compose-*:1.2.0-beta02
משוחרר. גרסה 1.2.0-beta02 מכילה את התחייבויות אלה.
תכונות חדשות
- הוספנו את המשתנה הניסיוני
LocalReduceMotion
CompositionLocal
החדש שמשבית את ההתאמה לעומס (scaling) ואת דהייה ב-ScalingLazyColumn
. (I58024)
תיקוני באגים
- עדכנו את הפרופילים הבסיסיים של ספריות החומרים והבסיסים של מוצרי Wear(I4725d)
- תיקנו חוסר עקביות בערכי ברירת המחדל עבור
SwipeToDismissBox
פרמטרים מסוגcontentScrimColor
(I2d70f) - תיקנו את ערך ברירת המחדל
DefaultTextStyle
המשמש עבור ההגדרהIncludeFontPadding
(I737ed)
גרסה 1.2.0-beta01
24 במאי 2023
androidx.wear.compose:compose-*:1.2.0-beta01
משוחרר. גרסה 1.2.0-beta01 מכילה את התחייבויות אלה.
מה חדש ב-Composes ב-Wear OS 1.2
לפי גרסת 1.2-בטא01 של 'כתיבה מהירה' ל-Wear OS, הגרסה הזו של הספרייה הושלמה ושה-API נעול (אלא אם הוא סומן כניסיוני). Wear Compose 1.2 כולל את הפונקציונליות החדשה הבאה:
expandableItem
ו-expandableItems
הם שני רכיביFoundation
חדשים שתומכים בהרחבה של פריטים בתוךScalingLazyColumn
. יש להשתמש ב-expandableItem
לפריט אחד שניתן להרחבה, כמו 'טקסט' שמכיל את מספר השורות. שימוש במאפייןexpandableItems
לקבוצה של פריטים שניתנים להרחבה ובמאפייןexpandableButton
כדי ליצור לחצן שמתכווץ אחרי הרחבת התוכן.HierarchicalFocusCoordinator
– התוכן הקומפוזבילי הניסיוני הזה מאפשר לסמן עץ משנה של היצירה כשהמיקוד מופעל או כשהמיקוד מושבת.Picker
– ה-API כולל עכשיו אתuserScrollEnabled
כדי לקבוע אם הבורר פעיל לגלילה של משתמשים.PickerGroup
– תוכן קומפוזבילי חדש לטיפול בכמה בוררים ביחד. הוא מטפל במיקוד בין הבוררים באמצעות ה-APIHierarchicalFocusCoordinator
, ומאפשר מרכוז אוטומטי של פריטים בבורר.Placeholder
- ביצענו עדכונים באנימציות ובאנימציות 'מחיקה'. אפקט המחיקה מוחל מיד כשהתוכן מוכן.ScalingLazyColumn
- העברנו אתScalingLazyColumn
ואת הכיתות המשויכות מ-androidx.wear.compose.material.ScalingLazyColumn
אלandroidx.wear.compose.foundation.lazy.ScalingLazyColumn
. כדי להשתמש בגרסה שלFoundation.Lazy
צריך לעדכן אותה.SwipeToReveal
– הוספנו תמיכה ניסיונית בתכונה 'החלקה להצגה' כאמצעי גישה לפעולות משניות, בנוסף לדפוס הקיים של 'לחיצה ארוכה'.Stepper
– עכשיו יש עומס יתר עם פרמטרenableRangeSemantics
נוסף, כדי להקל על השבתת הסמנטיקה של טווח ברירת המחדל.Previews
– הוספנו את ההערות המותאמות אישית הבאות לתצוגה מקדימה של תכנים קומפוזביליים במסכי Wear: האפליקציהWearPreviewSmallRound
מציגה את התוכן הקומפוזבילי במכשיר קטן ועגול. התכונהWearPreviewLargeRound
מציגה תצוגה מקדימה של התוכן הקומפוזבילי במכשיר עגול גדול. התוכן הקומפוזבילי במכשירWearPreviewSquare
מוצג בתצוגה מקדימה במכשיר ריבועי. בנוסף, ההערות הבאות ותצוגות מקדימות של תצוגה מקדימה:WearPreviewFontScales
מציגה תצוגה מקדימה של התכנים הקומפוזביליים במכשיר Wear עם גופנים בגדלים שונים, ואילוWearPreviewDevices
מציג תצוגה מקדימה של התכנים הקומפוזביליים במכשירי Wear שונים.- הוספנו
DefaultTextStyle
ל-Wear Compose, שמגדיר את המאפייןPlatformTextStyle.includeFontPadding
כ-True (זו ההגדרה הנוכחית) כברירת מחדל. כך נוכל לסנכרן את השבתת המרווח הפנימי של הגופנים כברירת מחדל עם ספריות הכתיבה בגרסת אלפא מוקדמת של 1.3. מידע נוסף זמין בכתובת 1.2.0-alpha10.
תכונות חדשות
- הוספנו תמיכה ניסיונית באנימציה של שינוי קנה מידה והעמעום, כשמופעלת ההגדרה ההודעהDecrease_motion והם לא מתאימה. (I58024)
תיקוני באגים
- תיעוד משופר עבור
angularWidthDp
ב-CurvedSize.kt
(Iab75c) SwipeDismissableNavHost
מתעדת עכשיו אזהרה עם סיבות אפשריות למקבץ גיבוי ריק. הדבר נעשה כדי למנוע קריסות לא צפויות שנגרמות בגלל השגיאהIllegalArgumentException
, שנדחתה כשהמקבץ לאחור היה ריק. (I04a81, b/277700155)
גרסה 1.2.0-alpha10
10 במאי 2023
androidx.wear.compose:compose-*:1.2.0-alpha10
משוחרר. גרסה 1.2.0-alpha10 מכילה את התחייבויות אלה.
תכונות חדשות
- הוספנו תמיכה בתכונה 'החלקה להצגה', כאמצעי גישה לפעולות משניות. הדפוס הזה משלימה את הדפוס של 'לחיצה ארוכה', שהיא הדרך הקיימת שבה משתמש יכול לחשוף פעולות משניות (שונות). (I60862)
שינויים ב-API
- הוספנו את המאפיין
RevealScope
לתכנים קומפוזביליים של פעולות ב-SwipeToReveal
, שנותן גישה לקיזוז שבו פעולות נוספות נחשפו. (I3fd56)
תיקוני באגים
- תוקנה בעיה ב-
ScalingLazyColumn
שנתקע ב-Wear API 33 אחרי הנפילה (Ic4599) - ביצענו כמה שיפורי ביצועים של
PositionIndicator
כדי להפחית את ממשק המשתמש. (I35e92) - תיקנו באג בצ'יפ וב-
CompactChip
שבהם התפקיד הסמנטי כבר לא הוגדר כ-Role.Button
. (I93f91, b/277326264)
בעיות מוכרות
זיהינו באג ב-Android Studio שגורם לכשל בעיבוד התצוגה המקדימה כשמוסיפים הערות עם @WearPreviewdevices ו- @WearPreviewFontScales. בקרוב יתוקן תיקון. חשוב לשים לב שההערות האחרות בתצוגה המקדימה פועלות כמו שצריך ב-Android Studio Giraffe מגרסה 2022.3.1 ואילך.
בגרסה 1.2.0-alpha07 הוספנו את DefaultTextStyle ל-Wear Compose, תוך שמירה על הערך הקיים PlatformTextStyle.includeFontPting כ-true. לרקע, ניתן לעיין במאמר תיקון מרווח פנימי של גופן בכתיבה. אנחנו נשנה את ערך DefaultTextStyle כדי להשבית את המרווח הפנימי של הגופן בגרסת אלפא מוקדמת של 1.3, כדי לשמור על עקביות בפלטפורמת Android. הפעולה הזו תטפל במקרים מסוימים של חיתוך טקסט בגופנים גדולים ויכולה להשפיע גם על פריסות המסך, לכן צריך לעדכן את הבדיקות של צילומי המסך. לדוגמה, בגופנים גדולים יחסית ניתן לראות כאן חיתוך טקסט:
- הוא לא מופיע יותר כשהמרווח הפנימי של הגופן מושבת:
עכשיו אפשר ליישם את ההגדרה החדשה על ידי שינוי הטיפוגרפיה שבעיצוב. למשל, אפשר לעיין בקוד לדוגמה.
גרסה 1.2.0-alpha09
19 באפריל 2023
androidx.wear.compose:compose-*:1.2.0-alpha09
משוחרר. גרסה 1.2.0-alpha09 מכילה את התחייבויות אלה.
שינויים ב-API
- צריך להוסיף את
angularSizeDp
לממשק ה-API שלCurvedModifier
להגדרת רוחב זוויתי ב-DP (I89a52)
תיקוני באגים
- תיקנו בעיות נגישות בהדגמות בכלי לבחירת זמן(Id0eb7)
גרסה 1.2.0-alpha08
5 באפריל 2023
androidx.wear.compose:compose-*:1.2.0-alpha08
משוחרר. גרסה 1.2.0-alpha08 מכילה את התחייבויות אלה.
שינויים ב-API
- שינינו את השם של
ExpandableItemsState
לשםExpandableState
. (If85ea) - הוספנו את המאפיין
expandableButton
כדי לפשט את תהליך יצירת לחצן שמתכווץ כאשר התוכן מורחב, וגם עדכנו את דוגמאות ההרחבה. (Iae309)
תיקוני באגים
- דוגמאות משופרות להרחבה כדי להציג יותר אפשרויות. אנימציה של
expandableItem
ששונתה כדי שהתוכן שלה יהיה במרכז האנימציה. (I2f637) - בוצע עדכון של
ToggleControls
כדי למנוע הרכבות מחדש במהלך אנימציה ידנית של הצבעים באמצעות State. (I5d319)
גרסה 1.2.0-alpha07
22 במרץ 2023
androidx.wear.compose:compose-*:1.2.0-alpha07
משוחרר. גרסה 1.2.0-alpha07 מכילה את התחייבויות אלה.
שינויים ב-API
- העברנו את רכיבי הפריט הניתן להרחבה (שנוספו בגרסה 1.2.0-alpha06) מחומר לבסיסי, כי לא הייתה להם הפניה משמעותית אל
MaterialTheme
. (Ib0525)
תיקוני באגים
- תיקנו קריסה שאירעה במסך באמצעות
PickerGroup
. לשם כך, צריך לוודא שהמיקוד שלPickerGroup
מתבצע כמו שצריך כשאין בורר ממוקד. הוספנו גם תמיכה בגלילה ב-RSB בהדגמות של הבורר. (If8c19) - שיפרנו את המעברים בין תיבות הדו-שיח – עכשיו המעבר של המבוא חלק יותר כדי להתאים למעבר הסיום. (Ib5af9)
- הוספנו
DefaultTextStyle
ל-Wear Compose, שמגדיר את המאפייןPlatformTextStyle.includeFontPadding
כ-True (זו ההגדרה הנוכחית) כברירת מחדל. כך נוכל לסנכרן את השבתת המרווח הפנימי של הגופנים כברירת מחדל עם ספריות הכתיבה בעתיד (תיקון מרווח פנימי של גופנים בכתיבה) ברקע. (I2aee8) - בוטלה התלות של התצוגה המקדימה של
UpsideDownCake
באמצעות כתיבת פעילות שחסמה את הפרסום של אפליקציות בחנות Google Play. (I6443d)
גרסה 1.2.0-alpha06
8 במרץ 2023
androidx.wear.compose:compose-*:1.2.0-alpha06
משוחרר. גרסה 1.2.0-alpha06 מכילה את התחייבויות אלה.
שינויים ב-API
- כאן מוסיפים רכיב
CurvedBox
, שמציב רכיבים אחד על גבי השני בעולם המעוקל. (I29200) - נוספו פריטים שניתנים להרחבה - שני רכיבים חדשים שתומכים בקבוצה של פריטים שניתנים להרחבה ב-
ScalingLazyColumn
או בפריט יחיד שניתן להרחבה, כמו טקסט שבו מספר השורות מתרחב. (I95dd5) - הוספנו את ההערות המותאמות אישית הבאות לתצוגה מקדימה של תכנים קומפוזביליים במסכי Wear: ב-
WearPreviewSmallRound
מוצגת תצוגה מקדימה של התוכן הקומפוזבילי במכשיר קטן ועגול; התוכן הקומפוזבילי במכשירWearPreviewLargeRound
מוצג בתצוגה מקדימה במכשיר עגול גדול. התוכן הקומפוזבילי במכשירWearPreviewSquare
מוצג בתצוגה מקדימה במכשיר ריבועי. בנוסף, ההערות הבאות ותצוגות מקדימות של תצוגה מקדימה:WearPreviewFontScales
מציגה תצוגה מקדימה של התכנים הקומפוזביליים במכשיר Wear עם גופנים בגדלים שונים, ואילוWearPreviewDevices
מציג תצוגה מקדימה של התכנים הקומפוזביליים במכשירי Wear שונים. כדי להשתמש בתצוגות המקדימות האלה, עליכם להשתמש בגרסה העדכנית ביותר של Android Studio (Giraffe Canary 6) ואילך. לתשומת ליבך: אם ההערות האלה לא מתאימות למטרה שלך, עדיין אפשר להשתמש בתצוגה המקדימה ותומכת בהתאמה אישית נוספת באמצעות פרמטרים. (I397ff) - סימנו את
HierarchicalFocusCoordinator
כניסוי ניסיוני בזמן שהוא נחשב כמועמד להעברה לספריות ליבה של הרכבים, מאחר שחלה עליו המדיניות הרחבה. (I3a768)
תיקוני באגים
- תוקן באג ב-
HierarchicalFocusCoordinator
, כשה-lambda שהועברה לפרמטרfocusEnabled
השתנה, עכשיו אנחנו משתמשים בפרמטר החדש כמו שצריך. (Icb353) - עדכנו את צבע התוכן המושבת שמוגדר כברירת מחדל ל'רקע' כשמשתמשים בצבעי ראשי כרקע ב
Button
, בCompactButton
, בChip
, בCompactChip
ובToggleButton
. כך ניתן לשפר את הניגודיות מבחינת הנגישות. (I527cc)
גרסה 1.2.0-alpha05
22 בפברואר 2023
androidx.wear.compose:compose-*:1.2.0-alpha05
משוחרר. גרסה 1.2.0-alpha05 מכילה את התחייבויות אלה.
שינויים ב-API
- ה-API של
PickerGroup
עודכן כדי לאפשר הפצה של מגבלות המינימום לתוכן הקומפוזבילי באופן אופציונלי. אם המדיניות מוגדרת כ-True, המגבלות המינימליות שהועברו מהרכיב הקומפוזבילי ברמה העליונה מותרות ב-PickerGroup
. אם המדיניות מוגדרת כ-False,PickerGroup
יאפס את המגבלות המינימליות. (I3e046) - הוספנו את
animateScrollToOption
ל- Picker API כדי לתמוך באנימציה פרוגרמטית באפשרות ספציפית של Picker (I6fe67)
תיקוני באגים
- עדכנו את
HorizontalPageIndicator
כך שיתמוך בפריסות מימין לשמאל. (Ia4359) - נוספו בדיקות צילום מסך לפריסה מימין לשמאל ב-
HorizontalPageIndicator
(I6fbb8) - נוספו בדיקות נוספות ל-
SwipeDismissableNavHostTest
המשתמשים ב-TestNavHostController
(I61d54)
גרסה 1.2.0-alpha04
8 בפברואר 2023
androidx.wear.compose:compose-*:1.2.0-alpha04
משוחרר. גרסה 1.2.0-alpha04 מכילה את התחייבויות אלה.
תכונות חדשות
PickerGroup
לטיפול בכמה בוחרים יחד באמצעות ה-Focus API. המערכת מטפלת במוקד המיקוד בין הבוררים השונים, מאפשרת מרכוז אוטומטי של הבוררים על סמך פרמטרים ומאפשרת למפתחים לשנות את המיקוד בין הבוררים השונים בזמן הטיפול באירועים מהקבוצה. במצב טוקבאק,PickerGroup
מטפל בפוקוס של TalkBack על ידי העברת המיקוד לבורר שנבחר מהקבוצה. (I60840)
שינויים ב-API
- הוספנו עומס יתר ל-Stepper עם פרמטר
enableRangeSemantics
נוסף כדי להקל על השבתת הסמנטיקה של טווח ברירת המחדל (Ia61d4)
תיקוני באגים
- אפשר להציב את
ScalingLazyColumn
בדף גלילה אופקית (Iec3f8, b/266555016) - שיפור של קובצי 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
, והוא טבעי יותר כי הוא לא רכיב חומר מקובע. השינוי מתבצע עכשיו כחלק מהכנת הספרייה החדשה של Material3, ואנחנו נעבוד עליה במקביל לספריית Material3 הקיימת. (I060e7)
השינויים הבאים הם חלק מההעברה של ScalingLazyColumn
מ-Material אל Foundation.Lazy
:
- ממשקי ה-API של
PositionIndicator
שמטרגטים את MaterialScalingLazyColumn
הוצאו משימוש. צריך לעדכן לגרסהFoundation.Lazy ScalingLazyColumn
. בנוסף, השדהanchorType
נוסף אלScalingLazyListLayoutInfo
. (I29d95) ScalingLazyColumn
סומן כהוצאה משימוש בחבילת Wear Compose Material (I16d34)- עדכנו את מגביל ה-
ScrollAway
כך שישתמש ב-ScalingLazyListState
מ-Wear ComposeFoundation.Lazy
והוצאנו את עומס החריגה מ-ScalingLazyListState
מ-Wear Compose. (Ifc42c) - עדכנו את ממשקי ה-API של Dialog כך שישתמשו ב-
ScalingLazyListState
מ-Foundation.Lazy
והוצאנו משימוש את עומסי-היתר שנעשה בהם שימוש ב-MaterialScalingLazyListState
(Ic8960) - עדכנו את ממשקי ה-API של Picker כך שישתמשו ב-
ScalingParams
מ-Foundation.Lazy
והוצאנו משימוש את עומסי-היתר שנעשה בהם שימוש בחומרScalingParams
. (Idc3d8)
תיקוני באגים
- תיקנו באג שגרם קומפוזיציות מחדש לא נחוצות ב-
ScalingLazyListState.centerItemIndex
כי אנחנו מוודאים שהפעולה 'דוחפת עדכונים' רק כשהערך משתנה בפועל (Ia9f38) - שיפרנו את הביצועים של
SwipeToDismissBox
(I3933b) - נוספו בדיקות השוואה לשוק עבור
ScalingLazyColumn
ב-Wear Compose Foundation (Ie00f9) - עדכנו כמה שיטות פנימיות של
ScalingLazyColumn
לכיתות ב-Material כדי להשתמש בשיטות המקבילות שלהן מ-Foundation.Lazy
(I38aab) - תיקנו כמה בעיות בבדיקות של Picker והוספנו עוד בדיקות לבדיקת גלילה עם היסט (I6ac34)
- העברנו את הדגמות השילוב של
ScalingLazyColumn
כך שיהיו תלויות ב-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 לכתיבה ירוצו עכשיו אישורי פריסה לכל פריים כשמריצים פריימים לצורך מעבר למצב 'לא פעיל' (למשל, דרך
waitForIdle
). הדבר עלול להשפיע על בדיקות שמצהירות על פריימים בודדים של אנימציית פריסה. (I8ea08, b/222093277) - הפרמטר
minLines
נוסף ל-Wear Text כדי לאפשר התנהגות עקבית עםBasicText
(I24874) - התג
CompactChipTapTargetPadding
הוגדר כגלוי לכולם כך שהוא יופיע במסמכים (If1e70, b/234119038)
תיקוני באגים
- השבתת גרסאות build מרובות בפלטפורמות לחבילות
wear.compose
(Iad3d7) - תיקון kdocs עבור
scrollToOption
(I6f9a0) - בוצע עדכון של
PlaceholderState.rememberPlaceholderState()
לשימוש ב-rememberUpdatedState
כדי שהמדינה תתעדכן אם ה-lambda שלonContentReady
. (I02635, b/260343754) - תיקנו בעיה של רעידות טקסט ברכיב
Picker
על ידי מינוף אסטרטגיית ההרכבה החדשה שנוספה אלModifier.graphicsLayer
. (I99302) - תיקנו באג שגרם להבהוב בהדגמה של
DatePicker
שלנו (I660bd) - שיפרנו את הנגישות בהדגמות של הכלי לבחירת תאריך ושעה של 12 שעות (I05e12)
- עדכנו את ההדגמות של בורר השעה והתאריך, כך שהבוררים לא יושפעו משינויים ב-RSB לאחר ביטול הבחירה (I4aecb)
גרסה 1.2.0-alpha01
7 בדצמבר 2022
androidx.wear.compose:compose-*:1.2.0-alpha01
משוחרר. גרסה 1.2.0-alpha01 מכילה את התחייבויות אלה.
תכונות חדשות
- עדכנו את הפונקציונליות הניסיונית של Placeholder כך שאפקט "Wipe Off" (מחיקה מושבת) מופעל מיידית כשהתוכן מוכן, במקום להמתין להתחלה של לולאת האנימציה הבאה. ערכנו גם כמה עדכונים של הנצנוץ ושל מחיקת האנימציות. (I5a7f4)
שינויים ב-API
- הוספנו
HierarchicalFocusCoordinator
תוכן קומפוזבילי כדי לאפשר סימון של תתי-עצים של היצירה כשמיקוד הפוקוס מופעל או כשהמיקוד מושבת.(I827cb) - הוספנו נכס חדש כדי לשנות את התפקיד הסמנטי של
ToggleButton
.(I67132) - עדכנו את
TimeTextDefaults.TimeFormat12Hours
כדי להסיר את AM/PM בTimeText
. הפעולה הזו תשנה את ערך ברירת המחדל של הפרמטריםtimeSource
ב-APITimeText
. (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
כדי שהמדינה תתעדכן אם ה-lambda שלonContentReady
. (I02635, b/260343754)
גרסה 1.1.0
7 בדצמבר 2022
androidx.wear.compose:compose-foundation:1.1.0
, androidx.wear.compose:compose-material:1.1.0
ו-androidx.wear.compose:compose-navigation:1.1.0
שוחררו. גרסה 1.1.0 כוללת את ההתחייבויות האלה.
שינויים חשובים מאז 1.0.0
- גרסה יציבה של 'כתיבה' ל-Wear OS 1.1.0 (למידע נוסף).
- רשימה של השינויים העיקריים ב-Wear Compose 1.1 אפשר למצוא בנתוני הגרסה של (כתיבה ל-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
בתוך בלוק המדידה, כדי להימנע מחיבור מחדש של הערך אחרי כל מדידה מחדש. (I4c6f1) - הוספנו מסמכים ודוגמה ל-placeholders כדי להראות את הסדר הנכון של
Modifier.placeholder
ו-Modifier.placeholderShimmer
כשמחילים אותם על אותו תוכן קומפוזבילי. (Ie96f4, b/256583229) - שינינו את רוחב הגבול המוגדר כברירת מחדל עבור
OutlinedCompactChip/OutlinedChip
מ-2.dp ל-1.dp כדי להתאים למפרטים הסופיים של חוויית המשתמש. (Ib3d8e) - תיקנו באג ב-
rememberPickerState
שגרם לכך שנתוני הקלט המעודכנים לא נשמרו, כך שתכנים קומפוזביליים לא עודכנו אחרי שינויים בערכי הקלט. (I49ff6, b/255323197) - ביצענו כמה עדכונים של ממשק המשתמש ב-placeholders, 1) שינוי הדרגתי של הנצנוץ פי 1.5 מגודל המסך, 2) הוספה של התאמה (cubic bezier) להתקדמות הבהובת ו-3) האצת אנימציית המחיקה (250 אלפיות שנייה). (Id29c1)
- תיקנו באג בממשק המשתמש באפקט המחיקה של ה-placeholder שבו הרקעים של הצ'יפים והכרטיסים נמחקו מעט מוקדם יותר כי לא הבאנו בחשבון את מיקום הרכיב על המסך. (I2c7cb)
- עדכנו את שרטוט הרקע של ה-placeholder כדי למזג צבעים במקום להוסיף אותם בשכבות כשאפשר, כדי לצמצם את הסיכון למיזוג אלפא של השכבות השונות שנחתכו כך שלא יאפשרו לצבעי הבסיס לגלוש בקצוות הרקע של ה-placeholder. (I2ea26)
- תיקנו את החישוב של
ScalingLazyListState.centerItemIndex/centerItemOffset
, כך שאם שני פריטים נמצאים בכל צד של קו המרכז של אזור התצוגה, הפריט הקרוב ביותר ייחשב כ-centerItem
. (I30709, b/254257769) - תיקנו באג ב-
ScalingLazyListState.layoutInfo.visibleItemsInfo
שדיווח על קיזוזים שגויים במהלך האתחול שלScalingLazyColumn
. בשלב הזה, רשימה ריקה תוחזר עד שכל הפריטים ברשימה יוצגו עם קיזוזים נכונים. צריך לבדוק אתScalingLazyListState.layoutInfo.visibleItemsInfo.isNotEmpty()
כדי לוודא שהאתחול שלScalingLazyColumn
הושלם והפריטים מוצגים. (I3a3b8)
גרסה 1.1.0-beta01
24 באוקטובר 2022
androidx.wear.compose:compose-foundation:1.1.0-beta01
, androidx.wear.compose:compose-material:1.1.0-beta01
ו-androidx.wear.compose:compose-navigation:1.1.0-beta01
שוחררו. גרסה 1.1.0-beta01 מכילה את התחייבויות אלה.
מה חדש ב-Composes עבור Wear OS 1.1
לפי גרסה 1.1.0-בטא01 של 'כתיבה מהירה' ל-Wear OS, הגרסה הזו של הספרייה הושלמה ושה-API נעול.
- הגרסה של Wear Compose 1.1 כוללת את הפונקציונליות החדשה הבאה:
- הבורר – שיפורי הנגישות בכלי לבחירת מספר, כך שיהיה אפשר לנווט במסכים של בוחרי המסך באמצעות קוראי מסך ותיאור התוכן יהיה נגיש
- הפרמטר
contentDescription
של הבורר משמש עכשיו רק לאפשרות של הבורר שנבחרה ומחזיר מחרוזת אפסית (בשמירה הקודמת, היה צורך להעביר מיפוי מהאפשרות לתיאור התוכן, אבל נעשה שימוש רק באפשרות שנבחרה). - עכשיו הפריטים בבורר תמיד יישור למרכז, לכן תיקון באג בזמן הגדרת הערך של
gradientRatio
כאפס הוביל לתוצאה הצדדית של שינוי היישור. Chip/ToggleChip
- עדכנו את מעברי הדירוג שמוגדרים כברירת מחדל ל-Chip/ToggleChip
כדי שיתאימו למפרט העדכני של חוויית המשתמש. הערך שלChipDefaults.gradientBackgroundChipColors
עודכן ועכשיו הוא 50% מהראשיות במקום 32.5%.Chip/ToggleChip
– נוספו עומסי יתר לשינוי צורות של צ'יפיםChip/Button/ToggleButton
– נוסף סגנון חדש עם קווי מתאר לצ'יפים וללחצנים, ולתכנים קומפוזביליים חדשים מסוגOutlinedChip
ו-OutlinedButton
שמספקיםChip/Button
שקוף עם מסגרת דקה.- כרטיס – עדכנו את שדרוגי ברירת המחדל של הכרטיסים כדי להתאים אותם למפרט העדכני של חוויית המשתמש. הערך של
CardDefaults.cardBackgroundPainter
עודכן כך שיתחיל מ-30% מהערך הראשוני ויסתיים ב-20% מ-onSurfaceVariant
(לפני כן היה 20% עד 10%onSurfaceVariant
).ToggleChip.toggleChipColors
משתנה משדרגת ליניארית של 75% פני שטח ל-32.5% ראשוני ל-0% לשטח ראשי של 50%. Button/ToggleButton
– נוספו מאפיינים לשינוי צורות לחצנים.- עיצוב – עדכנו את מספר צבעי ברירת המחדל ב
MaterialTheme
כדי לשפר את הנגישות, כי הצבעים המקוריים לא היו מספיק ניגודיות, ולכן המשתמשים לא יכולים להבדיל בין רקעים של צ'יפים/כרטיסים/לחצנים לבין צבע הרקע של העיצוב. InlineSlider/Stepper
– נוספו תפקידים של לחצנים כדי לאפשר ל-Talkback
לזהות אותם כלחצנים.- פיום - עכשיו
PositionIndicator
ממוקם והגודל שלו יתפוס רק את המקום הדרוש. האפשרות הזו שימושית, לדוגמה, אם מוסיפים מידע סמנטי, TalkBack עובר עכשיו לגבולות הנכונים שלPositionIndicator
במסך. CurvedText/TimeText
– נוספה האפשרותModifier.scrollAway
, שגוללת פריט אנכית או מחוץ לתצוגה לפי מצב הגלילה (עם עומסי יתר לעבודה עםColumn
,LazyColumn
ו-ScalingLazyColumn
).ScrollAway
משמש בדרך כלל לגלילהTimeText
מחוץ לתצוגה בזמן שהמשתמש מתחיל לגלול רשימת פריטים כלפי מעלה.CurvedText/TimeText
– נוספה תמיכה ב-fontFamily
, ב-fontStyle
וב-fontSynthesis
ב-CurvedTextStyle
, שניתן להשתמש בה ב-curvedText
וב-basicCurvedText
CurvedText/TimeText
-fontWeight
נוסף ל-constructor ולשיטת ההעתקה ב-CurvedTextStyle
ToggleControls
– נוספה אנימציה של מתגיCheckbox
,Switch
ו-RadioButton
לשימוש עםToggleChip
ו-SplitToggleChip
. אפשר להשתמש בסמלים האלה במקום בסמלים הסטטיים שסופקו על ידיToggleChipDefaults
(switchIcon
,checkboxIcon
ו-radioIcon
).- Placeholder – נוספה תמיכה ניסיונית ב-placeholder. הדוח כולל שלושה אפקטים חזותיים ייחודיים שמיועדים לפעול יחד.
- קודם כל, אפקט של מברשת רקע מסוג placeholder שנעשה בו שימוש בקונטיינרים כמו צ'יפ וכרטיסים, כדי לצייר על הרקע הרגיל בזמן המתנה לטעינת תוכן.
- שנייה: מקש צירוף (
Modifier.placeholder()
) לשרטוט ווידג'ט placeholder בצורת אצטדיון מעל התוכן שנטען. - שלישית, אפקט הדרגתי/הנצנוץ (
Modifier.placeholderShimmer()
) המוצג מעל לשאר האפקטים כדי לציין למשתמשים שאנחנו ממתינים לנתונים לטעינה.- כל האפקטים האלה מיועדים להיות מתואמים, מהבהבים ומנוצים בצורה מתוזמרת.
- יחסי התלות של הליבה לכתיבה עודכנו מ-1.2 ל-1.3
שינויים ב-API
- עכשיו אפשר לציין פרמטרים של גופן (
fontFamily
,fontWeight
,fontStyle
ו-fontSynthesis
) ישירות כפרמטרים שלcurvedText
(Idc422)
תיקוני באגים
curveText
ו-basicCurvedText
יפעלו עכשיו כראוי עם Talkback (הצומת המכיל צומת קומפוזיציה בגודל מתאים (אבל ריק) המשויך אליהם, תוך שימוש בטקסט כתיאור התוכן) (I7af7c, b/210721259)- תיקון הבאג ב-
Picker
כאשרPickerState.repeatedItems = false
מוסיף הגדרה מפורשת של פרמטרים לריכוך אוטומטי של בוררים בתוךScalingLazyColumn
, כדי להבטיח שניתן יהיה לגלול את האפשרות האפס למרכז התצוגה. (I8a4d7)
גרסה 1.1.0-alpha07
5 באוקטובר 2022
androidx.wear.compose:compose-foundation:1.1.0-alpha07
, androidx.wear.compose:compose-material:1.1.0-alpha07
ו-androidx.wear.compose:compose-navigation:1.1.0-alpha07
שוחררו. גרסה 1.1.0-alpha07 מכילה את התחייבויות אלה.
תכונות חדשות
- הוספנו תמיכה ב-placeholders ניסיונית. הדוח כולל שלושה אפקטים חזותיים ייחודיים שמיועדים לפעול יחד. קודם כל, אפקט של מברשת רקע מסוג placeholder שנעשה בו שימוש בקונטיינרים כמו צ'יפ וכרטיסים, כדי לצייר על הרקע הרגיל בזמן המתנה לטעינת תוכן. שנייה: מקש צירוף (
Modifier.placeholder()
) לשרטוט ווידג'ט placeholder בצורת אצטדיון מעל התוכן שנטען. שלישית, אפקט הדרגתי/הנצנוץ (Modifier.placeholderShimmer()
) המוצג מעל לשאר האפקטים כדי לציין למשתמשים שאנחנו ממתינים לנתונים לטעינה. כל האפקטים האלה מיועדים להיות מתואמים, מהבהבים ומנוצים בצורה מתוזמרת. I3c339
שינויים ב-API
- נוספה תמיכה ב-
fontWeight
, ב-fontFamily
, ב-fontStyle
וב-fontSynthesis
ב-CurvedTextStyle
, ניתן לשימוש ב-curvedText
וב-basicCurvedText
. אפשר להשתמש בפרמטרים האלה כדי לציין את הגופן והסגנון שבהם צריך להשתמש בטקסט העקום.(Iaa1a8),(I72759) - פרמטר ההיסט של
Modifier.scrollAway
עודכן ל-Dp כדי לשמור על עקביות עםModifier.offset
(בעבר הוא היה בפיקסלים). בנוסף, בוצע ארגון מחדש שמוגדר כLayoutModifier
מבחינת יעילות. (I9f94b) - במסגרת ה-API החדש לבקרה על החלפת מצב, שינינו את השם
RadioButton’s circleColor
ל-ringColor
. (I28fa9) - הוספנו אנימציה של מתגי
Checkbox
,Switch
ו-RadioButton
לשימוש עםToggleChip
ו-SplitToggleChip
. אפשר להשתמש בסמלים האלה במקום בסמלים הסטטיים שסופקו על ידיToggleChipDefaults
(switchIcon
,checkboxIcon
ו-radioIcon
). (I8a8c4)
גרסה 1.1.0-alpha06
21 בספטמבר 2022
androidx.wear.compose:compose-foundation:1.1.0-alpha06
, androidx.wear.compose:compose-material:1.1.0-alpha06
ו-androidx.wear.compose:compose-navigation:1.1.0-alpha06
שוחררו. גרסה 1.1.0-alpha06 מכילה את התחייבויות אלה.
תכונות חדשות
- הוספנו את התכונה
Modifier.scrollAway
, שגוללת את הפריט במצב אנכי או מחוץ לתצוגה, לפי מצב הגלילה (עם עומסי יתר לעבודה עםColumn
,LazyColumn
ו-ScalingLazyColumn
).ScrollAway
משמש בדרך כלל לגלילהTimeText
מחוץ לתצוגה בזמן שהמשתמש מתחיל לגלול רשימת פריטים כלפי מעלה. (I61766)
תיקוני באגים
- עכשיו ה-
PositionIndicator
ממוקם והגודל שלו יתפוס רק את המקום הדרוש. האפשרות הזו שימושית, לדוגמה, אם מוסיפים מידע סמנטי, 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 כדי לשפר את הנגישות, מאחר שהניגודיות בין הצבעים המקוריים לא הייתה מספקת מה שגרם למשתמשים להבחין בין רקעים של צ'יפים/כרטיסים/לחצנים לבין צבע הרקע של העיצוב. הצבעים המעודכנים הם פני שטח (0xFF202124->0xFF303133), onPrimary(0xFF202124->0xFF303133), onsecondary(0xFF202124->0xFF303133), primaryVariant(0xFF669DF6->0xFF80x4F8). שינויים בצבעים, אם כי עדינים יחסית, עשויים להשפיע על בדיקות קיימות של צילומי מסך. (81ab09)
תיקוני באגים
- תיקון של באג לוגי ב-
ScalingLazyColumn
שעלול לגרום לכך שרשימות עם מספר קטן (בדרך כלל בדיוק 2) של פריטים ברשימה לא משלימים את האתחול וכתוצאה מכך מתרחשת שקיפות. (504347)
גרסה 1.1.0-alpha03
10 באוגוסט 2022
androidx.wear.compose:compose-foundation:1.1.0-alpha03
, androidx.wear.compose:compose-material:1.1.0-alpha03
ו-androidx.wear.compose:compose-navigation:1.1.0-alpha03
שוחררו. גרסה 1.1.0-alpha03 מכילה את התחייבויות אלה.
תכונות חדשות
- הוספנו סגנון חדש עם קווי מתאר ל-
Chips
ול-Buttons
, ולתכנים קומפוזביליים חדשים מסוגOutlinedChip
ו-OutlinedButton
שמספקיםChip/Button
שקוף עם מסגרת דקה. (Id5972)
שינויים ב-API
- נוספו עומסי יתר לשינוי צורות לחצנים (Icccde)
תיקוני באגים
- תיקנו את הגודל של אזור הבקרה של המתג ב
ToggleChip
כי הוא לא תאם למפרט חוויית המשתמש. במפרט חוויית המשתמש צריך להוסיף רווח של 4.dp בין התווית לאזור של סמל מתג הבקרה בגודל 24x24.dp, כך שיהיה רוחב כולל של 28.dp. עם זאת, בזמן ההטמעה מצוין אזור הבקרה למתג 36x24.dp. התוצאה היא שטח של 8.dp של תוויות טקסט שניתן להשתמש בו. הערה: תיקון הבאג הזה מעניק יותר מקום לתווית הטקסט, וכתוצאה מכך הוא עשוי להשפיע (חיובית) על פריסת הטקסט של הטקסט שגולש. אם יש בדיקות של צילומי מסך, כוללToggleChips
, יכול להיות שצריך לעדכן אותן. (I514c8, b/240548670)
גרסה 1.1.0-alpha02
27 ביולי 2022
androidx.wear.compose:compose-foundation:1.1.0-alpha02
, androidx.wear.compose:compose-material:1.1.0-alpha02
ו-androidx.wear.compose:compose-navigation:1.1.0-alpha02
שוחררו. גרסה 1.1.0-alpha02 מכילה את התחייבויות אלה.
תכונות חדשות
- שינינו את יחסי התלות של 'כתיבה' ל-Wear OS בספריות ליבה לכתיבה מגרסה 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
של הבורר משמש עכשיו רק לאפשרות של הבורר שנבחרה ומחזיר מחרוזת אפסית (בעבר היה צורך להעביר מיפוי מהאפשרות לתיאור התוכן, אבל רק האפשרות שנבחרה הייתה בשימוש). (Ife6a7) - שיפרנו את הנגישות בבורר כדי שיהיה אפשר לנווט במסכים עם קוראי מסך מרובים ותיאור התוכן יהיה נגיש (I64edb)
תיקוני באגים
- עדכנו את כללי הפרופיל הבסיסיים שכלולים בספריית Wear Compose (I9c694)
- תיקנו את הכיוון של ההדרגתיות של הצ'יפים במצב מימין לשמאל. היה למעלה משמאל ->ימין למטה, עכשיו הוא ימין למעלה -> שמאל למטה. (Ic2e77)
- עדכנו את מדרגי ברירת המחדל של
Chip/ToggleChip/Card
כדי שיתאימו למפרט העדכני של חוויית המשתמש. הערך שלChipDefaults.gradientBackgroundChipColors
עודכן ועכשיו הוא 50% מהראשיות במקום 32.5%. הערך שלCardDefaults.cardBackgroundPainter
עודכן כך שיתחיל מ-30% מהערך הראשוני ויסתיים ב-20% מ-onSurfaceVariant
(לפני כן היה 20% עד 10%onSurfaceVariant
).ToggleChip.toggleChipColors
משתנה משדרגת ליניארית של 75% פני שטח ל-32.5% ראשוני ל-0% לשטח ראשי של 50%. (I43bbd) - הוספנו צבע רקע (
MaterialTheme.color.surface
) מאחוריChip/ToggleChips
עם רקעים הדרגתיים, כדי להבטיח שניתן יהיה לראות אותם כראוי במקרה הלא סביר שבו נעשה שימוש בצבע בהיר מאחוריהם. (Ibe1a4, b/235937657) - עכשיו הפריטים בבורר תמיד יישור למרכז, לכן תיקון באג בזמן הגדרת הערך של
gradientRatio
כאפס הוביל לתוצאה הצדדית של שינוי היישור. (I712b8)
גירסה 1.0
גרסה 1.0.2
7 בספטמבר 2022
androidx.wear.compose:compose-foundation:1.0.2
, androidx.wear.compose:compose-material:1.0.2
ו-androidx.wear.compose:compose-navigation:1.0.2
שוחררו. גרסה 1.0.2 כוללת את ההתחייבויות האלה.
תיקוני באגים
- תיקנו את סדר ה-z של המיקום והמחוונים של הדפים ב-Scaffold. האינדיקטורים יופיעו עכשיו מעל מודעת הביניים ולכן הם לא יוסתרו על ידי מודעת הביניים אם היא קיימת. (Ib988f, b/244207528)
גרסה 1.0.1
24 באוגוסט 2022
androidx.wear.compose:compose-foundation:1.0.1
, androidx.wear.compose:compose-material:1.0.1
ו-androidx.wear.compose:compose-navigation:1.0.1
שוחררו. גרסה 1.0.1 כוללת את ההתחייבויות האלה.
תיקוני באגים
- תיקון של באג לוגי ב-
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
- זוהי הגרסה היציבה הראשונה של 'כתיבה' ל-Wear OS (למידע נוסף).
- פיתוח נייטיב ל-Wear OS מבוסס על ספריות הליבה של פיתוח נייטיב, שמספק רכיבים נוספים שספציפיים ללבישים, ובמקרים הרלוונטיים, הטמעות חלופיות של רכיבי ליבה של פיתוח נייטיב שמותאמים למכשירים לבישים.
- לרשימת הרכיבים העיקריים ב-Wear Compose אפשר לעיין בנתוני הגרסה של (Compose for Wear OS Beta01).
תיקוני באגים
- הנפשנו את חשיפת מודעת הביניים בזמן הצגה/הסתרה של תיבת הדו-שיח, בהתאם לאנימציה הקיימת של שינוי קנה המידה. (Ida33e)
- תיקנו באג שבו עלול להתרחש חילוק של אפסים עקב התנהגות של הנביטה בזמן גלילה. (I86cb6)
- תוקן באג ב-
ChipDefaults.childChipColor()
כדי לוודא שצבע הרקע המושבת הוא שקוף לחלוטין. (I2b3c3, b/238057342)
גרסה 1.0.0-rc02
22 ביוני 2022
androidx.wear.compose:compose-foundation:1.0.0-rc02
, androidx.wear.compose:compose-material:1.0.0-rc02
ו-androidx.wear.compose:compose-navigation:1.0.0-rc02
שוחררו. גרסה 1.0.0-rc02 מכילה את ההתחייבויות האלה.
תיקוני באגים
- תיקנו את הכיוון של ההדרגתיות של הכרטיסים במצב מימין לשמאל (RTL). הוא היה משמאל למעלה->ימין למטה, ועכשיו הוא מימין למעלה->בפינה השמאלית התחתונה. (Ic2e77)
- עדכנו את מדרגי ברירת המחדל של
Chip/ToggleChip/Card
כדי שיתאימו למפרט העדכני של חוויית המשתמש. הערך שלChipDefaults.gradientBackgroundChipColors
עודכן ועכשיו הוא 50% מהראשיות במקום 32.5%. הערך שלCardDefaults.cardBackgroundPainter
עודכן כך שיתחיל מ-30% מהמקור הראשוני ויסתיים ב-20% מ-onSurfaceVariant
(לפני כן היה 20% עד 10% ב-OnSurfaceVariant).ToggleChip.toggleChipColors
משתנה משיפוע לינארי של 75% בפני השטח של 32.5% הראשי, למשטח של 0% ל-50% הראשי. (I43bbd) - הוספנו צבע רקע (
MaterialTheme.color.surface
) מאחוריChip/ToggleChips
עם רקעים הדרגתיים, כדי להבטיח שניתן יהיה לראות אותם כראוי במקרה הלא סביר שבו נעשה שימוש בצבע בהיר מאחוריהם. (Ibe1a4, b/235937657) - עדכנו את כללי הפרופיל הבסיסיים שכלולים בספריית Wear Compose (I9c694)
גרסה 1.0.0-rc01
15 ביוני 2022
androidx.wear.compose:compose-foundation:1.0.0-rc01
, androidx.wear.compose:compose-material:1.0.0-rc01
ו-androidx.wear.compose:compose-navigation:1.0.0-rc01
שוחררו. גרסה 1.0.0-rc01 מכילה את ההתחייבויות האלה.
שינויים ב-API
- ממשקים בספריות הרכבה נוצרים עכשיו באמצעות שיטות ברירת מחדל של jdk8 (I5bcf1)
תיקוני באגים
- הסרנו את הקריאה המפורשת ל-
fillMaxWidth()
בכותרת הרשימה כי אין בה צורך. היא עלולה לגרום לבעיות אם המאפייןScalinglazyColumn
מכיל שילוב של רכיביListHeader()
ו-Chip()
, כי הרוחב עשוי לגדול או להתכווץ ככל שהרוחב שלListHeader
פריטים נגלל פנימה או החוצה מהתצוגה. (I37144, b/235074035) - תיקנו באג ב-
ScalingLazyColumn
שגרם לכך שהפריטים ברשימה לא ייכתבו בצורה נכונה עד שתתבצע גלילה אם הפריט הרשימה ה-0 גדול מספיק (כולל מרווח פנימי) (Ic6159, b/234328517) - ביצענו שינוי קטן בהתאמה ל
ScalingLazyColumn
כשהפריטים מגיעים לקצה המסך בהתאם לעדכונים במפרט חוויית המשתמש. ערכים ישניםCubicBezierEasing(0.25f, 0.00f, 0.75f, 1.00f)
-> הערכים החדשים:CubicBezierEasing(0.3f, 0f, 0.7f, 1f)
. כדי לשמור על ההתנהגות הישנה, אפשר לעקוף אתscalingParams
שלScalingLazyColumn
(Ie375c) - הוספנו מרווח פנימי ל-
CompactChip
כדי להבטיח שגודל יעד ההקשה שלו הוא לפחות 48.dp גבוה בהתאם להנחיות הנגישות 'Material'. הפעולה הזו עשויה להשפיע על הפריסות שבהן השתמשת ב-CompactChips
כי הן יתפסו יותר מקום. (I3d57c)
גרסה 1.0.0-beta03
1 ביוני 2022
androidx.wear.compose:compose-foundation:1.0.0-beta03
, androidx.wear.compose:compose-material:1.0.0-beta03
ו-androidx.wear.compose:compose-navigation:1.0.0-beta03
שוחררו. גרסה 1.0.0-beta03 מכילה את התחייבויות אלה.
תכונות חדשות
- הכנו
ScalingLazyColumn
פעולות במצב 'כתיבה'@Preview
. (I3b3b6, b/232947354)
שינויים ב-API
- שינינו את ערך ברירת המחדל של המאפיין
ScalingLazyColumn.horizontalAlignment
מ'התחלה' ל-CenterHorizontally
, כדי להבטיח שכאשר פריטים ברשימה לא ימלאו את כל רוחב העמודה, הם יהיו מותאמים להשגת חשיפה מקסימלית. כדי לחזור לקבוצת ההתנהגות הקודמתhorizontalAlignment = Alignment.Start
.(I9ed4b)
בעיות מוכרות
- גובה ההקשה/המגע של CompactChip קטן יותר מהנחיות הנגישות של Material. התיקון הזה יתוקן בגרסה הבאה (15 ביוני). אם משתמשים ב-CompactChip, זה משפיע על הפריסות כי עכשיו ל-ComactChips יש מרווח פנימי נוסף מעל ומתחת. צריך לשנות ולבדוק את הפריסות או לעיין בתגובות על הבאג כדי לעקוף את ההתנהגות הקיימת. (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
(ייתכן שאפשר יהיה להוסיף את הפעולה הזו לשיטות ההעתקה וה-constructor בגרסאות עתידיות של ה-API) (Ieebb9) - שיפורים בהחלקה מהקצה. כשנעשה שימוש ב-
Modifier.edgeSwipeToDismiss
והחלקה שמאלה מופעלת מאזור הקצה, היא כבר לא מפעילה החלקה לסגירה כשהכיוון של ההחלקה משתנה ימינה. בעבר, היה אפשר להפעיל החלקה לסגירה על ידי החלקה שמאלה ואז החלקה ימינה.(I916ea) - ב-
HorizontalPageIndicator
מוצגים עכשיו עד 6 דפים במסך. אם יש יותר מ-6 דפים בסך הכל, יופיע אינדיקטור בחצי גודל משמאל או מימין, עם מעבר חלק בין דפים.(I2ac29) - שיפור התנהגות הצמדה שמוגדרת כברירת מחדל ב-
ScalingLazyColumn
וב-Picker
(I49539) - שיפורים בהחלקה מהקצה. כשמשתמשים ב-
Modifier.edgeSwipeToDismiss
, החלקה לסגירה מופעלת רק כשהנגיעה הראשונה נוחתת מהקצה והחלקה ימינה. בעבר הייתה אפשרות להפעיל החלקה לסגירה על ידי החלקה מכל חלק במסך אם הגלילה מגיעה להתחלה.(I8ca2a)
גרסה 1.0.0-beta01
11 במאי 2022
androidx.wear.compose:compose-foundation:1.0.0-beta01
, androidx.wear.compose:compose-material:1.0.0-beta01
ו-androidx.wear.compose:compose-navigation:1.0.0-beta01
שוחררו. גרסה 1.0.0-beta01 מכילה את התחייבויות אלה.
מה חדש ב-Composes עבור Wear OS 1.0
1.0.0-beta01
של 'כתיבה' ל-Wear OS הוא ציון דרך חשוב כי הספרייה הושלמה וה-API נעול.
רכיבי Wear Compose Material בגרסה 1.0 כוללים:
- עיצוב Material – שמשמש כתחליף ל-
MaterialTheme
Compose for Mobile, מספק את הצבעים, הצורות והטיפוגרפיה של רכיבי הבנייה של גאדג'טים לבישים שמיישמים את הנחיות חוויית המשתמש של Wear Material Design, ברכישה מלאה. Button
,CompactButton
ו-ToggleButton
– הלחצן מציע משבצת אחת לצילום סמל, תמונה או טקסט קצר (3 תווים לכל היותר). עיגול בצורת עיגול עם גדלים מומלצים לברירת המחדל, ללחצנים גדולים או קטנים. ב-CompactButton
יש חריץ אחד לצילום כל תוכן (סמל, תמונה או טקסט) והוא מעוגל, עם גודל רקע קטן במיוחד. ב-CompactButton
יש מרווח פנימי שקוף מסביב לרקע שמגדיל את אזור הלחיצה.ToggleButton
הוא לחצן שמציע מקום אחד לצילום כל תוכן (טקסט קצר, סמל או תמונה) ובמצבי הפעלה/כיבוי (מסומן/לא מסומן) עם צבעים וסמלים שונים, כדי לציין אם הם מסומנים או לא.- כרטיסים - משמשים להצגת מידע על אפליקציות, כגון התראות. עיצוב גמיש לתרחישים שונים לדוגמה עם
AppCard
ו-TitleCard
, שמעניק פריסות שונות ותמיכה לתמונות בתור תוכן או רקעים של כרטיסים. - צ'יפים – רכיבים בצורת אצטדיון שדומים ללחצנים, אבל עם אזור גדול יותר ומספר משבצות שאפשר להוסיף לתוויות, לתוויות משניות ולסמלים. בגדלים שונים עם תמיכה בתמונות בתור רקעים.
- החלפת מצב של צ'יפים ו-SplitToggleChips – צ'יפ במצב מסומן/לא מסומן והוספה של חריץ
ToggleControl
, להצגת סמל כמו מתג או לחצן בחירה להצגת המצב המסומן של הרכיב. בנוסף, ב-SplitToggleChip
יש שני אזורים שאפשר להקיש עליהם, אחד שאפשר ללחוץ עליו והשני אפשר להחלפה. - אינדיקטור התקדמות מעגלי – אינדיקטור התקדמות של חומר מלבוש עם שתי וריאציות. הראשון משקף את שיעור ההשלמה של משימה מתמשכת, ותומך בפער במסלול המעגלי בין זוויות ההתחלה והסיום. הערך השני מציין התקדמות לא צפויה למשך זמן המתנה שלא צוין.
- CurdText – חלק מה-DSL לתיאור
CurvedLayouts
, יחד עםcurvedRow
ו-curvedColumn
, לפרוס רכיבים מסביב למכשירים מעגליים. פרטים נוספים עלCurvedLayout
ו-CurvedModifier
מופיעים במאמר 'בסיס רכיבי Wear' שבהמשך (שממלאים תפקיד דומה לזה של המגבילים בעולם לא מעוקל ומאפשרים להגדיר היבטים שונים של פריסה, מרווח פנימי, הדרגה וכו'). - תיבת דו-שיח, התראה ואישור - תיבת הדו-שיח מציגה תיבת דו-שיח במסך מלא, המוצגת בשכבות מעל כל תוכן אחר, ותומך בהחלקה לסגירה. נדרש משבצת אחת, שאמורה להיות מקובצת תוכן של תיבת דו-שיח מסוג חומר Wear, כמו 'התראה' או 'אישור'. התראה היא תוכן של תיבת דו-שיח מקובצת עם משבצות לסמל, לכותרת ולהודעה. יש בו עומסי יתר של שני לחצנים חיוביים ושליליים שמוצגים זה לצד זה, או חריץ לצ'יפ אחד או יותר בערימה אנכית. אישור הוא תוכן של תיבת דו-שיח מקובע שבו מוצגת הודעה במשך פרק זמן נתון. יש בו מקום לסמל או לתמונה (שיכול להיות מונפש).
- אינדיקטור דף אופקי – מציג את מיקום הדף האופקי באופן שמתאים לגורם הצורה הלביש. נועדה להציג את המסך המלא ולהציג אינדיקטור מעוקל במכשירים עגולים. אפשר להשתמש בו עם מציג הדף המלווה.
- סמל – הטמעת Wear של Icon בעזרת צבע ואלפא מעיצוב העיצוב של Wear. אם מדובר בסמל שניתן ללחוץ עליו, ראו 'לחצן' או 'צ'יפ'.
- בורר - מציג רשימה של פריטים לבחירה שניתן לגלול. כברירת מחדל, פריטים יחזרו על עצמם 'ללא הגבלה' בשני הכיוונים. אפשר להציג במצב קריאה-בלבד כדי להסתיר אפשרויות שלא נבחרו.
- אינדיקטור מיקום – מציג את מיקום הגלילה או אינדיקציה אחרת למיקום באופן שמתאים לגורם הצורה הלביש. מיועד למסך מלא ומציג אינדיקטור מעוקל במכשירים עגולים.
- פילינג - הטמעת מבנה הפריסה החזותי הבסיסי של Wear Material Design. הרכיב הזה מספק API שמרכיב מספר רכיבים של Wear Material (כמו
TimeText
,PositionIndicator
ו-Vignette
) שמרכיבים את המסך, מה שמבטיח עבורם אסטרטגיית פריסה מתאימה ואיסוף נתונים נדרשים כדי שהרכיבים האלו יפעלו יחד כראוי. - ScalingLazyColumn – רכיב רשימת קנה מידה או עין הדג גלילה שמהווה חלק מרכזי בשפה של Wear Material Design. מספק אפקטים של התאמה לעומס (scaling) ושקיפות לגבי פריטי התוכן.
ScalingLazyColumn
מתוכנן כך שיוכל להתמודד עם מספר גדול של פריטי תוכן שעשויים להיות מהותיים ומורכבים רק במקרה הצורך. - פס הזזה - מאפשר למשתמשים לבחור מתוך מגוון ערכים. טווח הבחירות מוצג כעמודה, שניתן להציג עם מפרידים.
- שלבים – רכיב במסך מלא שמאפשר למשתמשים לבחור מתוך טווח ערכים באמצעות לחצני הגדלה או הקטנה בחלק העליון והתחתון של המסך, עם חריץ באמצע לטקסט או לצ'יפ.
- TalkBackToDismissBox - מטפל בתנועה של החלקה לסגירה. נדרש מיקום אחד לרקע (מוצג רק במהלך תנועת ההחלקה) ולתוכן שבחזית. ניתן לשלב אותו עם ספריית הניווט של androidx באמצעות
SwipeDismissableNavHost
(מידע נוסף זמין בספריית הניווט של Wear Compose בהמשך). - טקסט – הטמעת Wear של הרכיב Material Material Text, מקבלת צבע ואלפא מהעיצוב של Wear Material Design
- TimeText – רכיב להצגת השעה וסטטוס הבקשה בראש המסך. התאמה לצורת המסך באמצעות טקסט מעוקל במסכים עגולים.
דהייה בשוליים – עיצוב מסך לשימוש ב-Scaffold לטשטוש החלק העליון והתחתון של המסך כשנעשה שימוש בתוכן שניתן לגלול.
גם הרכיבים הבאים כלולים ב-Wear Compose Foundation:
CurvedLayout - Wear Foundation
CurvedLayout
הוא פורמט קומפוזבילי לפריסה שמציב את הילדים בקשתות ומסובב אותם לפי הצורך. הדבר דומה לפריסת שורות שמעוקלת לקטע של אנולוס. לתשומת ליבכם: התוכן שלCurvedLayout
הוא לא lambda קומפוזבילי, אלא DSL (שפה ספציפית לדומיין). כל הרכיבים ב-DSL של CurvedLayout תומכים בפרמטר אופציונלי של מגביל, שנוצר מ-CurvedModifier
.BasicCurvedText – רכיב ב-DSL
CurvedLayout
,basicCurvedText
מאפשר למפתחים לכתוב בקלות טקסט מעוקל שמופיע אחרי העקום של מעגל (בדרך כלל בקצה של מסך מעגלי). ניתן ליצור אתbasicCurvedText
רק בתוךCurvedLayout
כדי להבטיח את החוויה הטובה ביותר. למשל, אפשר לציין את המיקום ולהשתמש ב-CurvedModifiers
. לידיעתכם, ברוב המקרים כדאי להשתמש במקום זאת ב-CorpText, כי הוא מבוסס על עיצוב מהותי.CurdComposable – כולל תוכן קומפוזבילי רגיל כך שאפשר להשתמש בו עם
CurvedLayout
. אם ב-curvedComposable
יש מספר רכיבים, הם ייציירו זה על גבי זה (כמו תיבה). כדי להציב כמה תכנים קומפוזביליים לאורך עקומה, צריך לעטוף כל אחד מהם ב-curvedComposable
.CurdRow ו-CaworColumn – בדומה ל'שורה ועמודה', אפשר להציב את
curvedRow
ואתcurvedColumn
בתוךCurvedLayout
כדי לפרוס את הרכיבים לפי הצורך. עבורcurvedRow
, ניתן לציין את הכיוון של הפריסה הזוויתית והיישור הרדיאלי. עבורcurvedColumn
, אפשר לציין את היישור הזוויתי והכיוון הרדיאלי.CurvedModifier – כל הרכיבים המעוגלים מקבלים פרמטר מגביל שניתן ליצור באמצעות
CurvedModifier
: יש תמיכה ברקע, בגודל, במשקל ובמרווח הפנימי.גם הרכיב הבא נכלל בניווט עם Wear Compose:
התכונה 'CloseableNavHost' מספקת מקום בהיררכיית הכתיבה שבו תתאפשר ניווט עצמאי, באמצעות תנועת החלקה אחורה בזמן הניווט. התוכן מוצג בתוך
SwipeToDismissBox
, ומראה את רמת הניווט הנוכחית. במהלך תנועת החלקה כדי לסגור את התצוגה, רמת הניווט הקודמת (אם קיימת) מוצגת ברקע.לפרטים נוספים על הפריטים שסופקו, אפשר לעיין בנתוני הגרסה הקודמים של גרסאות האלפא השונות.
שינויים ב-API
- נוספו
CurvedModifier.padding*
פונקציות. המחרוזות האלה משמשות כדי לציין רווח נוסף שיש להוסיף סביב רכיב מעוקל. (I4db4) - הוסרה כיתה פנימית אחת (
CompositionLocal
) (I42490) - הוספנו ערכים קבועים לגודל הסמלים
Button
,CompactButton
וToggleButton
, כקו מנחה (I57cab) - צריך להוסיף את הפרמטר שהופעל ל-
AppCard
ול-TitleCard
. עכשיו יש להם API שדומה ל-androidx.compose.material
Cards. כשהפרמטר מוגדר כ-False, לא ניתן ללחוץ על הכרטיס. (Idc48d, b/228869805)
תיקוני באגים
- מערכת Stepper משביתה עכשיו את לחצני ההפחתה וההגדלה כשמגיעים למגבלות התחתון/העליון (ומחיל את ContentAlpha.Disabled על הסמל icon) (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
, בדומה לזה שב'כתיבה'. אפשר להשתמש בו בתווי צאצאים של CurvedRow ו-CurvedLayout (לרוחב) וצאצאים של CurvedColumn (לגובה). (I8abbd) - נוספו ערכי הצירוף
CurvedModifier.size
,.angularSize
ו-.radialSize
כדי לציין את הגודל של רכיב מעוקל. (I623c7)
שינויים ב-API
- שינוי הסדר של הפרמטרים כדי לוודא שהרקע מופיע לפני הצבע באופן עקבי בכל ה-API של Wear Compose (I43208)
- הוסר בכיוון השעון ו- פרמטרים של
insideOut
והוחלפו בקבועים מפורשים יותר במחלקות חדשות. עכשיו הכיוון של פריסה מעוקלת יכול להיות מודע ל-LayoutDirection
, והוא עובר בירושה כשהוא לא מוגדר (If0e6a) - החלפנו את הטקסט
autoCenter: Boolean
בכתובתautoCenter: AutoCentringParams
כדי לפתור בעיה ב-API שלScalingLazyColumn
. (Ia9c90) - שינינו את השם של
iconTintColor
ושלtoggleControlTintColor
ל-iconColor
ול-toggleControlColor
ב-API (Chip/ToggleChip/Dialog/Slider/Stepper/...) כי הצבע חל על משבצת הסמל/toggleControl. (Ied238) - שכתוב
PageIndicatorStyle
enum לסיווג ערך (I2dc72) - הוספנו את
RowScope/ColumnScope/BoxScope
לחלק מהמשבצות במשחקים הקומפוזביליים שלנו כדי לציין למפתחים את ההנחות לפריסות. כך מפתחים יוכלו להשתמש בהתאמות נוספות בחלק מהתכנים של מיקומי המודעות, ולא יהיה צורך לספק רכיבי פריסה נוספים. בנוסף, ביצענו כמה עדכונים קלים בצבעים של AppCard/TitleCard כך שערכי ברירת המחדל שלtimeColor
ו-appColor
הםcontentColor
. עדיין תהיה אפשרות לשנות את כל המאפיינים בנפרד במקרה הצורך. (I26b59) - אובייקט
SwipeToDismissBoxState.Companion
הפך לפרטי (I39e84) - תיקון סדר הפרמטרים עבור
InlineSlider
ו-Stepper
. שינוי פשוט בהתאם להנחיות ה-API (I11fec) - הסרנו את האובייקט Saver של
SwipeToDismissBoxState
כי לא נעשה בו שימוש. (Ifb54e) - עדכנו את
CompactChip
ועכשיו הוא מותאם למפרט החדש של חוויית המשתמש. המרווח הפנימי הופחת לפורמט אופקי = 12.dp ואנכי = 0.dp. הגופן של התווית השתנה מלחצן לכיתוב 1. גודלי הסמלים המומלצים הם 20x20 אם יש סמל וגם תווית, וגודל של 24x24 לצ'יפ קומפקטי של סמל בלבד. בתרחיש לדוגמה בלבד של הסמל, וידאנו גם שהסמל מיושר למרכז. (Iea2be) - הוספנו כמה שדות חדשים ל-
ScalingLazyListLayoutInfo
כדי לאפשר למפתחים לדעת אילוcontentPadding
ו-autoCenteringPadding
הוחלו. הפרמטרים האלה יכולים להיות שימושיים למפתחים בחישוב של הנעה או גלילה (I7577b) - הטמענו מעברים פנימה או החוצה עבור Dialog. נוסף פרמטר
showDialog
, ותיבת הדו-שיח שולטת עכשיו בחשיפה שלה (התכונה הזו מאפשרת לתיבת הדו-שיח להריץ אנימציות פתיחה וסיום כשתיבת הדו-שיח מוצגת או מוסתרת). שימו לב שהאנימציה בסיום לא מתבצעת כשהמשתמש יוצא מתיבת הדו-שיח באמצעות החלקה לסגירה. הוספנו גם ערך ברירת מחדל למצב בעומס היתר שלSwipeToDismissBox
שנוסף לאחרונה. (I682a0) - כדי לספק תמיכה טובה יותר ב-i18n וב-a11y, שינינו את
ToggleChip
ואתSplitToggleChip
כך שכבר לא תהיה בהם ברירת מחדל למשבצתtoggleControl
. שינינו גם אתToggleChipDefaults
כך שהשיטות הבאות יחזירו עכשיו ImageVector במקום סמל (שימו לב שמכיוון שהן כבר לא מחזירות @Composables, הן השתנו כך שיתחילו באותיות קטנות),SwitchIcon()->switchIcon()
,CheckboxIcon->checkboxIcon()
ו-RadioIcon()->radioIcon()
. זה מאפשר ומעודד מפתחים ליצור תכנים קומפוזביליים משלהם ב-Icon()
עם קבוצתcontentDescription
מתאימה. (I5bb5b) - הוספנו את הפרמטר
SwipeDismissableNavHostState
לפרמטרSwipeDismissableNavHost
. התכונה הזו תומכת בשימוש בהחלקה מהקצה במסכים שמשמשים כיעדי ניווט, כי עכשיו אפשר להעלות אתSwipeToDismissBoxState
ולהשתמש בו כדי לאתחל גם אתSwipeDismissableNavHostState
וגם אתModifier.edgeSwipeToDismiss
במסכים שנדרשת בהם החלקה מהקצה. (I819f5, b/228336555)
תיקוני באגים
- מוודאים שפריסות המעוגלות מעודכנות במקרה הצורך. (Ie8bfa, b/229079150)
- תיקון באג ב-https://issuetracker.google.com/issues/226648931 (Ia0a0a, b/226648931)
- הוסרו הערות ניסיוניות מיותרות (I88d7e)
גרסה 1.0.0-alpha20
6 באפריל 2022
androidx.wear.compose:compose-foundation:1.0.0-alpha20
, androidx.wear.compose:compose-material:1.0.0-alpha20
ו-androidx.wear.compose:compose-navigation:1.0.0-alpha20
שוחררו. גרסה 1.0.0-alpha20 מכילה את התחייבויות אלה.
תכונות חדשות
- הוספת מגביל
edgeSwipeToDismiss
בשדהSwipeToDismiss
. המדיניותswipeToDismiss
יכולה להיות פעילה רק בקצה השמאלי של אזור התצוגה. משמש כשמרכז המסך צריך להיות מסוגל לעבור בין דפים אופקיים, כמו גלילה דו-ממדית במפה או החלקה אופקית בין דפים.(I3fcec, b/200699800)
שינויים ב-API
- יישום בסיסי של
CurvedModifiers
, מאפשר להוסיף דרכים להתאמה אישית של תוכן מפותל (אבל עדיין לא סופקוCurvedModifiers
, ויכול להיות שתהיה אפשרות ליצור תכונות שינוי בהתאמה אישית בהמשך) (I9b8df) EdgeSwipe
מסמכי תיעוד המשנים וערכי ברירת המחדל מתעדכנים לצורך הבנה טובה יותר .(I6d00d)- מוסיפים חריץ אחד (
PageIndicator
) ל-Saffold. הוספה שלPageIndicator
ישירות ל-Saffold עשויה להבטיח שהוא יוצג כראוי במכשירים עגולים. (Ia6042) - מסירים את סמלי ברירת המחדל מהפרמטרים
InlineSlider
ו-Stepper. כך המפתחים יוכלו להיות קשובים יותר לדרישות ההתאמה לשוק המקומי ולנגישות. השימושים בסמלי ברירת המחדל הוצגו בהדגמות ובדוגמאות. (I7e6fd) - מחליפים את שמות הפרמטרים של 'טריילר' ו'מובילים' ב'התחלה' וב'סיום' ב-TimeText (Iaac32)
- הוספנו עומס יתר של
SwipeToDismissBox
עם פרמטרonDismissed
כדי לתמוך בשימוש נפוץ בהפעלת אירוע ניווט לאחר שתנועת ההחלקה מסתיימת. (I50353, b/226565726) - הוסרו
ExperimentalWearMaterialApi
הערות מהשימוש ב-TimeText
(Ide520) - סימנו את ממשקי ההיקף והמידע של
ScalingLazyList/Column
כחסומים, כי הם לא מיועדים למפתחים חיצוניים להטמעה, וכך נוכל להוסיף אליהם חברים חדשים בעתיד ללא שינויים בכשלים בינאריים. (I7d99f) - הוספנו נכס
flingBehaviour
חדש לבורר ושיטתPickerDefaults.flingBehaviour()
כדי להפעיל את ההגדרה של התנהגות ההטיה, כמו הוספת תמיכה ב-RSB.PickerState
מטמיע את הממשקScrollableState
. (Ib89c7)
תיקוני באגים
- עדכון כללי הפרופיל הבסיסיים של Android Runtime (ART) בספריות Wear Compose. מערכת ART יכולה להשתמש בכללי הפרופיל במכשירים כדי ליצור מראש קבוצת משנה ספציפית של אפליקציה ולשפר את הביצועים שלה. הערה: לא תהיה לכך השפעה על אפליקציות שניתנות לניפוי באגים. (Iaa8ef)
- שיפור מסמכי התיעוד (I2c051)
גרסה 1.0.0-alpha19
23 במרץ, 2022
androidx.wear.compose:compose-foundation:1.0.0-alpha19
, androidx.wear.compose:compose-material:1.0.0-alpha19
ו-androidx.wear.compose:compose-navigation:1.0.0-alpha19
שוחררו. גרסה 1.0.0-alpha19 מכילה את התחייבויות אלה.
שינויים ב-API
- השם של
CurvedRow
שונה ל-CurvedLayout
. הוא הוחל מחדש להיקף עם DSL. באמצעות ה-DSL הזה, ניתן לציין פריסות עקומות מורכבות יותר באמצעות סדרה שלcurvedRow
ו-curvedColumn
מקוננים (שהם המקבילות לפריסה מעוקלת של 'שורה' ו'עמודה'). בתוך רכיבי הפריסה האלה, אפשר להשתמש בשלושה רכיבים:curvedComposable
(כדי להוסיף כל רכיב @Composable),basicCurvedText
(הטקסט המעוקל של הבסיס) ו-curvedText
(ללבוש טקסט מעוקל תוך התמקדות בתוכן). (Ib776a) - מגדירים את הצד של
PositionIndicator
. עכשיו ניתן להגדיר את המיקום של מחוון המיקום הבסיסי בתור 'קצה' (מכוון לכיוון הפריסה), OppositeRsb (מביא בחשבון סיבוב מסך, כדי למקם את עצמו מול ה-RSB הפיזי) או כערכים המוחלטים משמאל ו- בסדר. (I2f1f3) - עבור
SwipeToDismissBox
שינינו את השם שלSwipeDismissTarget
.המקורית ל-SwipeToDismissValue.Default
ול-SwipeDismissTarget.Dismissal
ל-SwipeToDismissValue.Dismissed
. בנוסף, העברנו את ההגדרות שלSwipeToDismissBoxDefaults.BackgroundKey
ו-SwipeToDismissBoxDefaults.ContentKey
אלSwipeToDismissKeys.Background
,SwipeToDismissKeys.Content
בהתאמה. (I47a36) - הוספנו ל-Selecter מצב קריאה-בלבד, למסכים עם מספר משתמשים שבו ניתן לערוך רק בורר אחד בכל פעם. כשהבוחר מוגדר לקריאה בלבד, מוצגת האפשרות הנוכחית שנבחרה, ותווית אם ניתנה. (I879de)
- בוצע ארגון מחדש של
SwipeToDismissBoxState
כדי להגביל את ההיקף שלExperimentalWearMaterialApi
ל-Modifier.swipeable
ו-SwipeableState
, שנמצאים עכשיו בשימוש פנימי. ל-SwipeToDismissBoxState
יש עכשיו חברים ב-currentValue
, ב-targetValue
, ב-isAnimationRunning
וב-snapTo
לתמיכה בתרחישים נפוצים. אפשר לפנות אלינו אם יש לך צורך בנכסים נוספים. תוקנה גם ההתנהגות שלSwipeableState
במקרה שבו היסט ההחלקה נמצא בתוך שגיאת עיגול של עוגן. (I58302)
תיקוני באגים
- קוד פשוט וקבוע לזיהוי אם ניתן לגלול את התוכן של
ScalingLazyColumn
(משמש להחלטה אם להציג סרגל גלילה או לא) (I7bce0) - תוקן באג במדד המיקום כשמשתמשים בכמה מצבים ומחליפים ביניהם (I320b5)
- עדכנו את הטיפוגרפיה/הגופנים של העיצוב המוגדר כברירת מחדל ב-Wear OS ל-Wear OS כך שיתאימו להנחיות האחרונות בנושא חוויית המשתמש. לתשומת ליבכם: display1 (40.sp) ו-display2 (34.sp) קטנים עכשיו מהערכים הקודמים, וביצענו כמה עדכונים קטנים נוספים בגובה השורה ובריווח השורות. (Ie3077)
- הוספנו התנגדות ל
SwipeToDismissBox
כך שתנועה תתרחש רק כשהחלקה כדי לסגור, ולא בכלל בכיוון ההפוך. (Ifdfb9) - שינינו כמה מערכי הפרמטרים שמוגדרים כברירת מחדל לפונקציות
CircularProgressIndicator
כדי להתאים אותן להנחיות חוויית המשתמש של Wear Material Design. עבור גרסת Spinner/Indeterminant, עודכנו הגודל (40->24.dp), צבע המחולק (primary->onBackground), שקיפות צבעי מעקב (30%->10%) ורוחב הקווים (4->3dp) עודכנו. עבור גרסת 'התקדמות/קבוע', השקיפות TrackColor (30%->10%) עודכנה. (I659cc) - עדכנו את הפרמטרים של ברירת המחדל להתאמה לעומס (scaling) של
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
- מספר שיפורים במחוון המיקום: הצגת תוצאה שינה את השם של PositionIndicatorVisibility. שיפורי ביצועים מסוימים כדי למנוע חישובים מחדש במקרה הצורך (Iaed9d)
- הצבע המומלץ עבור
SplitToggleChip
עודכן. עכשיו יש ל-SplitToggleChip רקע בצבע אחיד כשהוא מסומן או לא מסומן, וצבוע של SwitchControl הוא האינדיקציה העיקרית לכך שהרכיב מסומן או לא. הוספנוToggleDefaults.splitToggleChipColors()
חדש כדי לתמוך בערכת הצבעים החדשה. בנוסף, הפכנו את השיטות שלtoggleChipColors()
לפשוטות יותר תוך הסרת ה-SplitBackgroundOverlayColor (I7e66e) - הוספנו את הערך uncustomedSize ל-
ScalingLazyListItemInfo
כי לא בטוח לחשב את גודל הפריט המקורי באמצעות הגודל המותאם אישית וגורם קנה המידה בגלל רמת דיוק מתמטית של מספר ממשי (float). (I54657, b/221079441) - הוספה של
HorizontalPageIndicator
. הוא מייצג את המספר הכולל של הדפים ואת הדף שנבחר. המכשיר עשוי להיות לינארי או מעוקל, בהתאם לצורת המכשיר. הוא תומך גם בצורה מותאמת אישית של אינדיקטור, שמגדיר איך כל אינדיקטור מיוצג באופן חזותי. (Iac898) - עדכנו את
PickerState
כך שניתן יהיה לעדכן את numberOfOptions. האפשרות הזו תומכת בתרחישים לדוגמה כמוDatePicker
, שבו מספר הימים בחודש משתנה בהתאם לחודש שנבחר. פרמטר ה-constructor של PickerState השתנה ל-InitialNumberOfOptions בהתאם. (Iad066) - הסתרת
PositionIndicator
כשמוצג סרגל גלילה ואי אפשר לגלול. (Id0a7f) - כדי לשמור על עקביות עם Scaffold, ברכיב של תיבת הדו-שיח במסך מלא מוצגים עכשיו
PositionIndicator
ו-Vignette
. אנחנו גם משתמשים עכשיו ב-ScalingLazyColumn
במקום ב-Column
, כלומר התוכן של תיבת הדו-שיח נמצא עכשיו ב-ScalingLazyListScope
(ובדרך כלל צריך להיות מוקף בפריט { /* content */ }). תיבת הדו-שיח תומכת בפרמטר אנכית Arrangement בהתאם. (Idea13) - שינינו את השם של מאפיין gtagIcon
ToggleChip
ו-SplitToggleChip
כדי להפעיל או להשבית את הבקרה כדי להתאים אותה טוב יותר ל-Material Design כדי לעזור למעצבים ולמפתחים לנווט ב-API. (If5921, b/220129803) - הוספנו ערך חדש לכיתוב 3 ל-Wear Material Theme Typology.Caption3 הוא גופן קטן המשמש לכתיבה ארוכה במיוחד, כמו טקסטים משפטיים. (I74b13, b/220128356)
תיקוני באגים
- תפסיקו את האנימציה המצולמת כשאנחנו מגיעים לשם. (Idb69d)
- הצגת שינויים במחוון המיקום. (I94cb9)
- על סמך משוב לגבי ממשק המשתמש או חוויית המשתמש, שינינו את המרכז האוטומטי של
ScalingLazyColumn
כך שהוא יספק רק מספיק מקום כדי להבטיח שתהיה אפשרות לגלול באופן מלא את הפריטים עם האינדקסScalingLazyListState.initialCenterItemIndex
ומעלה למרכז אזור התצוגה. כך מפתחים יכולים למקם במרכז פריט אחד או שניים לגבי הפריט, שלא ניתן לגלול באמצע. פירוש הדבר הוא ש-ScalingLazyColumn
של מרכז אוטומטי לא יוכל לגלול מעלinitialCenterItemIndex/initialCenterItemScrollOffset
(I22ee2) - הוספנו הדגמה של הכלי לבחירת תאריכים ותקנו באג ב-
PickerState
, שבו האפשרות הראשונית [נבחרה] לא הוחלה עד שהבורר הוצג. (Id0d7e) - כדי לצמצם את החיתוך של פריטי
ScalingLazyColumn
רחבים יותר במסכים עגולים, הגדלנו את המרווח הפנימי המוגדר כברירת מחדל לתוכן אופקי מ-8 ל-10dp. (I0d609) - מוודאים שה-
PositionIndicator
מוצג בזמן הגלילה. (Ied9a2)
גרסה 1.0.0-alpha17
23 בפברואר 2022
androidx.wear.compose:compose-foundation:1.0.0-alpha17
, androidx.wear.compose:compose-material:1.0.0-alpha17
ו-androidx.wear.compose:compose-navigation:1.0.0-alpha17
שוחררו. גרסה 1.0.0-alpha17 מכילה את התחייבויות אלה.
תכונות חדשות
- הוספנו תמיכה ב-Snap שניתן להשתמש בה עם
ScalingLazyColumn
. יש להגדיר אתflingBehavior = ScalingLazyColumnDefaults.flingWithSnapBehavior(state)
כדי להפעיל תמיכה בהצמדה. (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)
תיקוני באגים
- שינינו את ברירת המחדל של startCenterItemIndex עבור
ScalingLazyListState
מ-0->1. כלומר, אלא אם מבטלים את השינוי בבניית המדינה באמצעותScalingLazyListState.rememberScalingLazyListState(initialCenterItemIndex =
)
, הפריט השני ברשימה (index == 1) ימוקם במרכז אזור התצוגה בזמן האתחול והפריט הראשון (index == 0) ימוקם לפניו. כך ניתן ליצור אפקט חזותי טוב יותר שמוגדר כברירת מחדל מחוץ לתיבה, כי רוב אזור התצוגה יהיה מלא בפריטים ברשימה. (I0c623, b/217344252) - הורדנו את ערך ברירת המחדל של
ScalingLazyColumn
מסוגextraPadding
שנקבע כדי להבטיח שיש מספיק פריטים ברשימה לצייר (גם אם נקטין חלק מהם בגודלם) מ-10% ל-5%. פעולה זו תימנע מכתיבת פריטים נוספים ברשימה שייתכן שלא יופיעו באזור התצוגה. אם נעשה שימוש ב-scalingParams לא סטנדרטי (למשל, התאמה לעומס (scaling) בצורה קיצונית יותר), המפתח יכול להתאים מרווח פנימי נוסף באמצעותviewportVerticalOffsetResolver
. (I76be4) - פתרון בעיה שקשורה ל-TimeText במספר שורות במכשיר ריבועי (Ibd3fb)
- שינינו את
ScalingLazyColumn
כך שהוא כבר לא ימלא את כל השטח בהורה שלו בחמדנות. במקום זאת, הקובץ יקבל את הגודל בהתאם לגודל התוכן שבו. לכן הוא תואם להתנהגות שלLazyColumn
. אם ברצונך להחזיר את ההתנהגות הקודמת, יש להעביר אתModifier.fillMaxSize()
אלScalingLazyColumn
. הערה: השינוי הזה לא הושלם והוא יטופל בשינוי מעקב בגרסת האלפא הבאה. (I3cbfa)
גרסה 1.0.0-alpha15
26 בינואר, 2022
androidx.wear.compose:compose-foundation:1.0.0-alpha15
, androidx.wear.compose:compose-material:1.0.0-alpha15
ו-androidx.wear.compose:compose-navigation:1.0.0-alpha15
שוחררו. גרסה 1.0.0-alpha15 מכילה את התחייבויות אלה.
שינויים ב-API
- הוספנו נכס חדש
autoCentering
ל-ScalingLazyColumn
. אם הערך הוא True (ברירת המחדל), ניתן יהיה לגלול את כל הפריטים, כולל הפריט הראשון והאחרון, כך שיהיו גלויים במרכז של אזור התצוגה של הרשימות. הערה: אם משתמשים במרכוז אוטומטי, מומלץ להגדיר מרווח פנימי של תוכן אנכי ל-0.dp. אם תספקו גם מרכוז אוטומטי וגם מרווח פנימי של תוכן, שניהם יגרמו לשטח נוסף פנוי לפני הפריט הראשון ואחרי הפריט האחרון ברשימה, מה שיאפשר גלילה נוספת. (I2a282, b/214922490) - הוספנו רכיב
Dialog
שמאפשר לכל תוכן קומפוזבילי להפעיל תיבת דו-שיח במסך מלא שנמצאת מעל תוכן אחר. כשמוצגת, תיבת הדו-שיח תומכת בהחלקה לסגירה, ומציגה את התוכן של ההורה שלה ברקע במהלך תנועת ההחלקה. התוכן של תיבת הדו-שיח צריך להיותAlert
אוConfirmation
(שינוי השם מהרכיבים המוקדמים יותרAlertDialog
ו-ConfirmationDialog
) –Alert
,Confirmation
ו-Dialog
נמצאים כולם בחבילהandroidx.wear.compose.material.dialog
. אפשר להשתמש בהתראה ובאישור כיעדי ניווט. כמו כן, הוספנו את ColumnScope לפרמטרים של Alert (התראה) ו-Confirm (אישור) לפי הצורך. (Ia9014) - הסרנו את
onSurfaceVariant2
מהגדרות ה-Compose for Material Designs ל-WearOS והחלפנו את השימושים בספרייה ב-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)הוספנו handler של לחצן 'הקודם' ל-
SwipeDismissableNavHost
, כך שלחיצה על 'חזרה' תעביר אתכם לרמה הקודמת בהיררכיית הניווט. (I5b086, b/210205624)
גרסה 1.0.0-alpha13
15 בדצמבר 2021
androidx.wear.compose:compose-foundation:1.0.0-alpha13
, androidx.wear.compose:compose-material:1.0.0-alpha13
ו-androidx.wear.compose:compose-navigation:1.0.0-alpha13
שוחררו. גרסה 1.0.0-alpha13 מכילה את התחייבויות אלה.
שינויים ב-API
- הפכנו את
RangeIcons
להגדרה פנימית (הפניה פנימית על ידיInlineSlider
ועלStepper
). (I927ec)
תיקוני באגים
תוקנה בעיה שגרמה להוספה של יעד להיררכיית הכתיבה על ידי
SwipeDismissableNavHost
לפני שהיא הגיעה למצבCREATED
של מחזור החיים, וכתוצאה מכך התקבלIllegalStateException
. התיקון הזה היה דרישה מוקדמת לעדכון התלות ב-navigation-compose
ל-2.4.0-beta02
והלאה. (I40a2b, b/207328687)נוספה מחלקה מסוג 'טיפוסים בני מנייה (enum)' לצורך קבלת משאבים שניתן להזזה בספרייה של Wear Compose, כך שאין יותר צורך בחשיבה. תיקון באג שגרם להסרה של פריטים ניתנים להזזה של ספרייה כאשר
minifyEnabled=true
אוshrinkResources=true
הוסרו. (Ib2a98)נוספו בדיקות של
Stepper
ב-Wear Compose (I2d03a)נוספו דוגמאות של
SwipeDismissableNavHost
בניווט עם Wear Compose. (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 שמאפשר למשתמשים לבחור מתוך מגוון ערכים. Stepper היא שליטה במסך מלא עם לחצני הגדלה והקטנה בחלק העליון והתחתון, וגם חריץ באמצע (צפוי לקבל צ'יפ או טקסט). אפשר להתאים אישית את סמלי הלחצנים לפי הצורך. (I625fe)
הוספנו 2 תכנים קומפוזביליים חדשים להצגת תיבות דו-שיח: AlertDialog מחכה לתשובה מהמשתמש ומציג כותרת, סמל, הודעה וגם א) שני לחצנים לבחירות פשוטות או שליליות, או ב) צ'יפים שהוערמו אנכית או צ'יפים של החלפת מצב לאפשרויות גמישות יותר, CertificateDialog מציגה אישור עם זמן קצוב לתפוגה. תיבת הדו-שיח הפשוטה הזו כוללת חריצים לכותרת ולסמל (מונפש). (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 ומספר מתאמים חדשים למילויParentMaxSize/fillParentMaxwidth/fillParentMax לרוב כדי לאפשר התאמה של גודל פריטים ברשימה לפי הגודל של מאגר ההורה. אפשר להגדיר פריטים כך שימלאו את כל הגודל של תבנית ההורה או חלק ממנה. הפעולה הזו חושפת פונקציונליות שכבר זמינה ב-LazyRow/Column (I4612f)
- נוספה תמיכה ב-ScalingLazyColumn כדי לאפשר לפריטים לקבל מפתח. כמו כן, הוספנו שיטות נוחות כדי לאפשר הוספת פריטים ממערך ומרשימות. (Ic1f89)
תיקוני באגים
- דוגמאות נוספות ל-TimeText (I8cb64)
גרסה 1.0.0-alpha10
3 בנובמבר 2021
androidx.wear.compose:compose-foundation:1.0.0-alpha10
, androidx.wear.compose:compose-material:1.0.0-alpha10
ו-androidx.wear.compose:compose-navigation:1.0.0-alpha10
שוחררו. גרסה 1.0.0-alpha10 מכילה את התחייבויות אלה.
תכונות חדשות
נוסף InlineSlider לכתיבה ב-Wear. התכונה InlineSlider מאפשרת למשתמשים לבחור מתוך מגוון ערכים. טווח הבחירה מוצג כעמודה בין ערכי המינימום והמקסימום של הטווח, מתוכו משתמשים יכולים לבחור ערך יחיד. (If0148)
כדאי לנסות את תכונת הכתיבה החדשה של WearOS Codelab!
שינויים ב-API
- ערך מאקרובנצ'מרק הוא עכשיו
minSdkVersion
של23
. (If2655)
תיקוני באגים
- עדכון הטיפול במעבר ב: להחליקDismissableNavHost באפקט לוואי (I04994, b/202863359)
- עדכון הטיפול במעבר ב: SlidesableNavHost (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 מכילה את התחייבויות אלה.
תכונות חדשות
- השקנו את התצוגה המקדימה למפתחים של 'כתיבה' ב-Wear OS. כדאי לעיין בפוסט בבלוג שלנו שבו נפרט את התכנים הקומפוזביליים העיקריים ואת הקישורים למקורות מידע נוספים שיעזרו לכם להתחיל להשתמש בהם.
שינויים ב-API
- הוספנו תמיכה למפתחים כדי לאפשר להם להתאים אישית את כל הצבעים בעיצוב החדש של Wear Material Design. (I4759b, b/199754668)
תיקוני באגים
- נוספו דוגמאות של WAPToDismissBox שנשארות במצב קבוע (Ibaffe)
- נוספו קישורים למדריכים בכתובת developer.android.com מ-KDocs ל-CurvedText, TimeText ו להחליקToDismissBox. (I399d4)
- אם אין יעד נוכחי, ההגדרה ScrollableNavHost תושפע עכשיו אם אין יעד נוכחי (מציין זאת Nav Graph לא נבנה באמצעות wear.compose.navigation.composable Utility function) (I91403)
- נוספו מסמכים ודוגמאות נוספים לשימוש במקור זמן ב-TimeText (I4f6f0)
גרסה 1.0.0-alpha08
13 באוקטובר 2021
androidx.wear.compose:compose-foundation:1.0.0-alpha08
, androidx.wear.compose:compose-material:1.0.0-alpha08
ו-androidx.wear.compose:compose-navigation:1.0.0-alpha08
שוחררו. גרסה 1.0.0-alpha08 מכילה את התחייבויות אלה.
שינויים ב-API
- שינינו את השם של נכסי AppCard ו-TitleCard
body
ל-content
והעברנו אותם לסוף רשימת הנכסים כדי לאפשר להם להיות מסומנים כ-lambda בסוף. שינינו גם את השם שלbodyColor
לשםcontentColor
כדי לשמור על עקביות עם השמות החדשים של מיקומי המודעות. (I57e78)
תיקוני באגים
- קישורים נוספו אל developer.android.com מדריכים מ-KDocs עבור לחצן, כרטיס, צ'יפ, עיצוב, מחוון מיקום והתאמה לעומס (scaling) של רכיבי עמודה. (I22428)
- פתרון בעיות שקשורות ל-WearOS TapToDismissBox שלפעמים לא מטפלת בהחלקות. (I9387e)
- נוספו דוגמאות עבור 'לחצן', 'לחצן קומפקטי', Chip, CompactChip, AppCard, TitleCard, לחצן החלפת מצב, SwitchChip, SplitToggleChip (Iddc15)
- נוספו בדיקות ביצועים של מיקרו-בנצ'מרק עבור כרטיס, צ'יפ, החלפת צ'יפ, 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)
- הופכים את ArcPatingValues לממשק. (Iecd4c)
- נוספה אנימציה ל-SlideToDismissBox (I9ad1b)
- נוסף הפרמטר hasBackground ל-SlideToDismissBox כדי שאפשר יהיה להשבית את תנועת ההחלקה אין תוכן רקע להצגה. (I313d8)
rememberNavController()
הוא עכשיו אופציונלי קבוצה שלNavigator
מופעים שיתווספו אל הוחזרוNavController
לתמיכה טובה יותר אופציונלית מכשירי ניווט כמו אלה חומר ניווט למלווה. (I4619e)- הפניה בשם NamedNavArgument מאת ניווט נפוץ והסרת עותק מ- wear.compose.navigation. (I43af6)
תיקוני באגים
- תוקנה רמת הרגישות של הבדיקה של CurvedRow במכשירים קטנים יותר. (If7941)
- תיקנו הבהובים אפשריים ב-CurvedRow כשהתוכן מתעדכן, ומבטיח שהשורה המעוגלת תימדד מחדש (Ie4e06).
- ChipDefaults.לשחזרBackgroundChipColors() עודכן בהתאם לשינויים במפרטי חוויית המשתמש. ההדרגתיות מתחילה עכשיו ב-MaterialTheme.colors.primary באלפא 32.5% ומסתיימת ב-MaterialTheme.colors.surface עם alpha @ 0% על רקע של MaterialTheme.colors.surface ב-75% alpha. (Id1548)
- עדכנו את הצבעים של BluetoothChip במצב שנבחר, כך שיתאימו להנחיות העדכניות של מפרטי חוויית המשתמש ב-Wear Material Design. לאחר הבחירה באפשרות SwitchChips, יש עכשיו רקע הדרגתי מ-MaterialTheme.color.surface @ 0% alpha, בפינה השמאלית העליונה עד MaterialTheme.color.primary @ 32% alpha, ימין למטה, על רקע של MaterialTheme.color.surface ב-75% alpha. התוצאה היא הבדל עדין יותר בין מצב מסומן לבין לא מסומן עבור מתג החלפת המצב. (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 של אפליקציה קומפוזבילית ברמה העליונה שמספקת מבנה לטיפול במיקום מדדי מיקום (כמו גלילה או נפח), אזור בחלק העליון של המסך להצגת השעה וסטטוס האפליקציה, וגם תומכת בדהייה בשוליים לטשטוש הקצה העליון והתחתון של המסך לתוכן שניתן לגלול. האזור הראשי של ה-Saffold הוא המקום שבו מוצבים התוכן של האפליקציה. (I5e0bf)
- נוספה הטמעת TimeText של Wear Compose (I5654c)
ספריית הניווט של Wear Compose
הוספנו את הגרסה הראשונה של ספריית הניווט ל-Wear Compose, שמספקת שילוב בין ספריות הניווט של Wear Compose ושל Androidx. זהו אמצעי פשוט לניווט בין פונקציות @Composable כיעדים באפליקציה.
הגרסה הראשונית הזו מספקת:
- תוכן קומפוזבילי עם
SwipeDismissableNavHost
שמארח תרשים ניווט ומספק ניווט אחורה באמצעות תנועות החלקה - התוסף
NavGraphBuilder.composable
שעוזר לבנות תרשימי ניווט rememberSwipeDismissableNavController()
כדי לאפשר מצב העלאה
- תוכן קומפוזבילי עם
שימוש לדוגמה שבו אנחנו יוצרים שני מסכים ומנווטים ביניהם:
val navController = rememberSwipeDismissableNavController() SwipeDismissableNavHost( navController = navController, startDestination = "start" ) { composable("start") { Column( horizontalAlignment = Alignment.CenterHorizontally, verticalArrangement = Arrangement.Center, modifier = Modifier.fillMaxSize(), ) { Button(onClick = { navController.navigate("next") }) { Text("Go") } } } composable("next") { Column( horizontalAlignment = Alignment.CenterHorizontally, verticalArrangement = Arrangement.Center, modifier = Modifier.fillMaxSize(), ) { Text("Swipe to go back") } } }
הניווט ב-Wear Compose נארז כספרייה נפרדת, כך שאפליקציות פשוטות ל-WearCompose שמטמיעות שיטת ניווט משלהן באופן ידני לא נדרשות להיות תלויות בספריית הניווט של Androidx.
שינויים ב-API
SwipeDismissableNavHost
עודכן לתמיכהrememberSaveable
על ידי הגדרה של זהות המפתח לרקע ולתוכן (I746fd)- הוספנו מתאם PositionIndicator שיכול לטפל ב-LazyListState (I21b88)
- עודכן ב-SlideToDismissBox כדי לתמוך בשמירת נתונים (Ie728b)
- הוספנו ל-ScalingLazyColumn תמיכה בפריסה הפוכה. הפעולה הזו מאפשרת את ההיפוך של כיוון הגלילה והפריסה (I9e2fc)
- הוצאו משימוש
performGesture
ו-GestureScope
, שכוללים הוחלף על ידיperformTouchInput
ו-TouchInjectionScope
. (Ia5f3f, b/190493367) - שינינו את השם של VignetteValue ל-VgnettePosition ושינינו את השם של VignetteValue.Both ל-VgnettePosition.TopAndBottom. (I57ad7)
- שינינו את השם של ScalingLazyColumnState ל-ScalingLazyListState, ScalingLazyColumnItemInfo ל-ScalingLazyListItemInfo, ScalingLazyColumnLayoutInfo ל-ScalingLazyListLayoutInfo וב-ScalingLazyScope ל-ScalingLazyListScope במקרה שנחליט להוסיף את ההטמעה העתידית ScalingLazyListItemInfo. (I22734)
תיקוני באגים
- תיעוד של CompactChip עודכן כדי לתאר מה קורה אם לא סופקו סמל או תווית. (I4ba88)
- ביצענו כמה שינויים ברכיבים של כרטיס Wear. (I6b3d0)
- הריווח בין כותר לגוף הוקטן מ-8.dp ל-2.dp.
- גופן הכותרת של כרטיס הכותרת השתנה מגוף לכותרת 3.
- הדרגתיות של רקע הכרטיס השתנתה כדי לגרום לרקע להיראות כהה יותר.
גרסה 1.0.0-alpha05
1 בספטמבר 2021
androidx.wear.compose:compose-foundation:1.0.0-alpha05
ו-androidx.wear.compose:compose-material:1.0.0-alpha05
שוחררו. גרסה 1.0.0-alpha05 מכילה את התחייבויות אלה.
שינויים ב-API
- סימון ArcPRevenueValues כ- @Stable (I57deb)
- ב-ScalingLazyColumnState מוטמע עכשיו הממשק ScrollableState שמאפשר למפתחים גישה פרוגרמטית לגלילה של הרכיב. (I47dbc)
תיקוני באגים
- הקטנו את הריווח בין Icon ל-Text in Chip ו-SwitchChip כדי להתאים אותם לעדכונים במפרט חוויית המשתמש. (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 מכילה את התחייבויות אלה.
תכונות חדשות
- נוספה מקש TalkBackToDismissBox ומקש החלקה שניתן להשתמש בו כדי לתמוך בתנועת החלקה משמאל לימין לסגירה. למרות שהוא לא תלוי ברכיבי ניווט, הרשאה זו צפויה לשמש כדי לצאת ממסך אחד ולנווט למסך אחר. תאריך ההוספה בדיקות שילוב כדי להראות הדגמה של החלקה לסגירה. (I7baa)
- הוספנו את הממשקים ScalingLazyColumnItemInfo ו-ScalingLazyColumnLayoutInfo למחלקה ScalingLazyColumnState כדי לאפשר למפתחים לדעת את המיקומים והגדלים בפועל של הפריטים ב-ScalingLazyColumn לאחר החלת ההתאמה. בנוסף, תיקנו באג באופן שבו חושב ההתאמה לעומס (scaling) כאשר מרווח פנימי של תוכן מוחל על ScalingLazyColumn. (I27c07)
שינויים ב-API
- הוספת מחלקה של CurvedTextStyle כדי לציין עיצוב טקסט מעוקל אפשרויות. דומה ל-TextStyle, אבל תומך עכשיו רק בצבע, ב-fontSize וברקע. בעתיד נוסיף עוד אפשרויות עיצוב. (I96ac3)
- הוספנו את הממשקים ScalingLazyColumnItemInfo ו-ScalingLazyColumnLayoutInfo למחלקה ScalingLazyColumnState כדי לאפשר למפתחים לדעת את המיקומים והגדלים בפועל של הפריטים ב-ScalingLazyColumn לאחר החלת ההתאמה. בנוסף, תיקנו באג באופן שבו חושב ההתאמה לעומס (scaling) כאשר מרווח פנימי של תוכן מוחל על ScalingLazyColumn. (I27c07)
- הוספת את
@ExperimentalWearMaterialApi
ל-enumSwipeDismissTarget
, חלק מ-API שלSwipeToDismissBox
. (I48b5e)
תיקוני באגים
- נוסף חומר בדיקה ל-SlideToDismissBox (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 שמספק תצוגה בסגנון 'עין הדג', עם הקטנת גודל התוכן ברשימה והופכת לשקיפות בהתאם לקנה המידה הרצוי לקצה הרכיב. (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)
- נוספו סמלי מתג (תיבת סימון, מתג ולחצני בחירה) ל-TurnChipDefaults כדי להקל על המפתחים להגדיר את SwitchChip ואת SplitToggleChips (I7b639)
- המרווח הפנימי של תוכן ההתחלה והסיום של הצ'יפים עודכן כך שהוא נשאר בעקביות 14.dp, גם אם לצ'יפ יש סמל וגם אם לא (בעבר היה 12.dp אם קיים סמל, ו-14.dp אם לא) (I34c86)
תיקוני באגים
- הוספת בדיקות של CurvedRow (I93cdb)
- קשירת יחסי התלות של Wear Compose ל-Compose 1.0.0-rc01. (Ie6bc9)
- שינינו את השיטה של ציור תמונות רקע בכרטיסים ובצ'יפים, כך שהתמונה נחתכה ולא נמתחת כדי לשמור על הפרופורציות של התמונה. (I29b41)
- נוספו עוד הדגמות ובדיקות שילוב עבור 'לחצן' ו'לחצן החלפת מצב'. (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 הוא ספרייה מבוססת-Kotlin שמבוססת על פיתוח ותומכת ב-Wear Material Design, תוסף של Material Design לגאדג'טים לבישים של WearOS. גרסת האלפא הראשונה הזו כוללת הטמעות פונקציונליות מוקדמות של הרכיבים הבאים:
- עיצוב חומר - מגדיר את הצבעים, הטיפוגרפיה והצורות באופן עקבי בכל הרכיבים שבהם נעשה שימוש מהספרייה הזו.
- צ'יפ, CompactChip – צ'יפים הם בצורת אצטדיון ואפשר למצוא וריאציות שלהם ולהוסיף תוכן של סמלים, תוויות ותוויות משניות.
- - מתג החלפת מצב החלפת מצב, SplitToggleChip - סוג מיוחד של צ'יפ שכולל חריץ לסמל מתג דו-מצבי, כמו לחצן בחירה או תיבת סימון. בנוסף, SplitToggleChip כולל שני אזורים שאפשר להקיש עליהם, אחד שאפשר ללחוץ עליו והשני אפשר להחלפה.
- לחצן, לחצן קומפקטי – הלחצנים הם עגולים, עם חריץ תוכן יחיד לסמל או עם טקסט מינימלי (3 תווים לכל היותר).
- לחצן החלפת מצב – לחצן להפעלה או להשבתה של פעולה, עם חריץ יחיד לסמל או עם טקסט מינימלי (3 תווים לכל היותר).
- כרטיס, AppCard – בצורת מלבן עם פינות מעוגלות, עם משבצות לתוכן כמו סמל האפליקציה, השעה, השם וגוף האפליקציה.
בגרסאות עתידיות תתבצע הרחבה של קבוצת הווידג'טים, והיא תתמוך בבוררים, במחוונים, ברשימות, באינדיקטורים של דפים, בתיבות דו-שיח, באינדיקטורים של גלילה אוטומטית, בתצוגה מקדימה ובפריטים נוספים.
כמו כן, תהיה תמיכה בתכונות נוספות שמיועדות ללבישים, כמו פריסות וטקסט עקומים, וגם פיגועים שיאפשרו למפתחים ליצור בקלות אפליקציות או שכבות-על לבישות.
Material Compose (חומר) של Wear Compose (חומר) מעוצב לפי אותם עקרונות של Compose Material, למרות שהוא מתמקדת בגאדג'טים לבישים. כשמפתחים מכשירים לבישים, צריך להשתמש בספרייה 'חומרי לימוד מ-Wear Compose' במקום הספרייה 'יצירת חומרי לימוד'.
שתי הספריות 'חומר' צריכות להיחשב כבלעדיות באופן הדדי ואין לשלב אותן באותה האפליקציה. אם המפתחים כוללים בתלויות שלהם את ספריית 'הוספת חומרי לימוד', נראה א) שיש רכיבים שחסרים בספריית 'חומרי לימוד בנושא Wear', אפשר לספר לנו מה נדרש או ב) משתמשים ברכיב שאנחנו לא ממליצים להשתמש בו במכשירים לבישים.