การเขียนใน Wear
อัปเดตล่าสุด | รุ่นที่เสถียร | ตัวเลือกถอนการอ้างสิทธิ์ | รุ่นเบต้า | รุ่นอัลฟ่า |
---|---|---|---|---|
12 มิถุนายน 2024 | 1.3.1 | - | 1.4.0-เบต้า 03 | - |
การประกาศทรัพยากร Dependency
หากต้องการเพิ่มทรัพยากร Dependency ใน Wear คุณต้องเพิ่มที่เก็บ Google Maven ไปยัง อ่านที่เก็บ Maven ของ Google เพื่อดูข้อมูลเพิ่มเติม
เพิ่มทรัพยากร Dependency สำหรับอาร์ติแฟกต์ที่คุณต้องการในไฟล์ build.gradle
สำหรับ
ในแอปหรือโมดูล
Groovy
dependencies { implementation "androidx.wear.compose:compose-foundation:1.3.1" // For Wear Material Design UX guidelines and specifications implementation "androidx.wear.compose:compose-material:1.3.1" // For integration between Wear Compose and Androidx Navigation libraries implementation "androidx.wear.compose:compose-navigation:1.3.1" // For Wear preview annotations implementation("androidx.wear.compose:compose-ui-tooling:1.3.1") // NOTE: DO NOT INCLUDE a dependency on androidx.compose.material:material. // androidx.wear.compose:compose-material is designed as a replacement // not an addition to androidx.compose.material:material. // If there are features from that you feel are missing from // androidx.wear.compose:compose-material please raise a bug to let us know. }
Kotlin
dependencies { implementation("androidx.wear.compose:compose-foundation:1.3.1") // For Wear Material Design UX guidelines and specifications implementation("androidx.wear.compose:compose-material:1.3.1") // For integration between Wear Compose and Androidx Navigation libraries implementation("androidx.wear.compose:compose-navigation:1.3.1") // For Wear preview annotations implementation("androidx.wear.compose:compose-ui-tooling:1.3.1") // NOTE: DO NOT INCLUDE a dependency on androidx.compose.material:material. // androidx.wear.compose:compose-material is designed as a replacement // not an addition to androidx.compose.material:material. // If there are features from that you feel are missing from // androidx.wear.compose:compose-material please raise a bug to let us know. }
ดูข้อมูลเพิ่มเติมเกี่ยวกับทรัพยากร Dependency ได้ที่หัวข้อเพิ่มการอ้างอิงของบิลด์
ความคิดเห็น
ความคิดเห็นของคุณช่วยปรับปรุง Jetpack ให้ดียิ่งขึ้น โปรดแจ้งให้เราทราบหากคุณพบปัญหาใหม่หรือมี ไอเดียในการปรับปรุงไลบรารีนี้ โปรดดูที่ ปัญหาที่มีอยู่ ในไลบรารีนี้ก่อนที่จะสร้างใหม่ คุณสามารถเพิ่มการโหวตให้กับปัญหาที่มีอยู่ได้โดย คลิกปุ่มดาว
ดูเอกสารประกอบเกี่ยวกับเครื่องมือติดตามปัญหา เพื่อดูข้อมูลเพิ่มเติม
Wear Compose Material3 เวอร์ชัน 1.0
เวอร์ชัน 1.0.0-alpha23
14 พฤษภาคม 2024
ปล่อย androidx.wear.compose:compose-material3:1.0.0-alpha23
แล้ว เวอร์ชัน 1.0.0-alpha23 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- เราได้อัปเดต API ของ
ToggleButton
และRadioButton
เพื่อให้กำหนดค่าสีที่ปิดใช้ได้ (If13a7) - เราได้เพิ่ม
CircularProgressIndicator
ใหม่สำหรับ Material3 (Ib3bd7)
แก้ไขข้อบกพร่อง
- เราได้แก้ไขข้อบกพร่องตรงที่ปุ่มที่เลือกได้ประกาศให้แตะสองครั้งเพื่อเปิด/ปิดเมื่อเลือกปุ่มไว้แล้ว (I7ed88)
เวอร์ชัน 1.0.0-alpha22
1 พฤษภาคม 2024
ปล่อย androidx.wear.compose:compose-material3:1.0.0-alpha22
แล้ว เวอร์ชัน 1.0.0-alpha22 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- เราได้อัปเดต
ColorScheme
ของ Material3 (I7b2b8) - เราได้อัปเดตสวิตช์ Material3 รวมถึงการเปลี่ยนสีบางอย่างด้วย ตอนนี้เครื่องหมายถูกจะตรงกับช่องทำเครื่องหมายที่ใช้ (Icac7b)
แก้ไขข้อบกพร่อง
- อัปเดตการสาธิตการผสานรวมทั้งหมดเพื่อใช้ตัวแก้ไข
rotaryScrollable
ใหม่ (I25090)
เวอร์ชัน 1.0.0-alpha21
17 เมษายน 2024
ปล่อย androidx.wear.compose:compose-material3:1.0.0-alpha21
แล้ว เวอร์ชัน 1.0.0-alpha21 มีคอมมิตเหล่านี้
- ระบบทริกเกอร์รุ่นนี้เนื่องจากปัญหาทางเทคนิคในรุ่นก่อนหน้า ซึ่งทำให้ไม่มี Jar แหล่งที่มา ไม่มีสัญญาผูกมัดใหม่ในรุ่นนี้
เวอร์ชัน 1.0.0-alpha20
3 เมษายน 2024
ปล่อย androidx.wear.compose:compose-material3:1.0.0-alpha20
แล้ว เวอร์ชัน 1.0.0-alpha20 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- เราได้ปรับอัลฟ่าของสถานะการกดคลื่นและโฟกัสไปที่คอนทราสต์ (I59f0a)
- เราได้เพิ่มระยะห่างระหว่างป้ายกำกับหลักและป้ายกำกับรองใน
Button
,ToggleButton
และRadioButton
ตามการเปลี่ยนแปลงล่าสุดของรูปแบบตัวอักษรและความสูงของบรรทัด (I2c0ba)
เวอร์ชัน 1.0.0-alpha19
6 มีนาคม 2024
ปล่อย androidx.wear.compose:compose-material3:1.0.0-alpha19
แล้ว เวอร์ชัน 1.0.0-alpha19 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- เราได้เพิ่ม
TimeText
ลงในไลบรารี Material3 ของ Wear Compose คอมโพเนนต์นี้จะแสดงเวลาปัจจุบัน (และสถานะเพิ่มเติม) ที่ด้านบนของหน้าจอ 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
ในคลาสสีเฉพาะคอมโพเนนต์ออก และทำเครื่องหมายเมธอดตัวเข้าถึงภายในคลาสสีเป็นภายใน (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
ออกจากไลบรารี Material3 ของ Wear Compose เพื่อให้สอดคล้องกับไลบรารี Compose Material3 (I49a0a) - อุปกรณ์ Wear และคอมโพเนนต์ Material3 ของ Wear ที่แสดง
MutableInteractionSource
ใน API ได้รับการอัปเดตเพื่อแสดงMutableInteractionSource
ที่เป็นค่าว่างซึ่งมีค่าเริ่มต้นเป็น Null ไม่มีการเปลี่ยนแปลงทางความหมายที่นี่: การส่งค่า Null หมายความว่าคุณไม่ต้องการรอนMutableInteractionSource
และจะสร้างขึ้นภายในคอมโพเนนต์หากจำเป็น การเปลี่ยนเป็น Null จะทำให้คอมโพเนนต์บางรายการไม่จัดสรรMutableInteractionSource
เลย และช่วยให้คอมโพเนนต์อื่นๆ สร้างอินสแตนซ์แบบ Lazy Loading ได้เมื่อจำเป็นเท่านั้น ซึ่งจะช่วยปรับปรุงประสิทธิภาพของคอมโพเนนต์เหล่านี้ หากคุณไม่ได้ใช้MutableInteractionSource
ที่คุณส่งไปยังคอมโพเนนต์เหล่านี้ ขอแนะนำให้คุณส่ง null แทน เราขอแนะนำให้คุณทำการเปลี่ยนแปลงที่คล้ายกันในคอมโพเนนต์ของคุณเองด้วย (Ib90fc, b/298048146) - เพิ่ม Ripple API ใหม่ในไลบรารี
wear:compose-material
และwear:compose-material3
ซึ่งแทนที่rememberRipple
ที่เลิกใช้งานแล้ว และเพิ่มCompositionLocal
ชั่วคราวคือLocalUseFallbackRippleImplementation
เพื่อเปลี่ยนคอมโพเนนต์ Material ไปใช้ API ของrememberRipple/RippleTheme
ที่เลิกใช้งานแล้ว เราจะนำการตั้งค่านี้ออกในรุ่นที่มีความเสถียรรุ่นถัดไปและมีไว้เพื่อเป็นตัวช่วยในการย้ายข้อมูลชั่วคราวในกรณีที่คุณให้RippleTheme
ที่กำหนดเองเท่านั้น ดูข้อมูลการย้ายข้อมูลและความเป็นมาเพิ่มเติมเบื้องหลังการเปลี่ยนแปลงนี้ได้ที่ developer.android.com (af92b21) - เราได้ทำการปรับปรุงเล็กๆ น้อยๆ กับ
HorizontalPageIndicator
API และเอกสารประกอบ (I60efc) - เราได้อัปเดต
ColorScheme
ให้จะเปลี่ยนแปลงไม่ได้ ทำให้การอัปเดตสีแต่ละสีมีประสิทธิภาพน้อยลง แต่การใช้สีร่วมกันจะมีประสิทธิภาพมากขึ้น การเปลี่ยนแปลงนี้คือแอปส่วนใหญ่จะไม่อัปเดตสีแยกเป็นกรณีการใช้งานหลัก รูปแบบเช่นนี้ยังคงเป็นไปได้แต่จะมีการจัดเรียงใหม่มากกว่าเดิม ซึ่งส่งผลให้เราลดจำนวนการสมัครใช้บริการของรัฐลงเป็นอย่างมากผ่านโค้ด Material ทั้งหมด และจะส่งผลต่อต้นทุนการเริ่มต้นและรันไทม์ของ Use Case มาตรฐานมากขึ้น (Ibc2d6) - อัปเดต API ของ
ToggleButton
และSplitToggleButton
เพื่ออนุญาตให้ปรับแต่งสีที่ปิดใช้แล้ว นอกจากนี้ ยังใช้โทเค็นดีไซน์ Material กับค่าสีและการออกแบบตัวอักษรอีกด้วย (If087c) - อัปเดตสีพื้นหลังของรูปภาพปุ่มเพื่อใช้โทเค็นดีไซน์ Material (Iba215)
- เราได้เปลี่ยนคอมโพเนนต์
Checkbox
,Switch
และRadioButton
ให้เป็นแบบดิสเพลย์เท่านั้น โดยนำการจัดการคลิกออก คาดว่าคอมโพเนนต์เหล่านี้จะใช้ใน(Split)ToggleButton
ซึ่งจัดการการคลิก ตอนนี้คอมโพเนนต์จะระบุไว้ชัดเจนขึ้นว่า "ดิสเพลย์เท่านั้น" (และไม่ได้มีไว้สำหรับใช้เดี่ยวบน Wear) (I2322e)
แก้ไขข้อบกพร่อง
- เราได้เพิ่มโทเค็นสำหรับค่าการเคลื่อนไหวของระยะเวลาและการค่อยๆ เปลี่ยนใน Material ของ Wear Compose 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
ซึ่งทำให้เห็นความแตกต่างระหว่างคอมโพเนนต์ระดับพื้นฐานกับ Material3 ระดับSwipeToDismissBox
อย่างชัดเจน คำสั่งหลังจะดึงสีจากMaterialTheme
เพื่อนำมาใช้ใน Scrim และมอบสิทธิ์การใช้งานที่เหลืออยู่ให้กับBasicSwipeToDismissBox
(Ibecfc)
แก้ไขข้อบกพร่อง
- เราได้นำเลเยอร์ Material-core สำหรับปุ่ม Material3 ออกเพื่อปรับปรุงประสิทธิภาพ (I55555)
เวอร์ชัน 1.0.0-alpha14
18 ตุลาคม 2023
ปล่อย androidx.wear.compose:compose-material3:1.0.0-alpha14
แล้ว เวอร์ชัน 1.0.0-alpha14 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- เราได้นำพารามิเตอร์
indicatorStyle
ออกจาก 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 สำหรับ
TextButton
แล้ว (I769dc)
เวอร์ชัน 1.0.0-alpha12
20 กันยายน 2023
ปล่อย androidx.wear.compose:compose-material3:1.0.0-alpha12
แล้ว เวอร์ชัน 1.0.0-alpha12 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- เราได้อัปเดต
IconButton
เพื่อใช้โทเค็นดีไซน์ Material (I3F137) - เราได้อัปเดต
IconToggleButton
เพื่อใช้โทเค็นดีไซน์ Material (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
ในคลัง Material3 ของ Wear (Ifee99)
การเปลี่ยนแปลง API
- อัปเดตโค้ดปุ่มเพื่อใช้โทเค็นการออกแบบ Material3 (I92fe4)
- ประกาศ API ของ Wear Material 3 Stepper และ Slider เป็นเวอร์ชันทดลอง เนื่องจากยังอยู่ในกระบวนการสรุปรายละเอียดของอินเทอร์เฟซผู้ใช้ (I84d54)
- เราได้นำขนาด
ExtraSmall
ออกจากรอบTextButton
และTextToggleButton
เนื่องจากขนาดดังกล่าวใช้กับIconButton
เท่านั้น (Ibc7d5)
แก้ไขข้อบกพร่อง
- เราได้ปรับปรุงคำแนะนำเกี่ยวกับการพิมพ์สำหรับ TextToggleButton เพื่อใช้ LabelLarge สำหรับ LargeButtonSize (Ib10fa)
- เราได้ปรับปรุงคำแนะนำเกี่ยวกับการพิมพ์สำหรับ TextButton เพื่อใช้ LabelLarge สำหรับ LargeButtonSize (I8f3a7)
- เราได้ตั้งค่าเป้าหมายการสัมผัสขั้นต่ำของการ์ดเป็น 48dp สําหรับการช่วยเหลือพิเศษ (Ieb9b1)
- เพิ่ม AppCard พร้อมการสาธิตรูปภาพ นํา AppCard ที่มีการสาธิตในเบื้องหลัง (Id735f) ออก
- แก้ไขข้อบกพร่องของปุ่มวงกลมที่ไม่ได้ผูกแป้นกดร่วมอย่างถูกต้อง (I5e162)
เวอร์ชัน 1.0.0-alpha09
9 สิงหาคม 2023
ปล่อย androidx.wear.compose:compose-material3:1.0.0-alpha09
แล้ว เวอร์ชัน 1.0.0-alpha09 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- เราได้เพิ่ม
ToggleButton
สำหรับ Material3 (I6bed6)
การเปลี่ยนแปลง API
- เราได้เปิดใช้คำอธิบายประกอบ
FloatRange
เป็นข้อจำกัด API ซึ่งได้ระบุไว้ในความคิดเห็นก่อนหน้านี้แล้ว (Icb401) - เราได้อัปเดตการออกแบบตัวอักษรสำหรับ Wear Material3 ให้เป็นไปตามหลักเกณฑ์ล่าสุดของ Material3 (I1bad6)
แก้ไขข้อบกพร่อง
- เราได้อัปเดตสีสำหรับ
Button
,IconButton
และTextButton
เพื่อให้สอดคล้องกับดีไซน์ Material3 (Ib2495) - เราได้แก้ไขการทำเครื่องหมายในช่องทำเครื่องหมายในสถานะถูกปิดใช้งานแล้ว (Ib25bf)
เวอร์ชัน 1.0.0-alpha08
26 กรกฎาคม 2023
ปล่อย androidx.wear.compose:compose-material3:1.0.0-alpha08
แล้ว เวอร์ชัน 1.0.0-alpha08 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- เราได้เพิ่มการควบคุมการเลือกต่อไปนี้สำหรับ Material3 -
Switch
,Checkbox
,RadioButton
(Ib918C) - เราได้เพิ่ม
IconToggleButton
และTextToggleButton
ลงใน Material3 ซึ่งเป็นปุ่มเปิด/ปิดวงกลมที่มีช่องเดียวสำหรับไอคอนและข้อความตามลำดับ สำหรับToggleButton
ขนาดต่างๆ เราขอแนะนำให้ใช้Modifier.touchTargetAwareSize
กับขนาดที่ระบุไว้ในปุ่มเปิด/ปิดที่เกี่ยวข้อง (I9F015) - เราได้เพิ่ม
ListHeader
และListSubheader
ลงในคอมโพเนนต์ Material3 แล้ว (อีเบเฟ) - เราได้เพิ่ม Material3
SwipeToDismissBox
ซึ่งเรียกใช้องค์ประกอบพื้นฐานใหม่SwipeToDismissBox
และระบุค่าสีเริ่มต้นจากธีม (I275fb) - เราได้เพิ่ม Material3
InlineSlider
ลงใน Wear Compose ทำให้ผู้ใช้สามารถเลือกจากช่วงของค่า ช่วงของรายการที่เลือกจะแสดงเป็นแถบระหว่างค่าต่ำสุดและสูงสุดของช่วง ซึ่งผู้ใช้สามารถเลือกค่าใดค่าหนึ่งได้InlineSlider
เหมาะสำหรับการปรับการตั้งค่า เช่น ระดับเสียงหรือความสว่าง (I7085F)
การเปลี่ยนแปลง API
- เราได้อัปเดตรูปร่างในธีมของ Wear Material 3 เพื่อใช้ตาม
RoundedCornerShape
แทนรูปร่าง (Idb133) - เรากำหนดค่าความสูงสำหรับ Button ให้เป็นสาธารณะ (Idbfde)
- อัปเดตไฟล์ API เพื่อให้มีคำอธิบายประกอบสำหรับการระงับความเข้ากันได้ (I8e87a, b/287516207)
- เราได้อัปเดต
InlineSliderColors
ใน Material Compose ของ Wear 3 ให้มีตัวสร้างสาธารณะและพร็อพเพอร์ตี้สาธารณะ (I6B632) - เราได้อัปเดตคลาสสีทั้งหมดใน Material ของ Wear Compose 3 ให้มีเครื่องมือสร้างสาธารณะและคุณสมบัติสาธารณะ (I17702)
- เราเผยแพร่ค่าคงที่ของระยะห่างจากขอบแนวตั้งและแนวนอนของปุ่มต่อสาธารณะ (Ieeaf7)
แก้ไขข้อบกพร่อง
- ตอนนี้ปุ่มจะปรับความสูงของปุ่มเพื่อรองรับเนื้อหาที่เพิ่มขึ้นเนื่องจากมีแบบอักษรขนาดใหญ่เพื่อการช่วยเหลือพิเศษเมื่อจำเป็น (Iaf302)
- เราได้อัปเดตการสาธิตของปุ่มจำนวนหนึ่งเพื่อแก้ไขปัญหาในการเข้าถึง (I61ce9)
- ตอนนี้
Stepper
และInlineSlider
รองรับการคลิกซ้ำเมื่อกดค้างแล้ว คุณจึงสามารถเพิ่ม/ลดค่าของStepper
และInlineSlider
ได้อย่างรวดเร็วโดยกดปุ่ม + หรือ - ค้างไว้ (I27359)
เวอร์ชัน 1.0.0-alpha07
21 มิถุนายน 2023
ปล่อย androidx.wear.compose:compose-material3:1.0.0-alpha07
แล้ว เวอร์ชัน 1.0.0-alpha07 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- เราได้เพิ่มคอมโพเนนต์
Stepper
ลงในไลบรารี Material 3 ของ Compose สำหรับ Wear OS แล้ว เนื้อหานี้จะคล้ายกับ Material เวอร์ชันก่อนหน้า แต่ไม่แสดงความหมายของช่วงโดยค่าเริ่มต้นตามความคิดเห็นของนักพัฒนาแอป เราจะระบุModifier.rangeSemantics
กรณีที่จำเป็นต้องใช้ความหมายของช่วง (Ic39fd) - เราได้เพิ่ม
curvedText
ลงในไลบรารี Compose สำหรับ Material 3 ของ Wear OS (Ia8ae3)
แก้ไขข้อบกพร่อง
- เราได้อัปเดต
wear.compose.foundation
เป็นทรัพยากร Dependency ของ API ของwear.compose.material3
(I72004, b/285404743)
เวอร์ชัน 1.0.0-alpha06
7 มิถุนายน 2023
ปล่อย androidx.wear.compose:compose-material3:1.0.0-alpha06
แล้ว เวอร์ชัน 1.0.0-alpha06 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- เราได้อัปเดต
TextButton
ให้ใช้ฟังก์ชันของส่วนขยายtoDisabledColor
สำหรับค่าอัลฟ่าที่ปิดใช้อย่างถูกต้อง (I814c8)
เวอร์ชัน 1.0.0-alpha05
24 พฤษภาคม 2023
ปล่อย androidx.wear.compose:compose-material3:1.0.0-alpha05
แล้ว เวอร์ชัน 1.0.0-alpha05 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- เราได้เพิ่ม
TextButton
ลงใน Material3 ซึ่งเป็นปุ่มวงกลมที่มีช่องเดียวสำหรับข้อความ สำหรับTextButton
ขนาดต่างๆ เราขอแนะนำให้ใช้Modifier.touchTargetAwareSize
และExtraSmallButtonSize
,SmallButtonSize
,DefaultButtonSize
และLargeButtonSizeIcon
ที่ให้ไว้ในTextButtonDefaults
TextButton
เริ่มต้นไม่มีเส้นขอบและพื้นหลังโปร่งใสสำหรับการดำเนินการที่เน้นระดับต่ำ สำหรับการดำเนินการที่ต้องเน้นความสำคัญสูง ให้ใช้filledTextButtonColors
สำหรับการเน้นปานกลาง เส้นขอบTextButton
ให้กำหนดเส้นขอบเป็นButtonDefaults.outlinedButtonBorder
สำหรับระยะห่างตรงกลางระหว่างเติมขอบกับสีเติม ให้ใช้filledTonalTextButtonColors
(I667e4) - เราได้เพิ่ม
Card
,OutlinedCard
,AppCard
และTitleCard
ลงในไลบรารี Material3 ของ Wear ComposeAppCard
และ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 ซึ่งเป็นปุ่มวงกลมที่มีช่องเดียวสำหรับไอคอน/รูปภาพ มี 4 รูปแบบ ได้แก่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 ของ Wear Compose (เปลี่ยนชื่อเป็น "ปุ่ม" เพื่อให้สอดคล้องกับไลบรารี 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 3 ซึ่งกำหนดค่าPlatformTextStyle.includeFontPadding
เป็น true แล้ว (การตั้งค่าปัจจุบัน) ซึ่งจะช่วยให้เราซิงค์ข้อมูลการปิดระยะห่างจากขอบของแบบอักษรโดยค่าเริ่มต้นกับไลบรารี Compose ได้ในอนาคต (โปรดดูแก้ไขระยะห่างจากขอบของแบบอักษรใน Compose สำหรับพื้นหลัง) (I7e461)
เวอร์ชัน 1.0.0-alpha01
22 มีนาคม 2023
ปล่อย androidx.wear.compose:compose-material3:1.0.0-alpha01
แล้ว เวอร์ชัน 1.0.0-alpha01 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
Material 3 คือวิวัฒนาการขั้นถัดไปของดีไซน์ Material รวมถึงมีธีมที่อัปเดตและองค์ประกอบที่ออกแบบใหม่ Material 3 ใน Wear Compose ออกแบบมาให้สอดคล้องกับไลบรารี Material 3 Compose ใน Android รุ่นอัลฟ่ารุ่นแรกนี้มีการติดตั้งใช้งานฟังก์ชันการทำงานเบื้องต้นดังต่อไปนี้
เราจะพัฒนา Wear Material (
androidx.wear.compose:compose-material
) และ Wear Material 3 (androidx.wear.compose:compose-material3
) ต่อไปควบคู่กันไป Material3 รุ่นต่อๆ ไปจะขยายชุดวิดเจ็ตให้รวมคอมโพเนนต์อื่นๆ ที่คุ้นเคยจาก Compose สำหรับ Wear OS เช่น ปุ่ม เครื่องมือเลือก และแถบเลื่อนไลบรารีของ Wear Material และ Wear Material 3 ไม่เกี่ยวข้องกันและไม่ควรรวมในแอปเดียวกัน เนื่องจากมีการอ้างอิงธีมที่แตกต่างกันซึ่งทําให้เกิดความไม่สอดคล้องกันที่ไม่คาดคิด
เวอร์ชัน 1.4
เวอร์ชัน 1.4.0-beta03
12 มิถุนายน 2024
ปล่อย androidx.wear.compose:compose-*:1.4.0-beta03
แล้ว เวอร์ชัน 1.4.0-beta03 มีสัญญาผูกมัดเหล่านี้
แก้ไขข้อบกพร่อง
- เราได้อัปเดต
Modifier.rotaryScrollable
เพื่อแทนที่การใช้ "Focusable" ด้วย "FocusTarget" เพื่อปรับปรุงประสิทธิภาพ (Id294b) - เราได้แก้ไขปัญหาที่
ProgressIndicator
ประกาศซ้ำภายใต้TalkBack
แล้ว (I94563) - เราได้อัปเดตโปรไฟล์พื้นฐานของไลบรารี Wear Compose แล้ว (I3cbc3)
เวอร์ชัน 1.4.0-beta02
29 พฤษภาคม 2024
ปล่อย androidx.wear.compose:compose-*:1.4.0-beta02
แล้ว เวอร์ชัน 1.4.0-beta02 มีสัญญาผูกมัดเหล่านี้
แก้ไขข้อบกพร่อง
- เราได้เพิ่มความกว้างขอบเขตที่ส่งไปยังโปรแกรมอ่านหน้าจอจากข้อความโค้งเพื่อแก้ปัญหาเกี่ยวกับการตัดข้อความ (Id865f)
- เราได้จำกัดขอบเขตของ
HorizontalPageIndicator
ที่ส่งไปยังโปรแกรมอ่านหน้าจอ ซึ่งก่อนหน้านี้ตัวบ่งชี้จะแสดงเต็มหน้าจอ (Id8d7a)
เวอร์ชัน 1.4.0-beta01
14 พฤษภาคม 2024
ปล่อย androidx.wear.compose:compose-*:1.4.0-beta01
แล้ว เวอร์ชัน 1.4.0-beta01 มีคอมมิตเหล่านี้
Compose สำหรับ Wear OS รุ่น 1.4-beta01 ระบุว่าไลบรารีรุ่นนี้มีฟีเจอร์สมบูรณ์และ API ถูกล็อก (ยกเว้นที่ระบุว่าเป็นเวอร์ชันทดลอง) Wear Compose 1.4 มีฟังก์ชันการทำงานใหม่ต่อไปนี้
- เราได้เพิ่ม
Modifier.rotaryScrollable
ซึ่งเป็นตัวแก้ไขใหม่ที่เชื่อมต่อเหตุการณ์แบบหมุนกับคอนเทนเนอร์แบบเลื่อนได้ เพื่อให้ผู้ใช้เลื่อนผ่านเม็ดมะยมหรือขอบที่หมุนได้ในอุปกรณ์ Wear OS นอกจากนี้ScalingLazyColumn
และPicker
ยังรองรับการป้อนข้อมูลด้วยปุ่มหมุนโดยค่าเริ่มต้น ใช้พารามิเตอร์rotaryScrollableBehavior
เพื่อกำหนดค่าลักษณะการเลื่อนหรือสแนป สำหรับลักษณะการทำงานของสแนป ขอแนะนำให้ทำการสแนปผ่านพารามิเตอร์flingBehavior
รวมถึงการเลื่อนด้วยการแตะ - ตอนนี้
SwipeDismissableNavHost
มีภาพเคลื่อนไหวของรายการสำหรับการเปลี่ยนในแอปแล้ว - ขณะนี้
PositionIndicator
แสดงโดยค่าเริ่มต้นเมื่อแสดงหน้าจอครั้งแรก - เพิ่ม
SelectableChip
และSplitSelectableChip
เป็นรูปแบบที่ToggleChip
แล้ว ให้ใช้พารามิเตอร์นี้กับRadioButton
เพื่อให้ความหมายที่เลือกได้แทนความหมายแบบสลับได้สำหรับการช่วยเหลือพิเศษ - ขณะนี้
ListHeader
รองรับการปรับความสูงเมื่อเนื้อหาต้องการความสูงเพิ่มเติมเพื่อรองรับแบบอักษรขนาดใหญ่
แก้ไขข้อบกพร่อง
- เราได้แก้ไขข้อบกพร่องที่ชิปที่เลือกได้ประกาศให้แตะสองครั้งเพื่อเปิด/ปิดเมื่อเลือกอยู่แล้ว (I7ed88)
เวอร์ชัน 1.4.0-alpha08
1 พฤษภาคม 2024
ปล่อย androidx.wear.compose:compose-*:1.4.0-alpha08
แล้ว เวอร์ชัน 1.4.0-alpha08 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- เราได้ดำเนินการเปลี่ยนแปลงดังต่อไปนี้กับ Rotary API ใหม่: เปลี่ยนชื่อ
Modifier.rotary
เป็นModifier.rotaryScrollable
เปลี่ยนชื่ออินเทอร์เฟซRotaryBehavior
เป็นRotaryScrollableBehavior
และฟังก์ชันhandleScrollEvent
เป็นperformScroll
เปลี่ยนชื่อRotaryScrollableAdapter
เป็นRotaryScrollableLayoutInfoProvider
และนำพร็อพเพอร์ตี้scrollableState
ออก (I0c8a6) - เราได้ทำการเปลี่ยนแปลงเพิ่มเติมกับ Rotary API โดยเปลี่ยนชื่อ
RotaryScrollableLayoutInfoProvider
เป็นRotarySnapLayoutInfoProvider
(เนื่องจากผู้ให้บริการรายนี้ต้องใช้สำหรับปุ่มหมุนกับสแนปเท่านั้น) เปลี่ยนประเภทของพารามิเตอร์snapOffset
ในRotaryScrollableDefaults.snapBehavior snapOffset
จาก Int เป็น Dp (Iddebe) - เราได้เปลี่ยนชื่อพารามิเตอร์
clickInteractionSource
บนSplitSelectableChip
เป็นcontainerInteractionSource
(Ia8f84) - เราได้อัปเดตชื่อพารามิเตอร์ Callback ของคลิกสำหรับ
SplitSelectableChip
- จากonClick
เป็นonSelectionClick
และจากonBodyClick
เป็นonContainerClick
(I32237)
แก้ไขข้อบกพร่อง
- เราได้อัปเดตระยะห่างจากขอบแนวนอนของ
PositionIndicator
เป็น 2dp (เดิมคือ 5dp) เพื่อแก้ไขข้อบกพร่องที่PositionIndicator
(แถบเลื่อน) ซ้อนทับเนื้อหาที่เลื่อนได้ โปรดทราบว่าการเปลี่ยนแปลงนี้คาดว่าจะทำให้ภาพหน้าจอที่มีอยู่ซึ่งมีPositionIndicator
เสียหายเนื่องจากการเปลี่ยนแปลงของระยะห่างจากขอบ (I57472) - เราได้ปรับปรุงเอกสารประกอบเกี่ยวกับ Rotary API ใหม่โดยอธิบายความแตกต่างระหว่างอุปกรณ์แบบหมุนความละเอียดสูงกับความละเอียดต่ำ (I63abe)
- เราได้แก้ไขข้อยกเว้นนอกช่วงใน
SwipeDismissableNavHost
ที่อาจทริกเกอร์เมื่อค่าอัลฟ่าแบบสอดแทรกน้อยกว่า 0 (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
และเครื่องมือเลือกยังรองรับการป้อนข้อมูลด้วยปุ่มหมุนโดยค่าเริ่มต้น โดยมีโอเวอร์โหลดใหม่ที่มีพารามิเตอร์rotaryBehavior
สําหรับระบุการกําหนดค่าการเลื่อนหรือสแนป หากตั้งค่าพารามิเตอร์rotaryBehavior
เป็นสแนป ขอแนะนำให้ทำการสแนปผ่านพารามิเตอร์flingBehavior
ด้วยสำหรับการเลื่อนด้วยการแตะ (I2ef6f) UserInput
และSideEffect
จะมาแทนที่แหล่งที่มาการลากและวางNestedScroll
เพื่อรองรับคำจำกัดความแบบขยายของแหล่งที่มาเหล่านี้ ซึ่งตอนนี้จะมีภาพเคลื่อนไหว (เอฟเฟกต์ด้านข้าง) และล้อเลื่อนของเมาส์ (UserInput) รวมอยู่ด้วย (I40579)- เราได้เพิ่ม
SelectableChip
และSplitSelectableChip
เพื่อทำให้ความแตกต่างระหว่างการควบคุมการสลับ เช่นSwitch/Checkbox
และการควบคุมที่เลือกได้ชัดเจนยิ่งขึ้น เช่นRadioButton
การดำเนินการนี้จะแทนที่การโหลดที่มากเกินไปของToggleChip/SplitToggleChip
ก่อนหน้านี้ด้วยพารามิเตอร์selectionControl
(Ia0217) - อัปเดตตัวปรับแต่งระดับการเข้าถึงของ
IndeterminateStrokeWidth
ในProgressIndicatorDefaults
เป็นแบบสาธารณะแล้ว (I5b5a4)
เวอร์ชัน 1.4.0-alpha06
3 เมษายน 2024
ปล่อย androidx.wear.compose:compose-*:1.4.0-alpha06
แล้ว เวอร์ชัน 1.4.0-alpha06 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- เราได้เพิ่มแผนการสนับสนุนแบบหมุนไว้ภายใน ซึ่งเป็นส่วนหนึ่งของความพยายามครั้งใหญ่ในการย้ายข้อมูลลักษณะการทำงานแบบ Rotary ไปยัง AndroidX จาก Horologist (I617d1)
- เราได้เพิ่มแผนการสนับสนุนการโต้ตอบการสัมผัสไว้เป็นการภายใน ซึ่งเป็นส่วนหนึ่งของความพยายามครั้งใหญ่ในการย้ายข้อมูลการทำงานแบบ Rotary จาก Horologist ไปยัง 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
- เราได้เพิ่ม Ripple API ใหม่ในไลบรารี
wear:compose-material
และwear:compose-material3
ซึ่งแทนที่rememberRipple
ที่เลิกใช้งานแล้ว และเพิ่มCompositionLocal
ชั่วคราวคือLocalUseFallbackRippleImplementation
เพื่อเปลี่ยนคอมโพเนนต์ Material ไปใช้ API ของrememberRipple/RippleTheme
ที่เลิกใช้งานแล้ว เราจะนำการตั้งค่านี้ออกในรุ่นที่มีความเสถียรรุ่นถัดไปและมีไว้เพื่อเป็นตัวช่วยในการย้ายข้อมูลชั่วคราวในกรณีที่คุณให้RippleTheme
ที่กำหนดเองเท่านั้น ดูข้อมูลการย้ายข้อมูลและความเป็นมาเพิ่มเติมเบื้องหลังการเปลี่ยนแปลงนี้ได้ที่ developer.android.com (af92b21) - เราได้อัปเดต
ColorScheme
ให้จะเปลี่ยนแปลงไม่ได้ ทำให้การอัปเดตสีแต่ละสีมีประสิทธิภาพน้อยลง แต่การใช้สีร่วมกันจะมีประสิทธิภาพมากขึ้น การเปลี่ยนแปลงนี้คือแอปส่วนใหญ่จะไม่อัปเดตสีแยกเป็นกรณีการใช้งานหลัก รูปแบบเช่นนี้ยังคงเป็นไปได้แต่จะมีการจัดเรียงใหม่มากกว่าเดิม ด้วยเหตุนี้ เราจึงลดจำนวนการสมัครใช้บริการของรัฐลงเป็นอย่างมากผ่านโค้ด Material ทั้งหมด และจะส่งผลต่อต้นทุนการเริ่มต้นและรันไทม์ของ Use Case มาตรฐานมากขึ้น (f5c48b7) - เนื้อหา Wear และคอมโพเนนต์ Wear Material3 ที่แสดง
MutableInteractionSource
ใน API ได้รับการอัปเดตเพื่อแสดงMutableInteractionSource
ที่เป็นค่าว่างซึ่งมีค่าเริ่มต้นเป็น Null ไม่มีการเปลี่ยนแปลงทางความหมายที่นี่: การส่งค่า Null หมายความว่าคุณไม่ต้องการรอนMutableInteractionSource
และจะสร้างขึ้นภายในคอมโพเนนต์หากจำเป็น การเปลี่ยนเป็น Null จะทำให้คอมโพเนนต์บางรายการไม่จัดสรรMutableInteractionSource
เลย และช่วยให้คอมโพเนนต์อื่นๆ สร้างอินสแตนซ์แบบ Lazy Loading ได้เมื่อจำเป็นเท่านั้น ซึ่งจะช่วยปรับปรุงประสิทธิภาพของคอมโพเนนต์เหล่านี้ หากคุณไม่ได้ใช้MutableInteractionSource
ที่คุณส่งไปยังคอมโพเนนต์เหล่านี้ ขอแนะนำให้คุณส่ง null แทน เราขอแนะนำให้คุณทำการเปลี่ยนแปลงที่คล้ายกันในคอมโพเนนต์ของคุณเองด้วย (f8fa920) - เราได้อัปเดต
rememberExpandableState
เพื่อบันทึกสถานะที่ขยายได้ วิธีนี้ช่วยให้มั่นใจได้ว่าข้อมูลจะได้รับการจัดเก็บเมื่อไปยังหน้าจออื่นและจะได้รับการกู้คืนเมื่อกลับมาที่หน้าจอเดิม (5c80095)
แก้ไขข้อบกพร่อง
- เราอัปเดตการตั้งค่า
ReduceMotion
เพื่อใช้ Listener ที่รับรู้ในวงจรการใช้งานแล้ว (7c6b122) - เราได้อัปเดต Listener ของ
TouchExplorationStateProvider
ให้รับรู้ถึงวงจร (be28b01) แล้ว - เราได้นำเลเยอร์ Materialcore สำหรับ
CompactButton
ออกเพื่อปรับปรุงประสิทธิภาพ (25db8e9) - เราสร้างการชดเชยเวลา NaN ให้มีประสิทธิภาพยิ่งขึ้น
BasicSwipeToDismissBox
เพื่อหลีกเลี่ยงข้อยกเว้น (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 เช่น การใช้สีจากธีมที่กำหนดค่าไว้จะได้รับการจัดการแยกกัน - คลาส
SwipeToRevealCard
และSwipeToRevealChip
จะช่วยคุณในการนำrecommended swipe-to-reveal guidance
ไปใช้ ชั้นเรียนSwipeToRevealSample
จะสาธิตวิธีใช้คอมโพเนนต์เหล่านี้ รุ่น 1.3.0-alpha02 ของเรามีการเปลี่ยนแปลงที่ทำให้ออบเจ็กต์
Chip
และToggleChip
มีความสูงมากขึ้นเพื่อรองรับการปรับขนาดแบบอักษรที่ผู้ใช้เลือกได้ดีขึ้น ซึ่งอาจทำให้มีการตัดคลิปเกิดขึ้น ในการแก้ไขปัญหานี้ รูปร่างlarge
สำหรับMaterialTheme
จะใช้รัศมีของมุมที่ใหญ่ขึ้น (26 dp แทน 24 dp) ออบเจ็กต์Chip
และToggleChip
จะใช้รัศมีของมุมใหม่นี้เพื่อหลีกเลี่ยงการตัดเนื้อหาที่มุมของชิปและToggleChip
Chips
และToggleChips
ส่วนใหญ่ไม่มีการเปลี่ยนแปลง เนื่องจากความสูงเริ่มต้นคือ 52 dp แต่ออบเจ็กต์Chip
และToggleChip
ที่มีข้อความป้ายกำกับหลักหรือรองหลายบรรทัด หรือที่มีการลบล้างความสูง อาจทำให้การทดสอบภาพหน้าจอแตกได้
การเปลี่ยนแปลงเพิ่มเติม
โปรดดูชุดการเปลี่ยนแปลงที่สมบูรณ์ยิ่งขึ้นในเวอร์ชัน 1.3.0 ที่บันทึกประจำรุ่นของเวอร์ชันเบต้า 01
คำแนะนำในการใช้งาน
- หากแอปอนุญาตให้ผู้ใช้เลื่อนไปรอบๆ เนื้อหาของหน้าจอ เช่น ในแอปที่อิงตามแผนที่ ให้ปิดการจัดการการปัดโดยตั้งค่า
userSwipeEnabled
เป็นfalse
ใน ComposableSwipeDismissableNavHost
และใส่ปุ่มที่อนุญาตให้ผู้ใช้ไปที่หน้าจอก่อนหน้า - หากต้องการปิดภาพเคลื่อนไหวสำหรับตัวบ่งชี้ตำแหน่งระหว่างการแสดงภาพเคลื่อนไหวแบบเฟดอินและเปลี่ยนตำแหน่งภายในรายการแบบเลื่อน ให้ใช้ออบเจ็กต์
SnapSpec
- แสดง
Placeholder
ที่เขียนได้ด้วย Compose ว่างในขณะที่รอแอปสื่อโหลดเนื้อหาเพื่อเล่น - หากต้องการสร้างคอลเล็กชันของรายการที่ขยายได้แบบออนดีมานด์ ให้พิจารณาใช้คลาส
ExpandableStateMapping
ทดสอบ
เวอร์ชัน 1.3.0-rc01
10 มกราคม 2024
ปล่อย androidx.wear.compose:compose-*:1.3.0-rc01
แล้ว เวอร์ชัน 1.3.0-rc01 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
-
เราได้อัปเดตรูปร่างขนาดใหญ่
MaterialTheme
ให้ใช้รัศมีมุมโค้ง 26dp แล้ว และตอนนี้ชิปและToggleChip
จะใช้รูปร่างนี้ การเปลี่ยนแปลงนี้จำเป็นต่อการรองรับการปรับความสูงเมื่อเนื้อหาต้องมีความสูงเพิ่มเติมเพื่อรองรับแบบอักษรขนาดใหญ่ มิฉะนั้นรูปร่างของสนามกีฬาที่มีอยู่จะตัดเนื้อหาข้อความบางส่วนออกวันที่ ภาพที่ 1: ข้อความถูกตัดที่มุม รูปที่ 2: ไม่ได้ตัดข้อความ การเปลี่ยนแปลงนี้อาจทำให้การทดสอบภาพหน้าจอขัดข้อง (I2e6ae)
เวอร์ชัน 1.3.0-beta02
13 ธันวาคม 2023
ปล่อย androidx.wear.compose:compose-*:1.3.0-beta02
แล้ว เวอร์ชัน 1.3.0-beta02 มีการคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- เราได้คืนค่าการปัดตามที่ต้องการแล้วใน
BasicSwipeToDismissBox
ส่วนนี้ได้รับการปรับเปลี่ยนในรุ่นก่อนหน้า ทำให้ส่วนเลื่อนของการเปลี่ยนเกิดขึ้นขณะที่นิ้วสัมผัสหน้าจอ (รหัส 8e76)
เวอร์ชัน 1.3.0-beta01
15 พฤศจิกายน 2023
ปล่อย androidx.wear.compose:compose-*:1.3.0-beta01
แล้ว เวอร์ชัน 1.3.0-beta01 มีการคอมมิตเหล่านี้
Compose สำหรับ Wear OS รุ่น 1.3-beta01 ระบุว่าไลบรารีรุ่นนี้มีฟีเจอร์สมบูรณ์และ API ถูกล็อก (ยกเว้นที่ระบุว่าเป็นเวอร์ชันทดลอง) Wear Compose 1.3 มีฟังก์ชันการทำงานใหม่ต่อไปนี้
- ระบบย้ายข้อมูล
SwipeToDismissBoxState
,SwipeToDismissValue
และModifier.edgeSwipeToDismiss
จากandroidx.wear.compose.material
ไปยังandroidx.wear.compose.foundation
พร้อมกับการใช้งานการปัดเพื่อปิดที่เกี่ยวข้องในBasicSwipeToDismissBox
วิธีนี้จะช่วยให้ใช้การจัดการท่าทางสัมผัสสำหรับการเลื่อนเพื่อปิดได้อย่างอิสระจากดีไซน์ Material เช่น จากSwipeDismissableNavHost
ในandroidx.wear.compose.navigation
ยังคงแนะนำให้ใช้SwipeToDismissBox
จากandroidx.wear.compose.material
กับดีไซน์ Material เนื่องจากสีจะดึงสีจากMaterialTheme
จากนั้นจึงมอบสิทธิ์การใช้งานที่เหลือให้กับBasicSwipeToDismissBox
- ตอนนี้
SwipeDismissableNavHost
รองรับพารามิเตอร์userSwipeEnabled
ใหม่แล้วเพื่อให้สามารถปิดการจัดการการปัดสำหรับหน้าจอที่ไม่จำเป็นต้องใช้ BasicSwipeToDismissBox
ปรับปรุงการจัดการโฟกัสโดยใช้HierarchicalFocusCoordinator
SwipeToReveal
มี Composable ของSwipeToRevealCard
และSwipeToRevealChip
ใหม่ใน Material ที่เป็นไปตามคำแนะนำ UX ที่แนะนำสำหรับCard
และChip
นอกจากนี้ยังมีการเลิกรองรับการดำเนินการรองด้วย- ตอนนี้
DefaultTextStyle
จะปิดระยะห่างจากขอบของแบบอักษรเพื่อให้สอดคล้องกันทั่วทั้งแพลตฟอร์ม Android - ตอนนี้
Chip
และToggleChip
ปรับความสูงเพื่อรองรับเนื้อหาที่เพิ่มขึ้นเนื่องจากมีแบบอักษรขนาดใหญ่สำหรับการช่วยเหลือพิเศษ - ตอนนี้
PositionIndicator
มีข้อกำหนดภาพเคลื่อนไหวเฉพาะสำหรับภาพเคลื่อนไหวแบบเฟดอิน เฟดออก และเปลี่ยนตำแหน่ง ด้วยเหตุผลด้านประสิทธิภาพ เราขอแนะนำให้ปิดการเฟดเข้าและการเปลี่ยนตำแหน่งเมื่อใช้กับรายการที่เลื่อนได้ ExpandableStateMapping
เป็นวิธีใหม่ในการสร้างExpandableStates
เมื่อต้องสร้างตามคำขอ แต่ไม่จำเป็นต้องมีขอบเขต@Composable
- ตอนนี้
Placeholder
อนุญาตให้รีเซ็ตได้แล้วหากเนื้อหาไม่อยู่ในสถานะพร้อมใช้งานแล้ว นอกจากนี้การตั้งค่าการลดการเคลื่อนไหวยังมีผลกับเอฟเฟกต์แสงวาวและการเคลื่อนไหวแบบเลื่อนบนPlaceholder
ด้วย
ปัญหาที่ทราบ
PositionIndicator
ไม่แสดงในครั้งแรกที่หน้าจอแสดงเป็นครั้งแรก เราตั้งใจที่จะทำการเปลี่ยนแปลงในเวอร์ชันอัลฟ่า 1.4 ก่อนเปิดตัวเพื่อให้แสดงในตอนแรก แต่จะไม่มีภาพเคลื่อนไหวใดๆ
การเปลี่ยนแปลง API
- เราได้เปลี่ยนชื่อระดับพื้นฐาน
SwipeToDismissBox
เป็นBasicSwipeToDismissBox
ซึ่งทำให้เห็นความแตกต่างระหว่างคอมโพเนนต์ระดับพื้นฐานกับวัสดุระดับSwipeToDismissBox
ได้อย่างชัดเจน ชุดหลังจะดึงสีจากMaterialTheme
เพื่อนำมาใช้ใน Scrim และมอบสิทธิ์การใช้งานที่เหลืออยู่ให้กับBasicSwipeToDismissBox
(Ibecfc) - เราได้ทำเครื่องหมาย
rememberExpandableStateMapping
ว่าเป็นเวอร์ชันทดลองและปรับปรุงประสิทธิภาพของexpandableItem
(I5f6bc) - เราได้แทนที่คลาส
SwipeToRevealAction
ใน MaterialSwipeToReveal
Card and Chip API ด้วย API ตามสล็อตโดยใช้ Composable ของSwipeToRevealPrimaryAction
,SwipeToRevealSecondaryAction
และSwipeToRevealUndoAction
โปรดดูโค้ดตัวอย่างเกี่ยวกับวิธีใช้ API ใหม่ (Ia8943) - เราได้แทนที่แฟล็กภาพเคลื่อนไหว
PositionIndicator
ด้วยพารามิเตอร์AnimationSpec
แล้ว คุณจะปิดใช้ภาพเคลื่อนไหวแต่ละรายการได้โดยการส่งsnap
เป็นAnimationSpec
(I6c523)
แก้ไขข้อบกพร่อง
- เราได้แก้ไขข้อบกพร่องที่เกิดจากข้อความโค้งที่จำกัดเมื่อมีการจำกัดขนาด (I50efe)
- เราได้แก้ไขข้อขัดข้อง NaN ที่อาจเกิดขึ้นซึ่งเกี่ยวข้องกับ
curvedComposable
(I970eb) แล้ว - เราได้เปลี่ยนกลับการลบภาพเคลื่อนไหวไฮไลต์การเปลี่ยนตำแหน่งเมื่อวันที่
PositionIndicator
(Ieb424) - เราได้นำเลเยอร์ Material-core สำหรับชิปวัสดุเพื่อปรับปรุงประสิทธิภาพ (If2dcb)
เวอร์ชัน 1.3.0-alpha08
18 ตุลาคม 2023
ปล่อย androidx.wear.compose:compose-*:1.3.0-alpha08
แล้ว เวอร์ชัน 1.3.0-alpha08 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- เราได้เพิ่ม Flag แต่ละรายการลงในโอเวอร์โหลด
PositionIndicator
เพื่อควบคุมภาพเคลื่อนไหวที่แตกต่างกัน:showFadeInAnimation
,showFadeOutAnimation
และshowPositionAnimation
API ก่อนหน้านี้เลิกใช้งานแล้วและส่งต่อการเรียกใช้ไปยัง API ใหม่ ด้วยเหตุผลด้านประสิทธิภาพและเพื่อความสอดคล้อง UX เมื่อใช้PositionIndicator
กับรายการที่เลื่อนได้ เราขอแนะนำให้ปิดการตั้งค่าสถานะshowFadeInAnimation
และshowPositionAnimation
หากใช้PositionIndicator
เป็นตัวบ่งชี้แบบสแตนด์อโลน เช่น สำหรับการเปลี่ยนแปลงระดับเสียง เราขอแนะนำให้เปิดภาพเคลื่อนไหวทั้ง 3 รายการ (I44294) - เราเลิกใช้งานสื่อการเรียนการสอนของชั้นเรียน
SwipeToDismissBoxState
,SwipeToDismissValue
และedgeSwipeToDismiss
แล้วหลังจากย้ายข้อมูลฟังก์ชันแบบปัดเพื่อปิดไปยังwear.compose.foundation
โปรดแทนที่ด้วยค่าที่เทียบเท่าwear.compose.foundation
(Iee8c9)
แก้ไขข้อบกพร่อง
- เราได้อัปเดตโปรไฟล์พื้นฐานสําหรับไลบรารีพื้นฐานสำหรับ Wear Compose, วัสดุ และไลบรารีการนำทาง (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 ก่อนหน้านี้เลิกใช้งานแล้วและส่งต่อการเรียกใช้ไปยัง API ใหม่ ด้วยเหตุผลด้านประสิทธิภาพและเพื่อความสอดคล้อง UX เมื่อใช้PositionIndicator
กับรายการที่เลื่อนได้ เราขอแนะนำให้ปิดการตั้งค่าสถานะshowFadeInAnimation
และshowPositionAnimation
หากใช้PositionIndicator
เป็นตัวบ่งชี้แบบสแตนด์อโลน เช่น สำหรับการเปลี่ยนแปลงระดับเสียง เราขอแนะนำให้เปิดภาพเคลื่อนไหวทั้ง 3 รายการ (Ia2d63)
แก้ไขข้อบกพร่อง
- เราได้ปรับปรุงการปัดเพื่อแสดงการเคลื่อนไหวด้วยการเพิ่มภาพเคลื่อนไหวที่ค่อยๆ จางลงในข้อความการทำงานหลัก และการจางลงการดำเนินการรอง/การเปลี่ยนสัดส่วนไอคอนเมื่อขยายแบบเต็มการปัด (Ib7223)
- ขอแนะนำให้ทำให้การทำงาน "ปัดเพื่อดู" เข้าถึงได้ และเราได้เพิ่มการดำเนินการการช่วยเหลือพิเศษที่กำหนดเองลงในตัวอย่าง "การปัดเพื่อแสดง" แล้ว (I42224)
- เราได้ปรับปรุงประสิทธิภาพของ
SwipeToDismissBox
ซึ่งรวมถึงการเปลี่ยนโครงสร้างภายในโค้ดเพื่อให้มั่นใจว่าตรรกะเริ่มต้นจะไม่ทริกเกอร์การจัดองค์ประกอบใหม่ ตอนนี้SwipeToDismissBox
ถูกวาดเป็นขนาดเต็มหน้าจอ (Ie0aa2) - เราได้แก้ไขข้อบกพร่องเมื่อ
PositionIndicator
หายไปอย่างไม่ถูกต้อง (I2091a) - ปรับปรุงประสิทธิภาพของ
PositionIndicator
ด้วยการเพิ่มประสิทธิภาพการจัดองค์ประกอบใหม่ ต่อมาเราได้เพิ่ม Flag ใหม่สำหรับควบคุมภาพเคลื่อนไหว (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 Foundation และ Material (I1dd1f)
เวอร์ชัน 1.3.0-alpha05
6 กันยายน 2023
ปล่อย androidx.wear.compose:compose-*:1.3.0-alpha05
แล้ว เวอร์ชัน 1.3.0-alpha05 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- เราได้เพิ่มการจัดการในส่วน "ปัดเพื่อแสดง" เพื่อให้ปัดได้ครั้งละ 1 รายการเท่านั้น (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
ในคลัง Material3 ของ Wear (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
- เราได้เพิ่ม Composable ใหม่ 2 รายการใน Material สำหรับการใช้
SwipeToReveal
กับการ์ดและชิป Composable เหล่านี้เป็นไปตามคำแนะนำ UX ที่แนะนำในคอมโพเนนต์และช่วยให้นักพัฒนาแอปใช้SwipeToReveal
กับคอมโพเนนต์ที่มีอยู่ใน Wear Material ได้ง่ายขึ้น (I7ec65) - เราได้เปิดใช้คำอธิบายประกอบ
FloatRange
เป็นข้อจำกัด API ตามที่ได้ระบุไว้ในความคิดเห็นก่อนหน้านี้แล้ว (Icb401)
แก้ไขข้อบกพร่อง
- เราได้ย้ายตรรกะการเลื่อนเริ่มต้นของ
ScalingLazyColumn
ภายในonGloballyPositioned()
(Ic90f1) - ตอนนี้เราใช้
drawWithCache
ในPositionIndicator
,ProgressIndicator
และSelectionControls
เพื่อเพิ่มประสิทธิภาพการจัดสรรโรคหลอดเลือดสมอง (I5f225, b/288234617) - เราได้แก้ไขการทำเครื่องหมายในช่องทำเครื่องหมายในสถานะถูกปิดใช้งานแล้ว (Ib25bf)
- เราได้อัปเดต
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 (I4ff8e)
แก้ไขข้อบกพร่อง
- เราได้แก้ไขข้อบกพร่องของ z-order ที่
expandedItem
ไม่แสดงเนื้อหาที่ถูกต้องหลังจากคลิกการทำงานของปุ่มเมื่อมีปุ่ม (I1899d, b/289991514) - ปรับปรุงการจัดการโฟกัสของ
SwipeToDismissBox
(และSwipeDismissableNavHost
) โดยใช้HierarchicalFocusCoordinator
(I45362, b/277852486) - เราได้แก้ไขการจัดการท่าทางสัมผัสใน
SwipeableV2
แล้ว (I89737) - เราได้สรุปโปรไฟล์พื้นฐานสำหรับรุ่น 1.2 ของเราเรียบร้อยแล้ว (รหัส 5740)
- หลังจากย้ายข้อมูล
SwipeToDismissBox
ไปยัง Foundation แล้ว ระบบใช้ MaterialSwipeToDismissBox
ไปยัง "มูลนิธิ" และระบุค่าสีเริ่มต้นจากธีม (If8451) - เราได้เพิ่มความหมายของส่วนหัวไปยัง
ListHeader
แล้ว (Ic5420) - ตอนนี้
Chip
และToggleChip
จะปรับความสูงเพื่อรองรับเนื้อหาที่เพิ่มขึ้นเนื่องจากมีแบบอักษรขนาดใหญ่สำหรับการช่วยเหลือพิเศษ หากจำเป็น (Iaf302) - แก้ไขข้อบกพร่องเรื่องบทบาทเชิงความหมายในพื้นที่ที่แตะได้ของ
SplitToggleChip
สำหรับการช่วยเหลือพิเศษ (Ieed3a) - ตอนนี้การตั้งค่าการลดการเคลื่อนไหวจะปิดเอฟเฟกต์แสงวาวและการเลื่อนแบบเลื่อนออกในตัวยึดตำแหน่ง (I91046)
- ตอนนี้
Stepper
และInlineSlider
รองรับการคลิกซ้ำเมื่อกดค้างแล้ว คุณจึงสามารถเพิ่ม/ลดค่าของStepper
และInlineSlider
ได้อย่างรวดเร็วโดยกดปุ่ม + หรือ - ค้างไว้ (I27359)
เวอร์ชัน 1.3.0-alpha01
21 มิถุนายน 2023
ปล่อย androidx.wear.compose:compose-*:1.3.0-alpha01
แล้ว เวอร์ชัน 1.3.0-alpha01 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- ตามที่ประกาศไว้ใน
1.2.0-alpha07
และ1.2.0-alpha10
ขณะนี้เราจะเปลี่ยนแปลงDefaultTextStyle
เพื่อปิดระยะห่างจากขอบของแบบอักษรเพื่อให้สอดคล้องกันทั่วทั้งแพลตฟอร์ม Android การดำเนินการนี้จะแก้ปัญหาข้อความบางส่วนที่มีแบบอักษรขนาดใหญ่และยังอาจส่งผลต่อเลย์เอาต์หน้าจอด้วย จึงต้องอัปเดตการทดสอบภาพหน้าจอ ตัวอย่างเช่น เราเห็นการตัดข้อความที่นี่ (Ic6a86)
![ข้อความถูกตัดโดยใช้ตัวอักษรขนาดใหญ่](https://developer.android.com/static/jetpack/androidx/images/IncludeFontPadding-True.png?hl=th)
- ซึ่งจะไม่แสดงอีกต่อไปเมื่อปิดระยะห่างจากขอบของแบบอักษร
![ข้อความไม่ถูกตัดโดยใช้แบบอักษรขนาดใหญ่](https://developer.android.com/static/jetpack/androidx/images/IncludeFontPadding-False.png?hl=th)
- เราได้อัปเดต
wear.compose.foundation
เป็นทรัพยากร Dependency ของ API ของwear.compose.material
(I72004, b/285404743) แล้ว - เราได้แก้ไขข้อบกพร่องใน
SwipeToDismissBox
ตอนนี้ระบบส่งคีย์พื้นหลังและคีย์เนื้อหาไปยังบล็อกจำเพื่อสร้างตัวแก้ไขใหม่เมื่อเนื้อหาหรือพื้นหลังมีการเปลี่ยนแปลง (Ib876c, b/280392104) - เราได้อัปเดต
TimeText
ให้ใช้ภาษาเมื่อเลือกรูปแบบสำหรับเวลา 12 หรือ 24 ชั่วโมง (If4a3d) - เราได้แก้ไขความไม่สอดคล้องกันในพารามิเตอร์เริ่มต้นของ
contentScrimColor
แล้วSwipeToDismissBox
รายการ (I2d70f) - เราได้ปรับปรุงการจัดการการเคลื่อนไหวใน
SwipeToReveal
(I28fb7)
ปัญหาที่ทราบ
- การรองรับขนาดแบบอักษรที่กําหนดโดยผู้ใช้เป็นข้อกําหนดในการช่วยเหลือพิเศษ เราทราบดีว่าชิปหลายบรรทัดอาจทำให้เกิดการตัดข้อความเมื่อแสดงด้วยแบบอักษรขนาดใหญ่ เราจึงจะอัปเดตชิปในเวอร์ชันอัลฟ่า 1.3 ในช่วงต้นๆ เพื่อปรับความสูงในกรณีเหล่านั้น
เวอร์ชัน 1.2
เวอร์ชัน 1.2.1
18 ตุลาคม 2023
ปล่อย androidx.wear.compose:compose-*:1.2.1
แล้ว เวอร์ชัน 1.2.1 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- แก้ไขข้อบกพร่องเมื่อ
PositionIndicator
หายไปอย่างไม่ถูกต้อง (7a167f)
เวอร์ชัน 1.2.0
9 สิงหาคม 2023
ปล่อย androidx.wear.compose:compose-*:1.2.0
แล้ว เวอร์ชัน 1.2.0 มีคอมมิตเหล่านี้
การเปลี่ยนแปลงที่สำคัญตั้งแต่เวอร์ชัน 1.1.0
- Compose เวอร์ชันเสถียรสำหรับ Wear OS 1.2.0 (อ่านเพิ่มเติม)
- ดูรายการการเปลี่ยนแปลงที่สำคัญใน Wear Compose 1.2 ได้ในบันทึกประจำรุ่นของ (Compose สำหรับ Wear OS 1.2 Beta01)
เวอร์ชัน 1.2.0-rc01
26 กรกฎาคม 2023
ปล่อย androidx.wear.compose:compose-*:1.2.0-rc01
แล้ว เวอร์ชัน 1.2.0-rc01 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- เราได้สรุปโปรไฟล์พื้นฐานของรุ่น 1.2 (Id5740) แล้ว
เวอร์ชัน 1.2.0-beta02
7 มิถุนายน 2023
ปล่อย androidx.wear.compose:compose-*:1.2.0-beta02
แล้ว เวอร์ชัน 1.2.0-beta02 มีการคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- เราได้เพิ่มตัวแปร
LocalReduceMotion
CompositionLocal
ทดลองใหม่ ซึ่งจะปิดใช้การปรับสเกลและการจางลงในScalingLazyColumn
(I58024)
แก้ไขข้อบกพร่อง
- เราได้อัปเดตโปรไฟล์พื้นฐานสำหรับ Wear Compose Foundation และไลบรารี Material(I4725d)
- เราได้แก้ไขความไม่สอดคล้องกันของค่าเริ่มต้นสำหรับพารามิเตอร์
SwipeToDismissBox
contentScrimColor
(I2d70f) - เราได้แก้ไขค่าเริ่มต้น
DefaultTextStyle
ที่ใช้สำหรับการตั้งค่าIncludeFontPadding
(I737ed)
เวอร์ชัน 1.2.0-beta01
24 พฤษภาคม 2023
ปล่อย androidx.wear.compose:compose-*:1.2.0-beta01
แล้ว เวอร์ชัน 1.2.0-beta01 มีการคอมมิตเหล่านี้
ฟีเจอร์ Compose สำหรับ Wear OS 1.2
Compose สำหรับ Wear OS รุ่น 1.2-beta01 ระบุว่าไลบรารีรุ่นนี้มีฟีเจอร์สมบูรณ์และ API ถูกล็อก (ยกเว้นที่ระบุว่าเป็นเวอร์ชันทดลอง) Wear Compose 1.2 มีฟังก์ชันการทำงานใหม่ต่อไปนี้
expandableItem
และexpandableItems
เป็นคอมโพเนนต์Foundation
ใหม่ 2 รายการที่รองรับการขยายรายการภายในScalingLazyColumn
ใช้expandableItem
สําหรับรายการที่ขยายได้รายการเดียว เช่น ข้อความที่จํานวนบรรทัด ใช้expandableItems
สำหรับกลุ่มรายการที่ขยายได้ และใช้expandableButton
เพื่อลดความซับซ้อนในการสร้างปุ่มที่ยุบหลังจากขยายเนื้อหาHierarchicalFocusCoordinator
- Composable รุ่นทดลองนี้เปิดใช้การทำเครื่องหมายแผนผังย่อยขององค์ประกอบเป็นเปิดใช้โฟกัสหรือปิดใช้โฟกัสPicker
- ตอนนี้ API มีuserScrollEnabled
เพื่อควบคุมว่าจะให้เครื่องมือเลือกเปิดใช้งานสำหรับการเลื่อนผู้ใช้หรือไม่PickerGroup
- Composable ใหม่สำหรับจัดการเครื่องมือเลือกหลายรายการร่วมกัน จัดการโฟกัสระหว่างเครื่องมือเลือกโดยใช้HierarchicalFocusCoordinator
API และเปิดใช้การจัดกึ่งกลางรายการเครื่องมือเลือกโดยอัตโนมัติPlaceholder
- เราได้อัปเดตภาพเคลื่อนไหวระยิบระยับและภาพเคลื่อนไหวแบบ "กวาดปิด" ตอนนี้เอฟเฟกต์ล้างข้อมูลจะถูกนำไปใช้ทันทีเมื่อเนื้อหาพร้อมScalingLazyColumn
- เราได้ย้ายข้อมูลScalingLazyColumn
และชั้นเรียนที่เกี่ยวข้องจากandroidx.wear.compose.material.ScalingLazyColumn
ไปยังandroidx.wear.compose.foundation.lazy.ScalingLazyColumn
แล้ว โปรดอัปเดตเพื่อใช้เวอร์ชันFoundation.Lazy
SwipeToReveal
- เราได้เพิ่มการรองรับการทดลองสำหรับการเลื่อนเพื่อแสดงวิธีการในการเข้าถึงการกระทำรอง ซึ่งเป็นเสริมรูปแบบ "การกดค้าง" ที่มีอยู่Stepper
- ตอนนี้มีโอเวอร์โหลดที่มีพารามิเตอร์enableRangeSemantics
เพิ่มเติมเพื่ออำนวยความสะดวกในการปิดใช้ความหมายของช่วงเริ่มต้นPreviews
- เราได้เพิ่มคำอธิบายประกอบที่กำหนดเองต่อไปนี้สำหรับการแสดงตัวอย่าง Composable บนหน้าจอ Wear:WearPreviewSmallRound
แสดงตัวอย่าง Composable ในอุปกรณ์ทรงกลมขนาดเล็กWearPreviewLargeRound
แสดงตัวอย่าง Composable ในอุปกรณ์ทรงกลมขนาดใหญ่WearPreviewSquare
แสดงตัวอย่าง Composable ในอุปกรณ์สี่เหลี่ยมจัตุรัส นอกจากนี้ คำอธิบายประกอบและคำอธิบายประกอบแบบหลายตัวอย่างต่อไปนี้WearPreviewFontScales
จะแสดงตัวอย่าง Composable ในอุปกรณ์ Wear ที่มีแบบอักษรหลายขนาด ขณะที่WearPreviewDevices
แสดงตัวอย่าง Composable ในอุปกรณ์ Wear ที่แตกต่างกัน- เราได้เพิ่ม
DefaultTextStyle
ลงใน Wear Compose ซึ่งกำหนดค่าเริ่มต้นให้กับพร็อพเพอร์ตี้PlatformTextStyle.includeFontPadding
เป็น true (นี่คือการตั้งค่าปัจจุบัน) ซึ่งจะช่วยให้เราซิงค์การปิดระยะห่างจากขอบของแบบอักษรโดยค่าเริ่มต้นกับไลบรารี Compose ในเวอร์ชันอัลฟ่า 1.3 ในช่วงต้น โปรดดูข้อมูลเพิ่มเติมที่ 1.2.0-alpha10
ฟีเจอร์ใหม่
- เราได้เพิ่มการสนับสนุนการทดลองสำหรับการปรับขนาดที่ปิดและภาพเคลื่อนไหวที่ค่อยๆ จางลงเมื่อเปิดการตั้งค่าReduce_motion (I58024)
แก้ไขข้อบกพร่อง
- ปรับปรุงเอกสารประกอบสำหรับ
angularWidthDp
ในCurvedSize.kt
(Iab75c) - ขณะนี้
SwipeDismissableNavHost
จะบันทึกคำเตือนพร้อมสาเหตุที่เป็นไปได้ของ Backstack ที่ว่างเปล่า การดำเนินการนี้มีไว้เพื่อป้องกันไม่ให้เกิดข้อขัดข้องที่ไม่คาดคิดซึ่งเกิดจาก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
ไปยัง Action Composable ในSwipeToReveal
ซึ่งช่วยให้เข้าถึงออฟเซ็ตที่มีการแสดงการดำเนินการเพิ่มเติม (I3fd56)
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาเกี่ยวกับ
ScalingLazyColumn
ที่ค้างอยู่ใน Wear API 33 หลังจากการสะบัด (Ic4599) - เราได้ทําการปรับปรุงประสิทธิภาพบางอย่างใน
PositionIndicator
สําหรับการลดการกระตุก (I35e92) - เราได้แก้ไขข้อบกพร่องในชิปและ
CompactChip
ซึ่งไม่ได้ตั้งบทบาทเชิงความหมายเป็นRole.Button
อีกต่อไป (I93f91, b/277326264)
ปัญหาที่ทราบ
เราตรวจพบข้อบกพร่องใน Android Studio ซึ่งทำให้การแสดงตัวอย่างในการแสดงผลล้มเหลวเมื่อมีการใส่คำอธิบายประกอบด้วย @WearPreview Devices และ @WearPreviewFontScales สำหรับ @WearPreviewFontScales ในอนาคต เราวางแผนที่จะเปิดตัวการแก้ไขในเร็วๆ นี้ โปรดทราบว่าคำอธิบายประกอบการแสดงตัวอย่างการสวมใส่อื่นๆ ทำงานได้ตามที่ต้องการใน Android Studio Giraffe 2022.3.1 เป็นต้นไป
ในเวอร์ชัน 1.2.0-alpha07 เราได้เพิ่ม DefaultTextStyle ลงใน Wear Compose โดยยังคงค่า PlatformTextStyle.includeFontPadding ที่มีอยู่เป็น true เอาไว้สำหรับพื้นหลัง โปรดดูแก้ไขระยะห่างจากขอบของแบบอักษรใน Compose เราจะเปลี่ยนแปลง DefaultTextStyle เพื่อปิดระยะห่างจากขอบของแบบอักษรในเวอร์ชันอัลฟ่า 1.3 ในช่วงต้น เพื่อให้สอดคล้องกับแพลตฟอร์ม Android วิธีนี้จะช่วยแก้ไขบางกรณีของการตัดข้อความที่มีแบบอักษรขนาดใหญ่และยังอาจส่งผลต่อการจัดวางหน้าจอ การทดสอบภาพหน้าจอจึงต้องได้รับการอัปเดต ตัวอย่างเช่น ด้วยแบบอักษรขนาดใหญ่ เราจะเห็นข้อความที่ถูกตัดออกที่นี่:
![ข้อความถูกตัดโดยใช้ตัวอักษรขนาดใหญ่](https://developer.android.com/static/jetpack/androidx/images/IncludeFontPadding-True.png?hl=th)
- ซึ่งจะไม่แสดงอีกต่อไปเมื่อปิดระยะห่างจากขอบของแบบอักษร
![ข้อความไม่ถูกตัดโดยใช้แบบอักษรขนาดใหญ่](https://developer.android.com/static/jetpack/androidx/images/IncludeFontPadding-False.png?hl=th)
ตอนนี้คุณนำการตั้งค่าใหม่มาใช้ได้โดยการลบล้างการพิมพ์ในธีมของคุณ ดูโค้ดตัวอย่าง
เวอร์ชัน 1.2.0-alpha09
19 เมษายน 2023
ปล่อย androidx.wear.compose:compose-*:1.2.0-alpha09
แล้ว เวอร์ชัน 1.2.0-alpha09 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- เพิ่ม
angularSizeDp
ไปยังCurvedModifier
API เพื่อตั้งค่าความกว้างมุมเชิงมุมใน DP (I89a52)
แก้ไขข้อบกพร่อง
- เราได้แก้ไขปัญหาเกี่ยวกับการช่วยเหลือพิเศษในการสาธิตเครื่องมือเลือกเวลา(Id0eb7)
เวอร์ชัน 1.2.0-alpha08
5 เมษายน 2023
ปล่อย androidx.wear.compose:compose-*:1.2.0-alpha08
แล้ว เวอร์ชัน 1.2.0-alpha08 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- เราได้เปลี่ยนชื่อ
ExpandableItemsState
เป็นExpandableState
(If85ea) - เราได้เพิ่ม
expandableButton
เพื่อลดความซับซ้อนในการสร้างปุ่มที่ยุบเมื่อขยายเนื้อหา รวมถึงอัปเดตตัวอย่างที่ขยายได้ (Iae309)
แก้ไขข้อบกพร่อง
- ตัวอย่างที่ขยายได้ที่ปรับปรุงแล้วเพื่อแสดงความเป็นไปได้เพิ่มเติม ภาพเคลื่อนไหวที่แก้ไขแล้วของ
expandableItem
เพื่อรักษาเนื้อหาให้อยู่ตรงกลางผ่านภาพเคลื่อนไหว (I2f637) - อัปเดต
ToggleControls
เพื่อหลีกเลี่ยงการจัดองค์ประกอบใหม่เพิ่มเติมเมื่อทำให้สีเคลื่อนไหวด้วยตนเองโดยใช้สถานะ (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 (นี่คือการตั้งค่าปัจจุบัน) ซึ่งจะช่วยให้เราซิงค์ข้อมูลการปิดระยะห่างจากขอบของแบบอักษรโดยค่าเริ่มต้นกับไลบรารีของ Compose ได้ในอนาคต โปรดดู (แก้ไขระยะห่างจากขอบของแบบอักษรใน Compose) สำหรับพื้นหลัง (I2aee8) - เปลี่ยนกลับทรัพยากร Dependency ของ
UpsideDownCake
ผ่าน activity-compos ที่บล็อกการเผยแพร่แอปไปยัง Google Play Store (I6443D)
เวอร์ชัน 1.2.0-alpha06
8 มีนาคม 2023
ปล่อย androidx.wear.compose:compose-*:1.2.0-alpha06
แล้ว เวอร์ชัน 1.2.0-alpha06 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- เพิ่มคอมโพเนนต์
CurvedBox
ซึ่งจะวางคอมโพเนนต์ซ้อนกันในโลกโค้ง (I29200) - เพิ่มรายการที่ขยายได้ - คอมโพเนนต์ใหม่ 2 รายการเพื่อรองรับกลุ่มรายการที่ขยายได้ใน
ScalingLazyColumn
หรือรายการที่ขยายได้รายการเดียว เช่น ข้อความที่เพิ่มจำนวนบรรทัด (I95dd5) - เราได้เพิ่มคำอธิบายประกอบที่กำหนดเองสำหรับการแสดงตัวอย่าง Composable ในหน้าจอ Wear โดย
WearPreviewSmallRound
แสดงตัวอย่าง Composable ในอุปกรณ์ทรงกลมขนาดเล็กWearPreviewLargeRound
แสดงตัวอย่าง Composable ในอุปกรณ์ทรงกลมขนาดใหญ่WearPreviewSquare
แสดงตัวอย่าง Composable ในอุปกรณ์สี่เหลี่ยมจัตุรัส นอกจากนี้ คำอธิบายประกอบและคำอธิบายประกอบแบบหลายตัวอย่างต่อไปนี้WearPreviewFontScales
จะแสดงตัวอย่าง Composable ในอุปกรณ์ Wear ที่มีแบบอักษรหลายขนาด ขณะที่WearPreviewDevices
แสดงตัวอย่าง Composable ในอุปกรณ์ 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
- อัปเดต
PickerGroup
API เพื่ออนุญาตให้เผยแพร่ข้อจำกัดขั้นต่ำไปยัง Composable ที่ไม่บังคับได้ เมื่อตั้งค่าเป็น "จริง" ข้อจำกัดขั้นต่ำที่ส่งผ่านจาก Composable ระดับบนจะได้รับอนุญาตในPickerGroup
หากตั้งค่าเป็น "เท็จ"PickerGroup
จะรีเซ็ตข้อจำกัดขั้นต่ำ (I3e046) - เราได้เพิ่ม
animateScrollToOption
ลงใน Picker API เพื่อรองรับการสร้างภาพเคลื่อนไหวแบบเป็นโปรแกรมของตัวเลือกเครื่องมือเลือกที่เฉพาะเจาะจง (I6fe67)
แก้ไขข้อบกพร่อง
- เราได้อัปเดต
HorizontalPageIndicator
เพื่อให้รองรับเลย์เอาต์แบบขวาไปซ้าย (Ia4359) - เพิ่มการทดสอบภาพหน้าจอสำหรับเลย์เอาต์จากขวาไปซ้ายใน
HorizontalPageIndicator
(I6fbb8) - เพิ่มการทดสอบเพิ่มเติมไปยัง
SwipeDismissableNavHostTest
ที่ใช้TestNavHostController
(I61d54)
เวอร์ชัน 1.2.0-alpha04
8 กุมภาพันธ์ 2023
ปล่อย androidx.wear.compose:compose-*:1.2.0-alpha04
แล้ว เวอร์ชัน 1.2.0-alpha04 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
PickerGroup
สำหรับการจัดการเครื่องมือเลือกหลายรายการร่วมกันโดยใช้โฟกัส API โดยจะจัดการโฟกัสระหว่างเครื่องมือเลือกต่างๆ เปิดใช้การจัดกึ่งกลางเครื่องมือเลือกโดยอัตโนมัติโดยอิงตามพารามิเตอร์ และช่วยให้นักพัฒนาแอปเปลี่ยนโฟกัสระหว่างเครื่องมือเลือกต่างๆ ไปพร้อมกับจัดการเหตุการณ์จากกลุ่มได้ ในโหมด TalkBackPickerGroup
จะจัดการโฟกัสของ TalkBack โดยย้ายโฟกัสไปยังเครื่องมือเลือกที่เลือกจากกลุ่ม (I60840)
การเปลี่ยนแปลง API
- เราได้เพิ่มการโอเวอร์โหลดลงใน Stepper ด้วยพารามิเตอร์
enableRangeSemantics
เพิ่มเติมเพื่ออำนวยความสะดวกในการปิดใช้ความหมายของช่วงเริ่มต้น (Ia61d4)
แก้ไขข้อบกพร่อง
- อนุญาตให้ฝัง
ScalingLazyColumn
ในหน้าที่เลื่อนในแนวนอน (Iec3f8, b/266555016) - ปรับปรุงการล้างข้อมูลการทดสอบของ Stepper kdocs และ
StepperTest
(Ic118e) - อัปเดตทรัพยากร Dependency ของ
androidx.navigation
เป็นเวอร์ชัน 2.5.3 (If58ed) แล้ว
เวอร์ชัน 1.2.0-alpha03
25 มกราคม 2023
ปล่อย androidx.wear.compose:compose-*:1.2.0-alpha03
แล้ว เวอร์ชัน 1.2.0-alpha03 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- เราได้ย้ายข้อมูล
ScalingLazyColumn
(และชั้นเรียนที่เกี่ยวข้อง) จากandroidx.wear.compose.material.ScalingLazyColumn
ไปยังandrdoidx.wear.compose.foundation.lazy.ScalingLazyColumn
(ดูตัวอย่างนี้สำหรับการย้ายข้อมูล) ตำแหน่งใหม่นี้ใกล้เคียงกับตำแหน่งของcompose.foundation.lazy.LazyColumn
มากขึ้นและเป็นธรรมชาติมากขึ้นเนื่องจากไม่ใช่คอมโพเนนต์ Material ตามความคิดเห็น การเปลี่ยนแปลงกำลังเกิดขึ้นเพื่อเตรียมพร้อมสำหรับไลบรารี Material3 ใหม่ ซึ่งเราจะดำเนินการควบคู่ไปกับไลบรารี Material ที่มีอยู่เดิม (I060e7)
การเปลี่ยนแปลงต่อไปนี้เป็นส่วนหนึ่งของการย้ายข้อมูล ScalingLazyColumn
จาก Material ไปยัง Foundation.Lazy
- เลิกใช้งาน
PositionIndicator
เนื้อหาการกำหนดเป้าหมาย APIScalingLazyColumn
แล้ว โปรดอัปเดตเป็นFoundation.Lazy ScalingLazyColumn
นอกจากนี้ ได้เพิ่มช่องanchorType
ลงในScalingLazyListLayoutInfo
(I29d95) - ทำเครื่องหมาย
ScalingLazyColumn
ว่าเลิกใช้งานแล้วในแพ็กเกจ Material ของ Wear Compose (I16d34) - เราได้อัปเดตตัวแก้ไข
ScrollAway
เพื่อใช้ScalingLazyListState
จาก Wear ComposeFoundation.Lazy
และเลิกใช้งานโอเวอร์โหลดที่ใช้ScalingLazyListState
จากเนื้อหา Wear Compose (Ifc42c) - เราได้อัปเดต Dialog API ไปใช้
ScalingLazyListState
จากFoundation.Lazy
และเลิกใช้งานโอเวอร์โหลดที่ใช้ MaterialScalingLazyListState
(Ic8960) แล้ว - เราได้อัปเดต API ของเครื่องมือเลือกให้ใช้
ScalingParams
จากFoundation.Lazy
และเลิกใช้งานโอเวอร์โหลดที่ใช้ MaterialScalingParams
แล้ว (Idc3d8)
แก้ไขข้อบกพร่อง
- เราได้แก้ไขข้อบกพร่องที่ทำให้เกิดการจัดองค์ประกอบใหม่ที่ไม่จำเป็นใน
ScalingLazyListState.centerItemIndex
โดยตรวจสอบว่าได้พุชการอัปเดตเฉพาะเมื่อค่ามีการเปลี่ยนแปลงจริงๆ เท่านั้น (Ia9f38) - เราได้ปรับปรุงประสิทธิภาพของ
SwipeToDismissBox
(I3933b) - เพิ่มการทดสอบการเปรียบเทียบสำหรับ
ScalingLazyColumn
ใน Wear Compose Foundation (Ie00f9) - เราได้อัปเดตเมธอดคลาส
ScalingLazyColumn
ภายในบางส่วนใน Material เพื่อใช้ที่เทียบเท่าจากFoundation.Lazy
(I38aab) - เราได้แก้ไขปัญหาบางอย่างในการทดสอบเครื่องมือเลือกและเพิ่มการทดสอบสำหรับการตรวจสอบการเลื่อนที่มีออฟเซ็ต (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
- ตอนนี้การทดสอบ UI ของ Compose ใน Android จะเรียกใช้การส่งเลย์เอาต์สำหรับแต่ละเฟรมเมื่อเรียกใช้เฟรมเพื่อเข้าสู่โหมดไม่มีการใช้งาน (เช่น ผ่าน
waitForIdle
) ซึ่งอาจส่งผลต่อการทดสอบที่ยืนยันในแต่ละเฟรมของภาพเคลื่อนไหวในเลย์เอาต์ (I8ea08, b/222093277) - เพิ่มพารามิเตอร์
minLines
ลงใน Wear Text เพื่อพฤติกรรมที่สอดคล้องกันกับBasicText
(I24874) - ตั้งค่า
CompactChipTapTargetPadding
เป็นแบบสาธารณะแล้วเพื่อให้ปรากฏในเอกสารประกอบ (If1e70, b/234119038)
แก้ไขข้อบกพร่อง
- ปิดใช้บิลด์หลายแพลตฟอร์มสำหรับแพ็กเกจ
wear.compose
(Iad3d7) - แก้ไข kdocs สำหรับ
scrollToOption
(I6f9a0) PlaceholderState.rememberPlaceholderState()
อัปเดตให้ใช้rememberUpdatedState
ว่ารัฐจะอัปเดตหากonContentReady
lambda (I02635, b/260343754)- เราได้แก้ไขปัญหาการกระตุกของข้อความที่พบในคอมโพเนนต์
Picker
โดยการใช้ประโยชน์จากกลยุทธ์การเรียบเรียงใหม่ที่เพิ่มลงในModifier.graphicsLayer
(I99302) - เราได้แก้ไขข้อบกพร่องที่ทำให้เกิดภาพกะพริบในการสาธิต
DatePicker
(I660bd) แล้ว - เราได้ปรับปรุงการเข้าถึงสำหรับการสาธิตเครื่องมือเลือกวันที่แบบ 12 ชั่วโมง (I05e12)
- เราได้อัปเดตการสาธิตเครื่องมือเลือกเวลาและวันที่เพื่อให้เครื่องมือเลือกไม่ได้รับผลกระทบจากการเปลี่ยนแปลง RSB เมื่อไม่ได้เลือก (I4aecb)
เวอร์ชัน 1.2.0-alpha01
7 ธันวาคม 2022
ปล่อย androidx.wear.compose:compose-*:1.2.0-alpha01
แล้ว เวอร์ชัน 1.2.0-alpha01 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- เราได้อัปเดตฟังก์ชันการทำงานของตัวยึดตำแหน่งเวอร์ชันทดลองเพื่อให้เอฟเฟกต์ “กวาดปิด” มีผลทันทีเมื่อเนื้อหาพร้อม แทนที่จะต้องรอให้ภาพเคลื่อนไหววนซ้ำใหม่เริ่มขึ้น นอกจากนี้ เรายังอัปเดตภาพเคลื่อนไหวที่วาววับและล้างข้อมูลออกด้วย (I5a7f4)
การเปลี่ยนแปลง API
- เราได้เพิ่ม
HierarchicalFocusCoordinator
Composable เพื่อเปิดใช้การทำเครื่องหมายแผนผังย่อยขององค์ประกอบเป็นเปิดใช้โฟกัสหรือปิดใช้โฟกัส (I827cb) - เราได้เพิ่มพร็อพเพอร์ตี้ใหม่เพื่อลบล้างบทบาทเชิงความหมายสำหรับ
ToggleButton
(I67132) - เราได้ปรับปรุง
TimeTextDefaults.TimeFormat12Hours
เพื่อนำ AM/PM ในTimeText
ออก การดำเนินการนี้จะเปลี่ยนค่าเริ่มต้นของพารามิเตอร์timeSource
ในTimeText
API (I1eb7f) - เราได้ขยาย Picker API เพื่อปรับปรุงการเข้าถึงสำหรับหน้าจอที่มีตัวเลือกหลายรายการ มีพร็อพเพอร์ตี้ใหม่
userScrollEnabled
เพื่อควบคุมว่าเครื่องมือเลือกเปิดใช้งานสำหรับการเลื่อนผู้ใช้หรือไม่ (I3c3aa)
แก้ไขข้อบกพร่อง
- เราได้เปลี่ยนความกว้างเส้นขอบเริ่มต้นของ
OutlinedButton/OutlinedCompactButton
จาก 2.dp เป็น 1.dp เพื่อให้ตรงกับข้อกำหนดของ UX สุดท้าย (Icf84d) - เราได้เพิ่ม
autoCentering topPadding
โดยประมาณเมื่อเนื้อหาว่างเปล่า เพื่อลดผลกระทบของรายการแรกที่เพิ่มไปยังScalingLazyColumn
ที่ว่างเปล่าซึ่งจะปรากฏขึ้นเพื่อให้เลื่อนเข้าไป การเปลี่ยนแปลงนี้จะคำนวณระยะห่างจากขอบด้านบนที่ต้องใช้โดยสมมติว่ารายการความสูงเริ่มต้น 0.dp สำหรับScalingLazyListAnchorType.ItemStart
ฟังก์ชันนี้จะคำนวณระยะห่างจากขอบด้านบนที่ถูกต้อง สำหรับScalingLazyListAnchorType.ItemCenter
การคำนวณนี้จะไม่ถูกต้อง เนื่องจากจำเป็นต้องมีความสูงของรายการเพื่อปรับขนาดเนื้อหาให้ถูกต้อง ซึ่งส่งผลให้มีการเลื่อนขนาดเล็กลงตามความสูงจริงของรายการ (I239a4) - เราได้อัปเดต Scrim พื้นหลังที่ใช้กับภาพเคลื่อนไหว
SwipeToDismiss
เพื่อให้ตรงกับแพลตฟอร์ม Wear (I9003e) - เราได้แก้ไข
PositionIndicator
การจัดการLazyListState
และScalingLazyListState
สำหรับรายการขนาด 0 เพื่อหลีกเลี่ยงการหารด้วย 0 ข้อผิดพลาด (Ic28dd)
เวอร์ชัน 1.1
เวอร์ชัน 1.1.2
8 กุมภาพันธ์ 2023
ปล่อย androidx.wear.compose:compose-foundation:1.1.2
, androidx.wear.compose:compose-material:1.1.2
และ androidx.wear.compose:compose-navigation:1.1.2
แล้ว เวอร์ชัน 1.1.2 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- เราได้แก้ไขข้อบกพร่องที่ทำให้เกิดการจัดองค์ประกอบใหม่ที่ไม่จำเป็นใน
ScalingLazyListState.centerItemIndex
โดยตรวจสอบว่าได้พุชการอัปเดตเฉพาะเมื่อค่ามีการเปลี่ยนแปลงจริงๆ เท่านั้น (Ia9f38)
เวอร์ชัน 1.1.1
11 มกราคม 2023
ปล่อย androidx.wear.compose:compose-foundation:1.1.1
, androidx.wear.compose:compose-material:1.1.1
และ androidx.wear.compose:compose-navigation:1.1.1
แล้ว เวอร์ชัน 1.1.1 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
PlaceholderState.rememberPlaceholderState()
อัปเดตให้ใช้rememberUpdatedState
ว่ารัฐจะอัปเดตหากonContentReady
lambda (I02635, b/260343754)
เวอร์ชัน 1.1.0
7 ธันวาคม 2022
ปล่อย androidx.wear.compose:compose-foundation:1.1.0
, androidx.wear.compose:compose-material:1.1.0
และ androidx.wear.compose:compose-navigation:1.1.0
แล้ว เวอร์ชัน 1.1.0 มีคอมมิตเหล่านี้
การเปลี่ยนแปลงที่สำคัญตั้งแต่เวอร์ชัน 1.0.0
- Compose เวอร์ชันเสถียรสำหรับ Wear OS 1.1.0 (อ่านเพิ่มเติม)
- ดูรายการการเปลี่ยนแปลงที่สำคัญใน Wear Compose 1.1 ได้ในบันทึกประจำรุ่นของ (Compose for Wear OS 1.1 Beta01)
ฟีเจอร์ใหม่
- เราได้อัปเดตฟังก์ชันการทำงานของตัวยึดตำแหน่งเวอร์ชันทดลองเพื่อให้เอฟเฟกต์ “กวาดปิด” มีผลทันทีเมื่อเนื้อหาพร้อม แทนที่จะต้องรอให้ภาพเคลื่อนไหววนซ้ำใหม่เริ่มขึ้น นอกจากนี้ เรายังอัปเดตภาพเคลื่อนไหวที่วาววับและล้างข้อมูลออกด้วย (I5a7f4)
แก้ไขข้อบกพร่อง
- เราได้เปลี่ยนความกว้างเส้นขอบเริ่มต้นของ
OutlinedButton/OutlinedCompactButton
จาก 2.dp เป็น 1.dp เพื่อให้ตรงกับข้อกำหนดของ UX สุดท้าย (Icf84d) - เราได้เพิ่ม
autoCentering topPadding
โดยประมาณเมื่อเนื้อหาว่างเปล่า เพื่อลดผลกระทบของรายการแรกที่เพิ่มไปยังScalingLazyColumn
ที่ว่างเปล่าซึ่งจะปรากฏขึ้นเพื่อให้เลื่อนเข้าไป การเปลี่ยนแปลงนี้จะคำนวณระยะห่างจากขอบด้านบนที่ต้องใช้โดยสมมติว่ารายการความสูงเริ่มต้น 0.dp สำหรับScalingLazyListAnchorType.ItemStart
ฟังก์ชันนี้จะคำนวณระยะห่างจากขอบด้านบนที่ถูกต้อง สำหรับScalingLazyListAnchorType.ItemCenter
การคำนวณนี้จะไม่ถูกต้อง เนื่องจากจำเป็นต้องมีความสูงของรายการเพื่อปรับขนาดเนื้อหาให้ถูกต้อง ซึ่งส่งผลให้มีการเลื่อนขนาดเล็กลงตามความสูงจริงของรายการ (I239a4) - เราได้อัปเดต Scrim พื้นหลังที่ใช้กับภาพเคลื่อนไหว
SwipeToDismiss
เพื่อให้ตรงกับแพลตฟอร์ม Wear (I9003e) - เราได้แก้ไข
PositionIndicator
การจัดการLazyListState
และScalingLazyListState
สำหรับรายการขนาด 0 เพื่อหลีกเลี่ยงการหารด้วย 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) - เราได้เพิ่มเอกสารประกอบและตัวอย่างไปยังตัวยึดตำแหน่งเพื่อแสดงการจัดลำดับที่ถูกต้องสำหรับ
Modifier.placeholder
และModifier.placeholderShimmer
เมื่อใช้กับ Composable เดียวกัน (Ie96f4, b/256583229) - เราได้เปลี่ยนความกว้างเส้นขอบเริ่มต้นของ
OutlinedCompactChip/OutlinedChip
จาก 2.dp เป็น 1.dp เพื่อให้ตรงกับข้อกำหนดของ UX สุดท้าย (Ib3d8e) - เราได้แก้ไขข้อบกพร่องใน
rememberPickerState
ตรงที่ไม่มีการบันทึกอินพุตที่อัปเดต ดังนั้น Composable จึงไม่อัปเดตหลังจากมีการเปลี่ยนแปลงอินพุต (I49ff6, b/255323197) - เราได้อัปเดต UI บางส่วนในตัวยึดตำแหน่ง 1) เปลี่ยนการไล่ระดับสีแวววาวเป็น 1.5 เท่าของขนาดหน้าจอ 2) เพิ่มการค่อยๆ เปลี่ยน (ลูกบาศก์เบซิเยร์) และ 3) เร่งภาพเคลื่อนไหวแบบเลื่อนออก (250 มิลลิวินาที) (Id29c1)
- เราได้แก้ไขข้อบกพร่องของ UI ในเอฟเฟกต์ placeholderWipeOff ที่พื้นหลังของชิปและการ์ดเลื่อนออกเร็วขึ้นเล็กน้อยเนื่องจากไม่ได้นำตำแหน่งคอมโพเนนต์บนหน้าจอมาพิจารณา (I2c7cb)
- เราได้อัปเดตการวาดพื้นหลังของตัวยึดตําแหน่งเพื่อรวมสีต่างๆ แทนการเลือกเลเยอร์เหล่านั้นเมื่อเป็นไปได้ เพื่อลดความเสี่ยงในการผสานชั้นอัลฟ่าของเลเยอร์ต่างๆ ที่ครอบตัดแล้วไม่ให้สีที่อยู่เบื้องหลังสามารถแสดงออกมาตรงขอบพื้นหลังของตัวยึดตําแหน่ง (I2ea26)
- เราได้แก้ไขการคำนวณ
ScalingLazyListState.centerItemIndex/centerItemOffset
เพื่อที่ว่า หากมี 2 รายการอยู่ที่ด้านข้างของเส้นกึ่งกลางวิวพอร์ต รายการแรกที่ใกล้ที่สุดจะถือเป็นcenterItem
(I30709, b/254257769) - เราได้แก้ไขข้อบกพร่องใน
ScalingLazyListState.layoutInfo.visibleItemsInfo
ซึ่งรายงานการชดเชยที่ไม่ถูกต้องในระหว่างการเริ่มต้นScalingLazyColumn
ตอนนี้ระบบจะส่งคืนรายการที่ว่างเปล่าจนกว่ารายการทั้งหมดจะแสดงและมีออฟเซ็ตที่ถูกต้อง การตรวจสอบScalingLazyListState.layoutInfo.visibleItemsInfo.isNotEmpty()
จะยืนยันว่าการเริ่มต้นScalingLazyColumn
เสร็จสมบูรณ์และแสดงรายการได้ (I3a3b8)
เวอร์ชัน 1.1.0-beta01
24 ตุลาคม 2022
ปล่อย androidx.wear.compose:compose-foundation:1.1.0-beta01
, androidx.wear.compose:compose-material:1.1.0-beta01
และ androidx.wear.compose:compose-navigation:1.1.0-beta01
แล้ว เวอร์ชัน 1.1.0-beta01 มีการคอมมิตเหล่านี้
ฟีเจอร์ Compose สำหรับ Wear OS 1.1
1.1.0-beta01 ของ Compose สำหรับ Wear OS ระบุว่าไลบรารีรุ่นนี้มีฟีเจอร์สมบูรณ์และ API ล็อกอยู่
- รุ่น Wear Compose 1.1 มีฟังก์ชันใหม่ต่อไปนี้
- เครื่องมือเลือก - ปรับปรุงการเข้าถึงเครื่องมือเลือก เพื่อให้ไปยังส่วนต่างๆ ของหน้าจอที่มีตัวเลือกหลายรายการได้ด้วยโปรแกรมอ่านหน้าจอ และเข้าถึงคำอธิบายเนื้อหาได้
- ตอนนี้พารามิเตอร์เครื่องมือเลือก
contentDescription
จะใช้กับตัวเลือกเครื่องมือเลือกที่เลือกเท่านั้น และใช้สตริงที่เป็นค่าว่าง (ในคอมมิตก่อนหน้า คุณต้องส่งการแมปจากตัวเลือกไปยังคําอธิบายเนื้อหา แต่ใช้เฉพาะตัวเลือกที่เลือกเท่านั้น) - ตอนนี้รายการในเครื่องมือเลือกจะอยู่ในแนวกึ่งกลางเสมอ การแก้ไขข้อบกพร่องเมื่อตั้งค่า
gradientRatio
เป็น 0 จะทำให้เกิดผลข้างเคียงจากการเปลี่ยนการจัดข้อความ Chip/ToggleChip
- เราได้อัปเดตการไล่ระดับสีเริ่มต้นสำหรับChip/ToggleChip
เพื่อให้เป็นไปตามข้อกำหนด UX ล่าสุดChipDefaults.gradientBackgroundChipColors
ได้รับการอัปเดตให้เริ่มจาก 50% ของภาษาหลัก แทนที่จะเป็น 32.5%Chip/ToggleChip
- เพิ่มโอเวอร์โหลดสำหรับการแก้ไขรูปร่างชิปChip/Button/ToggleButton
- เพิ่มสไตล์เส้นขอบใหม่สำหรับชิปและปุ่ม รวมถึง Composable ของOutlinedChip
และOutlinedButton
ที่มีChip/Button
แบบโปร่งใสพร้อมเส้นขอบบาง- การ์ด - อัปเดตการไล่ระดับสีเริ่มต้นสำหรับการ์ดให้สอดคล้องกับข้อกำหนด UX ล่าสุด
CardDefaults.cardBackgroundPainter
ได้รับการอัปเดตให้เริ่มจาก 30% ของหลักและสิ้นสุดที่ 20% ของonSurfaceVariant
(จากเดิม 20% เป็น 10%onSurfaceVariant
)ToggleChip.toggleChipColors
เปลี่ยนจากการไล่ระดับสีแบบเส้นตรงของพื้นผิว 75% เป็นพื้นผิวหลัก 32.5% เป็นพื้นผิว 0% เป็นพื้นผิว 50% หลัก Button/ToggleButton
- เพิ่มคุณสมบัติสำหรับการแก้ไขรูปร่างของปุ่ม- ธีม - อัปเดตสีเริ่มต้นจำนวนหนึ่งใน
MaterialTheme
เพื่อปรับปรุงการช่วยเหลือพิเศษเนื่องจากสีเดิมมีคอนทราสต์ไม่เพียงพอซึ่งทำให้ผู้ใช้แยกความแตกต่างระหว่างพื้นหลังของชิป/การ์ด/ปุ่มจากสีพื้นหลังของธีมได้ InlineSlider/Stepper
- เพิ่มบทบาทของปุ่มเพื่อให้Talkback
ระบุได้ว่าเป็นปุ่ม- นั่งร้าน -
PositionIndicator
มีการวางตำแหน่งและปรับขนาดเพื่อให้ใช้พื้นที่ที่จำเป็นเท่านั้น วิธีนี้มีประโยชน์ เช่น หากมีการเพิ่มข้อมูลเชิงอรรถศาสตร์ ตอนนี้ TalkBack จะได้รับขอบเขตที่ถูกต้องของPositionIndicator
บนหน้าจอ CurvedText/TimeText
- เพิ่มModifier.scrollAway
ซึ่งเลื่อนรายการในแนวตั้ง/ออกจากมุมมอง ตามสถานะการเลื่อน (มีการโหลดมากเกินไปเพื่อให้ทำงานกับColumn
,LazyColumn
และScalingLazyColumn
) โดยปกติScrollAway
จะใช้ในการเลื่อนTimeText
ออกจากมุมมองเมื่อผู้ใช้เริ่มเลื่อนรายการขึ้นด้านบนCurvedText/TimeText
- เพิ่มการรองรับfontFamily
,fontStyle
และfontSynthesis
ในCurvedTextStyle
ซึ่งใช้งานได้ในcurvedText
และbasicCurvedText
CurvedText/TimeText
- เพิ่มfontWeight
ลงในเครื่องมือสร้างและวิธีคัดลอกในCurvedTextStyle
ToggleControls
- เพิ่มตัวควบคุมปุ่มสลับCheckbox
,Switch
และRadioButton
แบบเคลื่อนไหวสำหรับใช้กับToggleChip
และSplitToggleChip
ซึ่งอาจใช้แทนไอคอนแบบคงที่ของToggleChipDefaults
(switchIcon
,checkboxIcon
และradioIcon
)- ตัวยึดตำแหน่ง - เพิ่มการสนับสนุนตัวยึดตำแหน่งแบบทดลอง โดยมีเอฟเฟกต์ภาพ 3 แบบที่แตกต่างกันซึ่งออกแบบมาให้ทำงานร่วมกัน
- ก่อนอื่น เอฟเฟกต์แปรงพื้นหลังตัวยึดตำแหน่งที่ใช้ในคอนเทนเนอร์ เช่น ชิปและการ์ด เพื่อวาดบนพื้นหลังปกติเมื่อรอให้เนื้อหาโหลด
- ใช้ตัวแก้ไขที่ 2 (
Modifier.placeholder()
) เพื่อวาดวิดเจ็ตตัวยึดตำแหน่งรูปทรงสนามกีฬาที่ด้านบนของเนื้อหาที่กําลังโหลด - ขั้นที่ 3 เอฟเฟกต์การไล่ระดับสี/แวววาวแบบปรับแต่งได้ (
Modifier.placeholderShimmer()
) ที่จะแสดงทับเอฟเฟกต์อื่นๆ เพื่อแสดงให้ผู้ใช้เห็นว่าเรากำลังรอให้ข้อมูลโหลดอยู่- เอฟเฟ็กต์ทั้งหมดเหล่านี้ได้รับการออกแบบให้ประสานกัน ให้ประกายระยิบระยับ และทำให้ตัดกันเป็นเรียบ
- อัปเดตทรัพยากร Dependency ของ Compose จาก 1.2 เป็น 1.3 แล้ว
การเปลี่ยนแปลง API
- ตอนนี้คุณระบุพารามิเตอร์แบบอักษร (
fontFamily
,fontWeight
,fontStyle
และfontSynthesis
) โดยตรงเป็นพารามิเตอร์ของcurvedText
(Idc422) ได้แล้ว
แก้ไขข้อบกพร่อง
curveText
และbasicCurvedText
จะทำงานอย่างถูกต้องกับ talkback (มีโหนด UI เขียนที่มีขนาดเหมาะสมและมีการวาง (แต่ว่างเปล่า) ที่เกี่ยวข้อง โดยใช้ข้อความเป็นคำอธิบายเนื้อหา) (I7af7c, b/210721259)- แก้ไขข้อบกพร่องของ
Picker
เมื่อPickerState.repeatedItems = false
เพื่อเพิ่มการตั้งค่าที่ชัดแจ้งของพารามิเตอร์ autoCentering ในเครื่องมือเลือกภายในScalingLazyColumn
เพื่อให้แน่ใจว่าจะเลื่อนตัวเลือก 0 ไปยังกึ่งกลางของมุมมองได้ (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 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- เราได้เพิ่มการรองรับตัวยึดตำแหน่งเวอร์ชันทดลอง โดยมีเอฟเฟกต์ภาพ 3 แบบที่แตกต่างกันซึ่งออกแบบมาให้ทำงานร่วมกัน ก่อนอื่น เอฟเฟกต์แปรงพื้นหลังตัวยึดตำแหน่งที่ใช้ในคอนเทนเนอร์ เช่น ชิปและการ์ด เพื่อวาดบนพื้นหลังปกติเมื่อรอให้เนื้อหาโหลด ใช้ตัวแก้ไขที่ 2 (
Modifier.placeholder()
) เพื่อวาดวิดเจ็ตตัวยึดตำแหน่งรูปทรงสนามกีฬาที่ด้านบนของเนื้อหาที่กําลังโหลด ขั้นที่ 3 เอฟเฟกต์การไล่ระดับสี/แวววาวแบบปรับแต่งได้ (Modifier.placeholderShimmer()
) ที่จะแสดงทับเอฟเฟกต์อื่นๆ เพื่อแสดงให้ผู้ใช้เห็นว่าเรากำลังรอให้ข้อมูลโหลดอยู่ เอฟเฟ็กต์ทั้งหมดเหล่านี้ได้รับการออกแบบให้ประสานกัน ให้ประกายระยิบระยับ และทำให้ตัดกันเป็นเรียบ (I3c339)
การเปลี่ยนแปลง API
- เพิ่มการรองรับ
fontWeight
,fontFamily
,fontStyle
และfontSynthesis
ในCurvedTextStyle
ใช้ได้บนcurvedText
และbasicCurvedText
โดยสามารถใช้พารามิเตอร์เหล่านั้นเพื่อระบุแบบอักษรและรูปแบบที่จะใช้ในข้อความโค้งได้ (Iaa1a8),(I72759) - อัปเดตพารามิเตอร์ออฟเซ็ตของ
Modifier.scrollAway
เป็น Dp เพื่อให้สอดคล้องกับModifier.offset
(ก่อนหน้านี้เป็นพิกเซล) พร้อมเปลี่ยนโครงสร้างภายในโค้ดเป็นLayoutModifier
เพื่อประสิทธิภาพ (I9f94b) - เราได้เปลี่ยนชื่อ
RadioButton’s circleColor
เป็นringColor
ใน API การควบคุมการสลับแบบใหม่ (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 ของสัญญาณบอกสถานะและตัวแสดงหน้าในนั่งร้านแล้ว ตัวบ่งชี้จะอยู่ด้านบนของวิกเน็ตต์ ขอบมืดจึงจะไม่บดบังหากยังมีวิกเน็ตต์อยู่ (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 เพื่อปรับปรุงการช่วยเหลือพิเศษ เนื่องจากสีเดิมมีคอนทราสต์ไม่เพียงพอซึ่งทำให้ผู้ใช้แยกความแตกต่างระหว่างพื้นหลังของชิป/การ์ด/ปุ่มจากสีพื้นหลังของธีมได้ สีที่อัปเดตได้แก่ display(0xFF202124->0xFF303133), onPrimary(0xFF202124->0xFF303133), onsecondary (0xFF202124->0xFF303133), primaryVariant(0xFF669DF6->0xFF80AB4F8) การเปลี่ยนสีแม้เล็กน้อยมากอาจส่งผลกระทบต่อการทดสอบภาพหน้าจอที่มีอยู่ (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
รวมถึง ComposableOutlinedChip
และOutlinedButton
ใหม่ที่ให้Chip/Button
แบบโปร่งใสพร้อมเส้นขอบบาง (รหัส 5972)
การเปลี่ยนแปลง API
- เพิ่มโอเวอร์โหลดสำหรับการแก้ไขรูปร่างของปุ่ม (Icccde)
แก้ไขข้อบกพร่อง
- เราได้แก้ไขขนาดของพื้นที่ควบคุมการเปิด/ปิดของ
ToggleChip
เนื่องจากไม่ตรงกับข้อกำหนด UX ข้อกำหนด UX กำหนดให้มีแป้นเว้นวรรค 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 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- เราได้เปลี่ยน Compose สำหรับทรัพยากร Dependency ของ Wear OS ในไลบรารีหลักของ Compose จาก 1.2.0 เป็น 1.3.0-alpha0X
การเปลี่ยนแปลง API
- เพิ่มโอเวอร์โหลดสำหรับการแก้ไขรูปร่างชิป (I02e87)
แก้ไขข้อบกพร่อง
- เราได้ทำให้การมองเห็นวิกเน็ตต์เคลื่อนไหวเมื่อแสดง/ซ่อนกล่องโต้ตอบเพื่อให้สอดคล้องกับภาพเคลื่อนไหวสำหรับการปรับขนาดที่มีอยู่ (Ida33e)
- เราแก้ไขข้อบกพร่องที่อาจเกิดการหารด้วยศูนย์ด้วยลักษณะการสะบัดบางฟีเจอร์เมื่อเลื่อน (I86cb6)
- แก้ไขข้อบกพร่องใน
ChipDefaults.childChipColor()
เพื่อให้สีพื้นหลังที่ปิดใช้มีความโปร่งใส 100% (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
เพื่อให้สอดคล้องกับข้อกำหนด UX ล่าสุดChipDefaults.gradientBackgroundChipColors
ได้รับการอัปเดตให้เริ่มจาก 50% ของภาษาหลัก แทนที่จะเป็น 32.5%CardDefaults.cardBackgroundPainter
ได้รับการอัปเดตให้เริ่มจาก 30% ของหลักและสิ้นสุดที่ 20% ของonSurfaceVariant
(จากเดิม 20% เป็น 10%onSurfaceVariant
)ToggleChip.toggleChipColors
เปลี่ยนจากการไล่ระดับสีแบบเส้นตรงของพื้นผิว 75% เป็นพื้นผิวหลัก 32.5% เป็นพื้นผิว 0% เป็นพื้นผิว 50% หลัก (I43bbd) - เราได้เพิ่มสีพื้นหลัง (
MaterialTheme.color.surface
) ไว้หลังChip/ToggleChips
ซึ่งมีพื้นหลังแบบไล่ระดับสีเพื่อให้มองเห็นได้อย่างถูกต้องในกรณีที่มักมีการใช้สีอ่อนด้านหลัง (Ibe1a4, b/235937657) - ตอนนี้รายการในเครื่องมือเลือกจะอยู่ในแนวกึ่งกลางเสมอ การแก้ไขข้อบกพร่องเมื่อตั้งค่า
gradientRatio
เป็น 0 จะทำให้เกิดผลข้างเคียงจากการเปลี่ยนการจัดข้อความ (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 ของสัญญาณบอกสถานะและตัวแสดงหน้าในนั่งร้านแล้ว ตัวบ่งชี้จะอยู่ด้านบนของวิกเน็ตต์ ขอบมืดจึงจะไม่บดบังหากยังมีวิกเน็ตต์อยู่ (Ib988f, b/244207528)
เวอร์ชัน 1.0.1
24 สิงหาคม 2022
ปล่อย androidx.wear.compose:compose-foundation:1.0.1
, androidx.wear.compose:compose-material:1.0.1
และ androidx.wear.compose:compose-navigation:1.0.1
แล้ว เวอร์ชัน 1.0.1 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- แก้ไขข้อบกพร่องด้านตรรกะใน
ScalingLazyColumn
ซึ่งอาจส่งผลให้รายการมีจำนวนรายการน้อย (2 รายการ) ที่ไม่เริ่มต้นให้เสร็จสมบูรณ์และส่งผลให้มีความโปร่งใส (076C61)
เวอร์ชัน 1.0.0
27 กรกฎาคม 2022
ปล่อย androidx.wear.compose:compose-foundation:1.0.0
, androidx.wear.compose:compose-material:1.0.0
และ androidx.wear.compose:compose-navigation:1.0.0
แล้ว เวอร์ชัน 1.0.0 มีคอมมิตเหล่านี้
ฟีเจอร์หลักของ 1.0.0
- Compose สำหรับ Wear OS รุ่นแรกที่มีความเสถียร (อ่านเพิ่มเติม)
- Compose สำหรับ Wear OS สร้างขึ้นจากไลบรารี Compose หลักซึ่งมีคอมโพเนนต์เฉพาะสำหรับอุปกรณ์ที่สวมใส่ได้เพิ่มเติม และการใช้งานคอมโพเนนต์ Compose หลักในรูปแบบอื่นตามความเหมาะสมสำหรับอุปกรณ์ที่สวมใส่ได้
- ดูรายการองค์ประกอบหลักใน Wear Compose ได้ในบันทึกประจำรุ่นของ (Compose สำหรับ Wear OS Beta01)
แก้ไขข้อบกพร่อง
- เราได้ทำให้การมองเห็นวิกเน็ตต์เคลื่อนไหวเมื่อแสดง/ซ่อนกล่องโต้ตอบเพื่อให้สอดคล้องกับภาพเคลื่อนไหวสำหรับการปรับขนาดที่มีอยู่ (Ida33e)
- เราแก้ไขข้อบกพร่องที่อาจเกิดการหารด้วยศูนย์ด้วยลักษณะการสะบัดบางฟีเจอร์เมื่อเลื่อน (I86cb6)
- แก้ไขข้อบกพร่องใน
ChipDefaults.childChipColor()
เพื่อให้สีพื้นหลังที่ปิดใช้มีความโปร่งใส 100% (I2b3c3, b/238057342)
เวอร์ชัน 1.0.0-rc02
22 มิถุนายน 2022
ปล่อย androidx.wear.compose:compose-foundation:1.0.0-rc02
, androidx.wear.compose:compose-material:1.0.0-rc02
และ androidx.wear.compose:compose-navigation:1.0.0-rc02
แล้ว เวอร์ชัน 1.0.0-rc02 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- เราได้แก้ไขทิศทางการไล่ระดับสีสำหรับการ์ดในโหมดขวาไปซ้าย (RTL) แล้ว การตั้งค่าก่อนหน้านี้คือด้านบนซ้าย->ขวาล่าง และตอนนี้อยู่ด้านบนขวา->ล่างซ้าย (Ic2e77)
- เราได้อัปเดตการไล่ระดับสีเริ่มต้นสำหรับ
Chip/ToggleChip/Card
เพื่อให้เป็นไปตามข้อกำหนด UX ล่าสุดChipDefaults.gradientBackgroundChipColors
ได้รับการอัปเดตให้เริ่มจาก 50% ของภาษาหลัก แทนที่จะเป็น 32.5%CardDefaults.cardBackgroundPainter
ได้รับการอัปเดตให้เริ่มจาก 30% ของเวอร์ชันหลักและสิ้นสุดที่ 20% ของonSurfaceVariant
(จากเดิม 20% เป็น 10% ใน SurfaceVariant)ToggleChip.toggleChipColors
เปลี่ยนจากการไล่ระดับสีแบบเส้นตรงของพื้นผิว 75% เป็นพื้นผิวหลัก 32.5% เป็นพื้นผิว 0% เป็นพื้นผิวหลัก 50% (I43bbd) - เราได้เพิ่มสีพื้นหลัง (
MaterialTheme.color.surface
) ไว้หลังChip/ToggleChips
ซึ่งมีพื้นหลังแบบไล่ระดับสีเพื่อให้มองเห็นได้อย่างถูกต้องในกรณีที่มักมีการใช้สีอ่อนด้านหลัง (Ibe1a4, b/235937657) - เราได้อัปเดตกฎโปรไฟล์พื้นฐานที่แพ็กเกจมาพร้อมกับไลบรารี 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
เนื่องจากรายการไปถึงขอบของหน้าจอเพื่อให้ตรงกับการอัปเดตข้อมูลจำเพาะ UX ค่าเดิม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 การเปลี่ยนแปลงนี้จะส่งผลต่อเลย์เอาต์เนื่องจาก CompactChips จะมีระยะห่างจากขอบด้านบนและด้านล่างเพิ่มขึ้น โปรดปรับและทดสอบเลย์เอาต์ หรือดูความคิดเห็นของข้อบกพร่องเพื่อหาวิธีแก้ปัญหาเบื้องต้นในการใช้ลักษณะการทำงานที่มีอยู่ (b/234332135)
แก้ไขข้อบกพร่อง
- เดโมใหม่เพื่อให้ภาพเคลื่อนไหวในการเพิ่มหรือนําข้อความเริ่มต้นใน
TimeText
ออก (I16d75) - เพิ่มการทดสอบสำหรับ
HorizontalPageIndicator.PagesState
(I64ed0) - การอัปเดต
TimeText
ให้ใกล้เคียงกับข้อกําหนด UX มากขึ้น (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 มีการคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- ตอนนี้เครื่องมือเลือกจะตอบสนองต่อเหตุการณ์การเลื่อนเสมอแม้ว่าจะอยู่ในโหมดอ่านอย่างเดียว วิธีนี้จะช่วยให้ผู้ใช้ไม่ต้องเลือกเครื่องมือเลือกด้วยการแตะก่อนที่จะเลื่อนได้ ในโหมดอ่านอย่างเดียว ตัวเลือกอื่นนอกเหนือจากที่เลือกไว้ในปัจจุบันจะถูกบดบังด้วยชิมแปนซีใน
gradientColor
(I72925) - เราได้เปลี่ยนลักษณะการทำงานของ UX ของ
Chip/ToggleChip/CompactChip/SplitToggleChip
เพื่อหยุดการทำงานfillMaxWidth
โดยค่าเริ่มต้น แต่โฆษณาจะขยายให้เหมาะสมกับเนื้อหาของตัวเองแทน หากต้องการเก็บลักษณะการทำงานก่อนหน้าไว้ ให้เพิ่มmodifier = Modifier.fillMaxWidth()
(I60a2c, b/232206371)
แก้ไขข้อบกพร่อง
- ตัวสร้าง
CurvedTextStyle
ที่ใช้TextStyle
ตอนนี้ก็ดำเนินการตามfontWeight
เช่นกัน(อาจเพิ่มลงในตัวสร้างและวิธีการคัดลอกในการแก้ไข 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 มีการคอมมิตเหล่านี้
ฟีเจอร์ Compose สำหรับ Wear OS 1.0
1.0.0-beta01
ของ Compose สำหรับ Wear OS คือเป้าหมายสำคัญเนื่องจากไลบรารีมีฟีเจอร์สมบูรณ์แล้ว และ API ล็อกอยู่
คอมโพเนนต์ Material ของ Wear Compose ในรุ่น 1.0 ประกอบด้วย
- Material Theme จะใช้แทน
MaterialTheme
ของ Compose สำหรับอุปกรณ์เคลื่อนที่ โดยให้สี รูปร่าง และการออกแบบองค์ประกอบในการสร้างคอมโพเนนต์ในอุปกรณ์ที่สวมใส่ได้ซึ่งนำหลักเกณฑ์ UX ของ Wear Material มาใช้ได้ทันที Button
,CompactButton
และToggleButton
- ปุ่มมีช่องสำหรับใส่ไอคอน รูปภาพ หรือข้อความสั้นๆ (สูงสุด 3 อักขระ) รูปทรงกลมตามขนาดที่แนะนำสำหรับปุ่มเริ่มต้น ปุ่มขนาดใหญ่หรือเล็กCompactButton
มีช่องเดียวสำหรับใส่เนื้อหาใดก็ได้ (ไอคอน รูปภาพ หรือข้อความ) และเป็นทรงกลมพร้อมพื้นหลังขนาดเล็กพิเศษCompactButton
มีระยะห่างจากขอบโปร่งใสรอบๆ พื้นหลังเพื่อเพิ่มพื้นที่ที่คลิกได้ToggleButton
เป็นปุ่มที่มีช่องเดียวสำหรับใส่เนื้อหาใดก็ได้ (ข้อความสั้นๆ ไอคอน หรือรูปภาพ) และมีสถานะเปิด/ปิด (เลือก/ไม่เลือก) พร้อมการลงสีและไอคอนต่างๆ เพื่อแสดงให้เห็นว่าเลือกหรือไม่- การ์ด - ใช้เพื่อแสดงข้อมูลเกี่ยวกับแอปพลิเคชัน เช่น การแจ้งเตือน การออกแบบที่ยืดหยุ่นสำหรับการใช้งานที่แตกต่างกันใน
AppCard
และTitleCard
ทำให้มีเลย์เอาต์และการรองรับรูปภาพที่แตกต่างกันเป็นเนื้อหาการ์ดหรือพื้นหลัง - ชิป - องค์ประกอบที่มีลักษณะคล้ายสนามกีฬา แต่มีพื้นที่ขนาดใหญ่และมีช่องหลายช่องสำหรับใส่ป้ายกำกับ ป้ายกำกับรอง และไอคอน มีขนาดต่างกันและรองรับรูปภาพเป็นพื้นหลัง
- SwitchChips และ SplitToggleChips - ชิปที่มีสถานะ "เลือก/ไม่ได้" และเพิ่มช่อง
ToggleControl
เพื่อแสดงไอคอน เช่น สวิตช์หรือปุ่มตัวเลือกเพื่อแสดงสถานะที่เลือกของคอมโพเนนต์ นอกจากนี้SplitToggleChip
ยังมีพื้นที่ที่แตะได้ 2 พื้นที่ โดยพื้นที่หนึ่งคลิกได้และบริเวณที่สลับได้ 1 จุด - CircularProgressIndicator - สัญญาณบอกสถานะความคืบหน้าของ Wear Material ที่มี 2 รูปแบบ ภาพแรกแสดงสัดส่วนของการทำงานต่อเนื่องเสร็จสมบูรณ์และสนับสนุนช่องว่างในลู่วงกลมระหว่างมุมเริ่มต้นกับมุมสิ้นสุด รายการที่ 2 ระบุความคืบหน้าเป็นไม่ชัดเจนสำหรับเวลารอที่ไม่ระบุ
- CurdText - เป็นส่วนหนึ่งของ DSL เพื่ออธิบาย
CurvedLayouts
รวมถึงcurvedRow
และcurvedColumn
เพื่อจัดองค์ประกอบรอบอุปกรณ์ที่เป็นวงกลม ดูพื้นฐานคอมโพเนนต์ Wear ด้านล่างสำหรับรายละเอียดเพิ่มเติมเกี่ยวกับCurvedLayout
และCurvedModifier
(การ์ดนี้มีบทบาทคล้ายกับตัวปรับแต่งในโลกที่ไม่โค้งมน และช่วยให้กำหนดค่าเลย์เอาต์ ระยะห่างจากขอบ การไล่ระดับสี และอื่นๆ ได้ในหลายๆ ด้าน) - กล่องโต้ตอบ การแจ้งเตือน และการยืนยัน - กล่องโต้ตอบแสดงกล่องโต้ตอบแบบเต็มหน้าจอซึ่งวางซ้อนบนเนื้อหาอื่นๆ และรองรับการปัดเพื่อปิด ใส่ได้เพียงช่องเดียวซึ่งคาดว่าจะเป็นเนื้อหาในกล่องโต้ตอบของ Wear Material เช่น การแจ้งเตือนหรือการยืนยัน การแจ้งเตือนคือเนื้อหากล่องโต้ตอบแบบมีความเห็นที่มีช่องสำหรับไอคอน ชื่อ และข้อความ โดยมีโอเวอร์โหลดสำหรับปุ่มเชิงลบและปุ่มบวกสองปุ่มที่แสดงเคียงข้างกัน หรือช่องหนึ่งสำหรับชิปแบบเรียงซ้อนในแนวตั้งอย่างน้อย 1 ชิป การยืนยันคือเนื้อหาในกล่องโต้ตอบที่แสดงความคิดเห็นซึ่งแสดงข้อความในระยะเวลาที่กำหนด มีช่องสำหรับไอคอนหรือรูปภาพ (ที่สามารถเป็นภาพเคลื่อนไหวได้)
- HorizontalPageIndicator แสดงตำแหน่งหน้าแนวนอนตามรูปแบบของอุปกรณ์ที่สวมใส่ได้ ออกแบบมาให้แสดงเต็มหน้าจอและแสดงสัญญาณบอกสถานะแบบโค้งบนอุปกรณ์ทรงกลม ใช้ได้กับโปรแกรมดูหน้า Accompanist
- ไอคอน - การใช้ไอคอนของ Wear ซึ่งจะเลือกสีและอัลฟ่าจากธีม Material ของ Wear สำหรับไอคอนที่คลิกได้ โปรดดูที่ปุ่มหรือชิป
- เครื่องมือเลือก - แสดงรายการแบบเลื่อนได้ที่มีให้เลือก โดยค่าเริ่มต้น รายการต่างๆ จะปรากฏซ้ำ "ไม่สิ้นสุด" ในทั้ง 2 ทิศทาง สามารถแสดงในโหมดอ่านอย่างเดียวเพื่อซ่อนตัวเลือกที่ไม่ได้เลือก
- PositionIndicator - แสดงตำแหน่งการเลื่อนหรือสัญญาณบอกตำแหน่งอื่นๆ ในรูปแบบที่เหมาะสมกับรูปแบบของอุปกรณ์ที่สวมใส่ได้ ออกแบบมาให้แสดงแบบเต็มหน้าจอและแสดงสัญญาณบอกสถานะแบบโค้งบนอุปกรณ์ทรงกลม
- Scaffold - ใช้โครงสร้างการจัดวางภาพขั้นพื้นฐานของ Wear Material คอมโพเนนต์นี้มี API สำหรับสร้างคอมโพเนนต์ Wear Material หลายรายการ (เช่น
TimeText
,PositionIndicator
และVignette
) เพื่อสร้างหน้าจอ ซึ่งช่วยให้แน่ใจว่ามีกลยุทธ์การจัดวางที่เหมาะสมสำหรับองค์ประกอบเหล่านี้และรวบรวมข้อมูลที่จำเป็นเพื่อให้คอมโพเนนต์เหล่านี้ทำงานร่วมกันได้อย่างถูกต้อง - ScalingLazyColumn - คอมโพเนนต์รายการการปรับขนาด/ฟิชอายแบบเลื่อนที่กลายเป็นส่วนสำคัญของภาษาในดีไซน์ Material ของ Wear มอบเอฟเฟกต์การปรับขนาดและความโปร่งใสต่อรายการเนื้อหา
ScalingLazyColumn
ได้รับการออกแบบมาให้รองรับรายการเนื้อหาจำนวนมากซึ่งอาจมีข้อมูลที่เป็นรูปธรรมและประกอบขึ้นเมื่อจำเป็นเท่านั้น - แถบเลื่อน - ช่วยให้ผู้ใช้เลือกช่วงของค่าได้ ช่วงของรายการที่เลือกจะแสดงเป็นแถบ ซึ่งอาจแสดงโดยมีตัวคั่นหรือไม่ก็ได้
- สเตปเปอร์ - คอมโพเนนต์แบบเต็มหน้าจอที่อนุญาตให้ผู้ใช้เลือกค่าจากช่วงค่าต่างๆ โดยใช้ปุ่มเพิ่ม/ลดที่ด้านบนและด้านล่างของหน้าจอ โดยมีช่องที่อยู่ตรงกลางสำหรับข้อความหรือชิป
- ScrollToCloseBox - จัดการท่าทางสัมผัสการปัดเพื่อปิด โดยใช้ช่องเดียวสำหรับพื้นหลัง (แสดงระหว่างท่าทางสัมผัสการปัดเท่านั้น) และเนื้อหาเบื้องหน้า หรือจะใช้ร่วมกับไลบรารีการนำทางของ Androidx ก็ได้โดยใช้
SwipeDismissableNavHost
(ดูไลบรารีการนำทางของ Wear Compose ด้านล่าง) - ข้อความ - การใช้คอมโพเนนต์ Compose Material Text ใน Wear โดยใช้สีและอัลฟ่าจากธีม Material ของ Wear
- TimeText - คอมโพเนนต์สำหรับแสดงสถานะเวลาและแอปพลิเคชันที่ด้านบนของหน้าจอ ปรับให้เข้ากับรูปร่างหน้าจอโดยใช้ข้อความโค้งบนหน้าจอทรงกลม
ขอบมืด - ลักษณะหน้าจอที่ใช้ในนั่งร้านที่จะเบลอด้านบนและด้านล่างของหน้าจอเมื่อใช้เนื้อหาที่เลื่อนได้
คอมโพเนนต์ต่อไปนี้มาจาก Wear Compose Foundation ด้วยเช่นกัน
CurvedLayout - Wear Foundation
CurvedLayout
เป็นเลย์เอาต์ที่ประกอบกันได้โดยวางองค์ประกอบของบุตรหลานไว้ในแนวโค้งและหมุนตามต้องการ ซึ่งคล้ายกับเลย์เอาต์แถวที่โค้งเป็นส่วนของวงแหวน โปรดทราบว่าเนื้อหาของCurvedLayout
ไม่ใช่ lambda แบบประกอบได้ แต่เป็น DSL (ภาษาเฉพาะโดเมน) องค์ประกอบทั้งหมดใน DSL ของ CurvedLayout รองรับพารามิเตอร์ตัวปรับแต่งที่ไม่บังคับ ซึ่งสร้างขึ้นจากCurvedModifier
BasicCurvedText - องค์ประกอบใน
CurvedLayout
DSL,basicCurvedText
ช่วยให้นักพัฒนาซอฟต์แวร์เขียนข้อความโค้งตามแนวโค้งของวงกลมได้อย่างง่ายดาย (โดยปกติจะอยู่ที่ขอบของหน้าจอวงกลม)basicCurvedText
สามารถสร้างได้ภายในCurvedLayout
เท่านั้นเพื่อให้ได้ประสบการณ์การใช้งานที่ดีที่สุด เช่น สามารถระบุตําแหน่งและใช้CurvedModifiers
ได้ โปรดทราบว่าในกรณีส่วนใหญ่ ควรใช้ CurdText แทน เนื่องจากใช้การกำหนดธีมเนื้อหาCurdComposable - รวมเนื้อหา Composable ปกติเพื่อให้ใช้กับ
CurvedLayout
หากcurvedComposable
มีองค์ประกอบหลายอย่างอยู่ภายใน องค์ประกอบเหล่านั้นจะวาดทับกัน (เช่น กล่อง) หากต้องการใส่ Composable หลายรายการตามเส้นโค้ง ให้ล้อมรอบแต่ละรายการด้วยcurvedComposable
CurdRow และ CurdColumn - คล้ายกับ Row และ Column คือ
curvedRow
และcurvedColumn
จะซ้อนกันภายในCurvedLayout
เพื่อจัดเลย์เอาต์องค์ประกอบได้ตามต้องการ สำหรับcurvedRow
อาจระบุทิศทางของเลย์เอาต์เชิงมุมและการจัดแนวรัศมี สำหรับcurvedColumn
อาจระบุการจัดแนวเชิงมุมและทิศทางรัศมีCurvedModifier - คอมโพเนนต์แบบโค้งทั้งหมดยอมรับพารามิเตอร์ตัวปรับแต่งที่สร้างขึ้นโดยใช้
CurvedModifier
ได้ กล่าวคือรองรับพื้นหลัง ขนาด น้ำหนัก และระยะห่างจากขอบคอมโพเนนต์ต่อไปนี้รวมมาจากการนำทางของ Wear Compose ด้วย
SwanOffableNavHost - มอบตำแหน่งในลำดับชั้นของ Compose สำหรับการไปยังส่วนต่างๆ แบบจบในตัว พร้อมด้วยการนำทางแบบย้อนกลับที่ให้บริการโดยท่าทางสัมผัสการปัด เนื้อหาจะแสดงใน
SwipeToDismissBox
ซึ่งแสดงให้เห็นระดับการนำทางปัจจุบัน ระหว่างท่าทางสัมผัสการปัดเพื่อปิด ระดับการนำทางก่อนหน้า (หากมี) จะแสดงในเบื้องหลังดูบันทึกประจำรุ่นก่อนหน้าสำหรับรุ่นอัลฟ่ารุ่นต่างๆ สำหรับรายละเอียดเพิ่มเติมเกี่ยวกับสิ่งที่ส่งมอบแล้ว
การเปลี่ยนแปลง API
- เพิ่มฟังก์ชัน
CurvedModifier.padding*
รายการแล้ว ซึ่งใช้เพื่อระบุพื้นที่เพิ่มเติมที่จะเพิ่มรอบส่วนประกอบที่โค้ง (I4dbb4) - นำคลาสภายใน
CompositionLocal
ออกแล้ว (I42490) - เราได้เพิ่มค่าคงที่สำหรับไอคอนขนาด
Button
,CompactButton
และToggleButton
ตามคำแนะนำแล้ว (I57cab) - เพิ่มพารามิเตอร์ที่เปิดใช้ใน
AppCard
และTitleCard
แต่ตอนนี้มี API คล้ายกับandroidx.compose.material
Cards เมื่อตั้งค่าพารามิเตอร์เป็น "เท็จ" การ์ดจะคลิกไม่ได้ (Idc48d, b/228869805)
แก้ไขข้อบกพร่อง
- ตอนนี้ Stepper จะปิดปุ่มลดและเพิ่มเมื่อถึงขีดจำกัดที่ต่ำกว่า/บนแล้ว (และใช้ ContentAlpha.disabled กับ iconColor) (I4be9f)
- เราได้เพิ่มระยะห่างจากขอบ 1dp รอบเนื้อหาของเครื่องมือเลือกเมื่อวาดด้วยการไล่ระดับสีเพื่อไม่ให้เกิดการกระตุกในข้อความที่เห็นเมื่อปัด (I0b7b9)
- เพิ่มการทดสอบภาพหน้าจอสำหรับ
PositionIndicator
(I5e8bc) - เพิ่มการทดสอบสำหรับ
AppCard
และTitleCard
(I85391, b/228869805)
เวอร์ชัน 1.0.0-alpha21
20 เมษายน 2022
ปล่อย androidx.wear.compose:compose-foundation:1.0.0-alpha21
, androidx.wear.compose:compose-material:1.0.0-alpha21
และ androidx.wear.compose:compose-navigation:1.0.0-alpha21
แล้ว เวอร์ชัน 1.0.0-alpha21 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- เพิ่มตัวปรับแต่งแบบโค้งใหม่เพื่อระบุพื้นหลังขององค์ประกอบแบบโค้ง:
CurvedModifier.background
,.radialGradientBackground
และ.angularGradientBackground
(I8f392) - อนุญาตให้ระบุโหมดข้อความเพิ่มเติมแบบโค้ง (คลิป/จุดไข่ปลา/มองเห็นได้) (I8e7aa)
- เพิ่มตัวแก้ไข
CurvedModifier.weight
แล้ว ซึ่งคล้ายกับตัวแก้ไขใน Compose ซึ่งใช้ได้กับเด็กที่มีแถวโค้งและ CurvedLayout (สำหรับความกว้าง) และองค์ประกอบย่อยของ CurveColumn (สำหรับความสูง) (I8abbd) - เพิ่มตัวแก้ไข
CurvedModifier.size
,.angularSize
และ.radialSize
เพื่อระบุขนาดขององค์ประกอบที่โค้งแล้ว (I623c7)
การเปลี่ยนแปลง API
- เรียงลำดับพารามิเตอร์ใหม่เพื่อให้แน่ใจว่าพื้นหลังอยู่ก่อนสีที่สอดคล้องกันใน Wear Compose API (I43208)
- นำออกตามเข็มนาฬิกาและ
insideOut
และแทนที่ด้วยค่าคงที่ที่สื่อความหมายได้ดีกว่าในคลาสใหม่ ตอนนี้สามารถรับรู้LayoutDirection
ทิศทางของเลย์เอาต์แบบโค้งได้ และจะรับค่าเดิมเมื่อไม่ได้ระบุ (If0e6a) - เราได้แทนที่
autoCenter: Boolean
ด้วยautoCenter: AutoCentringParams
เพื่อแก้ไขปัญหา API ของScalingLazyColumn
แล้ว (Ia9c90) - เราได้เปลี่ยนชื่อ
iconTintColor
และtoggleControlTintColor
เป็นiconColor
และtoggleControlColor
ทั่วทั้ง API (Chip/ToggleChip/Dialog/Slider/Stepper/...) เนื่องจากมีการใช้สีกับช่อง icon/toggleControl (Ied238) - เขียน enum ของ
PageIndicatorStyle
ใหม่เป็นคลาสค่า (I2dc72) - เราได้เพิ่ม
RowScope/ColumnScope/BoxScope
ลงในช่องโฆษณาบางส่วนใน Composable เพื่อระบุให้นักพัฒนาแอปทราบถึงการคาดคะเนของเลย์เอาต์ ซึ่งจะช่วยให้นักพัฒนาซอฟต์แวร์สามารถใช้ตัวปรับแต่งเพิ่มเติมในเนื้อหาช่องบางส่วนได้และไม่จำเป็นต้องเพิ่มองค์ประกอบเลย์เอาต์เพิ่มเติม นอกจากนี้ เรายังอัปเดตสี AppCard/TitleCard เล็กน้อยเพื่อให้timeColor
และappColor
มีค่าเริ่มต้นเป็นcontentColor
นอกจากนี้ ระบบยังคงลบล้างพร็อพเพอร์ตี้เหล่านี้ได้ทีละรายการหากจำเป็น (I26B59) - ทำให้ออบเจ็กต์
SwipeToDismissBoxState.Companion
เป็นแบบส่วนตัว (I39e84) - แก้ไขลำดับพารามิเตอร์สำหรับ
InlineSlider
และStepper
การเปลี่ยนแปลงง่ายๆ เพื่อให้เป็นไปตามหลักเกณฑ์ API (I11fec) - เราได้นำออบเจ็กต์โปรแกรมประหยัดสำหรับ
SwipeToDismissBoxState
ออกแล้วเนื่องจากไม่มีการใช้งาน (Ifb54e) - เราได้อัปเดต
CompactChip
ให้สอดคล้องกับข้อกำหนด UX ล่าสุด ระยะห่างจากขอบได้ลดลงเป็นแนวนอน = 12.dp และแนวตั้ง = 0.dp แบบอักษรของป้ายกำกับเปลี่ยนจากปุ่มเป็นคำอธิบายภาพ 1 เมื่อมีไอคอนและป้ายกำกับอยู่ ขนาดไอคอนที่แนะนำคือ 20x20 และมีขนาด 24x24 สำหรับชิปไอคอนที่กะทัดรัดเท่านั้น สำหรับกรณีการใช้งานของไอคอนเท่านั้น เรายังได้ตรวจสอบให้ไอคอนอยู่ในแนวกึ่งกลางแล้ว (Iea2be) - เราได้เพิ่มช่องใหม่จำนวนหนึ่งลงใน
ScalingLazyListLayoutInfo
เพื่อให้นักพัฒนาแอปทราบจำนวนcontentPadding
และautoCenteringPadding
ที่มีการนำไปใช้แล้ว ซึ่งอาจเป็นประโยชน์สำหรับนักพัฒนาซอฟต์แวร์ในการคำนวณการปัด/เลื่อน (I7577b) - เราได้ติดตั้งใช้งานการเปลี่ยนเข้า/ออกสำหรับกล่องโต้ตอบ เพิ่มพารามิเตอร์
showDialog
แล้ว ตอนนี้กล่องโต้ตอบจะควบคุมระดับการมองเห็นของตัวเอง (ซึ่งทำให้กล่องโต้ตอบเรียกใช้ภาพเคลื่อนไหวช่วงอินโทรและเอาต์โทรเมื่อแสดง/ซ่อนกล่องโต้ตอบได้) โปรดทราบว่าภาพเคลื่อนไหวช่วงปิดท้ายจะไม่ทำงานเมื่อผู้ใช้ออกจากกล่องโต้ตอบผ่านการปัดเพื่อปิด นอกจากนี้ เรายังเพิ่มค่าเริ่มต้นสำหรับสถานะในการโอเวอร์โหลดSwipeToDismissBox
ที่เพิ่งเพิ่มเมื่อเร็วๆ นี้ (I682a0) - เราได้เปลี่ยน
ToggleChip
และSplitToggleChip
เพื่อไม่ให้มีค่าเริ่มต้นสำหรับช่องtoggleControl
อีกต่อไปเพื่อให้รองรับ i18n และ a11y ได้ดียิ่งขึ้น เรายังได้เปลี่ยนToggleChipDefaults
เพื่อให้เมธอดต่อไปนี้แสดงผล ImageVector แทนที่จะเป็น Icon (โปรดทราบว่าเมื่อไม่แสดงผล @Composables แล้ว ระบบจึงเปลี่ยนให้ขึ้นต้นด้วยตัวพิมพ์เล็ก)SwitchIcon()->switchIcon()
,CheckboxIcon->checkboxIcon()
และRadioIcon()->radioIcon()
วิธีนี้ช่วยและสนับสนุนให้นักพัฒนาซอฟต์แวร์สร้าง Composable ของ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
ทำงานเฉพาะตรงขอบด้านซ้ายของวิวพอร์ตเท่านั้น ใช้เมื่อต้องการที่กึ่งกลางของหน้าจอจะต้องจัดการกับการแบ่งหน้าตามแนวนอนได้ เช่น การเลื่อนแผนที่แบบ 2 มิติ หรือการเลื่อนระหว่างหน้าต่างๆ ในแนวนอน (I3fcec, b/200699800)
การเปลี่ยนแปลง API
- การนำ
CurvedModifiers
มาใช้พื้นฐานนี้ถือเป็นการเปิดโอกาสในการปรับแต่งเนื้อหาแบบโค้ง (แต่ยังไม่ให้บริการCurvedModifiers
และอาจสร้างตัวแก้ไขที่กำหนดเองในภายหลังได้) (I9b8df) EdgeSwipe
เอกสารประกอบของตัวแก้ไขและค่าเริ่มต้นที่อัปเดตเพื่อให้เข้าใจได้ดียิ่งขึ้น (I6d00d)- เพิ่ม
PageIndicator
ช่องลงในนั่งร้าน การเพิ่มPageIndicator
ลงใน Scaffold โดยตรงอาจทำให้เรารับรองว่าโฆษณาจะแสดงบนอุปกรณ์ที่เป็นวงกลมได้อย่างถูกต้อง (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
แบบซ้อนกัน (ซึ่งเป็นเลย์เอาต์แบบโค้งที่เทียบเท่ากับแถวและคอลัมน์) ภายในองค์ประกอบเลย์เอาต์เหล่านี้สามารถใช้องค์ประกอบ 3 รายการ ได้แก่curvedComposable
(เพื่อเพิ่ม @Composable ใดก็ได้),basicCurvedText
(ข้อความโค้งของรากฐาน) และcurvedText
(ข้อความโค้งที่รับรู้ตัววัสดุ) (Ib776a) - ทำให้ด้านของ
PositionIndicator
กำหนดค่าได้ ขณะนี้คุณสามารถกำหนดค่าตำแหน่งพื้นฐานของ PositionIndicator ให้เป็น End (ออกแบบทิศทางรับรู้), OppositeRsb (พิจารณาในการหมุนหน้าจอด้วย เพื่อกำหนดตำแหน่งให้ตรงข้ามกับ RSB จริง) หรือค่าสัมบูรณ์ของซ้าย & ขวา (I2f1f3) - สำหรับ
SwipeToDismissBox
เราได้เปลี่ยนชื่อSwipeDismissTarget
โดยเปลี่ยนชื่อต้นฉบับเป็นSwipeToDismissValue.Default
และSwipeDismissTarget.Dismissal
เป็นSwipeToDismissValue.Dismissed
และได้ย้ายSwipeToDismissBoxDefaults.BackgroundKey
และSwipeToDismissBoxDefaults.ContentKey
ไปยังSwipeToDismissKeys.Background
ในSwipeToDismissKeys.Content
ตามลำดับ (I47a36) - เราได้เพิ่มโหมดอ่านอย่างเดียวลงในเครื่องมือเลือกสำหรับหน้าจอที่มีเครื่องมือเลือกหลายรายการ โดยจะแก้ไขเครื่องมือเลือกได้ครั้งละ 1 รายการเท่านั้น เมื่อเครื่องมือเลือกเป็นแบบอ่านอย่างเดียว เครื่องมือเลือกจะแสดงตัวเลือกที่เลือกในปัจจุบัน รวมทั้งป้ายกำกับหากมีการระบุไว้ (I879de)
SwipeToDismissBoxState
เปลี่ยนโครงสร้างภายในโค้ดเพื่อจำกัดขอบเขตของExperimentalWearMaterialApi
เป็นModifier.swipeable
และSwipeableState
แล้ว ซึ่งขณะนี้จะใช้ภายใน ขณะนี้SwipeToDismissBoxState
มีสมาชิกcurrentValue
,targetValue
,isAnimationRunning
และsnapTo
เพื่อรองรับกรณีการใช้งานทั่วไป โปรดแจ้งให้เราทราบหากต้องการให้แสดงพร็อพเพอร์ตี้เพิ่มเติม รวมถึงแก้ไขลักษณะการทำงานของSwipeableState
ในกรณีที่ออฟเซ็ตการเลื่อนอยู่ภายในข้อผิดพลาดในการปัดเศษของ Anchor (I58302)
แก้ไขข้อบกพร่อง
- โค้ดที่เรียบง่ายและคงที่เพื่อดูว่าเนื้อหาของ
ScalingLazyColumn
เลื่อนได้หรือไม่ (ใช้ในการกำหนดว่าจะแสดง แถบเลื่อนหรือไม่) (I7bce0) - แก้ไขข้อบกพร่องของตัวระบุตำแหน่งเมื่อใช้กับสถานะมากกว่า 1 สถานะและมีการสลับระหว่างสถานะเหล่านั้น (I320b5)
- เราได้อัปเดต Compose เริ่มต้นสำหรับการออกแบบตัวอักษร/แบบอักษรในธีม Wear OS ให้สอดคล้องกับหลักเกณฑ์ UX ล่าสุด จากข้อมูลของ display1 (40.sp) และ display2 (34.sp) มีขนาดน้อยกว่าค่าก่อนหน้านี้ และได้มีการปรับปรุงเล็กน้อยอื่นๆ สำหรับความสูงของบรรทัดและระยะห่างระหว่างบรรทัด (Ie3077)
- เราได้เพิ่มการต้านทาน
SwipeToDismissBox
เพื่อให้การเคลื่อนไหวเกิดขึ้นเฉพาะเมื่อเลื่อนเพื่อปิด และไม่ทำงานในทิศทางตรงกันข้ามเลย (Ifdfb9) - เราได้เปลี่ยนค่าพารามิเตอร์เริ่มต้นบางส่วนสำหรับฟังก์ชัน
CircularProgressIndicator
เพื่อให้สอดคล้องกับคำแนะนำด้าน UX ของ Wear Material Design สำหรับเวอร์ชันตัวหมุน/อินดีเทอร์มิแนนต์ ขนาด (40->24.dp), identifierColor (หลัก->onBackground), ความโปร่งใสของ trackColor (30%->10%) และความกว้างของเส้นโครงร่าง (4->3dp) ได้รับการอัปเดตแล้ว สำหรับเวอร์ชัน "ความคืบหน้า/กำหนด" เราได้อัปเดตความโปร่งใสของ TrackColor (30%->10%) แล้ว (I659cc) - เราได้อัปเดตพารามิเตอร์การปรับขนาดเริ่มต้นของ
ScalingLazyColumn
ซึ่งสอดคล้องกับข้อกำหนด UX ของ Wear Material Design ล่าสุด การเห็นสิ่งนี้ส่งผลให้รายการเริ่มมีการปรับขนาดให้ใกล้เคียงกับศูนย์รายการมากขึ้น แต่ถูกปรับขนาดที่ขอบรายการน้อยลงกว่าเดิม (Ica8f3) - ปรับ
ScalingLazyColumnDefaults.snapFlingBehavior
บางส่วนเพื่อปรับปรุงจุดสิ้นสุดของภาพเคลื่อนไหว (If3260)
เวอร์ชัน 1.0.0-alpha18
9 มีนาคม 2022
ปล่อย androidx.wear.compose:compose-foundation:1.0.0-alpha18
, androidx.wear.compose:compose-material:1.0.0-alpha18
และ androidx.wear.compose:compose-navigation:1.0.0-alpha18
แล้ว เวอร์ชัน 1.0.0-alpha18 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- การปรับปรุงหลายประการใน PositionIndicator: แสดงผลลัพธ์ เปลี่ยนชื่อเป็น PositionIndicator visibility การปรับปรุงประสิทธิภาพบางอย่างเพื่อหลีกเลี่ยงการคำนวณซ้ำเมื่อไม่จำเป็น (Iaed9d)
- อัปเดตสีที่แนะนำสำหรับ
SplitToggleChip
แล้ว ตอนนี้ SplitToggleChip มีพื้นหลังเป็นสีทึบเมื่อเลือกหรือยกเลิกการเลือกโดยให้สีของ SwitchControl เป็นตัวบ่งชี้หลักว่ามีการเลือกคอมโพเนนต์หรือไม่ เราได้เพิ่มToggleDefaults.splitToggleChipColors()
ใหม่เพื่อรองรับรูปแบบสีใหม่แล้ว นอกจากนี้เรายังได้ลดความซับซ้อนของเมธอดtoggleChipColors()
ในการลบการแยกBackgroundOverlayColor (I7e66e) - เราได้เพิ่ม unadjustedSize ลงใน
ScalingLazyListItemInfo
เนื่องจากไม่ปลอดภัยที่จะคำนวณขนาดรายการดั้งเดิมโดยใช้ขนาดที่ปรับขนาดและตัวคูณมาตราส่วนเนื่องจากความแม่นยำของเลขทศนิยม (I54657, b/221079441) - เพิ่ม
HorizontalPageIndicator
โดยจะแสดงจำนวนหน้าทั้งหมดและหน้าที่เลือก อาจเป็นเส้นตรงหรือโค้ง ขึ้นอยู่กับรูปร่างของอุปกรณ์ และยังรองรับรูปร่างของตัวบ่งชี้แบบกำหนดเอง ซึ่งจะกำหนดวิธีแสดงตัวชี้วัดแต่ละตัว (Iac898) - เราได้อัปเดต
PickerState
เพื่อให้อัปเดต numberOfOptions ซึ่งรองรับกรณีการใช้งานต่างๆ เช่นDatePicker
เมื่อจำนวนวันในเดือนเปลี่ยนไปตามเดือนที่เลือก พารามิเตอร์ตัวสร้างสำหรับ PickerState จะเปลี่ยนเป็น defaultNumberOfOptions (Iad066) - ซ่อน
PositionIndicator
เมื่อเป็นแถบเลื่อนและจะทำไม่ได้ เลื่อน (Id0a7f) - เพื่อให้สอดคล้องกับ Scaffold คอมโพเนนต์กล่องโต้ตอบแบบเต็มหน้าจอของเราจะแสดง
PositionIndicator
และVignette
นอกจากนั้นเรายังใช้ScalingLazyColumn
แทนColumn
อีกด้วย ซึ่งหมายความว่าตอนนี้เนื้อหาของกล่องโต้ตอบจะอยู่ในScalingLazyListScope
(และโดยปกติจะต้องอยู่ในรายการ { /* content */ }) กล่องโต้ตอบรองรับพารามิเตอร์การจัดแนวตามแนวตั้ง (แนวคิด13) - เราได้เปลี่ยนชื่อของพร็อพเพอร์ตี้
ToggleChip
และพร็อพเพอร์ตี้ปุ่มสลับSplitToggleChip
เป็น replaceControl ให้สอดคล้องกับดีไซน์ Material มากขึ้นเพื่อช่วยให้นักออกแบบและนักพัฒนาซอฟต์แวร์ไปยังส่วนต่างๆ ของ API ได้ (If5921, b/220129803) - เราได้เพิ่มคำอธิบายภาพ 3 รายการใหม่ลงใน Typology ของ Wear Material โดยคำอธิบายภาพ3 เป็นแบบอักษรขนาดเล็กที่ใช้สำหรับการเขียนแบบยาวเพิ่มเติม เช่น ข้อความทางกฎหมาย (I74b13, b/220128356)
แก้ไขข้อบกพร่อง
- หยุดภาพเคลื่อนไหวของการสแนปเมื่อเราไปถึง (Idb69d)
- สร้างภาพเคลื่อนไหวใน PositionIndicator (I94cb9)
- ตามความคิดเห็นเกี่ยวกับ UI/UX เราได้เปลี่ยนแปลงการจัดกึ่งกลางอัตโนมัติของ
ScalingLazyColumn
ให้มีพื้นที่เพียงพอที่จะดูแลให้รายการที่มีดัชนีScalingLazyListState.initialCenterItemIndex
ขึ้นไปจะเลื่อนไปยังกึ่งกลางของวิวพอร์ตได้อย่างสมบูรณ์ วิธีนี้ช่วยให้นักพัฒนาแอปวางรายการเกี่ยวกับรายการนั้นไว้ตรงกลาง 1 หรือ 2 รายการได้ ซึ่งไม่สามารถเลื่อนตรงกลางได้ ซึ่งหมายความว่าScalingLazyColumn
ของ AutoCenter จะเลื่อนเหนือinitialCenterItemIndex/initialCenterItemScrollOffset
(I22ee2) ไม่ได้ - เราได้เพิ่มการสาธิตสำหรับเครื่องมือเลือกวันที่ และแก้ไขข้อบกพร่องใน
PickerState
ซึ่งระบบไม่มีการใช้ EuropeanSelectedOption จนกว่าเครื่องมือเลือกวันที่จะปรากฏ (Id0d7e) - เราได้เพิ่มระยะห่างจากขอบของเนื้อหาแนวนอนเริ่มต้นจาก 8 เป็น 10 dp เพื่อลดการตัดรายการ
ScalingLazyColumn
ที่กว้างขึ้นบนหน้าจอวงกลม (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 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- เราได้เพิ่มการรองรับการสแนปที่สามารถใช้กับ
ScalingLazyColumn
ตั้งค่าflingBehavior = ScalingLazyColumnDefaults.flingWithSnapBehavior(state)
เพื่อเปิดใช้การรองรับ Snap (I068d3, b/217377069) - เราได้เพิ่มการสาธิตสำหรับเครื่องมือเลือก เลือกเวลาในรูปแบบ 24 ชั่วโมงหรือ 12 ชั่วโมง (Ie5552)
การเปลี่ยนแปลง API
- แก้ไขปัญหาเกี่ยวกับแบบอักษรและแบบอักษรที่กำหนดเอง
TimeText
รายการ รูปแบบในอุปกรณ์สี่เหลี่ยมจัตุรัส (Iea76e) - ตอนนี้
ScalingLazyListLayoutInfo
มีreverseLayout
,viewportSize
และพร็อพเพอร์ตี้การวางแนวที่ตรงกับพร็อพเพอร์ตี้จากLazyListLayoutInfo
(I4f258, b/217917020) - ตอนนี้
ScalingLazyColumn
มีที่พักuserScrollEnabled
ที่ตรงกับจากLazyList
(I164d0, b/217912513) - ตอนนี้เครื่องมือเลือกจะมีการไล่ระดับสีด้านบนและด้านล่างโดยค่าเริ่มต้น (Iab92a)
แก้ไขข้อบกพร่อง
- เราได้แก้ไข
ScalingLazyColumn
เพื่อไม่ให้เติมพื้นที่ทั้งหมดในระดับบนสุดอีกต่อไป แต่จะนำขนาดมาจากขนาดของเนื้อหาแทน การดำเนินการนี้สอดคล้องกับลักษณะการทำงานของLazyColumn
หากต้องการกู้คืนลักษณะการทำงานเดิม ให้ส่งModifier.fillMaxWidth()/width()/widthIn()
ไปยังScalingLazyColumn
(I51bf8) - เราได้ปรับปรุงข้อความข้อยกเว้นใน
SwipeDismissableNavHost.kt
ที่จะถูกเรียกใช้หากแบ็กสแต็กการนำทางว่างเปล่า (I1b1dc)
เวอร์ชัน 1.0.0-alpha16
9 กุมภาพันธ์ 2022
ปล่อย androidx.wear.compose:compose-foundation:1.0.0-alpha16
, androidx.wear.compose:compose-material:1.0.0-alpha16
และ androidx.wear.compose:compose-navigation:1.0.0-alpha16
แล้ว เวอร์ชัน 1.0.0-alpha16 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- เพิ่ม
CircularProgressIndicator
สัญญาณบอกสถานะความคืบหน้าจะแสดงความยาวของกระบวนการหรือเวลารอที่ไม่ระบุ รองรับช่องว่าง (ตัดออก) สำหรับ TimeText หรือคอมโพเนนต์อื่นๆ หากใช้งานแบบเต็มหน้าจอ (Iab8da)
การเปลี่ยนแปลง API
- ตอนนี้เครื่องมือเลือกมีพารามิเตอร์
flingBehavior
ค่าเริ่มต้นจะจัดไปยังตัวเลือกที่ใกล้ที่สุดเมื่อเลื่อน/ขว้าง (I09000) - API จำนวนเต็มเพิ่มเติมสำหรับ inlineSlider และ Stepper (I1b5d6)
แก้ไขข้อบกพร่อง
- เราได้เปลี่ยน defaultCenterItemIndex สำหรับ
ScalingLazyListState
จาก 0->1 ซึ่งหมายความว่าหากไม่มีการลบล้างในโครงสร้างของรัฐด้วยScalingLazyListState.rememberScalingLazyListState(initialCenterItemIndex =
)
รายการที่ 2 (ดัชนี == 1) จะวางอยู่กึ่งกลางของวิวพอร์ตเมื่อเริ่มต้น และรายการที่ 1 (ดัชนี == 0) จะถูกวางก่อน ซึ่งจะทำให้ได้เอฟเฟกต์ภาพเริ่มต้นที่ดีกว่าเดิมเมื่อแกะกล่องแล้ว เนื่องจากวิวพอร์ตส่วนใหญ่จะมีรายการแบบรายการอยู่ในวิวพอร์ต (I0c623, b/217344252) - เราได้ลด
extraPadding
เริ่มต้นScalingLazyColumn
ที่ให้ไว้เพื่อให้แน่ใจว่ามีรายการจำนวนมากให้วาด (แม้ว่าเราจะลดขนาดข้อมูลบางส่วนลง) จาก 10% เหลือ 5% การทำเช่นนี้จะหลีกเลี่ยงการเขียนรายการเพิ่มเติมที่อาจไม่ปรากฏในวิวพอร์ต หากใช้การปรับขนาดที่ไม่ใช่แบบมาตรฐาน (เช่น การปรับขนาดที่เข้มงวดมากขึ้น) นักพัฒนาแอปจะปรับระยะห่างจากขอบเพิ่มเติมได้โดยใช้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
เมื่อเป็นจริง (ค่าเริ่มต้น) วิธีนี้จะช่วยเลื่อนรายการทั้งหมด ซึ่งรวมถึงรายการแรกและสุดท้าย เพื่อให้รายการปรากฏตรงกลางวิวพอร์ตของรายการ โปรดทราบว่าหากใช้การจัดกึ่งกลางอัตโนมัติ คุณอาจต้องตั้งค่าระยะห่างจากขอบของเนื้อหาแนวตั้งเป็น 0.dp หากมีการจัดกึ่งกลางอัตโนมัติและระยะห่างจากขอบของเนื้อหาแนวตั้ง ก็จะทำให้มีพื้นที่ว่างเพิ่มเติมก่อนรายการแรกและหลังรายการสุดท้าย ซึ่งทำให้เลื่อนได้ไกลขึ้น (I2a282, b/214922490) - เราได้เพิ่มคอมโพเนนต์
Dialog
ที่ช่วยให้ Composable สามารถทริกเกอร์กล่องโต้ตอบแบบเต็มหน้าจอที่อยู่บนเนื้อหาอื่นๆ เมื่อแสดง กล่องโต้ตอบจะรองรับการปัดเพื่อปิดและจะแสดงเนื้อหาของผู้ปกครองในพื้นหลังระหว่างท่าทางสัมผัสการปัด เนื้อหาของกล่องโต้ตอบควรเป็นAlert
หรือConfirmation
(เปลี่ยนชื่อจากคอมโพเนนต์ก่อนหน้าAlertDialog
และConfirmationDialog
) แต่Alert
,Confirmation
และDialog
ทั้งหมดอยู่ในแพ็กเกจandroidx.wear.compose.material.dialog
ใช้การแจ้งเตือนและการยืนยันเป็นปลายทางการนำทางได้ นอกจากนี้ ได้เพิ่ม ColumnScope ในพารามิเตอร์การแจ้งเตือนและการยืนยันตามที่จำเป็น (Ia9014) - เราได้นำ
onSurfaceVariant2
ออกจาก Compose สำหรับสีธีม Material ของ 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)เราได้เพิ่มเครื่องจัดการปุ่มกลับลงใน
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
เพิ่มปลายทางไปยังลำดับชั้น Compose ก่อนที่จะมาถึงสถานะวงจรCREATED
ซึ่งส่งผลให้เกิดIllegalStateException
การแก้ไขนี้เป็นข้อกำหนดเบื้องต้นในการอัปเดตทรัพยากร Dependency จากnavigation-compose
เป็น2.4.0-beta02
ขึ้นไป (I40a2b, b/207328687)เพิ่มคลาส Drawables 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 ที่ให้ผู้ใช้สามารถเลือกจากช่วงค่าต่างๆ ได้ สเตปเปอร์เป็นการควบคุมแบบเต็มหน้าจอที่มีปุ่มเพิ่มและลดที่ด้านบนและด้านล่าง และมีช่องที่อยู่ตรงกลาง (อาจมีชิปหรือข้อความก็ได้) สามารถปรับแต่งไอคอนปุ่มได้หากจำเป็น (I625fe)
เราได้เพิ่ม Composable ใหม่ 2 รายการสำหรับแสดงกล่องโต้ตอบ ดังนี้ AlertDialog รอคำตอบจากผู้ใช้แล้วแสดงชื่อ ไอคอน ข้อความ และ ก) ปุ่ม 2 ปุ่มสำหรับตัวเลือกเชิงบวก/เชิงลบที่เรียบง่าย หรือ ข) ชิปแบบเรียงซ้อนกันหรือสลับชิปเพื่อตัวเลือกที่ยืดหยุ่นมากขึ้น VerifyationDialog แสดงการตอบรับพร้อมการหมดเวลา กล่องโต้ตอบแบบง่ายนี้มีช่องสำหรับชื่อและไอคอน (ภาพเคลื่อนไหว) (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 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- เราได้เพิ่มคอมโพเนนต์เครื่องมือเลือกที่ให้ผู้ใช้เลือกรายการจากรายการแบบเลื่อนได้ โดยค่าเริ่มต้น รายการที่เลือกได้จะปรากฏซ้ำแบบ "ไม่สิ้นสุด" ในทั้ง 2 ทิศทาง เพื่อทำให้ภาพเป็นทรงกระบอกหมุนที่มองเห็นได้จากด้านข้าง เราจะเพิ่มฟีเจอร์ 2 อย่างในรุ่นต่อๆ ไป ซึ่งได้แก่ การสแนปเป็นค่าหลังจากการปัด/ปัด การเพิ่มฟังก์ชันไปยัง PickerState เพื่อตั้งค่า/เลื่อนเป็นค่าปัจจุบัน (I6461b)
การเปลี่ยนแปลง API
- เพิ่ม ScalingLazyItemScope และตัวแก้ไขใหม่ fitParentMaxSize/fillParentMaxWidth/fillParentMaxHeight เพื่ออนุญาตการปรับขนาดรายการตามขนาดของคอนเทนเนอร์หลัก ตั้งค่าให้รายการใช้ขนาดทั้งหมดหรือบางส่วนก็ได้ คอลัมน์นี้จะแสดงฟังก์ชันการทำงานที่มีอยู่แล้วใน LazyRow/Column (I4612f)
- เพิ่มการรองรับ ScalingLazyColumn เพื่อให้รายการมีคีย์ได้ และยังเพิ่มวิธีอำนวยความสะดวกเพื่อให้เพิ่มรายการจากอาร์เรย์และรายการได้ (Ic1f89)
แก้ไขข้อบกพร่อง
- ตัวอย่างเพิ่มเติมสำหรับ TimeText (I8cb64)
เวอร์ชัน 1.0.0-alpha10
3 พฤศจิกายน 2021
ปล่อย androidx.wear.compose:compose-foundation:1.0.0-alpha10
, androidx.wear.compose:compose-material:1.0.0-alpha10
และ androidx.wear.compose:compose-navigation:1.0.0-alpha10
แล้ว เวอร์ชัน 1.0.0-alpha10 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
เพิ่มตัวเลื่อนในบรรทัดสำหรับการเขียน Wear แถบเลื่อนในบรรทัดช่วยให้ผู้ใช้เลือกจากช่วงค่าได้ ช่วงของรายการที่เลือกจะแสดงเป็นแถบระหว่างค่าต่ำสุดและสูงสุดของช่วง ซึ่งผู้ใช้สามารถเลือกค่าใดค่าหนึ่งได้ (If0148)
ดู Compose ใหม่สำหรับ WearOS Codelab
การเปลี่ยนแปลง API
- ตอนนี้การเปรียบเทียบมาโครมี
minSdkVersion
ที่23
(If2655)
แก้ไขข้อบกพร่อง
- อัปเดตการจัดการการเปลี่ยนใน ScrollOffableNavHost ใน SideEffect (I04994, b/202863359)
- อัปเดตการจัดการการเปลี่ยนใน ScrollOffableNavHost (I1cbe0, b/202863359)
เวอร์ชัน 1.0.0-alpha09
27 ตุลาคม 2021
ปล่อย androidx.wear.compose:compose-foundation:1.0.0-alpha09
, androidx.wear.compose:compose-material:1.0.0-alpha09
และ androidx.wear.compose:compose-navigation:1.0.0-alpha09
แล้ว เวอร์ชัน 1.0.0-alpha09 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- เราได้เปิดตัวการแสดงตัวอย่างของ Compose สำหรับนักพัฒนาซอฟต์แวร์ใน Wear OS แล้ว โปรดดูบล็อกโพสต์ของเรา ซึ่งตรวจสอบ Composable หลักและลิงก์ไปยังแหล่งข้อมูลเพิ่มเติมเพื่อเริ่มใช้งาน
การเปลี่ยนแปลง API
- เราได้เพิ่มการสนับสนุนให้นักพัฒนาแอปปรับแต่งสีทั้งหมดในธีม Wear Material Design Color ได้ (I4759b, b/199754668)
แก้ไขข้อบกพร่อง
- เพิ่มตัวอย่าง ScrollToOffBox ที่ยังคงมีสถานะ (Ibaffe)
- เพิ่มลิงก์ไปยังคำแนะนำ developer.android.com จาก KDocuments สำหรับ CurvedText, TimeText และ ScrollToCloseBox (I399d4)
- ในตอนนี้ ScrollOffableNavHost จะแสดงหากไม่พบปลายทางปัจจุบัน (ระบุว่า NavGraph ไม่ได้สร้างขึ้นโดยใช้ wear.compose.navigation.composable ฟังก์ชันยูทิลิตี) (I91403)
- เพิ่มเอกสารประกอบและตัวอย่างการใช้งานแหล่งข้อมูลใน TimeText (I4f6f0)
เวอร์ชัน 1.0.0-alpha08
13 ตุลาคม 2021
ปล่อย androidx.wear.compose:compose-foundation:1.0.0-alpha08
, androidx.wear.compose:compose-material:1.0.0-alpha08
และ androidx.wear.compose:compose-navigation:1.0.0-alpha08
แล้ว เวอร์ชัน 1.0.0-alpha08 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- เราได้เปลี่ยนชื่อพร็อพเพอร์ตี้ AppCard และ TitleCard
body
เป็นcontent
และย้ายไปท้ายรายการพร็อพเพอร์ตี้แล้วเพื่อให้สามารถระบุเป็น lambda ต่อท้ายได้ และเปลี่ยนชื่อbodyColor
เป็นcontentColor
ด้วยเพื่อให้สอดคล้องกับชื่อช่องโฆษณาใหม่ (I57e78)
แก้ไขข้อบกพร่อง
- เพิ่มลิงก์ไปยัง developer.android.com คำแนะนำจาก KDocuments สำหรับปุ่ม การ์ด ชิป ธีม ตัวบ่งชี้ตำแหน่งและการปรับขนาดคอมโพเนนต์คอลัมน์แบบ Lazy (I22428)
- แก้ปัญหาที่ WearOS ScrollToOffBox ไม่สามารถทำได้ในบางครั้ง (I9387e)
- เพิ่มตัวอย่างสำหรับ Button, CompactButton Chip, CompactChip, AppCard, TitleCard SwitchButton, SwitchChip, SplitToggleChip (Iddc15)
- เพิ่มการทดสอบประสิทธิภาพการเปรียบเทียบแบบไมโครสำหรับ การ์ด, ชิป, SwitchChip, TimeText และ ScalingLazyColumn (If2fe9)
เวอร์ชัน 1.0.0-alpha07
29 กันยายน 2021
ปล่อย androidx.wear.compose:compose-foundation:1.0.0-alpha07
, androidx.wear.compose:compose-material:1.0.0-alpha07
และ androidx.wear.compose:compose-navigation:1.0.0-alpha07
แล้ว เวอร์ชัน 1.0.0-alpha07 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- เพิ่มคอมโพเนนต์ CurvedText ในวัสดุ ซึ่งเป็นคอมโพเนนต์ที่ช่วยให้นักพัฒนาแอปเขียนข้อความที่โค้งตามแนวโค้งของวงกลมได้อย่างง่ายดาย (โดยปกติจะอยู่ที่ขอบของหน้าจอวงกลม) (I19593)
การเปลี่ยนแปลง API
- เพิ่มการทดสอบสำหรับ TimeText (Idfead)
- แปลง ArcPaddingValues เป็นอินเทอร์เฟซ (Iecd4c)
- เพิ่มภาพเคลื่อนไหวไปยัง BrowseToCloseBox (I9ad1b)
- เพิ่มพารามิเตอร์ hasBackground ใน BrowseToOffBox API เพื่อให้สามารถปิดใช้ท่าทางสัมผัสการปัดได้ ไม่มีเนื้อหาพื้นหลังที่จะแสดง (I313d8)
- ตอนนี้
rememberNavController()
จะใช้ตัวเลือกที่ไม่บังคับ ชุดของอินสแตนซ์Navigator
รายการที่จะเพิ่มลงใน ส่งคืนNavController
เพื่อรองรับตัวเลือกได้ดียิ่งขึ้น Navigator เช่น ผู้ใช้จาก เนื้อหาการนำทางของ Accompanist (I4619e) - ข้อมูลอ้างอิง NamedNavArgument จาก Navigation-common และนำสำเนาออกจาก wear.compose.navigation (I43af6)
แก้ไขข้อบกพร่อง
- การทดสอบความไม่สม่ำเสมอของ CurvedRow ในอุปกรณ์ขนาดเล็ก (If7941)
- แก้ปัญหาภาพกะพริบใน CurvedRow เมื่อเนื้อหาอัปเดต และตรวจดูว่ามีการวัดแถวโค้งอีกครั้ง (Ie4e06)
- มีการอัปเดต ChipDefaults.levelBackgroundChipColors() ให้สอดคล้องกับการเปลี่ยนแปลงของข้อกำหนด UX การไล่ระดับสีจะเริ่มต้นด้วย MaterialTheme.colors.primary ที่มีอัลฟ่า 32.5% และลงท้ายด้วย MaterialTheme.colors.surface ที่มีอัลฟ่า @ 0% บนพื้นหลังของ MaterialTheme.colors.surface @ อัลฟ่า 75% (รหัส 1548)
- เราได้อัปเดตสีสำหรับ SwitchChips เมื่ออยู่ในสถานะที่เลือกเพื่อให้ตรงกับคำแนะนำล่าสุดด้านการออกแบบ UX ของ Wear Material ตอนนี้เมื่อเลือก SwitchChips จะมีพื้นหลังแบบไล่ระดับสีจาก MaterialTheme.color.surface @ อัลฟ่า 0% ซ้ายบน ไปยัง MaterialTheme.color.primary อัลฟา 32% ด้านล่างขวา เหนือพื้นหลังของ MaterialTheme.color.surface @ 75% อัลฟ่า ซึ่งจะทำให้เกิดความแตกต่างเล็กน้อยมากระหว่างการเลือกและยกเลิกการเลือกสำหรับ SwitchChip (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 เป็น Composable แอปพลิเคชันระดับบนสุดซึ่งมีโครงสร้างสำหรับการจัดการ PositionIndicators (เช่น Scroll หรือ Volume) ซึ่งเป็นพื้นที่ด้านบนของหน้าจอสำหรับแสดงเวลาและสถานะการสมัคร และยังรองรับ Vignette เพื่อเบลอขอบด้านบนและด้านล่างของหน้าจอสำหรับเนื้อหาที่เลื่อนได้ พื้นที่หลักของ Scaffold คือบริเวณที่วางเนื้อหาของแอปพลิเคชัน (I5e0bf)
- เพิ่มการใช้งาน TimeText สำหรับ Wear Compose (I5654c)
ไลบรารีการนำทางของ Wear Compose
เราได้เพิ่มไลบรารีการนำทางของ Wear Compose เวอร์ชันแรก ซึ่งผสานรวมไลบรารีการนำทางของ Wear Compose และ Androidx Navigation ซึ่งเป็นวิธีการง่ายๆ ในการสลับไปมาระหว่างฟังก์ชัน @Composable เป็นปลายทางในแอปพลิเคชันของคุณ
รุ่นแรกนี้มีฟีเจอร์ต่างๆ ดังต่อไปนี้
SwipeDismissableNavHost
Composable ที่โฮสต์กราฟการนำทางและแสดงการนำทางย้อนกลับผ่านท่าทางสัมผัสการปัด- ส่วนขยาย
NavGraphBuilder.composable
เพื่อช่วยในการสร้างกราฟการนำทาง rememberSwipeDismissableNavController()
เพื่ออนุญาตสถานะรอก
ตัวอย่างการใช้งานที่เราสร้าง 2 หน้าจอและสลับไปมาระหว่างหน้าจอแต่ละแบบ
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 จัดไว้เป็นไลบรารีแยกต่างหากเพื่อให้แอปพลิเคชัน Wear Compose แบบง่ายที่ใช้การนำทางแบบใช้มือม้วนขึ้นเองไม่จำเป็นต้องใช้ไลบรารีการนำทางของ Androidx
การเปลี่ยนแปลง API
- อัปเดต
SwipeDismissableNavHost
ให้รองรับแล้วrememberSaveable
โดยการตั้งค่าข้อมูลประจำตัวหลักสำหรับพื้นหลังและเนื้อหา (I746fd) - เราได้เพิ่มอะแดปเตอร์ PositionIndicator ที่สามารถจัดการ LazyListState (I21b88)
- อัปเดต ScrollToOffBox เพื่อสนับสนุน RememberSaveable (Ie728b)
- เราได้เพิ่มการสนับสนุน ReverseLayout ใน ScalingLazyColumn การดำเนินการนี้ช่วยให้มีการกลับทิศทางการเลื่อนและเลย์เอาต์ (I9e2fc)
- เลิกใช้งาน
performGesture
และGestureScope
ซึ่งมี ถูกแทนที่ด้วยperformTouchInput
และTouchInjectionScope
(Ia5f3f, b/190493367) - เราเปลี่ยนชื่อ VignetteValue เป็น VignettePosition และเปลี่ยนชื่อ VignetteValue โดยทั้ง 2 ประเภทเปลี่ยนชื่อเป็น VignettePosition.TopAndBottom (I57ad7)
- เราได้เปลี่ยนชื่อ ScalingLazyColumnState เป็น ScalingLazyListState, ScalingLazyColumnItemInfo เป็น ScalingLazyListItemInfo, ScalingLazyColumnLayoutInfo เป็น ScalingLazyListLayoutInfo และ ScalingLazyColumnScope เป็น ScalingLazyListScope ในกรณีที่ตัดสินใจเพิ่มการติดตั้งใช้งาน Scaling ในอนาคต (I22734)
แก้ไขข้อบกพร่อง
- อัปเดตเอกสารประกอบของ CompactChip เพื่ออธิบายสิ่งที่จะเกิดขึ้นหากไม่ได้ระบุไอคอนหรือป้ายกำกับ (I4ba88)
- เราได้ทำการปรับเปลี่ยนบางอย่างในคอมโพเนนต์การ์ด Wear (I6B3d0)
- ระยะห่างของการ์ดไตเติ้ลระหว่างชื่อและเนื้อหาลดลงจาก 8.dp เป็น 2.dp
- เปลี่ยนแบบอักษรของส่วนหัว TitleCard จากเนื้อหาเป็น title3 แล้ว
- เปลี่ยนการไล่ระดับพื้นหลังของการ์ดเพื่อทำให้พื้นหลังดูเข้มขึ้น
เวอร์ชัน 1.0.0-alpha05
1 กันยายน 2021
ปล่อย androidx.wear.compose:compose-foundation:1.0.0-alpha05
และ androidx.wear.compose:compose-material:1.0.0-alpha05
แล้ว เวอร์ชัน 1.0.0-alpha05 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- ทำเครื่องหมาย ArcPaddingValues เป็น @Stable (I57deb)
- ปัจจุบัน ScalingLazyColumnState ใช้อินเทอร์เฟซ ScrollableState ซึ่งช่วยให้นักพัฒนาซอฟต์แวร์มีสิทธิ์เลื่อนคอมโพเนนต์แบบเป็นโปรแกรมได้ (I47dbc)
แก้ไขข้อบกพร่อง
- เราได้ลดระยะห่างระหว่างไอคอนกับข้อความในชิปและ SwitchChip เพื่อให้สอดคล้องกันกับการอัปเดตข้อกำหนด UX (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 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- เพิ่ม ScrollToOffBox และตัวปรับแต่งแบบกวาดนิ้วได้ซึ่งสามารถใช้เพื่อ รองรับท่าทางสัมผัสการปัดจากซ้ายไปขวาเพื่อปิด แม้จะเป็นอิสระจากคอมโพเนนต์การนำทาง จะต้องใช้เพื่อออกจากหน้าจอหนึ่งและไปยังอีกหน้าจอหนึ่ง เพิ่มเมื่อ การทดสอบการผสานรวมไปยังการสาธิตแบบปัดเพื่อปิด (I7bbaa)
- เราได้เพิ่มอินเทอร์เฟซ ScalingLazyColumnItemInfo และ ScalingLazyColumnLayoutInfo ไปยังคลาส ScalingLazyColumnState เพื่อให้นักพัฒนาซอฟต์แวร์ทราบตำแหน่งและขนาดรายการจริงใน ScalingLazyColumn หลังจากใช้การปรับขนาดแล้ว เรายังแก้ไขข้อบกพร่องเรื่องวิธีคำนวณการปรับขนาดเมื่อ "ด้านบน" ด้วย ระยะห่างจากขอบของเนื้อหาจะใช้กับ ScalingLazyColumn (I27c07)
การเปลี่ยนแปลง API
- เพิ่มคลาส CurvedTextStyle เพื่อระบุการจัดรูปแบบข้อความแบบโค้ง ตัวเลือก คล้ายกับ TextStyle แต่ขณะนี้รองรับเฉพาะสี ขนาดตัวอักษร และพื้นหลังเท่านั้น ทั้งนี้ เราจะเพิ่มตัวเลือกการจัดรูปแบบอื่นๆ ในอนาคต (I96ac3)
- เราได้เพิ่มอินเทอร์เฟซ ScalingLazyColumnItemInfo และ ScalingLazyColumnLayoutInfo ไปยังคลาส ScalingLazyColumnState เพื่อให้นักพัฒนาซอฟต์แวร์ทราบตำแหน่งและขนาดรายการจริงใน ScalingLazyColumn หลังจากใช้การปรับขนาดแล้ว เรายังแก้ไขข้อบกพร่องเรื่องวิธีคำนวณการปรับขนาดเมื่อ "ด้านบน" ด้วย ระยะห่างจากขอบของเนื้อหาจะใช้กับ ScalingLazyColumn (I27c07)
- เพิ่ม
@ExperimentalWearMaterialApi
ในSwipeDismissTarget
enum ซึ่งเป็นส่วนหนึ่งของSwipeToDismissBox
API (I48b5e)
แก้ไขข้อบกพร่อง
- เพิ่มสื่อการทดสอบสำหรับ BrowseToOffBox (I9febc)
เวอร์ชัน 1.0.0-alpha03
4 สิงหาคม 2021
ปล่อย androidx.wear.compose:compose-foundation:1.0.0-alpha03
และ androidx.wear.compose:compose-material:1.0.0-alpha03
แล้ว เวอร์ชัน 1.0.0-alpha03 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- เพิ่มคอมโพเนนต์ CurvedText ซึ่งช่วยให้นักพัฒนาซอฟต์แวร์เขียนข้อความตาม ความโค้งของวงกลม (โดยปกติจะอยู่ที่ขอบของหน้าจอวงกลม) (Id1267)
- เราได้เปลี่ยนชื่อ
CardDefaults.imageBackgroundPainter()
เป็นCardDefaults.imageWithScrimBackgroundPainter()
เพื่อให้ชัดเจนว่าภาพพื้นหลังมีลายเส้นขีดทับ (I53206) - การเพิ่มคอมโพเนนต์ ScalingLazyColumn ที่มีคอมโพเนนต์รายการสำหรับ Wear Material ที่ให้มุมมองฟิชอายพร้อมเนื้อหาในรายการที่ลดขนาดลงและมีความโปร่งใสเมื่อปรับขนาดไปทางขอบของคอมโพเนนต์ (I7070C)
แก้ไขข้อบกพร่อง
- เราเปลี่ยนสีเริ่มต้นของเนื้อหา appName ใน AppCard เพื่อตอบสนองต่อการอัปเดตข้อกำหนด UX ตอนนี้สีเริ่มต้นของ 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 ใหม่ในการจัดวาง Composable ในโค้ง (I29941)
- เพิ่มการ์ดประเภทใหม่สำหรับใช้ในแอปพลิเคชัน (TitleCard) และเพิ่มการสนับสนุนสำหรับการมีรูปภาพเป็นพื้นหลังในการ์ดเพื่อเน้นเนื้อหา (I53b0f)
การเปลี่ยนแปลง API
- เพิ่มการรองรับการจัดข้อความแบบรัศมีเป็น CurvedRow (คล้ายกับ การจัดข้อความแนวตั้งในแถวแนวนอน) (Id9de5)
- เพิ่มคลาส CurvedRow ไปยัง Composable แบบจัดวางในโค้ง (I29941)
- เพิ่มการ์ดประเภทใหม่สำหรับใช้ในแอปพลิเคชัน (TitleCard) และเพิ่มการสนับสนุนสำหรับการมีรูปภาพเป็นพื้นหลังในการ์ดเพื่อเน้นเนื้อหา (I53b0f)
- เพิ่มไอคอนเปิด/ปิด (ช่องทำเครื่องหมาย สวิตช์ และปุ่มตัวเลือก) ไปยัง SwitchChipDefaults เพื่อให้นักพัฒนาซอฟต์แวร์กำหนดค่า SwitchChip และ SplitToggleChips (I7b639) ได้ง่ายขึ้น
- ระยะห่างจากขอบของเนื้อหาเริ่มต้นและสิ้นสุดสำหรับชิปได้รับการอัปเดตให้เป็น 14.dp อย่างสม่ำเสมอ โดยไม่คำนึงว่าชิปมีไอคอนอยู่หรือไม่ (ก่อนหน้านี้คือ 12.dp หากมีไอคอน และ 14.dp หากไม่มี) (I34c86)
แก้ไขข้อบกพร่อง
- เพิ่มการทดสอบสำหรับ CurvedRow (I93cdb)
- การเชื่อมโยงทรัพยากร Dependency ของ 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 เป็นไลบรารีที่ใช้ Compose จาก Kotlin ซึ่งรองรับดีไซน์ Material ของ Wear ซึ่งเป็นส่วนขยายของ Material Design สำหรับอุปกรณ์ที่สวมใส่ได้ WearOS รุ่นอัลฟ่ารุ่นแรกนี้มีการติดตั้งใช้งานฟังก์ชันการทำงานเบื้องต้นดังต่อไปนี้
- ธีมวัสดุ - กำหนดค่าสี รูปแบบอักษร และรูปทรงให้สอดคล้องกันในองค์ประกอบที่ใช้จากไลบรารีนี้
- Chip, CompactChip - ชิปเป็นรูปทรงสนามและความหลากหลายในการดำเนินการกับไอคอน ป้ายกำกับ และเนื้อหาของป้ายกำกับรอง
- - SwitchChip, SplitToggleChip - ชิปชนิดพิเศษที่มีช่องสำหรับไอคอนสลับ 2 สถานะ เช่น ปุ่มตัวเลือกหรือช่องทำเครื่องหมาย นอกจากนี้ SplitToggleChip ยังมีพื้นที่ที่แตะได้ 2 ส่วน โดยพื้นที่หนึ่งสามารถคลิกได้และอีกส่วนเปิด/ปิดได้
- ปุ่มแบบกะทัดรัด - ปุ่มเป็นรูปวงกลมโดยมีช่องเนื้อหาช่องเดียวสำหรับไอคอนหรือข้อความขนาดเล็ก (ไม่เกิน 3 อักขระ)
- เปิด/ปิดปุ่ม - ปุ่มที่เปิดหรือปิดการทำงาน โดยมีช่องเดียวสำหรับไอคอนหรือข้อความขนาดเล็ก (ไม่เกิน 3 อักขระ)
- การ์ด AppCard รูปสี่เหลี่ยมผืนผ้าขอบมนมีช่องสำหรับเนื้อหา เช่น ไอคอนแอป เวลา ชื่อ และเนื้อหา
รุ่นต่อๆ ไปจะขยายชุดวิดเจ็ตให้เพิ่มการรองรับเครื่องมือเลือกดีไซน์ Material ของ Wear, แถบเลื่อน, รายการ, ตัวบอกหน้า, กล่องโต้ตอบ, สัญญาณบอกสถานะการเลื่อน ข้อความโทสต์ และอื่นๆ
นอกจากนี้ยังมีการรองรับฟีเจอร์เฉพาะอื่นๆ ที่สวมใส่ได้ในอุปกรณ์ เช่น เลย์เอาต์และข้อความโค้ง รวมถึงนั่งร้านที่ช่วยให้นักพัฒนาแอปสร้างแอป/การวางซ้อนที่สวมใส่ได้ง่ายดาย
เนื้อหาสำหรับ Wear Compose ได้รับการออกแบบโดยใช้หลักการเดียวกันกับเนื้อหาสำหรับการเขียน แม้ว่าจะกำหนดเป้าหมายไปยังอุปกรณ์ที่สวมใส่ได้ ควรใช้ไลบรารี Material ของ Wear Compose แทนไลบรารี Material ของ Compose เมื่อสร้างสำหรับอุปกรณ์ที่สวมใส่ได้
ไลบรารี "Material" ทั้ง 2 รายการควรแยกเป็นอิสระและไม่ควรปะปนกันในแอปเดียวกัน หากนักพัฒนาแอปพบว่าตนเองได้รวมไลบรารี Material ของ Compose ไว้ในทรัพยากร Dependency ขอแนะนำว่า ก) มีคอมโพเนนต์หายไปจากไลบรารี Material ของ Wear Compose โปรดแจ้งให้เราทราบถึงสิ่งที่คุณต้องการ หรือ ข) ใช้คอมโพเนนต์ที่เราไม่แนะนําให้ใช้ในอุปกรณ์ที่สวมใส่ได้