Wear Compose

การประกาศทรัพยากร Dependency

หากต้องการเพิ่มทรัพยากร Dependency ใน Wear คุณต้องเพิ่มที่เก็บ Maven ของ Google ลงในโปรเจ็กต์ อ่านข้อมูลเพิ่มเติมในที่เก็บ Maven ของ Google

เพิ่มการอ้างอิงสำหรับอาร์ติแฟกต์ที่ต้องการในไฟล์ build.gradle สำหรับแอปหรือโมดูล

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

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

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

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

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

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

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

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

ดูข้อมูลเพิ่มเติมเกี่ยวกับการพึ่งพาได้ที่เพิ่มการพึ่งพิงบิวด์

ความคิดเห็น

ความคิดเห็นของคุณช่วยปรับปรุง Jetpack ได้ โปรดแจ้งให้เราทราบหากพบปัญหาใหม่หรือมีแนวคิดในการปรับปรุงคลังนี้ โปรดดูปัญหาที่มีอยู่ในคลังนี้ก่อนสร้างปัญหาใหม่ คุณสามารถเพิ่มการโหวตให้กับปัญหาที่มีอยู่ได้โดยคลิกปุ่มดาว

สร้างปัญหาใหม่

ดูข้อมูลเพิ่มเติมในเอกสารประกอบของเครื่องมือติดตามปัญหา

Wear Compose Material3 เวอร์ชัน 1.0

เวอร์ชัน 1.0.0-alpha30

11 ธันวาคม 2024

androidx.wear.compose:compose-material3:1.0.0-alpha30 ได้รับการปล่อยแล้ว เวอร์ชัน 1.0.0-alpha30 มีการคอมมิตเหล่านี้

การเปลี่ยนแปลง API

• มีการปรับโครงสร้างตัวแก้ไข scrollTransform สำหรับ TransformingLazyColumn ซึ่งทริกเกอร์การเปลี่ยนแปลง API (I0c6dc)
• เราได้อัปเดต IconToggleButtonShapes และ TextToggleButtonShapes ให้มีพารามิเตอร์รูปร่าง 2 แบบ ได้แก่ uncheckedPressed และ checkedPressed (I85dbd)
• ตอนนี้ตัวเลือกเดือน/วันที่ที่ไม่ถูกต้องจะปรากฏใน DatePicker พร้อม invalidPickerContentColor ใหม่เมื่อใช้ minDate หรือ maxDate (If4541)
• เราได้อัปเดต Stepper API เพื่อเพิ่มช่อง increaseIcon และ decreaseIcon ซึ่งเนื้อหาสำหรับช่องเหล่านี้จะสร้างได้ตามปกติจากคอมโพสิชันไอคอน (Id35da)
• เราได้อัปเดต dynamicColorScheme โดยนําพารามิเตอร์ defaultColorScheme ที่ไม่บังคับออก และตอนนี้จะแสดงผล ColorScheme แบบ Null ได้ ซึ่งหมายความว่าผู้เรียกใช้ต้องจัดการกรณีสำรองอย่างชัดเจนเมื่อไม่ได้ระบุชุดรูปแบบสีแบบไดนามิก (I6d62e)
• เราได้อัปเดตขนาดไอคอนใน ButtonDefaults เพื่อใช้กับ CompactButton CompactButton ที่มีเฉพาะไอคอนควรใช้ ButtonDefaults.SmallIconSize = 24.dp ส่วนCompactButton ที่มีทั้งไอคอนและข้อความควรใช้ ButtonDefaults.ExtraSmallIconSize = 20.dp ขอแนะนําให้ CompactButton ตัดเนื้อหา (แทนที่จะแสดงเต็มความกว้างสูงสุด) และอัปเดตตัวอย่างเพื่อแสดงข้อมูลดังกล่าว (I0582c)
• เราได้เพิ่ม EdgeButtonDefaults ที่มีขนาดไอคอนที่แนะนำสำหรับ EdgeButtonSizes 4 รายการที่แตกต่างกัน นอกจากนี้ เรายังได้อัปเดตเลย์เอาต์ EdgeButton เพื่อให้มีระยะห่างจากขอบด้านล่างมากกว่าระยะห่างจากขอบด้านบนเล็กน้อย ซึ่งช่วยปรับปรุงลักษณะที่ปรากฏของทั้งเนื้อหาไอคอนและข้อความ (Id772a)
• เราได้เพิ่มการเคลื่อนไหวลงใน LinearProgressIndicator และแสดง LinearProgressIndicatorContent ซึ่งให้เนื้อหาภาพที่ไม่มีภาพเคลื่อนไหว (Idee99)
• เราได้เพิ่มคอมโพสิชัน CircularProgressIndicatorContent ใหม่เพื่อแสดงเนื้อหาภาพ CircularProgressIndicator ที่ไม่มีภาพเคลื่อนไหว (Ie33d4)
• TransformingLazyColumn เพิ่มองค์ประกอบ LocalTransformingLazyColumnItemScope ใหม่ ซึ่งตอนนี้ Card, Button และ ListHeader ใช้เพื่อเปลี่ยนรูปร่างโดยอัตโนมัติเมื่อวางไว้ใน TransformingLazyColumn ผู้โทรสามารถปิดใช้การเปลี่ยนรูปแบบอัตโนมัติได้โดยใช้ TransformExclusion Wrapper ใหม่ (I1652f)
• เราได้อัปเดตประเภทของ ButtonDefaults.shape เป็น RoundedCornerShape (Iccdf2) แล้ว

การแก้ไขข้อบกพร่อง

• เราได้แก้ไขข้อบกพร่องเพื่อใช้ค่าอัลฟ่าที่มีอยู่บนพื้นหลังสำหรับ TimeText (I1eb60)
• เราได้ตั้งค่า TextMotion เป็น Animated โดยค่าเริ่มต้นในการจัดรูปแบบตัวอักษร เพื่อหลีกเลี่ยงการกระตุกของข้อความเนื่องจากการจับคู่อักขระตัวอักษรกับขอบเขตพิกเซลระหว่างการดำเนินการปรับขนาด (I626fa)
• เราได้อัปเดตรูปลักษณ์ของ ScrollIndicator โดยเพิ่มความกว้างและขนาดช่องว่างเพื่อปรับปรุงการแสดงผล (Ied7cb)
• เราได้แก้ไขข้อบกพร่องใน Modifier.scrollTransform เมื่อเพิ่ม/นำออก/ย้ายรายการ (I6830f)
• เราได้แก้ไขปัญหาภาพเคลื่อนไหวของปุ่มกลมสำหรับการแตะสั้นๆ แล้ว (ก่อนหน้านี้ ระยะเวลาภาพเคลื่อนไหวขั้นต่ำไม่เป็นไปตามที่คาดไว้เสมอไป) (I757a7)
• เราได้อัปเดตมุมการสแกนสำหรับ LevelIndicator เป็น 20% (72 องศา) (Idde5c)
• เราได้แก้ไขการจัดตําแหน่ง ScrollIndicator เมื่อใช้ ScalingLazyColumn กับ AutoCenteringParams แล้ว (I387dd)
• เราได้อัปเดตสีและแบบอักษรสำหรับ ListHeader และ ListSubHeader แล้ว รวมถึงสีสำหรับตัวควบคุมปุ่มเปิด/ปิดใน CheckboxButton และ SwitchButton (I39817)
• เราได้แก้ไขตำแหน่ง ScrollIndicator ใน LazyColumn และ ScalingLazyColumn ด้วย ContentPadding แล้ว (I2bc51)
• เราได้แก้ไขข้อบกพร่องที่พบในภาพเคลื่อนไหวแสดงขั้นตอนของ OpenOnPhoneDialog โดยใช้ CircularProgressIndicatorContent ใหม่ (I3e443)
• เราได้อัปเดต HorizontalPagerScaffold และ VerticalPagerScaffold เพื่อปิดใช้ภาพเคลื่อนไหวเมื่อเปิดใช้การลดการเคลื่อนไหว (Iaaf68)
• เราได้ติดตั้งใช้งานภาพเคลื่อนไหวแยกต่างหากสำหรับสัญญาณบอกสถานะความคืบหน้าแบบวงกลมเมื่อความคืบหน้ามากกว่า 100% (I47135)
• เราได้แก้ไขข้อบกพร่องที่อาจวาด EdgeButton ด้วยรูปร่างที่ไม่ถูกต้องในคอมโพเนนต์ Pager (I91db9)

เวอร์ชัน 1.0.0-alpha29

13 พฤศจิกายน 2024

androidx.wear.compose:compose-material3:1.0.0-alpha29 ได้รับการปล่อยแล้ว เวอร์ชัน 1.0.0-alpha29 มีการคอมมิตเหล่านี้

การเปลี่ยนแปลง API

• เราได้อัปเดต TimeText เพื่อแสดงเนื้อหาเริ่มต้นที่แสดงเวลา (Id23b3)
• เราได้ลดความซับซ้อนของ ScrollInfoProvider สำหรับ PagerState ด้วยการนำพารามิเตอร์ orientation ออก ซึ่งไม่จำเป็นแล้ว ลักษณะการทำงานแบบใหม่คือ TimeText จะยังคงอยู่ในตำแหน่งเดิมสำหรับการเลื่อนหน้าทั้งแนวนอนและแนวตั้ง (I71767)
• ตอนนี้ LocalHapticFeedback มีการใช้งาน HapticFeedback เริ่มต้นเมื่อ Vibrator API ระบุว่ารองรับการสัมผัส เราได้เพิ่มรายการต่อไปนี้ลงใน HapticFeedbackType - Confirm, ContextClick, GestureEnd, GestureThresholdActivate, Reject, SegmentFrequentTick, SegmentTick, ToggleOn, ToggleOff, VirtualKey ตอนนี้คอมโพเนนต์แบบคลิกค้างได้ของ Wear Compose เช่น Button, IconButton, TextButton และ Card จะใช้การสัมผัส LONG_PRESS เมื่อมีการระบุตัวแฮนเดิลการคลิกค้าง (I5083d)

การแก้ไขข้อบกพร่อง

• เราได้อัปเดตการเคลื่อนไหวสำหรับการยืนยันแล้ว (I04bff)
• เราได้อัปเดตทรัพยากร Dependency ของ API เป็น 1.7.4 สำหรับไลบรารี Compose แล้ว (I88b46)
• เพิ่มการเคลื่อนไหวใหม่สำหรับกล่องโต้ตอบ OpenOnPhone (I1e10a)
• เราได้แก้ไขข้อบกพร่องใน LevelIndicator แล้ว ตอนนี้จึงแสดงระดับเป็น 0 อย่างถูกต้อง (Ie95a4)
• เราได้อัปเดตภาพเคลื่อนไหว HorizontalPageIndicator และ VerticalPageIndicator (I5c8f3)
• เราได้เพิ่มภาพเคลื่อนไหวที่ย่อขนาดเป็นจุดให้กับ ArcProgressIndicator แบบไม่แน่นอน (I9fd51)

เวอร์ชัน 1.0.0-alpha28

30 ตุลาคม 2024

androidx.wear.compose:compose-material3:1.0.0-alpha28 ได้รับการปล่อยแล้ว เวอร์ชัน 1.0.0-alpha28 มีการคอมมิตเหล่านี้

การเปลี่ยนแปลง API

• เราได้เพิ่มรูปแบบส่วนโค้งในสัญญาณบอกสถานะความคืบหน้าแบบวงกลมที่ไม่แน่นอน (I2efc1)
• เราได้เผยแพร่คอมโพสิชัน AlertDialogContent และ Dialog ที่ใช้สร้าง AlertDialog API ให้เป็นแบบสาธารณะแล้ว เพื่อให้คุณเพิ่มการปรับแต่งได้หากจำเป็น (เช่น การปรับแต่งภาพเคลื่อนไหว AlertDialog ขณะคงเลย์เอาต์เนื้อหาที่แนะนำไว้) นอกจากนี้ เรายังได้เพิ่มพารามิเตอร์ Modifier และ Color ให้กับสมาชิก EdgeButton, ConfirmButton และ DismissButton ของ AlertDialogDefaults (I4eb71)
• เราได้อัปเดต Placeholder API ดังนี้ เปลี่ยนชื่อ PlaceholderState.startPlaceholderAnimation เป็น PlaceholderState.animatePlaceholder, PlaceholderState.isShowContent เป็น PlaceholderState.isHidden และ PlaceholderDefaults.shape เป็น PlaceholderDefaults.Shape เปลี่ยนระดับการแชร์ของ PlaceholderState.placeholderProgression จากสาธารณะเป็นภายในและเปลี่ยนชื่อเป็น placeholderShimmerProgression เพิ่มค่าคงที่ของระยะเวลาภาพเคลื่อนไหวตัวยึดตําแหน่งลงใน PlaceholderDefaultspainterpainterWithPlaceholderOverlayBackgroundBrushoriginalPainter (Ie5a59)
• เราได้อัปเดต EdgeButton API ดังนี้ เปลี่ยนชื่อพารามิเตอร์ใน ScreenScaffold จาก bottomButton เป็น edgeButton และทําให้ EdgeButtonSize เป็นคลาสค่า (Ieef15)
• เราได้เปลี่ยนระดับการแชร์ของ copy() เป็นสาธารณะในคลาสสีของวัสดุ 3 สำหรับเสื้อผ้า (I0287f)

การแก้ไขข้อบกพร่อง

• เพิ่มระยะเวลาภาพเคลื่อนไหวขั้นต่ำสำหรับ IconToggleButton และ TextToggleButton เมื่อคลิก (Ieb333)
• เพิ่มระยะเวลาขั้นต่ำในภาพเคลื่อนไหวรูปร่าง IconButton และ TextButton (Iebcee)
• แก้ไขสถานะตัวเลือก "ซ้ำ" ของ DatePicker แล้ว (I3587c)
• เพิ่มการเคลื่อนไหวสำหรับกล่องโต้ตอบการแจ้งเตือนและการยืนยัน (I173b1)

เวอร์ชัน 1.0.0-alpha27

16 ตุลาคม 2024

androidx.wear.compose:compose-material3:1.0.0-alpha27 ได้รับการปล่อยแล้ว เวอร์ชัน 1.0.0-alpha27 มีการคอมมิตเหล่านี้

การเปลี่ยนแปลง API

• เราได้อัปเดต ScreenScaffold และ ScrollIndicator หลังจากที่เปลี่ยนชื่อ Wear Compose Foundation LazyColumn เป็น TransformingLazyColumn (I0608b)
• ระบบได้เปลี่ยนชื่อพารามิเตอร์ preferredHeight ของ EdgeButton เป็น buttonSize และค่าของพารามิเตอร์นี้จะเลือกได้จากค่าคงที่ 4 ค่าในคลาสค่า EdgeButtonSize ที่เพิ่งเปิดตัว (Icdd70)
• เราได้เปลี่ยนชื่อ ListSubheader เป็น ListSubHeader และเพิ่มค่าเริ่มต้นที่เข้าถึงได้แบบสาธารณะสำหรับ ListHeader และ ListSubHeader (I96730)
• เราได้เพิ่มคอมโพเนนต์ HorizontalPagerScaffold และ VerticalPagerScaffold ใหม่สำหรับ Wear ซึ่งให้ภาพเคลื่อนไหวใหม่และประสานงานระหว่างคอมโพเนนต์ข้อความเวลากับคอมโพเนนต์ตัวบ่งชี้หน้า (Iff7d0)
• เราได้เพิ่มการรองรับปุ่มหมุนใน HorizontalPagerScaffold และ VerticalPagerScaffold ซึ่งช่วยให้ผู้ใช้ไปยังส่วนต่างๆ ของโปรแกรมรับส่งข้อความได้โดยใช้อุปกรณ์อินพุตแบบหมุน (I9770d)
• เราได้ทําการเปลี่ยนแปลง MotionScheme API เพื่อลดความซับซ้อนในการใช้งานและปรับปรุงความสอดคล้อง นําฟังก์ชันการจดจําแบบแทรกไว้และย้ายรูปแบบการเคลื่อนไหวในตัวไปยังออบเจ็กต์คอมพาเนียน MotionScheme โดยเฉพาะ เปลี่ยนชื่อ standardMotionScheme และ expressiveMotionScheme เป็นมาตรฐานและสื่ออารมณ์ (I5fd45)
• เราได้เพิ่มการรองรับรูปแบบสีแบบไดนามิกตามสีของระบบ (I073e9)
• เราได้อัปเดต Stepper เป็นข้อกำหนด UX ฉบับล่าสุดแล้ว (I622bb)

การแก้ไขข้อบกพร่อง

• เราได้อัปเดตแบบอักษรและการเว้นวรรคสำหรับคอมโพเนนต์การ์ด (I3ae48)
• เราได้เปลี่ยนระยะห่างจากขอบใน AlertDialog ระหว่างปุ่มยืนยัน/ปิดกับเนื้อหาที่เหลือจาก 8dp เป็น 12dp ตามข้อกำหนด UX (Ie55f0)
• เราได้อัปเดตความทึบแสงของสีสำหรับคอมโพเนนต์แถบเลื่อน (Idb383)

เวอร์ชัน 1.0.0-alpha26

2 ตุลาคม 2024

androidx.wear.compose:compose-material3:1.0.0-alpha26 ได้รับการปล่อยแล้ว เวอร์ชัน 1.0.0-alpha26 มีการคอมมิตเหล่านี้

การเปลี่ยนแปลง API

• เราได้อัปเดต API และลักษณะที่ปรากฏของ HorizontalPageIndicator และเพิ่ม VerticalPageIndicator เพื่อใช้กับ VerticalPager (Ic9309)
• ตอนนี้ AlertDialog รองรับการละเว้นปุ่มด้านล่างเริ่มต้นจากรูปแบบกองปุ่มสําหรับเลย์เอาต์ที่กําหนดเองซึ่งไม่จําเป็นต้องใช้ EdgeButton (I34fa9)
• เราได้เพิ่มคอมโพเนนต์ SwipeToReveal สำหรับ Wear Material 3 (Ic38b2) แล้ว
• เราได้เพิ่มการรองรับการปัดแบบ 2 ทิศทางใน SwipeToReveal สำหรับกรณีที่พบไม่บ่อยที่หน้าจอปัจจุบันไม่รองรับการปัดเพื่อปิด ค่าเริ่มต้นจะยังคงเป็นการปัดเพื่อแสดงเฉพาะเมื่อปัดไปจากขวาไปซ้าย และเราขอแนะนำอย่างยิ่งให้ใช้ลักษณะการทำงานเริ่มต้นเพื่อหลีกเลี่ยงความขัดแย้งกับการปัดเพื่อปิด (Ifac04)
• เราได้เปลี่ยนชื่อพารามิเตอร์ buttonHeight ของ EdgeButton เป็น preferredHeight (I4fab3)
• อัปเดต Kotlin เป็นเวอร์ชัน 1.9 แล้ว (I1a14c)
• เราได้เปลี่ยนชื่อ OpenOnPhoneDialogDefaults.Icon เป็น OpenOnPhoneDialogDefaults.OpenOnPhoneIcon เพื่อไม่ให้ชนกับ Icon(I0f391)
• เราได้เพิ่มการรองรับ ScrollIndicator ใน LazyColumn (Ia546a)
• เราได้อัปเดตค่าเริ่มต้นสำหรับ TextToggleButton และ IconToggleButton แล้ว (I7aaa9)
• เราได้ลดความซับซ้อนของ Picker และ PickerGroup API (Id0653)
• เราได้เพิ่ม CardDefaults.Shape และ CardDefaults.Height ซึ่ง (เนื่องจากเป็นโทเค็น) จะเป็นข้อมูลส่วนตัวสำหรับนักพัฒนาแอปที่ใช้ไลบรารี (I1594a, b/347649765)
• เราได้เปลี่ยนชื่อพารามิเตอร์ความคืบหน้าของสัญญาณบอกสถานะความคืบหน้าแบบวงกลมที่แบ่งออกเป็นส่วนๆ แบบไบนารีเป็น segmentValue (Ib72d9)
• เราได้อัปเดตสีและเลย์เอาต์ของแถบเลื่อนแล้ว (Ic3eec)

การแก้ไขข้อบกพร่อง

• เราได้อัปเดตภาพเคลื่อนไหวของไอคอน openOnPhone (I66f85) แล้ว
• ตอนนี้เราใช้ไอคอนสัญลักษณ์ Google ใน Slider, TimePicker และ DatePicker (I46c7c)
• เราได้อัปเดตระยะห่างจากขอบใน Confirmation และ OpenOnPhoneDialog แล้ว (Iaa82e)

เวอร์ชัน 1.0.0-alpha25

18 กันยายน 2024

androidx.wear.compose:compose-material3:1.0.0-alpha25 ได้รับการปล่อยแล้ว เวอร์ชัน 1.0.0-alpha25 มีการคอมมิตเหล่านี้

การเปลี่ยนแปลง API

• เราได้เพิ่มสัญญาณบอกสถานะความคืบหน้าแบบวงกลมที่ไม่ทราบเวลาสิ้นสุด (I427a7)
• เราได้เพิ่มการรองรับการประมวลผลข้อมูลเกินเปอร์เซ็นต์ (เปอร์เซ็นต์มากกว่า 100%) ทั้งสำหรับ CircularProgressIndicator และ SegmentedCircularProgressIndicator เมื่อความคืบหน้าเกิน 1.0 ระบบจะแสดงด้วยสี overflowTrack ใหม่ (Iaaa3d)
• ตอนนี้ IconToggleButton และ TextToggleButton แบบกลมรองรับรูปแบบภาพเคลื่อนไหวของรูปร่างแบบใหม่แล้ว ซึ่งรูปร่างต่างๆ จะแสดงสถานะ "เลือก" "ไม่ได้เลือก" และ "กด" ระบบจะยังคงรองรับรูปแบบรูปร่างแบบเคลื่อนไหวก่อนหน้านี้สำหรับสถานะ "เพิ่งกด" (I29f03)
• เราได้ยกเลิกการรองรับการใช้ EdgeButton กับ Column เนื่องจากต้องระบุความสูง EdgeButton อย่างชัดแจ้งใน ScreenScaffold (Ie353d)
• เราได้เพิ่มการรองรับ Wear Compose LazyColumn ด้วย ScreenScaffold (และเพิ่มการใช้งาน ScrollInfoProvider สำหรับ LazyColumnState) (Ib8d29)
• เราได้รวม LocalTextMaxLines, LocalTextAlign, LocalTextOverflow เข้าเป็นองค์ประกอบ LocalTextConfiguration เดียวในเครื่องเพื่อให้เป็นโซลูชันที่ปรับขนาดได้มากขึ้นในอนาคต (I5edbc)
• เราได้เพิ่ม arc-large เป็นขนาดตัวอักษรเพิ่มเติม ซึ่งสงวนไว้สำหรับสตริงข้อความส่วนหัวสั้นๆ ที่ด้านบนสุดหรือด้านล่างสุดของหน้าจอ เช่น ในข้อความวางซ้อนสำหรับการยืนยัน (I60e3e)
• เราได้เพิ่มค่าเริ่มต้นลงในปุ่มสำหรับขนาดไอคอนขนาดใหญ่และขนาดใหญ่พิเศษที่แนะนำ รวมถึงระยะห่างจากขอบของเนื้อหา (I84675)

การแก้ไขข้อบกพร่อง

• เราได้อัปเดตสีสำหรับ IconButton และ TextButton แล้ว (I48324)
• เราได้เปลี่ยนการโอเวอร์โหลดพื้นฐานของ Button ให้จัดแนวในแนวตั้งตรงกลางเพื่อให้สอดคล้องกับการโอเวอร์โหลดอื่นๆ หากต้องการคืนค่าลักษณะการทำงานก่อนหน้า ให้ใช้ Modifier.align จาก RowScope (I66e57)

เวอร์ชัน 1.0.0-alpha24

4 กันยายน 2024

androidx.wear.compose:compose-material3:1.0.0-alpha24 ได้รับการปล่อยแล้ว เวอร์ชัน 1.0.0-alpha24 มีการคอมมิตเหล่านี้

การเปลี่ยนแปลง API

• เราได้เพิ่มรูปแบบการเคลื่อนไหวลงในธีม Material3 แล้ว คอมโพเนนต์ในไลบรารีจะใช้ข้อมูลนี้เพื่อใช้ข้อกำหนดเฉพาะของภาพเคลื่อนไหว เช่น สปริงสำหรับการเคลื่อนไหวที่สื่ออารมณ์ (I54ff3)
• เราได้เพิ่มคอมโพเนนต์ AppScaffold และ ScreenScaffold ลงในคลัง Material3 ซึ่งมีฟังก์ชันการทำงานเพื่อประสานงานการวางซ้อนและทรานซิชันของ TimeText และ ScrollIndicator AppScaffold มีคอมโพเนนต์สแคฟเฟิลด์ระดับบนสุดที่วางอยู่ด้านบนของหน้าจอทั้งหมด ดังนั้น การเพิ่ม TimeText ลงใน AppScaffold จะช่วยให้ AppScaffold คงที่ขณะที่ปัดระหว่างหน้าจอ หน้าจอสามารถลบล้างหรือซ่อนข้อความเวลาได้ ScreenScaffold มีช่องสำหรับ ScrollIndicator และแสดงภาพเคลื่อนไหวของเคอร์เซอร์การเลื่อนโดยอัตโนมัติเมื่อเลื่อน รวมถึงหมดเวลาเพื่อซ่อนเคอร์เซอร์การเลื่อนหลังจากไม่มีการใช้งาน (I047d6)
• เราได้เพิ่ม ScrollIndicator ที่มีการออกแบบ Material3 ใหม่ โดยจะมีขนาดภาพขนาดย่อคงที่ตามเนื้อหารายการเริ่มต้น เพื่อหลีกเลี่ยงความหลากหลายของขนาดเมื่อระบบโหลดเนื้อหาแบบ Lazy ลงในรายการ (Ic228d)
• เราได้เปลี่ยน ScrollAway API เพื่อให้ ScreenStage เป็นคลาสค่าแทนที่จะเป็นคลาส Enum เพื่ออนุญาตให้เพิ่มระยะการทำงานเพิ่มเติมได้ตามต้องการในอนาคต (I48c93)
• เราได้เพิ่ม EdgeButton ซึ่งเป็นปุ่มเฉพาะสำหรับ Wear ที่มีรูปร่างตามส่วนโค้งของด้านล่างของหน้าจอ (I16369)
• เราได้เพิ่มช่องใหม่ลงใน ScreenScaffold สำหรับปุ่มด้านล่าง (เช่น EdgeButton) ซึ่งจะแสดงและปรับขนาดตามเนื้อหาที่เลื่อน (I032eb)
• เราได้เพิ่ม Modifier.scrollTransform และ Modifier.targetMorphingHeight เพื่อเพิ่มเอฟเฟกต์การเคลื่อนไหวของ Material3 ให้กับรายการใน LazyColumn (Ie229a)
• เราได้เพิ่ม SegmentedCircularProgressIndicator เป็นรูปแบบของ CircularProgressIndicator แล้ว ตัวแปรที่แบ่งกลุ่มจะแสดงค่าความคืบหน้าเดียวในทุกกลุ่ม หรือแสดงแต่ละกลุ่มเป็นเปิด/ปิด (I6e059)
• เราได้เพิ่ม LinearProgressIndicator เพื่อเป็นทางเลือกเพิ่มเติมจาก CircularProgressIndicator ที่มีอยู่ (I89182)
• เราได้เพิ่ม AlertDialog ซึ่งแสดงเลย์เอาต์สำหรับแสดงพรอมต์สำคัญต่อผู้ใช้ รูปแบบต่างๆ จะรวมไว้สำหรับปุ่มยืนยัน/ปิด 2 ปุ่มหรือปุ่มด้านล่างปุ่มเดียว (โดยทั่วไปคือ EdgeButton) ใต้กองตัวเลือก ทั้ง 2 รูปแบบมีช่องสำหรับไอคอน ชื่อ และข้อความเพิ่มเติมเพื่อแสดงรายละเอียดเพิ่มเติม (Ieb873)
• เราได้เพิ่ม OpenOnPhoneDialog ซึ่งควรใช้เพื่อระบุการดำเนินการที่จะดำเนินการต่อในโทรศัพท์ของผู้ใช้ OpenOnPhoneDialog จะปิดลงหลังจากหมดเวลาที่กำหนด (I978fd)
• เราได้เพิ่ม Confirmation ซึ่งเป็นคอมโพเนนต์กล่องโต้ตอบที่มีช่องสำหรับไอคอนและข้อความโค้งหรือเส้นตรง มีข้อความสำเร็จ/ไม่สำเร็จที่หลากหลาย การยืนยันจะปิดโดยอัตโนมัติหลังจากหมดเวลา (Ib43e8)
• เราได้เพิ่มพื้นหลังให้กับ TimeText เพื่อลดปัญหาที่เนื้อหาที่อยู่เบื้องหลังและ TimeText ทับซ้อนกันและบดบังเวลา (Ia11fd)
• เราได้เพิ่ม LevelIndicator ซึ่งแสดงค่าของการตั้งค่า เช่น ระดับเสียง และใช้ร่วมกับคอมโพเนนต์ Stepper ที่มีอยู่เพื่อสร้างหน้าจอระดับเสียงได้ LevelIndicator คล้ายกับ ScrollIndicator แต่แสดงอยู่ฝั่งตรงข้ามของหน้าจอ มีความกว้างของเส้นหนากว่า และมีสีตัวบ่งชี้ที่ต่างกันโดยค่าเริ่มต้น (I8a4ac)
• เราได้เพิ่ม TimePicker ที่มีเลย์เอาต์สำหรับเวลาแบบ 24 ชั่วโมง (มีหรือไม่มีวินาที) หรือเวลาแบบ 12 ชั่วโมงพร้อมตัวเลือก am/pm (Ia5124)
• เราได้เพิ่ม DatePicker พร้อมการกำหนดค่าสำหรับการจัดเรียงคอลัมน์ (เช่น วัน-เดือน-ปี เดือน-วัน-ปี หรือปี-เดือน-วัน) และวันที่ขั้นต่ำ/สูงสุดที่ไม่บังคับ (Ibf13b)
• เราได้เพิ่มพารามิเตอร์น้ำหนักลงในฟังก์ชัน text ของ TimeText ในกรณีที่ TimeText ประกอบด้วยองค์ประกอบข้อความมากกว่า 1 รายการ ตัวเลือกนี้จะให้คุณควบคุมวิธีจัดสรรพื้นที่ว่างได้ (I36700)
• เราได้เพิ่ม RadioButton และ SplitRadioButton ซึ่งคอมโพเนนต์เหล่านี้จะลดความซับซ้อนของ API ก่อนหน้าด้วยการรวมทั้ง (Split)SelectableButton และการควบคุมตัวเลือกแบบเปิด/ปิด (If7ae8) เข้าด้วยกัน
• เราได้เพิ่ม CheckboxButton และ SplitCheckboxButton ซึ่งคอมโพเนนต์เหล่านี้จะลดความซับซ้อนของ API ก่อนหน้าด้วยการรวมทั้งการควบคุมช่องทําเครื่องหมายย่อย (แยก)ToggleButton และ (Ia8f70)
• เราได้เพิ่ม SwitchButton และ SplitSwitchButton ซึ่งคอมโพเนนต์เหล่านี้จะลดความซับซ้อนของ API ก่อนหน้าด้วยการรวมทั้ง (Split)ToggleButton และตัวควบคุม Switch ย่อย (I0d349)
• เราได้อัปเดตเอกสารประกอบของ AnimatedText เพื่ออธิบายลักษณะการเกินราคา (Iff30a)
• เราได้เพิ่ม ButtonGroup เพื่อรวมปุ่ม 2 หรือ 3 ปุ่มเข้าด้วยกันเพื่อให้การกดปุ่มสร้างภาพเคลื่อนไหวที่ประสานกัน (Ie27db)
• เราได้เพิ่มภาพเคลื่อนไหวของรูปร่างสำหรับ IconButton และ TextButton เมื่อกด (ไม่บังคับ) (Iffca5)
• เราได้เพิ่มสี FilledVariant เข้ามาเป็นตัวเลือกเพิ่มเติมจาก Button, IconButton, TextButton, CompactButton และ EdgeButton (I65fc3)
• เราได้เพิ่มพารามิเตอร์ forcedSize ลงใน ImageWithScrimPainter เพื่อให้พื้นหลังรูปภาพของปุ่มคงขนาดคอมโพเนนต์ไว้โดยค่าเริ่มต้น การตั้งค่า forcedSize = null จะนํา Painter.instrinsicSize มาใช้แทน (Ic57af)
• เราได้เพิ่มการกดปุ่มค้างไว้ (Ib613d)
• นอกจากนี้ เรายังได้เพิ่มการรองรับการคลิกค้างไปยัง IconButton และ TextButton ด้วย (I38891)
• เพิ่มการรองรับการคลิกค้างไว้ในการ์ดแล้ว (I305d5)
• เราได้เพิ่ม LocalTextMaxLines, LocalTextAlign, LocalTextOverflow เป็น CompositionLocals และใช้พารามิเตอร์ดังกล่าวเป็นค่าเริ่มต้นใน Text ตอนนี้คอมโพเนนต์ต่างๆ เช่น CheckboxButton, SwitchButton, RadioButton สามารถใช้องค์ประกอบในคอมโพสิชันเพื่อใช้หลักเกณฑ์ UX แต่นักพัฒนาแอปสามารถลบล้างพารามิเตอร์ได้หากจําเป็น (Iab841)
• เราได้เพิ่ม Placeholder เพื่อช่วยในการมาสก์เนื้อหาของคอมโพเนนต์ เช่น ปุ่มและการ์ด จนกว่าระบบจะโหลดข้อมูล (I1a532)
• เราได้เพิ่ม IconToggleButtonColors และ TextToggleButtonColors เข้ามาแทนที่ ToggleButtonColors ที่ถูกนำออกแล้ว (Ie0bf1)

การแก้ไขข้อบกพร่อง

• เราได้อัปเดต Button, FilledTonalButton, OutlinedButton, ChildButton, CompactButton เพื่อใช้ CompositionLocals LocalTextMaxLines, LocalTextAlign, LocalTextOverflow ใหม่เพื่อใช้คําแนะนํา UX ซึ่งนักพัฒนาแอปสามารถลบล้างพารามิเตอร์เหล่านี้ในข้อความได้โดยตรง หากจําเป็น (Ie51f7)
• เราได้เปลี่ยนความกว้างของเส้นโครงร่างเริ่มต้นของ LevelIndicator เป็น 6dp เพื่อแยกความแตกต่างจาก ScrollIndicator ซึ่งมีเส้นโครงร่างความกว้าง 4dp (If6f63)
• เราได้แก้ไขปัญหาใน TimeText เพื่อให้รองรับมุมการกวาดที่กว้างขึ้น (Ie489f)
• แก้ไขปัญหาระหว่างการจัดองค์ประกอบใหม่ของ EdgeButton (I4cdca)
• แก้ไขเลย์เอาต์ของปุ่มเปิด/ปิดแบบแยกเมื่อระบุการเว้นวรรคเนื้อหาที่กําหนดเอง (Ia33d3)
• ปัดเศษค่าความคืบหน้าเล็กๆ ขึ้นเป็นอย่างน้อยเท่ากับความกว้างของเส้นตัวบ่งชี้ความคืบหน้า (I3bd84)

เวอร์ชัน 1.0.0-alpha23

14 พฤษภาคม 2024

androidx.wear.compose:compose-material3:1.0.0-alpha23 ได้รับการปล่อยแล้ว เวอร์ชัน 1.0.0-alpha23 มีการคอมมิตเหล่านี้

การเปลี่ยนแปลง API

• เราได้อัปเดต ToggleButton และ RadioButton API เพื่อให้กำหนดค่าสีที่ปิดใช้ได้ (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

• เราได้อัปเดต Material3 ColorScheme แล้ว (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 ลงในคลัง Wear Compose Material3 แล้ว คอมโพเนนต์นี้จะแสดงเวลาปัจจุบัน (และสถานะเพิ่มเติม) ที่ด้านบนของหน้าจอ Material3 API ใหม่ที่กระชับจะช่วยหลีกเลี่ยงการซ้ำกันระหว่างเนื้อหาแบบเส้นตรงและแบบโค้ง (I4d7c3)
• เราได้อัปเดตชื่อพารามิเตอร์จาก onSelected เป็น onSelect สําหรับ RadioButton แล้ว (I1a971)
• แยก RadioButton และ SplitRadioButton เป็นโทเค็น และจัดระเบียบวิธีการที่มีอยู่เพื่อลดจำนวนการค้นหา CompositionLocal ด้วยการเพิ่มอินสแตนซ์สีที่แคชไว้ และทำให้วิธีการของ RadioButtonColors และ SplitRadioButtonColors เป็นวิธีการภายใน (I02b33)

เวอร์ชัน 1.0.0-alpha18

21 กุมภาพันธ์ 2024

androidx.wear.compose:compose-material3:1.0.0-alpha18 ได้รับการปล่อยแล้ว เวอร์ชัน 1.0.0-alpha18 มีการคอมมิตเหล่านี้

การเปลี่ยนแปลง API

• เราได้ปรับรูปแบบค่าเริ่มต้นสำหรับ CardColors, ToggleButtonColors และ SplitToggleButtonColors โดยการสร้างอินสแตนซ์ที่แคชไว้ภายในและลดการใช้งาน CompositionLocal (If3fec)

เวอร์ชัน 1.0.0-alpha17

7 กุมภาพันธ์ 2024

androidx.wear.compose:compose-material3:1.0.0-alpha17 ได้รับการปล่อยแล้ว เวอร์ชัน 1.0.0-alpha17 มีการคอมมิตเหล่านี้

การเปลี่ยนแปลง API

• เราได้อัปเดต Button API ให้ใช้ buttonColors โดยค่าเริ่มต้นและนำ filledButtonColors ที่ซ้ำกันออก (I4fe3b)
• เราได้ปรับโครงสร้างรูปแบบเริ่มต้นสำหรับ ButtonColors, IconButtonColors และ TextButtonColors โดยการสร้างอินสแตนซ์ที่แคชไว้ภายในและลดการใช้งาน CompositionLocal (I5f51c)
• เราได้นําค่าใช้จ่ายเพิ่มเติมของ rememberUpdatedState ในคลาสสีเฉพาะคอมโพเนนต์ออกแล้ว และทําเครื่องหมายเมธอดการเข้าถึงภายในคลาสสีเป็น "ภายใน" (If6571)

การแก้ไขข้อบกพร่อง

• เราได้อัปเดต Modifier.minimumInteractiveComponentSize เพื่อใช้ Modifier.node แล้ว (Iba6b7)

เวอร์ชัน 1.0.0-alpha16

24 มกราคม 2024

androidx.wear.compose:compose-material3:1.0.0-alpha16 ได้รับการปล่อยแล้ว เวอร์ชัน 1.0.0-alpha16 มีการคอมมิตเหล่านี้

ฟีเจอร์ใหม่

• เราได้เพิ่ม CompactButton ซึ่งสามารถใช้สีแบบเติม สีแบบโทนสีที่เติม และสีที่วาดเส้นขอบได้เช่นเดียวกับปุ่ม (I05df0)

การเปลี่ยนแปลง API

• เราได้เพิ่ม RadioButton/SplitRadioButton เป็นตัวคอนเทนเนอร์สำหรับตัวควบคุมการเลือก เช่น ตัวควบคุมตัวเลือกแบบเปิด/ปิด ซึ่งแตกต่างจาก ToggleButton ที่มีอยู่ตรงที่ RadioButton สามารถเลือกได้ (และทำงานภายในกลุ่มการเลือก) ส่วน ToggleButton จะเปิด/ปิดได้ (และทำงานอิสระ) (I61275)
• เราจะนำ LocalContentAlpha ออกจากคลัง Wear Compose Material3 เพื่อให้สอดคล้องกับคลัง Compose Material3 (I49a0a)
• คอมโพเนนต์ Wear Material และ Wear Material3 ที่แสดง MutableInteractionSource ใน API ได้รับการอัปเดตให้แสดง MutableInteractionSource แบบ Null ที่ค่าเริ่มต้นเป็น Null ไม่มีการทําการเปลี่ยนแปลงเชิงความหมายในส่วนนี้ การผ่านค่า Null หมายความว่าคุณไม่ต้องการยกระดับ MutableInteractionSource และระบบจะสร้าง MutableInteractionSource นั้นภายในคอมโพเนนต์หากจําเป็น การเปลี่ยนเป็น null จะช่วยให้คอมโพเนนต์บางรายการไม่จัดสรร MutableInteractionSource เลย และช่วยให้คอมโพเนนต์อื่นๆ สร้างอินสแตนซ์แบบเลื่อนเวลาไว้ใช้เมื่อจำเป็นเท่านั้น ซึ่งจะช่วยปรับปรุงประสิทธิภาพของคอมโพเนนต์เหล่านี้ หากคุณไม่ได้ใช้ MutableInteractionSource ที่ส่งไปยังคอมโพเนนต์เหล่านี้ เราขอแนะนำให้ส่งค่า Null แทน นอกจากนี้ เราขอแนะนำให้คุณทำการเปลี่ยนแปลงที่คล้ายกันในคอมโพเนนต์ของคุณเองด้วย (Ib90fc, b/298048146)
• เพิ่ม Ripple API ใหม่ในไลบรารี wear:compose-material และ wear:compose-material3 ซึ่งมาแทนที่ rememberRipple ที่เลิกใช้งานแล้ว นอกจากนี้ ยังเพิ่ม CompositionLocal ชั่วคราว LocalUseFallbackRippleImplementation เพื่อเปลี่ยนคอมโพเนนต์ Material กลับไปใช้ rememberRipple/RippleTheme API ที่เลิกใช้งานแล้ว เราจะนำตัวเลือกนี้ออกในรุ่นที่ใช้งานเสถียรรุ่นถัดไป และตัวเลือกนี้มีไว้เพื่อเป็นความช่วยเหลือในการย้ายข้อมูลชั่วคราวในกรณีที่คุณระบุ RippleTheme ที่กําหนดเองเท่านั้น ดูข้อมูลการย้ายข้อมูลและข้อมูลเบื้องต้นเพิ่มเติมเกี่ยวกับการเปลี่ยนแปลงนี้ได้ที่ developer.android.com (af92b21)
• เราได้ทำการปรับปรุงเล็กน้อยใน HorizontalPageIndicator api และเอกสารประกอบ (I60efc)
• เราได้อัปเดต ColorScheme ให้เป็นค่าแบบคงที่ ซึ่งทำให้การอัปเดตสีแต่ละสีมีประสิทธิภาพน้อยลง แต่ทำให้การใช้งานสีทั่วไปมีประสิทธิภาพมากขึ้น เหตุผลของการเปลี่ยนแปลงนี้ก็คือแอปส่วนใหญ่ไม่ได้ใช้การอัปเดตสีแต่ละสีเป็น Use Case หลัก การดำเนินการนี้ยังคงเป็นไปได้ แต่จะคอมโพสใหม่มากกว่าเดิม ซึ่งจะทำให้เราลดจำนวนการสมัครใช้บริการสถานะผ่านโค้ดของ Material ทั้งหมดได้อย่างมาก และส่งผลต่อต้นทุนในการเริ่มต้นและรันไทม์ของ Use Case มาตรฐานมากขึ้น (Ibc2d6)
• อัปเดต API ToggleButton และ SplitToggleButton เพื่ออนุญาตให้ปรับแต่งสีที่ปิดใช้ นอกจากนี้ ตอนนี้ระบบจะใช้โทเค็น Material Design สำหรับค่าสีและแบบอักษร (If087c)
• อัปเดตสีพื้นหลังของรูปภาพปุ่มให้ใช้โทเค็น Material Design (Iba215)
• เราได้เปลี่ยนคอมโพเนนต์ Checkbox, Switch และ RadioButton ให้แสดงผลเท่านั้นโดยนําการจัดการการคลิกออก คาดว่าจะใช้คอมโพเนนต์เหล่านี้ใน (Split)ToggleButton ซึ่งจัดการการคลิก ดังนั้นตอนนี้จึงมีการระบุว่าคอมโพเนนต์เหล่านี้เป็นการแสดงผลเท่านั้นอย่างชัดเจนยิ่งขึ้น (และไม่ได้มีไว้สําหรับใช้งานแบบสแตนด์อโลนใน Wear) (I2322e)

การแก้ไขข้อบกพร่อง

• เราได้เพิ่มโทเค็นสำหรับค่าการเคลื่อนไหวของระยะเวลาและการผ่อนปรนใน Wear Compose Material 3 (I437cd)
• เราได้แก้ไขข้อบกพร่องใน ToggleButton, SplitToggleButton, Checkbox, Switch และ RadioButton เพื่อไม่ให้ประกาศการช่วยเหลือพิเศษซ้ำกัน (ก่อนหน้านี้มีบทบาทเชิงความหมายซ้ำกัน) (Ica281)
• เราได้นําเลเยอร์ materialcore ของ CompactButton ออกเพื่อปรับปรุงประสิทธิภาพ (7902858)

เวอร์ชัน 1.0.0-alpha15

15 พฤศจิกายน 2023

androidx.wear.compose:compose-material3:1.0.0-alpha15 ได้รับการปล่อยแล้ว เวอร์ชัน 1.0.0-alpha15 มีการคอมมิตเหล่านี้

การเปลี่ยนแปลง API

• เราได้เปลี่ยนชื่อระดับพื้นฐาน SwipeToDismissBox เป็น BasicSwipeToDismissBox วิธีนี้ช่วยให้แยกความแตกต่างระหว่างคอมโพเนนต์ระดับ Foundation กับ SwipeToDismissBox ระดับ Material3 ได้ชัดเจนขึ้น โดยที่ MaterialTheme จะดึงสีจาก BasicSwipeToDismissBox เพื่อใช้ในภาพตัวอย่าง และมอบหมายการติดตั้งใช้งานที่เหลือให้กับ 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 ออกจาก Material3 HorizontalPageIndicator แล้ว โดยระบบจะเป็นไปตามรูปร่างของหน้าจออุปกรณ์ (แนวนอนหรือกลม) แทน (I83728)
• เราได้แยกสีสำหรับ SplitToggleButton ออกจากสีสำหรับ ToggleButton โดยการเพิ่มคลาส SplitToggleButtonColors ใหม่ (I78bee)

เวอร์ชัน 1.0.0-alpha13

4 ตุลาคม 2023

androidx.wear.compose:compose-material3:1.0.0-alpha13 ได้รับการปล่อยแล้ว เวอร์ชัน 1.0.0-alpha13 มีการคอมมิตเหล่านี้

การเปลี่ยนแปลง API

• เราได้เพิ่มช่องคำบรรยาย (ไม่บังคับ) ลงใน TitleCard (Ifc45a)
• เราได้เพิ่มโทนสี Material Design สำหรับ TextButton แล้ว (I769dc)

เวอร์ชัน 1.0.0-alpha12

20 กันยายน 2023

androidx.wear.compose:compose-material3:1.0.0-alpha12 ได้รับการปล่อยแล้ว เวอร์ชัน 1.0.0-alpha12 มีการคอมมิตเหล่านี้

การเปลี่ยนแปลง API

• เราได้อัปเดต IconButton ให้ใช้โทเค็น Material Design แล้ว (I3f137)
• เราได้อัปเดต IconToggleButton ให้ใช้โทเค็น Material Design แล้ว (I7d263)
• เราได้เปิดเผยตัวสร้างของ CheckboxColors, RadioButtonColors, SwitchColors สู่สาธารณะแล้ว (I82b73)

เวอร์ชัน 1.0.0-alpha11

6 กันยายน 2023

androidx.wear.compose:compose-material3:1.0.0-alpha11 ได้รับการปล่อยแล้ว เวอร์ชัน 1.0.0-alpha11 มีการคอมมิตเหล่านี้

การแก้ไขข้อบกพร่อง

• เราได้อัปเดตแบบอักษรสำหรับการ์ด Material3 เป็น TitleMedium แล้ว (I597bd)
• เราได้อัปเดตแบบอักษรและการจัดแนวสำหรับ ListHeader และ ListSubheader ของ Material3 แล้ว (Ib5ceb)

เวอร์ชัน 1.0.0-alpha10

23 สิงหาคม 2023

androidx.wear.compose:compose-material3:1.0.0-alpha10 ได้รับการปล่อยแล้ว เวอร์ชัน 1.0.0-alpha10 มีการคอมมิตเหล่านี้

ฟีเจอร์ใหม่

• เพิ่ม HorizontalPageIndicator ในคลัง Wear Material3 (Ifee99)

การเปลี่ยนแปลง API

• อัปเดตโค้ดปุ่มเพื่อใช้โทเค็นการออกแบบ Material3 (I92fe4)
• การประกาศว่า Wear Material 3 Stepper และ Slider API เป็นเวอร์ชันทดลองเนื่องจากรายละเอียดของอินเทอร์เฟซผู้ใช้ยังอยู่ระหว่างการสรุป (I84d54)
• เราได้นําขนาด ExtraSmall ออกจาก TextButton และ TextToggleButton แบบกลมแล้ว เนื่องจากขนาดดังกล่าวใช้ได้กับ IconButton เท่านั้น (Ibc7d5)

การแก้ไขข้อบกพร่อง

• เราได้อัปเดตคำแนะนำเกี่ยวกับการจัดรูปแบบตัวอักษรสำหรับ TextToggleButton ให้ใช้ LabelLarge สำหรับ LargeButtonSize (Ib10fa)
• เราได้อัปเดตคำแนะนำเกี่ยวกับการจัดรูปแบบตัวอักษรสำหรับ TextButton ให้ใช้ LabelLarge สำหรับ LargeButtonSize (I8f3a7)
• เราได้กำหนดเป้าหมายการสัมผัสขั้นต่ำของการ์ดไว้ที่ 48dp เพื่อรองรับการช่วยเหลือพิเศษ (Ieb9b1)
• เพิ่ม AppCard พร้อมภาพสาธิต การนํา AppCard ออกพร้อมภาพสาธิตพื้นหลัง (Id735f)
• แก้ไขข้อบกพร่องในปุ่มกลมที่ไม่ได้ต่อคีย์ตัวหนอนอย่างถูกต้อง (I5e162)

เวอร์ชัน 1.0.0-alpha09

9 สิงหาคม 2023

androidx.wear.compose:compose-material3:1.0.0-alpha09 ได้รับการปล่อยแล้ว เวอร์ชัน 1.0.0-alpha09 มีการคอมมิตเหล่านี้

ฟีเจอร์ใหม่

• เราได้เพิ่ม ToggleButton สำหรับ material3 (I6bed6) แล้ว

การเปลี่ยนแปลง API

• เราได้เปิดใช้คำอธิบายประกอบ FloatRange เป็นข้อจำกัดของ API ตามที่ระบุไว้ในความคิดเห็นก่อนหน้านี้ (Icb401)
• เราได้อัปเดตแบบอักษรสำหรับ Wear Material3 ให้เป็นไปตามหลักเกณฑ์ Material3 ล่าสุด (I1bad6)

การแก้ไขข้อบกพร่อง

• เราได้อัปเดตสีของ Button, IconButton และ TextButton ให้สอดคล้องกับการออกแบบ Material3 แล้ว (Ib2495)
• เราได้แก้ไขการแสดงเครื่องหมายถูกในช่องทําเครื่องหมายในสถานะปิดใช้ (Ib25bf)

เวอร์ชัน 1.0.0-alpha08

26 กรกฎาคม 2023

androidx.wear.compose:compose-material3:1.0.0-alpha08 ได้รับการปล่อยแล้ว เวอร์ชัน 1.0.0-alpha08 มีการคอมมิตเหล่านี้

ฟีเจอร์ใหม่

• เราได้เพิ่มตัวควบคุมการเลือกต่อไปนี้สำหรับ Material3 - Switch, Checkbox, RadioButton (Ib918c)
• เราได้เพิ่ม IconToggleButton และ TextToggleButton ลงใน Material3 ซึ่งเป็นปุ่มเปิด/ปิดแบบกลมที่มีช่องเดียวสำหรับไอคอนและข้อความตามลำดับ สำหรับ ToggleButton ขนาดต่างๆ เราขอแนะนำให้ใช้ Modifier.touchTargetAwareSize ที่มีขนาดที่ระบุไว้ในปุ่มเปิด/ปิดที่เกี่ยวข้อง (I9f015)
• เราได้เพิ่ม ListHeader และ ListSubheader ลงในคอมโพเนนต์ Material3 แล้ว (Ibaefe)
• เราได้เพิ่ม Material3 SwipeToDismissBox ซึ่งเรียกใช้ Foundation SwipeToDismissBox เวอร์ชันใหม่และระบุค่าสีเริ่มต้นจากธีม (I275fb)
• เราได้เพิ่ม InlineSlider ของ Material3 ลงใน Wear Compose แล้ว ซึ่งช่วยให้ผู้ใช้เลือกจากช่วงค่าได้ ช่วงของตัวเลือกจะแสดงเป็นแถบระหว่างค่าต่ำสุดและสูงสุดของช่วง ซึ่งผู้ใช้จะเลือกค่าใดค่าหนึ่งได้ InlineSlider เหมาะสำหรับการปรับการตั้งค่า เช่น ระดับเสียงหรือความสว่าง (I7085f)

การเปลี่ยนแปลง API

• เราได้อัปเดตธีมรูปร่างใน Wear Material 3 ให้ใช้ RoundedCornerShape แทน Shape แล้ว (Idb133)
• เราได้ทำให้ค่าคงที่ความสูงของ Button เป็นสาธารณะ (Idbfde)
• อัปเดตไฟล์ API เพื่อกำกับเนื้อหาการระงับความเข้ากันได้ (I8e87a, b/287516207)
• เราได้อัปเดต InlineSliderColors ใน Wear Compose Material 3 ให้มีคอนสตรัคเตอร์สาธารณะและพร็อพเพอร์ตี้สาธารณะ (I6b632)
• เราได้อัปเดตคลาสสีทั้งหมดใน Wear Compose Material 3 ให้มีคอนสตรัคเตอร์และพร็อพเพอร์ตี้สาธารณะ (I17702)
• เราได้ทำให้ค่าคงที่ของระยะห่างจากขอบแนวนอนและแนวตั้งของ Button เป็นสาธารณะ (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 ลงในคลัง Compose สำหรับ Wear OS Material 3 แล้ว ซึ่งคล้ายกับ Material เวอร์ชันก่อนหน้า แต่จะละเว้นความหมายของช่วงโดยค่าเริ่มต้นตามความคิดเห็นของนักพัฒนาซอฟต์แวร์ เราระบุ Modifier.rangeSemantics ในกรณีที่ต้องใช้ความหมายของช่วง (Ic39fd)
• เราได้เพิ่ม curvedText ลงในคลัง Compose สำหรับ Wear OS Material 3 แล้ว (Ia8ae3)

การแก้ไขข้อบกพร่อง

• เราได้อัปเดต wear.compose.foundation ให้เป็น API ที่ต้องพึ่งพาของ wear.compose.material3 (I72004, b/285404743)

เวอร์ชัน 1.0.0-alpha06

7 มิถุนายน 2023

androidx.wear.compose:compose-material3:1.0.0-alpha06 ได้รับการปล่อยแล้ว เวอร์ชัน 1.0.0-alpha06 มีการคอมมิตเหล่านี้

การแก้ไขข้อบกพร่อง

• เราได้อัปเดต TextButton ให้ใช้ฟังก์ชันส่วนขยาย toDisabledColor เพื่อแก้ไขค่าอัลฟ่าที่ปิดใช้ (I814c8)

เวอร์ชัน 1.0.0-alpha05

24 พฤษภาคม 2023

androidx.wear.compose:compose-material3:1.0.0-alpha05 ได้รับการปล่อยแล้ว เวอร์ชัน 1.0.0-alpha05 มีการคอมมิตเหล่านี้

ฟีเจอร์ใหม่

• เราได้เพิ่ม TextButton ลงใน Material3 ซึ่งเป็นปุ่มกลมที่มีช่องสำหรับข้อความเพียงช่องเดียว สำหรับ TextButton ขนาดต่างๆ เราขอแนะนำให้ใช้ Modifier.touchTargetAwareSize และ ExtraSmallButtonSize, SmallButtonSize, DefaultButtonSize และ LargeButtonSizeIcon ที่มีให้ใน TextButtonDefaults TextButton เริ่มต้นไม่มีเส้นขอบและพื้นหลังโปร่งใสสําหรับการดําเนินการที่มีระดับความสำคัญต่ำ สําหรับการดําเนินการที่ต้องใช้การเน้นสูง ให้ใช้ filledTextButtonColors สําหรับการเน้นปานกลาง ให้ใช้ TextButton แบบมีเส้นขอบ โดยตั้งค่าเส้นขอบเป็น ButtonDefaults.outlinedButtonBorder สําหรับการเน้นระดับกลางระหว่างแบบมีเส้นขอบและแบบทึบ ให้ใช้ filledTonalTextButtonColors (I667e4)
• เราได้เพิ่ม Card, OutlinedCard, AppCard และ TitleCard ลงในคลัง Wear Compose Material3 แล้ว นอกจากนี้ คุณยังทำให้ AppCard และ TitleCard มีลักษณะเป็นเส้นขอบได้โดยใช้ CardDefaults.outlinedCardColors และ CardDefaults.outlinedCardBorder(I80e72)

การเปลี่ยนแปลง API

• เราได้ย้ายพารามิเตอร์ป้ายกํากับปุ่มไปไว้ที่ท้ายสุดเพื่อรองรับไวยากรณ์แลมดาต่อท้ายและนําพารามิเตอร์บทบาทออก (เนื่องจากสามารถลบล้างได้โดยใช้ 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 Material 3 ซึ่งตั้งค่า PlatformTextStyle.includeFontPadding เป็น true โดยค่าเริ่มต้น (การตั้งค่าปัจจุบัน) ซึ่งจะช่วยให้เราซิงค์การปิดการเยื้องแบบอักษรโดยค่าเริ่มต้นกับไลบรารี Compose ในอนาคตได้ (ดูแก้ไขการเยื้องแบบอักษรใน Compose สำหรับพื้นหลัง) (I7e461)

เวอร์ชัน 1.0.0-alpha01

22 มีนาคม 2023

androidx.wear.compose:compose-material3:1.0.0-alpha01 ได้รับการปล่อยแล้ว เวอร์ชัน 1.0.0-alpha01 มีการคอมมิตเหล่านี้

ฟีเจอร์ใหม่

• Material 3 เป็นวิวัฒนาการขั้นถัดไปของ Material Design รวมถึงธีมที่ได้รับการอัปเดตและคอมโพเนนต์ที่ออกแบบใหม่ Material 3 ใน Wear Compose ได้รับการออกแบบให้สอดคล้องกับไลบรารี Material 3 ของ Compose ใน Android รุ่นอัลฟ่าแรกนี้มีการใช้งานเบื้องต้นที่ใช้งานได้จริงของสิ่งต่อไปนี้

  • ธีม Material - กำหนดค่ารูปแบบสี การจัดวางตัวอักษร และรูปร่างให้สอดคล้องกันสำหรับคอมโพเนนต์ทั้งหมดในไลบรารี ธีม Material3 มีสีที่ปรับปรุงใหม่ซึ่งรองรับคอนทราสต์ที่เข้าถึงได้ง่าย (I84005)
  • ข้อความ/ไอคอน - องค์ประกอบพื้นฐานสําหรับแอป Wear Compose (I8e06a)

• เราจะพัฒนา Wear Material (androidx.wear.compose:compose-material) และ Wear Material 3 (androidx.wear.compose:compose-material3) ควบคู่กันไป เวอร์ชันในอนาคตของ Material3 จะขยายชุดวิดเจ็ตให้รวมคอมโพเนนต์อื่นๆ ที่คุ้นเคยจาก Compose สำหรับ Wear OS เช่น ปุ่ม เครื่องมือเลือก และแถบเลื่อน

• ไลบรารี Wear Material และ Wear Material 3 ใช้ร่วมกันไม่ได้และไม่ควรนำมาใช้ร่วมกันในแอปเดียวกัน เนื่องจากไลบรารีเหล่านี้อ้างอิงธีมที่แตกต่างกัน ซึ่งอาจทำให้เกิดความไม่สอดคล้องกันโดยไม่คาดคิด

Wear Compose เวอร์ชัน 1.5

เวอร์ชัน 1.5.0-alpha07

11 ธันวาคม 2024

androidx.wear.compose:compose-*:1.5.0-alpha07 ได้รับการปล่อยแล้ว เวอร์ชัน 1.5.0-alpha07 มีการคอมมิตเหล่านี้

การเปลี่ยนแปลง API

• TransformingLazyColumnState มีวิธีดูความคืบหน้าของการเลื่อนปัจจุบันตามดัชนีของรายการแอตทริบิวต์ "a" แล้ว (I72b01)
• เราได้เพิ่มภาพเคลื่อนไหวลงใน TransformingLazyColumn เมื่อเพิ่ม นําออก และย้ายรายการ หากรายการเหล่านั้นมี Modifier.animateItem เวอร์ชันใหม่ (Iecb9c)
• ตอนนี้ TransformingLazyColumn แสดงค่าสำหรับ beforeContentPadding และ afterContentPadding แล้ว (Iccd5f)
• ตอนนี้ TransformingLazyColumn มี LocalTransformingLazyColumnItemScope ระดับองค์ประกอบ ซึ่งคอมโพเนนต์ (เช่น Card และ Button ใน Material3) สามารถใช้เพื่อเปลี่ยนรูปแบบโดยอัตโนมัติเมื่อวางไว้ใน TransformingLazyColumn ผู้โทรสามารถปิดใช้การเปลี่ยนรูปแบบอัตโนมัติได้โดยใช้ TransformExclusion wrapper ใหม่ (I1652f)

การแก้ไขข้อบกพร่อง

• เราได้อัปเดตความเร็วขั้นต่ำและสูงสุดของการพลิกสำหรับอุปกรณ์ที่กําหนดเป้าหมายเป็น U ขึ้นไป (I33559)
• เราได้แก้ไขข้อขัดข้องที่จะเกิดขึ้นหากรายการใน TransformingLazyColumn ไม่มีคอมโพสิเบิล (Idb99d)
• เราได้เพิ่มการรองรับ ScrollFeedbackProvider สำหรับระบบสัมผัสแบบหมุนใน Android Vanilla Ice Cream (Ibc553)
• เราได้เพิ่มการเลื่อนสัมผัสเมื่อใช้ SwipeToReveal เพื่อลดโอกาสที่จะเกิดการปัดโดยไม่ได้ตั้งใจเมื่อเลื่อนในแนวตั้ง (Ic0672)
• เราได้อัปเดต SwipeDismissableNavHost ให้ใช้ PredictiveBackHandler เมื่อพร้อมใช้งานใน API 35 ขึ้นไป ในกรณีนี้ ระบบจะใช้ภาพเคลื่อนไหวใหม่ (I08c11)

เวอร์ชัน 1.5.0-alpha06

13 พฤศจิกายน 2024

androidx.wear.compose:compose-*:1.5.0-alpha06 ได้รับการปล่อยแล้ว เวอร์ชัน 1.5.0-alpha06 มีการคอมมิตเหล่านี้

การเปลี่ยนแปลง API

• เราได้ลดความซับซ้อนของ ScrollInfoProvider สำหรับ PagerState ด้วยการนำพารามิเตอร์ orientation ออก ซึ่งไม่จำเป็นแล้ว ลักษณะการทำงานแบบใหม่คือ TimeText จะยังคงอยู่ในตำแหน่งเดิมสำหรับการเลื่อนหน้าทั้งแนวนอนและแนวตั้ง (I71767)
• TransformingLazyColumn เปิดตัวในรุ่นก่อนหน้า ตอนนี้เราจะนำอีเมลแทน LazyColumn ของ Wear (ซึ่งส่งต่อไปยัง TransformingLazyColumn) ออกเพื่อใช้ชื่อใหม่ TransformingLazyColumn นอกจากนี้ เรายังได้นําพร็อพเพอร์ตี้ height ของ TransformingLazyColumnVisibleItemInfo ออกแล้ว โปรดใช้ measuredHeight แทน (I0ea1e)
• เราได้เปลี่ยนข้อกำหนดของ PagerDefaults.snapFlingBehavior snapAnimationSpec จาก Tween เป็น Spring (I10d02, b/349781047, b/303807950)
• เราได้โปรโมต LocalReduceMotion CompositionLocal เป็นเวอร์ชันเสถียร (Ia6f32) แล้ว

การแก้ไขข้อบกพร่อง

• เราได้อัปเดต Modifier.rotaryScrollable ให้ใช้ focusTargetWithSemantics เพื่อรองรับความหมายในแบบโรตารีได้ดียิ่งขึ้น (Ief0a0)
• เราได้อัปเดตทรัพยากร Dependency ของ API เป็น 1.7.4 สำหรับไลบรารี Compose แล้ว (I88b46)
• เราได้ปิดใช้การเปลี่ยนความกว้างใน TransformingLazyColumn เพื่อแก้ปัญหาข้อบกพร่องในการตัด (I3dfb8)
• เราได้แก้ไขข้อบกพร่องที่ทำให้รายการหายไปหลังจากเลื่อนผ่านด้วย TransformingLazyColumn (Id7668)
• เราได้เพิ่ม LazyLayoutSemantics สำหรับ TransformingLazyColumn แล้ว (Ia8f56)

เวอร์ชัน 1.5.0-alpha05

30 ตุลาคม 2024

androidx.wear.compose:compose-*:1.5.0-alpha05 ได้รับการปล่อยแล้ว เวอร์ชัน 1.5.0-alpha05 มีการคอมมิตเหล่านี้

การเปลี่ยนแปลง API

• เราได้เพิ่มการรองรับ animateScrollTo ใน TransformingLazyColumnState เพื่อให้สามารถแสดงภาพเคลื่อนไหวเมื่อเลื่อนไปยังรายการ (I4097d)
• เราได้เพิ่ม requestScrollTo ใน TransformingLazyColumnState เพื่อเลื่อนการเลื่อนไปยังการวัดถัดไป (I20a5e)
• เราได้เพิ่มการรองรับ contentPadding ใน TransformingLazyColumn (I3a69c)

การแก้ไขข้อบกพร่อง

• เราได้แก้ไขข้อบกพร่องในการแสดงผล TransformingLazyColumn เมื่อความสูงของเนื้อหาสั้นกว่าความสูงของหน้าจอ (I6c3e1)
• ตอนนี้ ScrollInfoProvder สำหรับ TransformingLazyColumn จะติดตามรายการแรกอย่างถูกต้องแล้ว (I1e4a3)
• ตอนนี้ TransformingLazyColumnState จะบันทึกสถานะ (anchorItemIndex และ anchorItemScrollOffset) (I3d265)

เวอร์ชัน 1.5.0-alpha04

16 ตุลาคม 2024

androidx.wear.compose:compose-*:1.5.0-alpha04 ได้รับการปล่อยแล้ว เวอร์ชัน 1.5.0-alpha04 มีการคอมมิตเหล่านี้

การเปลี่ยนแปลง API

• เราได้เปลี่ยนชื่อ Wear Compose Foundation LazyColumn เป็น TransformingLazyColumn เพื่อให้แยกความแตกต่างระหว่างแพลตฟอร์มนี้กับ Compose Foundation LazyColumn ได้ชัดเจนขึ้น (I0608b)
• เพิ่มการรองรับปุ่มหมุนสำหรับโปรแกรมรับส่งข้อความแนวนอน/แนวตั้ง ซึ่งช่วยให้ผู้ใช้ไปยังส่วนต่างๆ ของโปรแกรมรับส่งข้อความได้โดยใช้อุปกรณ์อินพุตแบบหมุน (I9770d)
• เราได้อัปเดต PagerDefaults ใหม่เพื่อให้ชัดเจนว่าตัวแบ่งหน้าจะยึดตามหน้าเว็บโดยค่าเริ่มต้น (Iff7d0)
• TransformingLazyColumnItemScrollProgress กลายเป็นคลาสมูลค่าแล้ว ซึ่งน่าจะช่วยปรับปรุงประสิทธิภาพ (Ic399e)
• ตอนนี้ TransformingLazyColumn รองรับโรตารีตั้งแต่แกะกล่อง (I05206)
• ขณะนี้ TransformingLazyColumnState รองรับ scrollToItem แล้ว (I507b3)
• นํา @ExperimentalWearFoundationApi ออกจาก SwipeToReveal API แล้ว (I34a66)

เวอร์ชัน 1.5.0-alpha03

2 ตุลาคม 2024

androidx.wear.compose:compose-*:1.5.0-alpha03 ได้รับการปล่อยแล้ว เวอร์ชัน 1.5.0-alpha03 มีการคอมมิตเหล่านี้

การเปลี่ยนแปลง API

• เราได้เพิ่มการรองรับการปัดแบบ 2 ทิศทางใน SwipeToReveal สำหรับกรณีที่พบไม่บ่อยที่หน้าจอปัจจุบันไม่รองรับการปัดเพื่อปิด ค่าเริ่มต้นจะยังคงเป็นการปัดเพื่อแสดงเฉพาะเมื่อปัดไปจากขวาไปซ้าย และเราขอแนะนำอย่างยิ่งให้ใช้ลักษณะการทำงานเริ่มต้นเพื่อหลีกเลี่ยงความขัดแย้งกับการปัดเพื่อปิด (Ifac04)
• เราได้อัปเดต LazyColumnState เพื่อลบล้าง canScrollForward และ canScrollBackward ซึ่งตอนนี้จะหยุดการเลื่อนเมื่อรายการแรกหรือรายการสุดท้ายอยู่ตรงกลางหน้าจอพอดี (Ia77d7)
• เราได้เพิ่มคอมโพเนนต์ HorizontalPager และ VerticalPager ใหม่ซึ่งจะจัดการปัญหาที่พบได้ทั่วไป เช่น การจัดการโฟกัสและการโต้ตอบกับการปัดเพื่อปิดของระบบที่อาจเกิดขึ้นใน Wear (I2902b)
• เราได้เพิ่มการรองรับ LazyColumn เพื่อแสดง key และ contentType ของลูกค้าผ่าน layoutItems (I1bd9c)

การแก้ไขข้อบกพร่อง

• เราได้อัปเดตภาพเคลื่อนไหวของข้อความโค้งให้ราบรื่นขึ้นโดยใช้ Flag ของ Paint (I73a15)
• เราได้อัปเดตเอกสารประกอบของ Material Dialog เพื่อระบุว่าระบบจะไม่เรียกใช้ onDismissRequest หลังจากที่ตั้งค่า Flag show เป็น false (Ifd8d6)
• เราได้แก้ไขข้อบกพร่องเกี่ยวกับภาพเคลื่อนไหวแบบวิกเน็ตต์ในกล่องโต้ตอบ Material (I126bf) แล้ว

เวอร์ชัน 1.5.0-alpha02

18 กันยายน 2024

androidx.wear.compose:compose-*:1.5.0-alpha02 ได้รับการปล่อยแล้ว เวอร์ชัน 1.5.0-alpha02 มีการคอมมิตเหล่านี้

การเปลี่ยนแปลง API

• เราได้เพิ่มการรองรับ Wear Compose LazyColumn ด้วย ScreenScaffold (และเพิ่มการใช้งาน ScrollInfoProvider สำหรับ LazyColumnState) (Ib8d29)
• เราได้เพิ่ม viewportSize ไปยัง LazyColumnLayoutInfo แล้ว (I4187f)

การแก้ไขข้อบกพร่อง

• เราได้แก้ไขข้อบกพร่องเพื่อให้การเลื่อนแบบหมุนใน ScalingLazyColumn ปิดอยู่เมื่อตั้งค่า Flag userScrollEnabled เป็น false (I490ab, b/360295825)
• เราได้ทำการแก้ไขข้อบกพร่องเพื่อจัดการกับระยะห่างจากขอบในแนวตั้งที่ไม่คาดคิดในข้อความโค้ง ตอนนี้ความสูงของข้อความโค้งจะตรงกับพื้นที่จริงที่ข้อความใช้มากขึ้น โปรดทราบว่าการดำเนินการนี้อาจทำให้การทดสอบภาพหน้าจอที่เกี่ยวข้องกับข้อความโค้ง (Iaa6ef) ใช้งานไม่ได้
• เราได้เปลี่ยนการแก้ไขข้อบกพร่องใน Dialog ซึ่งมีการเรียก onDismissRequest callback เมื่อตั้งค่า showDialog เป็นเท็จ เนื่องจากในบางกรณีการเรียกนี้ส่งผลให้มีการเรียก onDismissRequest หลายครั้ง (I64656)

เวอร์ชัน 1.5.0-alpha01

4 กันยายน 2024

androidx.wear.compose:compose-*:1.5.0-alpha01 ได้รับการปล่อยแล้ว เวอร์ชัน 1.5.0-alpha01 มีการคอมมิตเหล่านี้

การเปลี่ยนแปลง API

• เราได้เพิ่ม LazyColumn ใหม่ลงในไลบรารี Wear Compose Foundation ที่มี LazyColumnState และ LazyColumnScope API ที่เกี่ยวข้อง ข้อมูลนี้จะเป็นรากฐานในการสร้างเอฟเฟกต์การเปลี่ยนขนาดและการเปลี่ยนรูปแบบที่ปรับแต่งได้โดยใช้ Wear Compose (Ib3b22)
• เราได้เพิ่ม itemsIndexed เวอร์ชันที่จัดทําดัชนีแล้วลงใน LazyColumnScope โดยเป็นส่วนหนึ่งของ LazyColumn API เวอร์ชันใหม่ (Ib4a57)
• เราได้เพิ่มตัวแก้ไข LazyColumn เพื่อรองรับลักษณะการปรับเปลี่ยนขนาดและการแปรสภาพ (Ie229a)
• HierarchicalFocusCoordinator ได้รับการโปรโมตเป็นเวอร์ชันเสถียรแล้ว (I31035)
• เราได้เพิ่มการรองรับระยะห่างของตัวอักษรในข้อความโค้ง (I3c740)
• เพิ่มพารามิเตอร์ rotationLocked ลงใน CurvedLayout.curvedComposable เพื่อหยุดการหมุนคอมโพเนนต์ (I66898)
• นํา LocalUseFallbackRippleImplementation API ชั่วคราวออกจาก wear material และ wear material3 แล้ว (I62282)
• นำ WearDevices.SQUARE ออกจากตัวอย่างเพลงหลายรายการของ @WearPreviewDevices (I11c02)

การแก้ไขข้อบกพร่อง

• ตอนนี้ SwipeToReveal จะจัดวางรายการที่แสดงในส่วนที่มองเห็นได้ของหน้าจอ ซึ่งจะมีประโยชน์เมื่อใช้ SwipeToReveal ภายในรายการ เพื่อให้ผู้ใช้โต้ตอบกับรายการได้เสมอและรายการจะไม่อยู่นอกหน้าจอ (I38929)
• ตอนนี้ SwipeToReveal จะรีเซ็ต lastActionType เป็น "ไม่มี" เมื่อ animatedTo เสร็จสมบูรณ์ (I59b03)
• ปรับปรุงเอกสารประกอบสําหรับพารามิเตอร์ rotationLocked ใหม่ใน curvedComposable (Ifbd57)
• แก้ไขข้อขัดข้องเมื่อส่ง NaN ไปยัง performFling ของ ScalingLazyColumnSnapFlingBehavior (Ic13da)
• แก้ไขข้อบกพร่องเกี่ยวกับตัวแก้ไขขนาดเลย์เอาต์แบบโค้ง (I0fedf)
• เราได้เพิ่มการรองรับการเว้นวรรคระหว่างตัวอักษรที่ระบุใน "sp" (I9f6e3)
• เราได้แก้ไขข้อบกพร่องในกล่องโต้ตอบ Material2 ที่ไม่มีการเรียกใช้การเรียกกลับ onDismissRequest เมื่อกล่องโต้ตอบมองไม่เห็น (I64656)
• เปลี่ยนชื่อ LayoutCoordinates.introducesFrameOfReference เป็น LayoutCoordinates.introducesMotionFrameOfReference เพื่อให้สอดคล้องกับวัตถุประสงค์มากขึ้น เปลี่ยนชื่อฟังก์ชันที่เกี่ยวข้องเพื่อคำนวณพิกัดตาม Flag นั้น (I3a330)

เวอร์ชัน 1.4

เวอร์ชัน 1.4.0

4 กันยายน 2024

androidx.wear.compose:compose-*:1.4.0 ได้รับการปล่อยแล้ว เวอร์ชัน 1.4.0 มีการคอมมิตเหล่านี้

การเปลี่ยนแปลงที่สําคัญตั้งแต่เวอร์ชัน 1.3.0

• ตอนนี้ ScalingLazyColumn และ Picker รองรับอินพุตแบบหมุนโดยค่าเริ่มต้นแล้ว เราขอแนะนำให้นำการจัดการแบบหมุนที่ชัดเจนออกและรอให้ระบบทำงานตามลักษณะการทำงานเริ่มต้น หากจําเป็น ให้ใช้พารามิเตอร์ rotaryScrollableBehavior เพื่อกําหนดค่าลักษณะการเลื่อนหรือลักษณะการยึด ในกรณีลักษณะการยึด เราขอแนะนําให้ระบุลักษณะการยึดและความสามารถในการเลื่อนด้วยการแตะโดยใช้พารามิเตอร์ flingBehavior
• Modifier.rotaryScrollable คือตัวแก้ไขใหม่ที่เชื่อมต่อเหตุการณ์แบบหมุนกับคอนเทนเนอร์ที่เลื่อนได้ ซึ่งช่วยให้ผู้ใช้เลื่อนโดยใช้เม็ดมะยมหรือขอบหน้าปัดแบบหมุนในอุปกรณ์ Wear OS ได้
• ตอนนี้ SwipeDismissableNavHost มีภาพเคลื่อนไหวตอนเข้าสู่หน้าจอสําหรับการเปลี่ยนภาพในแอป
• ตอนนี้ PositionIndicator จะแสดงโดยค่าเริ่มต้นเมื่อหน้าจอแสดงขึ้นเป็นครั้งแรก

การเปลี่ยนแปลงเพิ่มเติม

• ดูชุดการเปลี่ยนแปลงทั้งหมดที่เปิดตัวในเวอร์ชัน 1.3.0 ได้ที่บันทึกประจำรุ่น beta01

เวอร์ชัน 1.4.0-rc01

21 สิงหาคม 2024

androidx.wear.compose:compose-*:1.4.0-rc01 ได้รับการปล่อยแล้ว เวอร์ชัน 1.4.0-rc01 มีการคอมมิตเหล่านี้

• เราได้อัปเดต Compose Dependencies เป็น 1.7.0-rc01 และปักหมุด Wear Compose Navigation เป็น androidx.lifecycle 2.8.3

เวอร์ชัน 1.4.0-beta03

12 มิถุนายน 2024

androidx.wear.compose:compose-*:1.4.0-beta03 ได้รับการปล่อยแล้ว เวอร์ชัน 1.4.0-beta03 มีการคอมมิตเหล่านี้

การแก้ไขข้อบกพร่อง

• เราได้อัปเดต Modifier.rotaryScrollable เพื่อแทนที่การใช้ "focusable" ด้วย "focusTarget" ซึ่งช่วยปรับปรุงประสิทธิภาพ (Id294b)
• เราได้แก้ไขปัญหาที่ ProgressIndicator ประกาศซ้ำใน TalkBack (I94563)
• เราได้อัปเดตโปรไฟล์พื้นฐานของไลบรารี Wear Compose (I3cbc3)

เวอร์ชัน 1.4.0-beta02

29 พฤษภาคม 2024

androidx.wear.compose:compose-*:1.4.0-beta02 ได้รับการปล่อยแล้ว เวอร์ชัน 1.4.0-beta02 มีการคอมมิตเหล่านี้

การแก้ไขข้อบกพร่อง

• เราได้เพิ่มความกว้างของขอบเขตที่ส่งไปยังโปรแกรมอ่านหน้าจอจากข้อความโค้งเพื่อแก้ไขปัญหาการตัดข้อความ (Id865f)
• เราได้จำกัดขอบเขตของ HorizontalPageIndicator ที่ส่งไปยังโปรแกรมอ่านหน้าจอแล้ว ก่อนหน้านี้ตัวบ่งชี้ครอบครองทั้งหน้าจอ (Id8d7a)

เวอร์ชัน 1.4.0-beta01

14 พฤษภาคม 2024

androidx.wear.compose:compose-*:1.4.0-beta01 ได้รับการปล่อยแล้ว เวอร์ชัน 1.4.0-beta01 มีการคอมมิตเหล่านี้

เวอร์ชัน 1.4-beta01 ของ Compose สำหรับ Wear OS บ่งบอกว่าไลบรารีเวอร์ชันนี้มีฟีเจอร์ครบถ้วนและ API ถูกล็อก (ยกเว้นในกรณีที่ทำเครื่องหมายเป็นเวอร์ชันทดลอง) Wear Compose 1.4 มีฟังก์ชันการทำงานใหม่ต่อไปนี้

• เราได้เพิ่ม Modifier.rotaryScrollable ซึ่งเป็นตัวแก้ไขใหม่ที่เชื่อมต่อเหตุการณ์แบบหมุนกับคอนเทนเนอร์ที่เลื่อนได้ ซึ่งช่วยให้ผู้ใช้เลื่อนผ่านเม็ดมะยมหรือขอบที่หมุนได้ในอุปกรณ์ Wear OS นอกจากนี้ ScalingLazyColumn และ Picker ยังรองรับการป้อนข้อมูลแบบหมุนโดยค่าเริ่มต้นด้วย ใช้พารามิเตอร์ rotaryScrollableBehavior เพื่อกําหนดค่าลักษณะการเลื่อนหรือลักษณะการยึด สำหรับลักษณะการยึดตำแหน่ง เราขอแนะนำให้ระบุการยึดตำแหน่งผ่านพารามิเตอร์ flingBehavior ด้วยสำหรับการเลื่อนด้วยการแตะ
• ตอนนี้ SwipeDismissableNavHost มีภาพเคลื่อนไหวตอนเข้าสู่หน้าจอสําหรับการเปลี่ยนภาพในแอป
• ตอนนี้ PositionIndicator จะแสดงโดยค่าเริ่มต้นเมื่อหน้าจอแสดงขึ้นเป็นครั้งแรก
• เพิ่ม SelectableChip และ SplitSelectableChip เป็นตัวแปรของ ToggleChip - ใช้กับ RadioButton เพื่อให้ความหมายที่เลือกได้แทนความหมายที่เปิด/ปิดได้สำหรับการช่วยเหลือพิเศษ
• ตอนนี้ ListHeader รองรับการปรับความสูงเมื่อเนื้อหาต้องการความสูงเพิ่มเติมเพื่อรองรับขนาดแบบอักษรขนาดใหญ่

การแก้ไขข้อบกพร่อง

• เราได้แก้ไขข้อบกพร่องที่ชิปที่เลือกได้จะแจ้งให้แตะสองครั้งเพื่อสลับเมื่อเลือกไว้แล้ว (I7ed88)

เวอร์ชัน 1.4.0-alpha08

1 พฤษภาคม 2024

androidx.wear.compose:compose-*:1.4.0-alpha08 ได้รับการปล่อยแล้ว เวอร์ชัน 1.4.0-alpha08 มีการคอมมิตเหล่านี้

การเปลี่ยนแปลง API

• เราได้ทําการเปลี่ยนแปลงต่อไปนี้กับ Rotary API ใหม่ ได้แก่ เปลี่ยนชื่อ Modifier.rotary เป็น Modifier.rotaryScrollable เปลี่ยนชื่ออินเทอร์เฟซ RotaryBehavior เป็น RotaryScrollableBehavior และเปลี่ยนชื่อฟังก์ชัน handleScrollEvent เป็น performScroll เปลี่ยนชื่อ RotaryScrollableAdapter เป็น RotaryScrollableLayoutInfoProvider และนําพร็อพเพอร์ตี้ scrollableState ออก (I0c8a6)
• เราได้ทําการเปลี่ยนแปลงเพิ่มเติมใน Rotary API โดยเปลี่ยนชื่อ RotaryScrollableLayoutInfoProvider เป็น RotarySnapLayoutInfoProvider (เนื่องจากต้องใช้ผู้ให้บริการนี้กับ Rotary ที่มี Snap เท่านั้น) และเปลี่ยนประเภทพารามิเตอร์ snapOffset ใน RotaryScrollableDefaults.snapBehavior snapOffset จาก Int เป็น Dp (Iddebe)
• เราได้เปลี่ยนชื่อพารามิเตอร์ clickInteractionSource ใน SplitSelectableChip เป็น containerInteractionSource แล้ว (Ia8f84)
• เราได้อัปเดตชื่อพารามิเตอร์การเรียกกลับจากการคลิกสําหรับ SplitSelectableChip จาก onClick เป็น onSelectionClick และจาก onBodyClick เป็น onContainerClick (I32237)

การแก้ไขข้อบกพร่อง

• เราได้อัปเดตระยะห่างแนวนอนของ PositionIndicator เป็น 2dp (เดิมคือ 5dp) เพื่อแก้ไขข้อบกพร่องที่ PositionIndicator (แถบเลื่อน) ทับซ้อนกับเนื้อหาที่เลื่อนได้ โปรดทราบว่าการเปลี่ยนแปลงนี้จะทำให้ภาพหน้าจอที่มีอยู่ซึ่งรวม PositionIndicator ใช้งานไม่ได้เนื่องจากมีการเปลี่ยนแปลงระยะห่างจากขอบ (I57472)
• เราได้ปรับปรุงเอกสารประกอบสําหรับ Rotary API ใหม่โดยอธิบายความแตกต่างระหว่างอุปกรณ์ Rotary ความละเอียดต่ำและความละเอียดสูง (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 และ Picker ยังรองรับอินพุตแบบหมุนโดยค่าเริ่มต้นด้วย โดยใช้การโอเวอร์โหลดแบบใหม่ที่มีพารามิเตอร์ rotaryBehavior สำหรับระบุการกําหนดค่าของ Scroll หรือ Snap หากตั้งค่าพารามิเตอร์ rotaryBehavior เป็น "snap" เราขอแนะนำให้ระบุ snap ผ่านพารามิเตอร์ flingBehavior ด้วยสำหรับการเลื่อนด้วยการแตะ (I2ef6f)
• แหล่งที่มาของ NestedScroll ประเภทลากและปัดจะเปลี่ยนไปใช้ UserInput และ SideEffect เพื่อรองรับคำจำกัดความที่ขยายออกไปของแหล่งที่มาเหล่านี้ ซึ่งตอนนี้รวมภาพเคลื่อนไหว (ผลข้างเคียง) และล้อเลื่อนของเมาส์และแป้นพิมพ์ (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 มีการคอมมิตเหล่านี้

การแก้ไขข้อบกพร่อง

• เราได้เพิ่มการร่างการรองรับโรตารีภายใน ซึ่งเป็นส่วนหนึ่งของความพยายามที่ยิ่งใหญ่กว่าในการย้ายข้อมูลลักษณะการทำงานของโรตารีจาก Horologist ไปยัง AndroidX (I617d1)
• เราได้เพิ่มการร่างการรองรับการสัมผัสภายใน ซึ่งเป็นส่วนหนึ่งของความพยายามที่ยิ่งใหญ่กว่าในการย้ายข้อมูลลักษณะการทำงานของ Rotary ไปยัง AndroidX จาก Horologist (I5568a)

เวอร์ชัน 1.4.0-alpha05

20 มีนาคม 2024

androidx.wear.compose:compose-*:1.4.0-alpha05 ได้รับการปล่อยแล้ว เวอร์ชัน 1.4.0-alpha05 มีการคอมมิตเหล่านี้

การเปลี่ยนแปลง API

• เราได้ทำให้พร็อพเพอร์ตี้ initialCenterItemIndex และ initialCenterItemScrollOffset ของ ScalingLazyListState เป็นสาธารณะแล้ว (I0c616)
• เราได้เผยแพร่ FullScreenStrokeWidth จาก ProgressIndicatorDefaults เป็นแบบสาธารณะแล้ว (Ibea23)

การแก้ไขข้อบกพร่อง

• เราได้ปรับปรุงประสิทธิภาพของ PositionIndicator ด้วยการลดจํานวนการเรียก layoutInfo จาก ScalingLazyColumn (Idc83d)

เวอร์ชัน 1.4.0-alpha04

6 มีนาคม 2024

androidx.wear.compose:compose-*:1.4.0-alpha04 ได้รับการปล่อยแล้ว เวอร์ชัน 1.4.0-alpha04 มีการคอมมิตเหล่านี้

การเปลี่ยนแปลง API

• เราได้เพิ่มการโอเวอร์โหลดใหม่สำหรับ ToggleChip และ SplitToggleChip ที่ใช้พารามิเตอร์ selectionControl แทนพารามิเตอร์ toggleControl ควรใช้กับการควบคุม RadioButton เพื่อให้ความหมายที่เลือกได้แทนความหมายที่เปิด/ปิดได้สำหรับการช่วยเหลือพิเศษ (I1d6d9)
• เราได้อัปเดตชื่อพารามิเตอร์สําหรับ selectionControl ใหม่จาก onSelected เป็น onSelect สําหรับ ToggleChip และ SplitToggleChip (I1a971)

เวอร์ชัน 1.4.0-alpha03

21 กุมภาพันธ์ 2024

androidx.wear.compose:compose-*:1.4.0-alpha03 ได้รับการปล่อยแล้ว เวอร์ชัน 1.4.0-alpha03 มีคอมมิตเหล่านี้

การเปลี่ยนแปลง API

• เราเลิกใช้งาน Modifier.inspectable Wrapper แล้ว 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 กลับไปใช้ rememberRipple/RippleTheme API ที่เลิกใช้งานแล้ว เราจะนำตัวเลือกนี้ออกในรุ่นที่ใช้งานเสถียรรุ่นถัดไป และตัวเลือกนี้มีไว้เพื่อเป็นความช่วยเหลือในการย้ายข้อมูลชั่วคราวในกรณีที่คุณระบุ RippleTheme ที่กําหนดเองเท่านั้น ดูข้อมูลการย้ายข้อมูลและข้อมูลเบื้องต้นเพิ่มเติมเกี่ยวกับการเปลี่ยนแปลงนี้ได้ที่ developer.android.com (af92b21)
• เราได้อัปเดต ColorScheme ให้เป็นค่าแบบคงที่ ซึ่งทำให้การอัปเดตสีแต่ละสีมีประสิทธิภาพน้อยลง แต่ทำให้การใช้งานสีทั่วไปมีประสิทธิภาพมากขึ้น เหตุผลของการเปลี่ยนแปลงนี้ก็คือแอปส่วนใหญ่ไม่ได้ใช้การอัปเดตสีแต่ละสีเป็น Use Case หลัก การดำเนินการนี้ยังคงเป็นไปได้ แต่จะคอมโพสใหม่มากกว่าเดิม ซึ่งจะทำให้เราลดจำนวนการสมัครใช้บริการสถานะผ่านโค้ดวัสดุทั้งหมดได้อย่างมาก และจะมีผลต่อต้นทุนในการเริ่มต้นและรันไทม์ของ Use Case มาตรฐานมากขึ้น (f5c48b7)
• คอมโพเนนต์ Wear Material และ Wear Material3 ที่แสดง MutableInteractionSource ใน API ได้รับการอัปเดตให้แสดง MutableInteractionSource แบบ Null ที่ค่าเริ่มต้นเป็น Null ไม่มีการทําการเปลี่ยนแปลงเชิงความหมายในส่วนนี้ การผ่านค่า Null หมายความว่าคุณไม่ต้องการยกระดับ MutableInteractionSource และระบบจะสร้าง MutableInteractionSource นั้นภายในคอมโพเนนต์หากจําเป็น การเปลี่ยนเป็น null จะช่วยให้คอมโพเนนต์บางรายการไม่จัดสรร MutableInteractionSource เลย และช่วยให้คอมโพเนนต์อื่นๆ สร้างอินสแตนซ์แบบเลื่อนเวลาไว้ใช้เมื่อจำเป็นเท่านั้น ซึ่งจะช่วยปรับปรุงประสิทธิภาพของคอมโพเนนต์เหล่านี้ หากคุณไม่ได้ใช้ MutableInteractionSource ที่ส่งไปยังคอมโพเนนต์เหล่านี้ เราขอแนะนำให้ส่งค่า Null แทน นอกจากนี้ เราขอแนะนำให้คุณทำการเปลี่ยนแปลงที่คล้ายกันในคอมโพเนนต์ของคุณเองด้วย (f8fa920)
• เราได้อัปเดต rememberExpandableState เพื่อบันทึกสถานะแบบขยาย วิธีนี้ช่วยให้มั่นใจได้ว่าระบบจะจัดเก็บข้อมูลเมื่อไปยังหน้าจออื่นและกู้คืนข้อมูลเมื่อกลับมาที่หน้าจอเดิม (5c80095)

การแก้ไขข้อบกพร่อง

• เราได้อัปเดตการตั้งค่า ReduceMotion เพื่อใช้ Listener ที่รับรู้วงจร (7c6b122)
• เราได้อัปเดต Listener ของ TouchExplorationStateProvider ให้รับรู้ถึงวงจรของลูกค้า (be28b01)
• เราได้นําเลเยอร์ materialcore ของ CompactButton ออกเพื่อปรับปรุงประสิทธิภาพ (25db8e9)
• เราได้ทําให้ BasicSwipeToDismissBox ทนทานต่อค่าออฟเซต NaN มากขึ้นเพื่อหลีกเลี่ยงข้อยกเว้น (b983739)
• เราได้อัปเดต BasicSwipeToDismissBox เพื่อให้ค่าอัลฟ่าอยู่ในช่วง 0,1
• เราได้แก้ไขข้อบกพร่องใน ToggleButton, SplitToggleButton, Checkbox, Switch และ RadioButton เพื่อไม่ให้ประกาศการช่วยเหลือพิเศษซ้ำ (ก่อนหน้านี้มีบทบาทเชิงความหมายซ้ำกัน) (d11eeb7)

เวอร์ชัน 1.3

เวอร์ชัน 1.3.1

3 เมษายน 2024

androidx.wear.compose:compose-*:1.3.1 ได้รับการปล่อยแล้ว เวอร์ชัน 1.3.1 มีการคอมมิตเหล่านี้

การแก้ไขข้อบกพร่อง

• เราได้แก้ไขข้อบกพร่องในการปัดเพื่อแสดง ซึ่งทำให้ผู้ใช้โต้ตอบ (และยกเลิก) การดำเนินการที่ดำเนินการไปแล้วในรายการหนึ่งได้โดยการเริ่มปัดรายการอื่น (Ide059)

เวอร์ชัน 1.3.0

24 มกราคม 2024

androidx.wear.compose:compose-*:1.3.0 ได้รับการปล่อยแล้ว เวอร์ชัน 1.3.0 มีคอมมิตเหล่านี้

การเปลี่ยนแปลงที่สำคัญตั้งแต่เวอร์ชัน 1.2.0

• ตอนนี้คลาส SwipeToDismissBoxState, การแจกแจง SwipeToDismissValue และฟังก์ชันส่วนขยาย Modifier.edgeSwipeToDismiss เป็นส่วนหนึ่งของแพ็กเกจ androidx.wear.compose.foundation แล้ว ไม่ใช่แพ็กเกจ androidx.wear.compose.material สถาปัตยกรรมที่อัปเดตนี้ช่วยให้คุณใช้การจัดการท่าทางสัมผัสได้โดยไม่คำนึงถึงข้อควรพิจารณาด้านการออกแบบอื่นๆ ระบบจะจัดการเวิร์กโฟลว์ Material Design เช่น การใช้สีจากธีมที่กําหนดค่าไว้แยกต่างหาก
• คลาส SwipeToRevealCard และ SwipeToRevealChip ช่วยให้คุณติดตั้งใช้งาน recommended swipe-to-reveal guidance ได้ คลาส SwipeToRevealSample แสดงวิธีใช้คอมโพเนนต์เหล่านี้

• เวอร์ชัน 1.3.0-alpha02 ของเราได้เปิดตัวการเปลี่ยนแปลงที่ทำให้วัตถุ Chip และ ToggleChip สูงขึ้นเพื่อรองรับการปรับขนาดแบบอักษรที่ผู้ใช้เลือกได้ดียิ่งขึ้น ซึ่งอาจทำให้มีการตัดเสียงบางส่วน ในการแก้ไขปัญหานี้ ตอนนี้รูป large สำหรับ MaterialTheme ใช้รัศมีมุมที่ใหญ่ขึ้น (26 dp แทน 24 dp) วัตถุ Chip และ ToggleChip ใช้รัศมีมุมใหม่นี้เพื่อหลีกเลี่ยงการครอบตัดเนื้อหาที่มุมของชิปและ ToggleChip

  • Chips และ ToggleChips ส่วนใหญ่จะไม่เปลี่ยนแปลงเนื่องจากมีความสูงเริ่มต้น 52 dp อย่างไรก็ตาม ออบเจ็กต์ Chip และ ToggleChip ที่มีข้อความป้ายกำกับหลักหรือรองหลายบรรทัด หรือมีการลบล้างความสูงไว้ อาจทำให้การทดสอบภาพหน้าจอใช้งานไม่ได้

การเปลี่ยนแปลงเพิ่มเติม

ดูชุดการเปลี่ยนแปลงทั้งหมดที่เปิดตัวในเวอร์ชัน 1.3.0 ได้ที่บันทึกประจำรุ่น beta01

คําแนะนําสําหรับการใช้งาน

• หากแอปของคุณอนุญาตให้ผู้ใช้เลื่อนดูเนื้อหาของหน้าจอ เช่น ในแอปที่อิงตามแผนที่ ให้ปิดการจัดการการปัดโดยตั้งค่า userSwipeEnabled เป็น false ในคอมโพสิชัน SwipeDismissableNavHost และใส่ปุ่มที่อนุญาตให้ผู้ใช้ไปยังหน้าจอก่อนหน้า
• หากต้องการปิดภาพเคลื่อนไหวสำหรับตัวบ่งชี้ตำแหน่งระหว่างภาพเคลื่อนไหวที่ค่อยๆ ปรากฏขึ้นและภาพเคลื่อนไหวที่เปลี่ยนตำแหน่งภายในรายการที่เลื่อน ให้ใช้ออบเจ็กต์ SnapSpec
• ขณะรอให้แอปสื่อโหลดเนื้อหาเพื่อเล่น ให้แสดงคอมโพสิเบิล Placeholder ว่างเปล่า
• หากต้องการสร้างคอลเล็กชันรายการแบบขยายได้เมื่อต้องการ ให้พิจารณาใช้คลาส ExpandableStateMapping เวอร์ชันทดลอง

เวอร์ชัน 1.3.0-rc01

10 มกราคม 2024

androidx.wear.compose:compose-*:1.3.0-rc01 ได้รับการปล่อยแล้ว เวอร์ชัน 1.3.0-rc01 มีการคอมมิตเหล่านี้

การแก้ไขข้อบกพร่อง

• เราได้อัปเดตรูปร่าง MaterialTheme ขนาดใหญ่ให้ใช้รัศมีมุมมน 26dp และตอนนี้ชิปและ ToggleChip จะใช้รูปร่างนี้ การเปลี่ยนแปลงนี้จำเป็นเพื่อรองรับการปรับความสูงเมื่อเนื้อหาต้องการความสูงเพิ่มเติมเพื่อให้รองรับแบบอักษรขนาดใหญ่ มิเช่นนั้น รูปร่างสนามกีฬาที่มีอยู่จะตัดเนื้อหาข้อความบางส่วนออก

  

  

  การเปลี่ยนแปลงนี้อาจทำให้การทดสอบภาพหน้าจอใช้งานไม่ได้ (I2e6ae)

เวอร์ชัน 1.3.0-beta02

13 ธันวาคม 2023

androidx.wear.compose:compose-*:1.3.0-beta02 ได้รับการปล่อยแล้ว เวอร์ชัน 1.3.0-beta02 มีการคอมมิตเหล่านี้

การแก้ไขข้อบกพร่อง

• เราได้คืนค่าการปัดตามที่ต้องการใน BasicSwipeToDismissBox แล้ว การดำเนินการนี้ได้รับการแก้ไขในรุ่นก่อนหน้า เช่น ส่วนที่เลื่อนของการเปลี่ยนเกิดขึ้นขณะที่นิ้วสัมผัสหน้าจอ (Id8e76)

เวอร์ชัน 1.3.0-beta01

15 พฤศจิกายน 2023

androidx.wear.compose:compose-*:1.3.0-beta01 ได้รับการปล่อยแล้ว เวอร์ชัน 1.3.0-beta01 มีการคอมมิตเหล่านี้

เวอร์ชัน 1.3-beta01 ของ Compose สำหรับ Wear OS บ่งบอกว่าไลบรารีเวอร์ชันนี้มีฟีเจอร์ครบถ้วนและ API ถูกล็อก (ยกเว้นในกรณีที่ทำเครื่องหมายว่าเป็นแบบทดลอง) Wear Compose 1.3 มีฟังก์ชันการทำงานใหม่ต่อไปนี้

• ย้ายข้อมูล SwipeToDismissBoxState, SwipeToDismissValue และ Modifier.edgeSwipeToDismiss จาก androidx.wear.compose.material ไปยัง androidx.wear.compose.foundation แล้ว รวมถึงการใช้งานการปัดเพื่อปิดใน BasicSwipeToDismissBox ซึ่งช่วยให้การจัดการท่าทางสัมผัสสำหรับการปัดเพื่อปิดใช้งานได้อย่างอิสระจาก Material Design เช่น จาก SwipeDismissableNavHost ใน androidx.wear.compose.navigation เรายังคงแนะนำให้ใช้ SwipeToDismissBox จาก androidx.wear.compose.material กับ Material Design เนื่องจากจะดึงสีจาก MaterialTheme แล้วมอบหมายการติดตั้งใช้งานที่เหลือให้กับ BasicSwipeToDismissBox
• ตอนนี้ SwipeDismissableNavHost รองรับพารามิเตอร์ userSwipeEnabled ใหม่เพื่อให้ปิดการจัดการการปัดสำหรับหน้าจอที่ไม่จําเป็นได้
• BasicSwipeToDismissBox ปรับปรุงการจัดการโฟกัสโดยใช้ HierarchicalFocusCoordinator
• SwipeToReveal มีคอมโพสิเบิล SwipeToRevealCard และ SwipeToRevealChip ใหม่ใน Material ที่เป็นไปตามคำแนะนำ UX ที่แนะนำสำหรับ Card และ Chip และยังรองรับการเลิกทำสำหรับการดำเนินการรองด้วย
• ตอนนี้ DefaultTextStyle จะปิดการเยื้องแบบอักษรเพื่อให้สอดคล้องกันทั่วทั้งแพลตฟอร์ม Android
• ตอนนี้ Chip และ ToggleChip จะปรับความสูงให้รองรับเนื้อหาที่เพิ่มขึ้นเนื่องจากแบบอักษรขนาดใหญ่เพื่อการช่วยเหลือพิเศษ
• ตอนนี้ PositionIndicator มีข้อมูลจำเพาะภาพเคลื่อนไหวแต่ละรายการสำหรับภาพเคลื่อนไหวที่ค่อย ๆ ปรากฏขึ้น ภาพเคลื่อนไหวที่ค่อย ๆ หายไป และภาพเคลื่อนไหวที่เปลี่ยนตำแหน่ง เราขอแนะนำให้ปิดการค่อยๆ ปรากฏขึ้นและการเปลี่ยนตำแหน่งเมื่อใช้กับรายการที่เลื่อนได้เพื่อเหตุผลด้านประสิทธิภาพ
• ExpandableStateMapping มีวิธีใหม่ในการสร้าง ExpandableStates เมื่อจำเป็นต้องสร้างตามคําขอและไม่จำเป็นต้องมีขอบเขต @Composable
• ตอนนี้ Placeholder อนุญาตให้รีเซ็ตได้หากเนื้อหาไม่อยู่ในสถานะพร้อมใช้งานแล้ว นอกจากนี้ ตอนนี้การตั้งค่าลดการเคลื่อนไหวจะมีผลกับเอฟเฟกต์แสงระยิบระยับและการเคลื่อนไหวแบบลบออกใน Placeholder ด้วย

ปัญหาที่ทราบ

• PositionIndicator จะไม่แสดงในตอนแรกเมื่อหน้าจอแสดงขึ้นเป็นครั้งแรก เราตั้งใจที่จะทำการเปลี่ยนแปลงในเวอร์ชัน 1.4 อัลฟ่าช่วงแรกเพื่อให้แสดงในตอนแรก แต่จะไม่มีภาพเคลื่อนไหว

การเปลี่ยนแปลง API

• เราได้เปลี่ยนชื่อระดับพื้นฐาน SwipeToDismissBox เป็น BasicSwipeToDismissBox วิธีนี้ช่วยให้แยกความแตกต่างระหว่างคอมโพเนนต์ระดับ Foundation กับระดับ Material SwipeToDismissBox ได้ชัดเจนขึ้น ไฟล์หลังจะดึงสีจาก MaterialTheme เพื่อใช้ในภาพตัวอย่างและมอบหมายการติดตั้งใช้งานที่เหลือให้กับ BasicSwipeToDismissBox (Ibecfc)
• เราได้ทําเครื่องหมาย rememberExpandableStateMapping เป็นการทดสอบและปรับปรุงประสิทธิภาพของ expandableItem แล้ว (I5f6bc)
• เราได้แทนที่คลาส SwipeToRevealAction ใน SwipeToReveal Card และ Chip API ของ Material ด้วย API ตามช่องโดยใช้คอมโพสิเบิล SwipeToRevealPrimaryAction, SwipeToRevealSecondaryAction และ SwipeToRevealUndoAction โปรดดูตัวอย่างโค้ดเพื่อดูวิธีใช้ API ใหม่ (Ia8943)
• เราได้แทนที่ Flag ภาพเคลื่อนไหว PositionIndicator ด้วยพารามิเตอร์ AnimationSpec คุณปิดใช้ภาพเคลื่อนไหวแต่ละรายการได้โดยส่ง snap เป็น AnimationSpec (I6c523)

การแก้ไขข้อบกพร่อง

• เราได้แก้ไขข้อบกพร่องที่เกิดจากข้อความโค้งแบบจำกัดเมื่อขนาดถูกจำกัด (I50efe)
• เราได้แก้ไขปัญหาข้อขัดข้อง NaN ที่อาจเกิดขึ้นซึ่งเกี่ยวข้องกับ curvedComposable (I970eb) แล้ว
• เราได้เปลี่ยนกลับการนําภาพเคลื่อนไหวไฮไลต์การเปลี่ยนแปลงตําแหน่งออกใน PositionIndicator แล้ว (Ieb424)
• เราได้นําเลเยอร์วัสดุหลักออกสําหรับชิปวัสดุเพื่อปรับปรุงประสิทธิภาพ (If2dcb)

เวอร์ชัน 1.3.0-alpha08

18 ตุลาคม 2023

androidx.wear.compose:compose-*:1.3.0-alpha08 ได้รับการปล่อยแล้ว เวอร์ชัน 1.3.0-alpha08 มีการคอมมิตเหล่านี้

การเปลี่ยนแปลง API

• เราได้เพิ่ม Flag แต่ละรายการลงใน PositionIndicator overload เพื่อควบคุมภาพเคลื่อนไหวที่แตกต่างกัน ได้แก่ showFadeInAnimation, showFadeOutAnimation และ showPositionAnimation ระบบเลิกใช้งาน API เวอร์ชันเก่าและส่งต่อการเรียกไปยัง API เวอร์ชันใหม่ เราขอแนะนำให้ปิด Flag showFadeInAnimation และ showPositionAnimation เมื่อใช้ PositionIndicator กับรายการที่เลื่อนได้ เพื่อเหตุผลด้านประสิทธิภาพและความสอดคล้องของ UX หากใช้ PositionIndicator เป็นอินดิเคเตอร์แบบสแตนด์อโลน เช่น สำหรับการเปลี่ยนแปลงระดับเสียง เราขอแนะนำให้เปิดภาพเคลื่อนไหวทั้ง 3 แบบ (I44294)
• เราได้เลิกใช้งาน Material 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

• เราได้เพิ่ม Flag แต่ละรายการลงใน PositionIndicator เพื่อควบคุมภาพเคลื่อนไหวที่แตกต่างกัน ได้แก่ showFadeInAnimation, showFadeOutAnimation และ showPositionAnimation ระบบเลิกใช้งาน API เวอร์ชันเก่าและส่งต่อการเรียกไปยัง API เวอร์ชันใหม่ เราขอแนะนำให้ปิด Flag showFadeInAnimation และ showPositionAnimation เมื่อใช้ PositionIndicator กับรายการที่เลื่อนได้ เพื่อเหตุผลด้านประสิทธิภาพและความสอดคล้องของ UX หากใช้ 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 มีการคอมมิตเหล่านี้

การแก้ไขข้อบกพร่อง

• เราได้เพิ่มการจัดการในการปัดเพื่อดูเพื่อให้ปัดได้ทีละรายการเท่านั้น (I3cd7a)
• ปรับปรุงเอกสารประกอบของ ScalingLazyColumnDefaults ให้สอดคล้องกับลักษณะการทำงานจริงมากขึ้น (I886d3)

เวอร์ชัน 1.3.0-alpha04

23 สิงหาคม 2023

androidx.wear.compose:compose-*:1.3.0-alpha04 ได้รับการปล่อยแล้ว เวอร์ชัน 1.3.0-alpha04 มีการคอมมิตเหล่านี้

ฟีเจอร์ใหม่

• เราได้เพิ่มการรองรับการเลิกทำสำหรับการดำเนินการรองของ SwipeToReveal (I7a22d)

การเปลี่ยนแปลง API

• เพิ่ม HorizontalPageIndicator ในคลัง Wear Material3 (Ifee99)
• อัปเดตเครื่องมือสำหรับแสดงตัวอย่างของ Wear Compose เพื่อใช้ไลบรารี androidx.wear.tooling.preview (Ib036e)

การแก้ไขข้อบกพร่อง

• แก้ไขข้อบกพร่องในปุ่มกลมที่ไม่ได้ใช้ตัวแก้ไขอย่างถูกต้อง (I5e162)

เวอร์ชัน 1.3.0-alpha03

9 สิงหาคม 2023

androidx.wear.compose:compose-*:1.3.0-alpha03 ได้รับการปล่อยแล้ว เวอร์ชัน 1.3.0-alpha03 มีการคอมมิตเหล่านี้

การเปลี่ยนแปลง API

• เราได้เพิ่มคอมโพสิเบิลใหม่ 2 รายการใน Material สำหรับการใช้ SwipeToReveal กับการ์ดและชิป คอมโพสิเบิลเหล่านี้เป็นไปตามหลักเกณฑ์ 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 Foundation (I4ff8e)

การแก้ไขข้อบกพร่อง

• เราได้แก้ไขข้อบกพร่องเกี่ยวกับลําดับชั้น z ซึ่ง expandedItem ไม่แสดงเนื้อหาที่ถูกต้องหลังจากคลิกลักษณะการทํางานของปุ่มเมื่อมีปุ่ม (I1899d, b/289991514)
• ปรับปรุงการจัดการโฟกัสของ SwipeToDismissBox (และ SwipeDismissableNavHost) โดยใช้ HierarchicalFocusCoordinator (I45362, b/277852486)
• เราได้แก้ไขการจัดการท่าทางสัมผัสใน SwipeableV2 แล้ว (I89737)
• เราได้สรุปโปรไฟล์พื้นฐานสําหรับรุ่น 1.2 แล้ว (Id5740)
• หลังจากการย้ายข้อมูล SwipeToDismissBox ไปยัง Foundation ตอนนี้การติดตั้งใช้งาน Material SwipeToDismissBox จะส่งต่อไปยัง Foundation และระบุค่าสีเริ่มต้นจากธีม (If8451)
• เราได้เพิ่มความหมายของส่วนหัวลงใน ListHeader แล้ว (Ic5420)
• ตอนนี้ Chip และ ToggleChip จะปรับความสูงให้รองรับเนื้อหาที่เพิ่มขึ้นเนื่องจากแบบอักษรขนาดใหญ่สำหรับการช่วยเหลือพิเศษ (หากจำเป็น) (Iaf302)
• แก้ไขข้อบกพร่องในบทบาทเชิงความหมายของพื้นที่ที่แตะได้ของ SplitToggleChip เพื่อความสามารถในการเข้าถึง (Ieed3a)
• ตอนนี้การตั้งค่าลดการเคลื่อนไหวจะปิดเอฟเฟกต์แสงระยิบระยับและการเคลื่อนไหวแบบลบออกในตัวยึดตําแหน่ง (I91046)
• ตอนนี้ Stepper และ InlineSlider รองรับการคลิกซ้ำเมื่อกดค้างไว้เพื่อให้คุณเพิ่ม/ลดค่าของ Stepper และ InlineSlider ได้อย่างรวดเร็วโดยกดปุ่ม + หรือ - ค้างไว้ (I27359)

เวอร์ชัน 1.3.0-alpha01

21 มิถุนายน 2023

androidx.wear.compose:compose-*:1.3.0-alpha01 ได้รับการปล่อยแล้ว เวอร์ชัน 1.3.0-alpha01 มีการคอมมิตเหล่านี้

การแก้ไขข้อบกพร่อง

• ตามที่ได้ประกาศไว้ใน 1.2.0-alpha07 และ 1.2.0-alpha10 ตอนนี้เรากำลังเปลี่ยน DefaultTextStyle เพื่อปิดการเยื้องแบบอักษรเพื่อให้สอดคล้องกันทั่วทั้งแพลตฟอร์ม Android วิธีนี้จะช่วยแก้ปัญหาการตัดข้อความบางส่วนด้วยแบบอักษรขนาดใหญ่ และอาจส่งผลต่อเลย์เอาต์หน้าจอด้วย จึงต้องมีการอัปเดตการทดสอบภาพหน้าจอ ตัวอย่างเช่น เราเห็นการคัดลอกข้อความที่นี่ (Ic6a86)

• ซึ่งจะหายไปเมื่อปิดการเยื้องแบบอักษร

• เราได้อัปเดต wear.compose.foundation ให้เป็น API ที่ต้องพึ่งพาของ wear.compose.material แล้ว (I72004, b/285404743)
• เราได้แก้ไขข้อบกพร่องใน SwipeToDismissBox แล้ว ตอนนี้ระบบจะส่งคีย์พื้นหลังและเนื้อหาไปยังบล็อกการจดจำเพื่อให้สร้างตัวแก้ไขใหม่เมื่อมีการเปลี่ยนแปลงเนื้อหาหรือพื้นหลัง (Ib876c, b/280392104)
• เราได้อัปเดต TimeText ให้ใช้ภาษาเมื่อเลือกรูปแบบเวลา 12 หรือ 24 ชั่วโมง (If4a3d)
• เราได้แก้ไขความไม่สอดคล้องในพารามิเตอร์เริ่มต้นของ SwipeToDismissBox contentScrimColor แล้ว (I2d70f)
• เราได้ปรับปรุงการจัดการการเคลื่อนไหวใน SwipeToReveal (I28fb7)

ปัญหาที่ทราบ

• การรองรับขนาดแบบอักษรที่ผู้ใช้กําหนดค่าเป็นข้อกําหนดด้านการช่วยเหลือพิเศษ เราทราบดีว่าชิปหลายบรรทัดอาจทำให้ข้อความถูกตัดออกเมื่อแสดงด้วยแบบอักษรขนาดใหญ่ ดังนั้นเราจะอัปเดตชิปในเวอร์ชัน 1.3 อัลฟ่ารุ่นแรกเพื่อปรับความสูงในกรณีดังกล่าว

เวอร์ชัน 1.2

เวอร์ชัน 1.2.1

18 ตุลาคม 2023

androidx.wear.compose:compose-*:1.2.1 ได้รับการปล่อยแล้ว เวอร์ชัน 1.2.1 มีคอมมิตเหล่านี้

การแก้ไขข้อบกพร่อง

• แก้ไขข้อบกพร่องเมื่อ PositionIndicator หายไปอย่างไม่ถูกต้อง (7a167f)

เวอร์ชัน 1.2.0

9 สิงหาคม 2023

androidx.wear.compose:compose-*:1.2.0 ได้รับการปล่อยแล้ว เวอร์ชัน 1.2.0 มีคอมมิตเหล่านี้

การเปลี่ยนแปลงที่สําคัญตั้งแต่เวอร์ชัน 1.1.0

• Compose สำหรับ Wear OS 1.2.0 เวอร์ชันเสถียร (อ่านเพิ่มเติม)
• ดูรายการการเปลี่ยนแปลงที่สำคัญใน Wear Compose 1.2 ได้ที่บันทึกประจำรุ่นของ (Compose สำหรับ 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(I4725d)
• เราได้แก้ไขปัญหาค่าเริ่มต้นที่ไม่สอดคล้องกันสำหรับพารามิเตอร์ SwipeToDismissBox contentScrimColor (I2d70f)
• เราได้แก้ไขค่าเริ่มต้น DefaultTextStyle ที่ใช้สำหรับการตั้งค่า IncludeFontPadding แล้ว (I737ed)

เวอร์ชัน 1.2.0-beta01

24 พฤษภาคม 2023

androidx.wear.compose:compose-*:1.2.0-beta01 ได้รับการปล่อยแล้ว เวอร์ชัน 1.2.0-beta01 มีการคอมมิตเหล่านี้

สิ่งที่มีใน Compose สำหรับ Wear OS 1.2

เวอร์ชัน 1.2-beta01 ของ Compose สำหรับ Wear OS บ่งบอกว่าไลบรารีเวอร์ชันนี้มีฟีเจอร์ครบถ้วนและ API ถูกล็อก (ยกเว้นในกรณีที่ทำเครื่องหมายเป็นเวอร์ชันทดลอง) Wear Compose 1.2 มีฟังก์ชันการทำงานใหม่ต่อไปนี้

• expandableItem และ expandableItems เป็นคอมโพเนนต์ Foundation ใหม่ 2 รายการที่รองรับการขยายรายการภายใน ScalingLazyColumn ใช้ expandableItem สำหรับรายการแบบขยายได้รายการเดียว เช่น ข้อความที่มีจำนวนบรรทัด ใช้ expandableItems สำหรับกลุ่มรายการที่ขยายได้ และ expandableButton เพื่อลดความซับซ้อนในการสร้างปุ่มที่จะยุบลงหลังจากขยายเนื้อหา
• HierarchicalFocusCoordinator - คอมโพสิชันเวอร์ชันทดลองนี้ช่วยให้คุณทำเครื่องหมายต้นไม้ย่อยขององค์ประกอบเป็น "เปิดใช้โฟกัส" หรือ "ปิดใช้โฟกัส" ได้
• Picker - ตอนนี้ API มี userScrollEnabled เพื่อควบคุมว่าเครื่องมือเลือกจะทำงานเมื่อผู้ใช้เลื่อนหรือไม่
• PickerGroup - คอมโพสิชันใหม่สำหรับจัดการเครื่องมือเลือกหลายรายการร่วมกัน โดยจัดการโฟกัสระหว่างเครื่องมือเลือกโดยใช้ HierarchicalFocusCoordinator API และเปิดใช้การทำให้รายการเครื่องมือเลือกอยู่ตรงกลางโดยอัตโนมัติ
• Placeholder - เราได้อัปเดตภาพเคลื่อนไหวที่สั่นไหวและ "ปัดออก" ตอนนี้ระบบจะใช้เอฟเฟกต์การลบออกทันทีเมื่อเนื้อหาพร้อมใช้งาน
• ScalingLazyColumn - เราได้ย้ายข้อมูล ScalingLazyColumn และชั้นเรียนที่เกี่ยวข้องจาก androidx.wear.compose.material.ScalingLazyColumn ไปยัง androidx.wear.compose.foundation.lazy.ScalingLazyColumn แล้ว โปรดอัปเดตเพื่อใช้เวอร์ชัน Foundation.Lazy
• SwipeToReveal - เราได้เพิ่มการรองรับการทดลองใช้การปัดเพื่อแสดงเป็นวิธีเข้าถึงการดำเนินการรอง ซึ่งมาเสริมรูปแบบ "การกดค้าง" ที่มีอยู่
• Stepper - ตอนนี้มีการโอเวอร์โหลดด้วยพารามิเตอร์ enableRangeSemantics เพิ่มเติมเพื่ออำนวยความสะดวกในการปิดใช้ความหมายของช่วงเริ่มต้น
• Previews - เราได้เพิ่มคำอธิบายประกอบที่กำหนดเองต่อไปนี้สำหรับการแสดงตัวอย่างคอมโพเนนต์บนหน้าจอ Wear ได้แก่ WearPreviewSmallRound แสดงตัวอย่างคอมโพเนนต์บนอุปกรณ์ทรงกลมขนาดเล็ก WearPreviewLargeRound แสดงตัวอย่างคอมโพเนนต์บนอุปกรณ์ทรงกลมขนาดใหญ่ และ WearPreviewSquare แสดงตัวอย่างคอมโพเนนต์บนอุปกรณ์สี่เหลี่ยมจัตุรัส นอกจากนี้ คําอธิบายประกอบต่อไปนี้และการแสดงตัวอย่างหลายรายการ WearPreviewFontScales จะแสดงตัวอย่างคอมโพสิเบิลในอุปกรณ์ Wear ที่มีแบบอักษรหลายขนาด ส่วน WearPreviewDevices จะแสดงตัวอย่างคอมโพสิเบิลในอุปกรณ์ Wear เครื่องต่างๆ
• เราได้เพิ่ม DefaultTextStyle ลงใน Wear Compose ซึ่งจะตั้งค่าพร็อพเพอร์ตี้ PlatformTextStyle.includeFontPadding เป็น "จริง" โดยค่าเริ่มต้น (ซึ่งเป็นการตั้งค่าปัจจุบัน) ซึ่งจะช่วยให้เราซิงค์การปิดการเยื้องแบบอักษรโดยค่าเริ่มต้นกับไลบรารีการเขียนอีเมลในเวอร์ชัน 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 ลงในคอมโพสิชันการดําเนินการใน SwipeToReveal ซึ่งจะให้สิทธิ์เข้าถึงออฟเซตที่แสดงการดำเนินการเพิ่มเติม (I3fd56)

การแก้ไขข้อบกพร่อง

• แก้ไขปัญหา ScalingLazyColumn ค้างอยู่ที่ Wear API 33 หลังจาก Fling (Ic4599)
• เราได้ปรับปรุงประสิทธิภาพของ PositionIndicator เพื่อลดการกระตุก (I35e92)
• เราได้แก้ไขข้อบกพร่องในชิปและ CompactChip ที่ระบบไม่ได้ตั้งค่าบทบาทเชิงความหมายเป็น Role.Button อีกต่อไป (I93f91, b/277326264)

ปัญหาที่ทราบ

• เราพบข้อบกพร่องใน Android Studio ซึ่งทําให้แสดงตัวอย่างไม่สําเร็จเมื่อใส่คำอธิบายประกอบด้วย @WearPreviewDevices และ @WearPreviewFontScales และวางแผนที่จะเผยแพร่การแก้ไขในเร็วๆ นี้ โปรดทราบว่าคำอธิบายประกอบอื่นๆ ของตัวอย่าง Wear จะทำงานตามที่ตั้งใจไว้ใน Android Studio Giraffe 2022.3.1 ขึ้นไป

• ในเวอร์ชัน 1.2.0-alpha07 เราได้เพิ่ม DefaultTextStyle ลงใน Wear Compose โดยยังคงค่า PlatformTextStyle.includeFontPadding ที่มีอยู่เป็น true สำหรับพื้นหลัง โปรดดูแก้ไขระยะห่างจากขอบของแบบอักษรใน Compose เราจะเปลี่ยน DefaultTextStyle เพื่อปิดการเยื้องแบบอักษรในเวอร์ชัน 1.3 รุ่นอัลฟ่าช่วงต้น เพื่อให้สอดคล้องกับแพลตฟอร์ม Android วิธีนี้จะช่วยแก้ปัญหาการตัดข้อความบางส่วนด้วยแบบอักษรขนาดใหญ่ และอาจส่งผลต่อเลย์เอาต์หน้าจอด้วย ดังนั้นการทดสอบภาพหน้าจอจึงต้องมีการอัปเดต ตัวอย่างเช่น เมื่อใช้แบบอักษรขนาดใหญ่ เราจะเห็นการครอบตัดข้อความที่นี่

• ซึ่งจะหายไปเมื่อปิดการเยื้องแบบอักษร

คุณใช้การตั้งค่าใหม่ได้แล้วโดยการลบล้างแบบอักษรในธีมของคุณ ดูโค้ดตัวอย่าง

เวอร์ชัน 1.2.0-alpha09

19 เมษายน 2023

androidx.wear.compose:compose-*:1.2.0-alpha09 ได้รับการปล่อยแล้ว เวอร์ชัน 1.2.0-alpha09 มีการคอมมิตเหล่านี้

การเปลี่ยนแปลง API

• เพิ่ม angularSizeDp ลงใน 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 จัดการโฟกัสอย่างถูกต้องเมื่อไม่มี Picker ใดมีโฟกัส นอกจากนี้ เรายังเพิ่มการรองรับการเลื่อน RSB ในการแสดงตัวอย่างเครื่องมือเลือกด้วย (If8c19)
• เราได้ปรับปรุงทรานซิชันของบทสนทนา ตอนนี้ทรานซิชันช่วงอินโทรจะราบรื่นยิ่งขึ้นเพื่อให้เข้ากับทรานซิชันช่วงปิด (Ib5af9)
• เราได้เพิ่ม DefaultTextStyle ลงใน Wear Compose ซึ่งจะตั้งค่าพร็อพเพอร์ตี้ PlatformTextStyle.includeFontPadding เป็น "จริง" โดยค่าเริ่มต้น (ซึ่งเป็นการตั้งค่าปัจจุบัน) ซึ่งจะช่วยให้เราซิงค์การปิดการเยื้องแบบอักษรโดยค่าเริ่มต้นกับไลบรารี Compose ในอนาคตได้ ดูข้อมูลเบื้องต้นได้ที่ (แก้ไขการเยื้องแบบอักษรใน Compose) (I2aee8)
• เปลี่ยนกลับการพึ่งพาตัวอย่าง UpsideDownCake ผ่าน activity-compose ที่บล็อกการเผยแพร่แอปไปยัง 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)
• เราได้เพิ่มคำอธิบายประกอบที่กำหนดเองต่อไปนี้สำหรับการแสดงตัวอย่างคอมโพเนนต์บนหน้าจอ Wear ได้แก่ WearPreviewSmallRound แสดงตัวอย่างคอมโพเนนต์บนอุปกรณ์ทรงกลมขนาดเล็ก WearPreviewLargeRound แสดงตัวอย่างคอมโพเนนต์บนอุปกรณ์ทรงกลมขนาดใหญ่ WearPreviewSquare แสดงตัวอย่างคอมโพเนนต์บนอุปกรณ์สี่เหลี่ยมจัตุรัส นอกจากนี้ คําอธิบายประกอบต่อไปนี้และการแสดงตัวอย่างหลายรายการ WearPreviewFontScales จะแสดงตัวอย่างคอมโพสิเบิลในอุปกรณ์ Wear ที่มีแบบอักษรหลายขนาด ส่วน WearPreviewDevices จะแสดงตัวอย่างคอมโพสิเบิลในอุปกรณ์ Wear เครื่องต่างๆ หากต้องการใช้ตัวอย่างเหล่านี้ คุณต้องใช้ Android Studio เวอร์ชันล่าสุด (Giraffe Canary 6) ขึ้นไป โปรดทราบว่าหากคำอธิบายประกอบเหล่านี้ไม่เหมาะกับวัตถุประสงค์ของคุณ คุณยังคงใช้ตัวอย่างเพลงและปรับแต่งเพิ่มเติมผ่านพารามิเตอร์ได้ (I397ff)
• เราได้ทําเครื่องหมาย HierarchicalFocusCoordinator ว่าเป็นแบบทดลองขณะที่พิจารณาว่าควรย้ายไปยังคลังคอมโพสิทหลัก เนื่องจากมีการใช้งานที่หลากหลาย (I3a768)

การแก้ไขข้อบกพร่อง

• แก้ไขข้อบกพร่องใน HierarchicalFocusCoordinator เมื่อมีการแก้ไข Lambda ที่ส่งเข้ามาสำหรับพารามิเตอร์ focusEnabled ตอนนี้เราใช้ Lambda ใหม่อย่างถูกต้องแล้ว (Icb353)
• เราได้อัปเดตสีเริ่มต้นของเนื้อหาที่ปิดใช้เป็นพื้นหลังเมื่อใช้สีหลักเป็นพื้นหลังใน Button, CompactButton, Chip, CompactChip และ ToggleButton ซึ่งจะช่วยปรับปรุงคอนทราสต์เพื่อความสามารถในการเข้าถึง (I527cc)

เวอร์ชัน 1.2.0-alpha05

22 กุมภาพันธ์ 2023

androidx.wear.compose:compose-*:1.2.0-alpha05 ได้รับการปล่อยแล้ว เวอร์ชัน 1.2.0-alpha05 มีการคอมมิตเหล่านี้

การเปลี่ยนแปลง API

• อัปเดต PickerGroup API เพื่ออนุญาตให้เผยแพร่ข้อจำกัดขั้นต่ำไปยังคอมโพสิเบิลได้ (ไม่บังคับ) เมื่อตั้งค่าเป็น "จริง" ระบบจะอนุญาตข้อจำกัดขั้นต่ำที่ส่งผ่านจาก Composable หลักใน PickerGroup หากตั้งค่าเป็นเท็จ PickerGroup จะรีเซ็ตข้อจำกัดขั้นต่ำ (I3e046)
• เราได้เพิ่ม animateScrollToOption ลงใน Picker API เพื่อรองรับภาพเคลื่อนไหวแบบเป็นโปรแกรมในตัวเลือก Picker ที่เฉพาะเจาะจง (I6fe67)

การแก้ไขข้อบกพร่อง

• เราได้อัปเดต HorizontalPageIndicator เพื่อรองรับเลย์เอาต์จากขวาไปซ้าย (Ia4359)
• เพิ่มการทดสอบภาพหน้าจอสำหรับเลย์เอาต์จากขวาไปซ้ายใน HorizontalPageIndicator (I6fbb8)
• เพิ่มการทดสอบเพิ่มเติมใน SwipeDismissableNavHostTest ที่ใช้ TestNavHostController (I61d54)

เวอร์ชัน 1.2.0-alpha04

8 กุมภาพันธ์ 2023

androidx.wear.compose:compose-*:1.2.0-alpha04 ได้รับการปล่อยแล้ว เวอร์ชัน 1.2.0-alpha04 มีการคอมมิตเหล่านี้

ฟีเจอร์ใหม่

• PickerGroup สำหรับการจัดการเครื่องมือเลือกหลายรายการพร้อมกันโดยใช้ Focus API โดยจะจัดการโฟกัสระหว่างเครื่องมือเลือกต่างๆ เปิดใช้การกึ่งกลางเครื่องมือเลือกโดยอัตโนมัติตามพารามิเตอร์ และช่วยให้นักพัฒนาแอปเปลี่ยนโฟกัสระหว่างเครื่องมือเลือกต่างๆ ได้ขณะจัดการเหตุการณ์จากกลุ่ม ในโหมด Talkback PickerGroup จะจัดการโฟกัสของ Talkback โดยย้ายโฟกัสไปยังเครื่องมือเลือกที่เลือกจากกลุ่ม (I60840)

การเปลี่ยนแปลง API

• เราได้เพิ่มการโอเวอร์โหลดไปยัง Stepper ด้วยพารามิเตอร์ enableRangeSemantics เพิ่มเติมเพื่อให้ปิดใช้ความหมายของช่วงเริ่มต้นได้ง่ายขึ้น (Ia61d4)

การแก้ไขข้อบกพร่อง

• อนุญาตให้ฝัง ScalingLazyColumn ภายในหน้าเว็บที่เลื่อนแนวนอน (Iec3f8, b/266555016)
• การปรับปรุง kdocs ของ Stepper และการล้างข้อมูลการทดสอบ StepperTest (Ic118e)
• อัปเดต androidx.navigation ขึ้นเป็นเวอร์ชัน 2.5.3 (If58ed)

เวอร์ชัน 1.2.0-alpha03

25 มกราคม 2023

androidx.wear.compose:compose-*:1.2.0-alpha03 ได้รับการปล่อยแล้ว เวอร์ชัน 1.2.0-alpha03 มีคอมมิตเหล่านี้

การเปลี่ยนแปลง API

• เราได้ย้ายข้อมูล ScalingLazyColumn (และคลาสที่เกี่ยวข้อง) จาก androidx.wear.compose.material.ScalingLazyColumn ไปยัง andrdoidx.wear.compose.foundation.lazy.ScalingLazyColumn แล้ว (ดูการย้ายข้อมูลในตัวอย่างนี้) ตําแหน่งใหม่นี้ตรงกับของ compose.foundation.lazy.LazyColumn มากกว่าและดูเป็นธรรมชาติมากกว่า เนื่องจากไม่ใช่คอมโพเนนต์ Material ที่แสดงความคิดเห็น การเปลี่ยนแปลงนี้เกิดขึ้นแล้วเพื่อเตรียมพร้อมสำหรับไลบรารี Material3 ใหม่ ซึ่งเราจะพัฒนาควบคู่ไปกับไลบรารี Material ที่มีอยู่ (I060e7)

การเปลี่ยนแปลงต่อไปนี้เป็นส่วนหนึ่งของการย้ายข้อมูล ScalingLazyColumn จาก Material ไปยัง Foundation.Lazy

• เราได้เลิกใช้งาน PositionIndicator apis ที่กําหนดเป้าหมายเป็น Material ScalingLazyColumn แล้ว โปรดอัปเดตเป็น Foundation.Lazy ScalingLazyColumn นอกจากนี้ ระบบยังเพิ่มช่อง anchorType ลงใน ScalingLazyListLayoutInfo ด้วย (I29d95)
• ScalingLazyColumn มีการทำเครื่องหมายว่าเลิกใช้งานแล้วในแพ็กเกจ Wear Compose Material (I16d34)
• เราได้อัปเดตตัวแก้ไข ScrollAway ให้ใช้ ScalingLazyListState จาก Wear Compose Foundation.Lazy และเลิกใช้งานการโอเวอร์โหลดที่ใช้ ScalingLazyListState จาก Wear Compose Material (Ifc42c)
• เราได้อัปเดต Dialog API ให้ใช้ ScalingLazyListState จาก Foundation.Lazy และเลิกใช้งานการโอเวอร์โหลดที่ใช้ Material ScalingLazyListState (Ic8960)
• เราได้อัปเดต Picker API ให้ใช้ ScalingParams จาก Foundation.Lazy และเลิกใช้งานการโอเวอร์โหลดที่ใช้ Material ScalingParams (Idc3d8)

การแก้ไขข้อบกพร่อง

• เราได้แก้ไขข้อบกพร่องที่ทําให้ต้องมีการจัดองค์ประกอบใหม่ใน ScalingLazyListState.centerItemIndex โดยไม่จําเป็น โดยการตรวจสอบว่าระบบจะพุชการอัปเดตก็ต่อเมื่อค่ามีการเปลี่ยนแปลงจริงเท่านั้น (Ia9f38)
• เราได้ปรับปรุงประสิทธิภาพของ SwipeToDismissBox (I3933b) แล้ว
• เพิ่มการทดสอบการเปรียบเทียบสำหรับ ScalingLazyColumn ใน Wear Compose Foundation (Ie00f9)
• เราได้อัปเดตเมธอดของคลาส ScalingLazyColumn ภายในบางรายการใน Material เพื่อใช้เมธอดที่เทียบเท่าจาก Foundation.Lazy (I38aab)
• เราได้แก้ไขปัญหาบางอย่างในการทดสอบเครื่องมือเลือก และเพิ่มการทดสอบเพิ่มเติมเพื่อตรวจสอบการเลื่อนด้วยออฟเซต (I6ac34)
• เราได้ย้ายข้อมูลเดโมการผสานรวม ScalingLazyColumn ให้ใช้ Foundation.Lazy แทน Material ScalingLazyColumn (Ic6caa)
• เราได้เพิ่มพารามิเตอร์ fromDate/toDate ที่ไม่บังคับลงในเดโม DatePicker (I961cd)

เวอร์ชัน 1.2.0-alpha02

11 มกราคม 2023

androidx.wear.compose:compose-*:1.2.0-alpha02 ได้รับการปล่อยแล้ว เวอร์ชัน 1.2.0-alpha02 มีการคอมมิตเหล่านี้

การเปลี่ยนแปลง API

• ตอนนี้การทดสอบ UI ของ Android Compose จะเรียกใช้การวางเลย์เอาต์สำหรับแต่ละเฟรมเมื่อเรียกใช้เฟรมเพื่อเข้าสู่สถานะไม่ทำงาน (เช่น ผ่าน waitForIdle) ซึ่งอาจส่งผลต่อการทดสอบที่ยืนยันในเฟรมแต่ละเฟรมของภาพเคลื่อนไหวของเลย์เอาต์ (I8ea08, b/222093277)
• เพิ่มพารามิเตอร์ minLines ลงในข้อความ Wear เพื่อให้ทำงานได้สอดคล้องกันกับ 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

• เราได้เพิ่ม HierarchicalFocusCoordinatorcomposable เพื่อเปิดใช้การทำเครื่องหมายต้นไม้ย่อยขององค์ประกอบเป็นโฟกัสที่เปิดใช้หรือโฟกัสที่ปิดใช้ (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)
• เราได้อัปเดตภาพพื้นหลังที่ใช้กับภาพเคลื่อนไหว 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 สำหรับ Wear OS 1.1 Beta01)

ฟีเจอร์ใหม่

• เราได้อัปเดตฟังก์ชันการทำงานของตัวยึดตำแหน่งเวอร์ชันทดลองเพื่อให้ระบบใช้เอฟเฟกต์ "ลบออก" ทันทีเมื่อเนื้อหาพร้อมใช้งานแทนที่จะรอให้ภาพเคลื่อนไหววนรอบถัดไปเริ่มขึ้น นอกจากนี้ เรายังได้อัปเดตภาพเคลื่อนไหวของชิมเมอร์และการลบออกด้วย (I5a7f4)

การแก้ไขข้อบกพร่อง

• เราได้เปลี่ยนความกว้างของเส้นขอบเริ่มต้นสำหรับ OutlinedButton/OutlinedCompactButton จาก 2.dp เป็น 1.dp เพื่อให้ตรงกับข้อกำหนด UX ขั้นสุดท้าย (Icf84d)
• เราได้เพิ่ม autoCentering topPadding โดยประมาณเมื่อเนื้อหาว่างเปล่าเพื่อลดผลของรายการแรกที่เพิ่มลงใน ScalingLazyColumn ว่างเปล่าซึ่งดูเหมือนจะเลื่อนไปอยู่ในตำแหน่ง การเปลี่ยนแปลงนี้จะคำนวณจำนวนการเว้นวรรคด้านบนที่จำเป็นโดยสมมติว่ารายการแรกมีความสูง 0.dp สำหรับ ScalingLazyListAnchorType.ItemStart ระบบจะคำนวณระยะห่างจากขอบด้านบนที่ถูกต้อง แต่สำหรับ ScalingLazyListAnchorType.ItemCenter การคำนวณนี้จะไม่ถูกต้องเนื่องจากต้องใช้ความสูงของรายการเพื่อปรับขนาดเนื้อหาให้ถูกต้อง ซึ่งจะทำให้มีการเลื่อนเล็กน้อยเพื่อจัดวางตามความสูงจริงของรายการ (I239a4)
• เราได้อัปเดตพื้นหลังที่ใช้กับภาพเคลื่อนไหว 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 เพื่อให้ TimeText ยังคงแสดงอยู่หาก itemIndex ที่ระบุไม่ถูกต้อง (เช่น หากดัชนีรายการนั้นอยู่นอกช่วง) (I2137a)
• เราได้อัปเดตภาพเคลื่อนไหว SwipeToDismissBox ให้สอดคล้องกับการใช้งานแพลตฟอร์ม หลังจากภาพเคลื่อนไหวการบีบครั้งแรก ตอนนี้หน้าจอจะเลื่อนออกไปทางขวาเมื่อมีการเรียกให้ปิด (I41d34)
• เราได้อัปเดต Modifier.scrollAway ให้อ่านเฉพาะ scrollState ภายในบล็อกการวัดเพื่อหลีกเลี่ยงการคอมโพสิชันตัวแก้ไขอีกครั้งหลังจากการวัดใหม่แต่ละครั้ง เพื่อเป็นการเพิ่มประสิทธิภาพ (I4c6f1)
• เราได้เพิ่มเอกสารประกอบและตัวอย่างลงในตัวยึดตําแหน่งเพื่อแสดงลําดับที่ถูกต้องสําหรับ Modifier.placeholder และ Modifier.placeholderShimmer เมื่อนําไปใช้กับคอมโพสิเบิลเดียวกัน (Ie96f4, b/256583229)
• เราได้เปลี่ยนความกว้างของเส้นขอบเริ่มต้นสำหรับ OutlinedCompactChip/OutlinedChip จาก 2.dp เป็น 1.dp เพื่อให้ตรงกับข้อกำหนด UX ขั้นสุดท้าย (Ib3d8e)
• เราได้แก้ไขข้อบกพร่องใน rememberPickerState ซึ่งระบบไม่บันทึกอินพุตที่อัปเดตแล้ว จึงทำให้คอมโพสิเบิลไม่อัปเดตหลังจากมีการเปลี่ยนแปลงอินพุต (I49ff6, b/255323197)
• เราได้อัปเดต UI ของตัวยึดตําแหน่งบางส่วน ดังนี้ 1) เปลี่ยนการไล่ระดับสีของแสงระยิบระยับเป็น 1.5 เท่าของขนาดหน้าจอ 2) เพิ่มการผ่อนปรน (Cubic Bezier) ของการเปลี่ยนแปลงแสงระยิบระยับ และ 3) เร่งความเร็วของภาพเคลื่อนไหวการลบออก (250 มิลลิวินาที) (Id29c1)
• เราได้แก้ไขข้อบกพร่อง UI ในเอฟเฟกต์การลบตัวยึดตําแหน่ง ซึ่งพื้นหลังของชิปและการ์ดจะหายไปก่อนเวลาอันควรเนื่องจากไม่ได้คำนึงถึงตําแหน่งคอมโพเนนต์บนหน้าจอ (I2c7cb)
• เราได้อัปเดตการวาดพื้นหลังของตำแหน่งโฆษณาเพื่อผสานสีแทนการวางซ้อนสีเมื่อเป็นไปได้ เพื่อลดความเสี่ยงในการผสมอัลฟ่าของเลเยอร์ที่มีการครอบตัดที่แตกต่างกัน ซึ่งอาจทำให้สีที่อยู่เบื้องหลังแสดงผ่านขอบพื้นหลังของตำแหน่งโฆษณา (I2ea26)
• เราได้แก้ไขการคํานวณ ScalingLazyListState.centerItemIndex/centerItemOffset เพื่อให้ระบบถือว่ารายการที่อยู่ใกล้ที่สุดเป็น centerItem หากมี 2 รายการอยู่ด้านข้างของเส้นกึ่งกลางของวิวพอร์ต (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 ของเครื่องมือเลือกจะใช้กับตัวเลือกเครื่องมือเลือกที่เลือกเท่านั้น และจะรับสตริงที่อนุญาตค่า Null (ในคอมมิตก่อนหน้า จำเป็นต้องส่งการแมปจากตัวเลือกไปยังคำอธิบายเนื้อหา แต่จะใช้เฉพาะตัวเลือกที่เลือกเท่านั้น)
  • ตอนนี้รายการเครื่องมือเลือกจะจัดแนวกึ่งกลางเสมอ ซึ่งจะแก้ไขข้อบกพร่องเมื่อการตั้งค่า gradientRatio เป็น 0 มีผลข้างเคียงเป็นการเปลี่ยนแปลงการจัดแนว
  • Chip/ToggleChip - เราได้อัปเดตไล่ระดับสีเริ่มต้นของ Chip/ToggleChip ให้สอดคล้องกับข้อกำหนด UX ล่าสุด เราได้อัปเดต ChipDefaults.gradientBackgroundChipColors ให้เริ่มต้นจาก 50% ของสีหลักแทน 32.5%
  • Chip/ToggleChip - เพิ่มการโอเวอร์โหลดสำหรับการแก้ไขรูปร่างชิป
  • Chip/Button/ToggleButton - เพิ่มรูปแบบใหม่ที่มีเส้นขอบสำหรับชิปและปุ่ม รวมถึงคอมโพสิเบิล 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 จดจำปุ่มดังกล่าว
  • Scaffold - ตอนนี้ 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 ได้อย่างถูกต้อง (มีโหนด compose-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 ของตำแหน่งและตัวบ่งชี้หน้าใน Scaffold แล้ว ตอนนี้ตัวบ่งชี้จะวางอยู่ด้านบนของวิกเน็ต จึงจะไม่ถูกบดบังโดยวิกเน็ตหากมี (Ib988f, b/244207528)

เวอร์ชัน 1.1.0-alpha04

24 สิงหาคม 2022

androidx.wear.compose:compose-foundation:1.1.0-alpha04, androidx.wear.compose:compose-material:1.1.0-alpha04 และ androidx.wear.compose:compose-navigation:1.1.0-alpha04 เผยแพร่แล้ว เวอร์ชัน 1.1.0-alpha04 มีการคอมมิตเหล่านี้

การเปลี่ยนแปลง API

• เราได้อัปเดตสีเริ่มต้นหลายสีใน MaterialTheme เพื่อปรับปรุงการช่วยเหลือพิเศษ เนื่องจากสีเดิมมีคอนทราสต์ไม่เพียงพอ ทำให้ผู้ใช้แยกแยะพื้นหลังของชิป/การ์ด/ปุ่มออกจากสีพื้นหลังของธีมได้ยาก สีที่อัปเดตแล้ว ได้แก่ surface(0xFF202124->0xFF303133), onPrimary(0xFF202124->0xFF303133), onSecondary(0xFF202124->0xFF303133), primaryVariant(0xFF669DF6->0xFF8AB4F8) และ onError(0xFF202124->0xFF000000) การเปลี่ยนแปลงสีแม้จะดูไม่ชัดเจนนัก แต่ก็อาจส่งผลต่อการทดสอบภาพหน้าจอที่มีอยู่ (81ab09)

การแก้ไขข้อบกพร่อง

• แก้ไขข้อบกพร่องด้านตรรกะใน ScalingLazyColumn ซึ่งอาจส่งผลให้รายการที่มีรายการรายการย่อยจำนวนน้อย (โดยทั่วไปคือ 2 รายการ) ไม่สามารถเริ่มต้นได้จนเสร็จสมบูรณ์ และส่งผลให้รายการโปร่งใส (504347)

เวอร์ชัน 1.1.0-alpha03

10 สิงหาคม 2022

androidx.wear.compose:compose-foundation:1.1.0-alpha03, androidx.wear.compose:compose-material:1.1.0-alpha03 และ androidx.wear.compose:compose-navigation:1.1.0-alpha03 เผยแพร่แล้ว เวอร์ชัน 1.1.0-alpha03 มีการคอมมิตเหล่านี้

ฟีเจอร์ใหม่

• เราได้เพิ่มรูปแบบใหม่ที่มีเส้นขอบสำหรับ Chips และ Buttons รวมถึงคอมโพสิเบิล OutlinedChip และ OutlinedButton ใหม่ที่มี Chip/Button แบบโปร่งใสพร้อมเส้นขอบบางๆ (Id5972)

การเปลี่ยนแปลง 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 มีการคอมมิตเหล่านี้

ฟีเจอร์ใหม่

• เราได้เปลี่ยนทรัพยากร Dependency ของ Compose สำหรับ Wear OS ในไลบรารีหลักของ Compose จาก 1.2.0 เป็น 1.3.0-alpha0X

การเปลี่ยนแปลง API

• เพิ่มการโอเวอร์โหลดสำหรับการแก้ไขรูปร่างชิป (I02e87)

การแก้ไขข้อบกพร่อง

• เราได้ทำให้ขอบมืดเคลื่อนไหวเมื่อแสดง/ซ่อนกล่องโต้ตอบ เพื่อให้สอดคล้องกับภาพเคลื่อนไหวการปรับขนาดที่มีอยู่ (Ida33e)
• เราได้แก้ไขข้อบกพร่องที่อาจเกิดการหารด้วย 0 กับลักษณะการฟลิงบางอย่างเมื่อเลื่อน (I86cb6)
• แก้ไขข้อบกพร่องใน ChipDefaults.childChipColor() เพื่อให้สีพื้นหลังที่ปิดใช้โปร่งแสงอย่างสมบูรณ์ (I2b3c3, b/238057342)

เวอร์ชัน 1.1.0-alpha01

29 มิถุนายน 2022

androidx.wear.compose:compose-foundation:1.1.0-alpha01, androidx.wear.compose:compose-material:1.1.0-alpha01 และ androidx.wear.compose:compose-navigation:1.1.0-alpha01 เผยแพร่แล้ว เวอร์ชัน 1.1.0-alpha01 มีการคอมมิตเหล่านี้

การเปลี่ยนแปลง API

• ตอนนี้พารามิเตอร์ contentDescription ของเครื่องมือเลือกจะใช้กับตัวเลือกเครื่องมือเลือกที่เลือกเท่านั้น และจะรับสตริงที่อนุญาตค่า Null (ก่อนหน้านี้จำเป็นต้องส่งการแมปจากตัวเลือกไปยังคำอธิบายเนื้อหา แต่ระบบจะใช้เฉพาะตัวเลือกที่เลือกเท่านั้น) (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 ที่มีพื้นหลังไล่ระดับ เพื่อให้แน่ใจว่าผู้ใช้จะเห็น 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 ของตำแหน่งและตัวบ่งชี้หน้าใน Scaffold แล้ว ตอนนี้ตัวบ่งชี้จะวางอยู่ด้านบนของวิกเน็ต จึงจะไม่ถูกบดบังโดยวิกเน็ตหากมี (Ib988f, b/244207528)

เวอร์ชัน 1.0.1

24 สิงหาคม 2022

androidx.wear.compose:compose-foundation:1.0.1, androidx.wear.compose:compose-material:1.0.1 และ androidx.wear.compose:compose-navigation:1.0.1 เผยแพร่แล้ว เวอร์ชัน 1.0.1 มีคอมมิตเหล่านี้

การแก้ไขข้อบกพร่อง

• แก้ไขข้อบกพร่องด้านตรรกะใน ScalingLazyColumn ซึ่งอาจส่งผลให้รายการที่มีรายการรายการย่อยจำนวนน้อย (โดยทั่วไปคือ 2 รายการ) ไม่สามารถเริ่มต้นได้จนเสร็จสมบูรณ์ และส่งผลให้รายการโปร่งใส (076c61)

เวอร์ชัน 1.0.0

27 กรกฎาคม 2022

androidx.wear.compose:compose-foundation:1.0.0, androidx.wear.compose:compose-material:1.0.0 และ androidx.wear.compose:compose-navigation:1.0.0 เผยแพร่แล้ว เวอร์ชัน 1.0.0 มีคอมมิตเหล่านี้

ฟีเจอร์หลักของ 1.0.0

• นี่เป็นรุ่นเสถียรครั้งแรกของ Compose สำหรับ Wear OS (อ่านเพิ่มเติม)
• Compose สำหรับ Wear OS สร้างขึ้นจากไลบรารีหลักของ Compose ซึ่งให้คอมโพเนนต์เพิ่มเติมสำหรับอุปกรณ์ที่สวมใส่ได้ และการใช้งานคอมโพเนนต์หลักของ Compose ทางเลือกที่ปรับให้เหมาะกับอุปกรณ์ที่สวมใส่ได้ตามความเหมาะสม
• ดูรายการคอมโพเนนต์หลักใน Wear Compose ได้ที่บันทึกประจำรุ่นของ (Compose สำหรับ Wear OS Beta01)

การแก้ไขข้อบกพร่อง

• เราได้ทำให้ขอบมืดเคลื่อนไหวเมื่อแสดง/ซ่อนกล่องโต้ตอบ เพื่อให้สอดคล้องกับภาพเคลื่อนไหวการปรับขนาดที่มีอยู่ (Ida33e)
• เราได้แก้ไขข้อบกพร่องที่อาจเกิดการหารด้วย 0 กับลักษณะการฟลิงบางอย่างเมื่อเลื่อน (I86cb6)
• แก้ไขข้อบกพร่องใน ChipDefaults.childChipColor() เพื่อให้สีพื้นหลังที่ปิดใช้มีความโปร่งแสงอย่างสมบูรณ์ (I2b3c3, b/238057342)

เวอร์ชัน 1.0.0-rc02

22 มิถุนายน 2022

androidx.wear.compose:compose-foundation:1.0.0-rc02, androidx.wear.compose:compose-material:1.0.0-rc02 และ androidx.wear.compose:compose-navigation:1.0.0-rc02 เผยแพร่แล้ว เวอร์ชัน 1.0.0-rc02 มีการคอมมิตเหล่านี้

การแก้ไขข้อบกพร่อง

• เราได้แก้ไขทิศทางของไล่ระดับสีสำหรับการ์ดในโหมดจากขวาไปซ้าย (RTL) แล้ว จากเดิมที่ด้านซ้ายบนไปด้านขวาล่าง ตอนนี้เปลี่ยนเป็นด้านขวาบนไปด้านซ้ายล่าง (Ic2e77)
• เราได้อัปเดตไล่ระดับสีเริ่มต้นของ Chip/ToggleChip/Card ให้สอดคล้องกับข้อกำหนด UX ล่าสุด เราได้อัปเดต ChipDefaults.gradientBackgroundChipColors ให้เริ่มต้นจาก 50% ของสีหลักแทน 32.5% CardDefaults.cardBackgroundPainter ได้รับการอัปเดตให้เริ่มต้นที่ 30% ของรายการหลักและสิ้นสุดที่ 20% ของ onSurfaceVariant (ก่อนหน้านี้คือ 20% ถึง 10% ใน onSurfaceVariant) ToggleChip.toggleChipColors เปลี่ยนจากการไล่ระดับสีแบบเส้นตรงจากพื้นผิว 75% เป็นสีหลัก 32.5% เป็นพื้นผิว 0% เป็นสีหลัก 50% (I43bbd)
• เราได้เพิ่มสีพื้นหลัง (MaterialTheme.color.surface) ไว้ด้านหลัง Chip/ToggleChips ที่มีพื้นหลังไล่ระดับ เพื่อให้แน่ใจว่าผู้ใช้จะเห็น 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 easing เมื่อรายการถึงขอบของหน้าจอเพื่อให้ตรงกับข้อมูลจำเพาะ 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 จาก "Start" เป็น CenterHorizontally เพื่อให้รายการในลิสต์จัดแนวเพื่อให้มองเห็นได้สูงสุดเมื่อรายการไม่เต็มความกว้างของคอลัมน์ หากต้องการเปลี่ยนกลับไปใช้ลักษณะการทำงานก่อนหน้า ให้ตั้งค่า horizontalAlignment = Alignment.Start (I9ed4b)

ปัญหาที่ทราบ

• ความสูงของการแตะ/สัมผัสของ CompactChip น้อยกว่าหลักเกณฑ์การช่วยเหลือพิเศษของ Material เราจะแก้ไขเรื่องนี้ในรุ่นถัดไป (15 มิถุนายน) หากคุณใช้ CompactChip การเปลี่ยนแปลงนี้จะส่งผลต่อเลย์เอาต์ เนื่องจากตอนนี้ CompactChip จะมีระยะห่างจากขอบด้านบนและด้านล่างเพิ่มขึ้น โปรดปรับและทดสอบเลย์เอาต์หรือดูความคิดเห็นเกี่ยวกับข้อบกพร่องเพื่อหาวิธีแก้ปัญหาชั่วคราวในการใช้ลักษณะการทำงานที่มีอยู่ (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 ได้รับการล็อกแล้ว

คอมโพเนนต์ของ Wear Compose Material ในรุ่น 1.0 มีดังนี้

• ธีม Material - ใช้แทน Compose สำหรับอุปกรณ์เคลื่อนที่ MaterialTheme โดยให้สี รูปร่าง และแบบอักษรสำหรับการสร้างคอมโพเนนต์ในอุปกรณ์ที่สวมใส่ได้ ซึ่งใช้หลักเกณฑ์ UX ของ Material Design ใน Wear โดยตรง
• Button, CompactButton และ ToggleButton - ปุ่มมีช่องเดียวสำหรับใส่ไอคอน รูปภาพ หรือข้อความสั้นๆ (สูงสุด 3 อักขระ) เป็นรูปวงกลมที่มีขนาดที่แนะนำสำหรับปุ่มเริ่มต้น ปุ่มขนาดใหญ่ หรือปุ่มขนาดเล็ก CompactButton มีช่องเดียวสำหรับใส่เนื้อหา (ไอคอน รูปภาพ หรือข้อความ) และมีรูปร่างเป็นวงกลมโดยพื้นหลังมีขนาดพิเศษเล็ก CompactButton มีระยะห่างจากขอบที่โปร่งใสรอบพื้นหลังซึ่งจะเพิ่มพื้นที่ที่คลิกได้ (ไม่บังคับ) ToggleButton คือปุ่มที่มีช่องเดียวสำหรับใส่เนื้อหา (ข้อความสั้นๆ ไอคอน หรือรูปภาพ) และมีสถานะเปิด/ปิด (เลือก/ยกเลิกการเลือก) ที่มีสีและไอคอนต่างๆ เพื่อแสดงว่าเลือกหรือไม่เลือก
• การ์ด - ใช้แสดงข้อมูลเกี่ยวกับแอปพลิเคชัน เช่น การแจ้งเตือน การออกแบบที่ยืดหยุ่นสำหรับกรณีการใช้งานที่แตกต่างกันด้วย AppCard และ TitleCard ซึ่งให้เลย์เอาต์ที่แตกต่างกันและรองรับรูปภาพเป็นเนื้อหาหรือพื้นหลังของการ์ด
• ชิป - คอมโพเนนต์รูปทรงสนามกีฬาคล้ายกับปุ่ม แต่มีพื้นที่ขนาดใหญ่ขึ้นและมีช่องหลายช่องเพื่อให้ใส่ป้ายกำกับ ป้ายกำกับรอง และไอคอนได้ มีขนาดต่างๆ และรองรับการใช้รูปภาพเป็นพื้นหลัง
• ToggleChips และ SplitToggleChips - ชิปที่มีสถานะเลือก/ไม่ได้เลือก และการเพิ่มช่อง ToggleControl เพื่อแสดงไอคอน เช่น สวิตช์หรือปุ่มตัวเลือกเพื่อแสดงสถานะเลือกของคอมโพเนนต์ นอกจากนี้ SplitToggleChip ยังมีพื้นที่ที่แตะได้ 2 พื้นที่ ได้แก่ พื้นที่ที่คลิกได้ 1 พื้นที่และพื้นที่สลับได้ 1 พื้นที่
• CircularProgressIndicator - สัญญาณบอกสถานะความคืบหน้าแบบวงกลมของ Material Design ที่มี 2 รูปแบบ ค่าแรกแสดงสัดส่วนความคืบหน้าของงานที่ดําเนินอยู่และรองรับช่องว่างในแทร็กวงกลมระหว่างมุมเริ่มต้นและมุมสิ้นสุด ส่วนสถานะที่สองบ่งบอกถึงความคืบหน้าที่ไม่แน่นอนสำหรับเวลารอที่ไม่ระบุ
• curvedText - เป็นส่วนหนึ่งของ DSL สําหรับอธิบาย CurvedLayouts พร้อมกับ curvedRow และ curvedColumn เพื่อวางองค์ประกอบรอบอุปกรณ์ทรงกลม ดูรายละเอียดเพิ่มเติมเกี่ยวกับ CurvedLayout และ CurvedModifier ได้ที่ Wear Component Foundation ด้านล่าง (ส่วนนี้ทำหน้าที่คล้ายกับตัวแก้ไขในอุปกรณ์ที่ไม่ใช่หน้าจอโค้ง และช่วยให้คุณกำหนดค่าแง่มุมต่างๆ ของเลย์เอาต์ ระยะห่างจากขอบ ไล่ระดับสี ฯลฯ ได้)
• กล่องโต้ตอบ การแจ้งเตือน และการยืนยัน - กล่องโต้ตอบจะแสดงกล่องโต้ตอบแบบเต็มหน้าจอที่วางซ้อนทับเนื้อหาอื่นๆ และรองรับการปัดเพื่อปิด ช่องนี้ใช้ช่องเดียวซึ่งคาดว่าจะเป็นเนื้อหากล่องโต้ตอบแบบมีความคิดเห็นของ Material Design ใน Wear เช่น การแจ้งเตือนหรือการยืนยัน การแจ้งเตือนคือเนื้อหากล่องโต้ตอบที่มีความคิดเห็นพร้อมช่องสำหรับไอคอน ชื่อ และข้อความ โดยจะมีปุ่มลบและบวก 2 ปุ่มแสดงคู่กัน หรือมีช่องสำหรับชิปที่ซ้อนกันแนวตั้งอย่างน้อย 1 ช่อง การยืนยันคือเนื้อหากล่องโต้ตอบที่มีความคิดเห็นซึ่งแสดงข้อความเป็นระยะเวลาหนึ่ง โดยจะมีช่องสำหรับไอคอนหรือรูปภาพ (ที่อาจเป็นภาพเคลื่อนไหว)
• HorizontalPageIndicator - แสดงตําแหน่งหน้าแนวนอนในลักษณะที่เหมาะกับรูปแบบของอุปกรณ์ที่สวมใส่ได้ ออกแบบมาเพื่อแสดงเต็มหน้าจอและแสดงตัวบ่งชี้แบบโค้งบนอุปกรณ์ทรงกลม ใช้ได้กับโปรแกรมดูหน้าสำหรับ Accompanist
• ไอคอน - การใช้งานไอคอนใน Wear ซึ่งใช้สีและค่าอัลฟาจากธีม Material ของ Wear สำหรับไอคอนที่คลิกได้ โปรดดูปุ่มหรือชิป
• เครื่องมือเลือก - แสดงรายการรายการแบบเลื่อนเพื่อเลือก โดยค่าเริ่มต้น ระบบจะแสดงรายการซ้ำ "แบบไม่จำกัด" ทั้งใน 2 ทิศทาง แสดงในโหมดอ่านอย่างเดียวเพื่อซ่อนตัวเลือกที่ไม่ได้เลือก
• PositionIndicator - แสดงตำแหน่งการเลื่อนหรือตัวบ่งชี้ตำแหน่งอื่นๆ ในลักษณะที่เหมาะกับรูปแบบของอุปกรณ์ที่สวมใส่ได้ ออกแบบมาเพื่อใช้เต็มหน้าจอและแสดงตัวบ่งชี้แบบโค้งบนอุปกรณ์ทรงกลม
• Scaffold - ใช้โครงสร้างเลย์เอาต์ภาพพื้นฐานของ Material Design ใน Wear คอมโพเนนต์นี้มี API สำหรับรวมคอมโพเนนต์ Wear Material หลายรายการ (เช่น TimeText, PositionIndicator และ Vignette) เข้าด้วยกันเพื่อสร้างหน้าจอ ตรวจสอบว่าใช้กลยุทธ์เลย์เอาต์ที่เหมาะสมกับคอมโพเนนต์เหล่านั้น และรวบรวมข้อมูลที่จำเป็นเพื่อให้คอมโพเนนต์เหล่านี้ทำงานร่วมกันได้อย่างถูกต้อง
• ScalingLazyColumn - คอมโพเนนต์รายการแบบเลื่อน/ฟิชอายที่ปรับขนาดได้ ซึ่งถือเป็นส่วนสำคัญของภาษา Material Design ของ Wear แสดงเอฟเฟกต์การปรับขนาดและความโปร่งใสให้กับรายการเนื้อหา ScalingLazyColumn ออกแบบมาเพื่อจัดการรายการเนื้อหาจำนวนมากที่อาจเกิดขึ้น ซึ่งจะแสดงและคอมโพสเมื่อจำเป็นเท่านั้น
• แถบเลื่อน - ช่วยให้ผู้ใช้เลือกจากช่วงค่าได้ ช่วงของตัวเลือกจะแสดงเป็นแถบ ซึ่งจะแสดงร่วมกับตัวคั่นได้
• ตัวควบคุมแบบเป็นขั้นๆ - คอมโพเนนต์แบบเต็มหน้าจอที่ช่วยให้ผู้ใช้เลือกจากช่วงค่าต่างๆ ได้โดยใช้ปุ่มเพิ่ม/ลดที่ด้านบนและด้านล่างของหน้าจอ โดยมีช่องตรงกลางสำหรับข้อความหรือชิป
• SwipeToDismissBox - จัดการท่าทางสัมผัสด้วยการปัดเพื่อปิด โดยจะใช้สล็อตเดียวสำหรับพื้นหลัง (แสดงเฉพาะระหว่างการใช้ท่าทางสัมผัสการปัด) และเนื้อหาเบื้องหน้า สามารถใช้ร่วมกับไลบรารีการนำทาง androidx ได้โดยการใช้ SwipeDismissableNavHost (ดูไลบรารีการนำทางของ Wear Compose ด้านล่าง)
• ข้อความ - การใช้งานคอมโพเนนต์ข้อความ Material ของ Compose ใน Wear ซึ่งนำสีและค่าอัลฟ่ามาจากธีม Material ของ Wear
• TimeText - คอมโพเนนต์สำหรับแสดงเวลาและสถานะการสมัครที่ด้านบนของหน้าจอ ปรับให้เข้ากับรูปร่างของหน้าจอโดยใช้ข้อความโค้งบนหน้าจอกลม

• การแสดงผลแบบ Vignette - การจัดการหน้าจอสําหรับใช้ใน Scaffold ซึ่งเบลอด้านบนและด้านล่างของหน้าจอเมื่อมีการใช้เนื้อหาที่เลื่อนได้

• นอกจากนี้ ยังมีคอมโพเนนต์ต่อไปนี้จาก Wear Compose Foundation ด้วย

• CurvedLayout - Wear Foundation CurvedLayout เป็นคอมโพสิชันเลย์เอาต์ที่วางองค์ประกอบย่อยเป็นเส้นโค้ง โดยหมุนองค์ประกอบย่อยตามต้องการ ซึ่งคล้ายกับเลย์เอาต์แถวที่โค้งเป็นส่วนของวงแหวน โปรดทราบว่าเนื้อหาของ CurvedLayout ไม่ใช่ Lambda แบบคอมโพสิเบิล แต่เป็น DSL (ภาษาเฉพาะโดเมน) องค์ประกอบทั้งหมดใน DSL ของ CurvedLayout รองรับพารามิเตอร์ตัวแก้ไขที่ไม่บังคับซึ่งสร้างจาก CurvedModifier

• basicCurvedText - องค์ประกอบใน CurvedLayout DSL, basicCurvedText ช่วยให้นักพัฒนาแอปเขียนข้อความโค้งตามเส้นโค้งของวงกลมได้อย่างง่ายดาย (โดยปกติอยู่ที่ขอบของหน้าจอทรงกลม) basicCurvedText สร้างขึ้นได้ภายใน CurvedLayout เท่านั้นเพื่อให้ได้รับประสบการณ์การใช้งานที่ดีที่สุด เช่น ระบุตําแหน่งและใช้ CurvedModifiers ได้ โปรดทราบว่าในกรณีส่วนใหญ่ คุณควรใช้ curvedText แทน เนื่องจากใช้ธีม Material

• curvedComposable - ตัดเนื้อหาที่คอมโพสิเบิลแบบปกติเพื่อให้ใช้กับ CurvedLayout ได้ หาก curvedComposable มีองค์ประกอบหลายรายการอยู่ภายใน ระบบจะวาดองค์ประกอบเหล่านั้นซ้อนกัน (เช่น กล่อง) หากต้องการวางคอมโพสิเบิลหลายรายการตามแนวโค้ง ให้ใส่ curvedComposable ไว้รอบคอมโพสิเบิลแต่ละรายการ

• curvedRow และ curvedColumn - คล้ายกับแถวและคอลัมน์ โดย curvedRow และ curvedColumn สามารถฝังภายใน CurvedLayout เพื่อวางองค์ประกอบตามต้องการ สำหรับ curvedRow คุณสามารถระบุทิศทางของเลย์เอาต์เชิงมุมและการจัดแนวตามแนวรัศมี สําหรับ curvedColumn คุณสามารถระบุการจัดแนวเชิงมุมและทิศทางรัศมี

• CurvedModifier - คอมโพเนนต์โค้งทั้งหมดยอมรับพารามิเตอร์ตัวแก้ไขที่สร้างได้โดยใช้ CurvedModifier: รองรับพื้นหลัง ขนาด น้ำหนัก และระยะห่างจากขอบ

• คอมโพเนนต์ต่อไปนี้ยังรวมอยู่ในการนําทางของ Wear Compose ด้วย

• SwipeDismissableNavHost - ระบุตำแหน่งในลําดับชั้นของ Compose เพื่อให้เกิดการนําทางแบบสําเร็จรูป โดยมีการนำทางย้อนกลับซึ่งดำเนินการโดยท่าทางสัมผัสการปัด เนื้อหาจะแสดงภายใน SwipeToDismissBox ซึ่งแสดงระดับการนําทางปัจจุบัน ในระหว่างการใช้ท่าทางสัมผัสเพื่อปิด ระดับการนําทางก่อนหน้า (หากมี) จะแสดงอยู่เบื้องหลัง

• ดูรายละเอียดเพิ่มเติมเกี่ยวกับสิ่งที่ได้ส่งไปแล้วได้ในบันทึกประจำรุ่นก่อนหน้าของรุ่นอัลฟ่าต่างๆ

การเปลี่ยนแปลง API

• เพิ่มฟังก์ชัน CurvedModifier.padding* ใช้เพื่อระบุพื้นที่เพิ่มเติมที่จะเพิ่มรอบๆ คอมโพเนนต์โค้ง (I4dbb4)
• นําคลาสภายใน CompositionLocal ออก (I42490)
• เราได้เพิ่มค่าคงที่สำหรับขนาดไอคอน Button, CompactButton และ ToggleButton เพื่อเป็นแนวทาง (I57cab)
• เพิ่มพารามิเตอร์ที่เปิดใช้ใน AppCard และ TitleCard ตอนนี้การ์ดมี API ที่คล้ายกับการ์ด androidx.compose.material เมื่อตั้งค่าพารามิเตอร์เป็น "เท็จ" การ์ดจะคลิกไม่ได้ (Idc48d, b/228869805)

การแก้ไขข้อบกพร่อง

• ตอนนี้ตัวควบคุมจำนวนจะปิดใช้ปุ่มลดและเพิ่มเมื่อถึงขีดจำกัดล่าง/บนแล้ว (และใช้ 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 ซึ่งคล้ายกับตัวแก้ไขในเครื่องมือเขียน ซึ่งสามารถใช้กับรายการย่อยของ curvedRow และ CurvedLayout (สำหรับความกว้าง) และรายการย่อยของ curvedColumn (สำหรับความสูง) (I8abbd)
• เพิ่มตัวแก้ไข CurvedModifier.size, .angularSize และ .radialSize เพื่อระบุขนาดขององค์ประกอบโค้ง (I623c7)

การเปลี่ยนแปลง API

• จัดเรียงพารามิเตอร์ใหม่เพื่อให้พื้นหลังอยู่ก่อนสีอย่างสอดคล้องกันใน Wear Compose API (I43208)
• นําพารามิเตอร์ clockwise และ insideOut ออกและแทนที่ด้วยค่าคงที่ที่สื่อความหมายมากขึ้นในคลาสใหม่ ตอนนี้ LayoutDirection รับรู้ทิศทางของเลย์เอาต์แบบโค้งได้แล้ว และจะรับค่านี้มาโดยค่าเริ่มต้นหากไม่ได้ระบุ (If0e6a)
• เราได้แทนที่ autoCenter: Boolean ด้วย autoCenter: AutoCentringParams เพื่อแก้ไขปัญหา API เกี่ยวกับ ScalingLazyColumn (Ia9c90)
• เราได้เปลี่ยนชื่อ iconTintColor และ toggleControlTintColor เป็น iconColor และ toggleControlColor ใน API ทั้งหมด (ชิป/ชิปเปิด/ปิด/กล่องโต้ตอบ/แถบเลื่อน/ตัวควบคุมขั้นตอน/...) เนื่องจากมีการใช้สีกับช่องไอคอน/toggleControl (Ied238)
• เขียน enum PageIndicatorStyle ใหม่เป็นคลาสค่า (I2dc72)
• เราได้เพิ่ม RowScope/ColumnScope/BoxScope ลงในช่องบางช่องใน Composable เพื่อแจ้งให้นักพัฒนาซอฟต์แวร์ทราบถึงข้อสันนิษฐ์ของเลย์เอาต์ ซึ่งจะช่วยให้นักพัฒนาแอปใช้ตัวแก้ไขเพิ่มเติมในเนื้อหาของบางช่องได้โดยไม่ต้องระบุองค์ประกอบเลย์เอาต์เพิ่มเติม นอกจากนี้ เราได้ทำการอัปเดตเล็กน้อยกับสีของ AppCard/TitleCard เพื่อให้ timeColor และ appColor เป็น contentColor โดยค่าเริ่มต้น แต่คุณยังคงลบล้างแต่ละพร็อพเพอร์ตี้เหล่านี้แยกกันได้หากต้องการ (I26b59)
• ทําออบเจ็กต์ SwipeToDismissBoxState.Companion เป็นส่วนตัว (I39e84)
• แก้ไขลําดับพารามิเตอร์สําหรับ InlineSlider และ Stepper การเปลี่ยนแปลงง่ายๆ เพื่อปฏิบัติตามหลักเกณฑ์ API (I11fec)
• เราได้นําออบเจ็กต์ Saver ของ SwipeToDismissBoxState ออกแล้วเนื่องจากไม่มีการใช้งาน (Ifb54e)
• เราได้อัปเดต CompactChip เพื่อให้สอดคล้องกับข้อกำหนดเฉพาะ UX ฉบับล่าสุด ระยะห่างจากขอบลดลงเป็นแนวนอน = 12.dp และแนวตั้ง = 0.dp เปลี่ยนแบบอักษรของป้ายกำกับจาก button เป็น caption1 แล้ว ขนาดไอคอนที่แนะนำคือ 20x20 เมื่อมีทั้งไอคอนและป้ายกำกับ และ 24x24 สำหรับชิปคอมแพคที่มีเฉพาะไอคอน สำหรับกรณีการใช้งานเฉพาะไอคอน เราได้ตรวจสอบว่าไอคอนนั้นจัดแนวตรงกลางแล้ว (Iea2be)
• เราได้เพิ่มช่องใหม่หลายช่องลงใน ScalingLazyListLayoutInfo เพื่อให้นักพัฒนาแอปทราบจํานวน contentPadding และ autoCenteringPadding ที่ใช้ ซึ่งจะเป็นประโยชน์สำหรับนักพัฒนาแอปเมื่อคำนวณการปัด/การเลื่อน (I7577b)
• เราได้ติดตั้งใช้งานทรานซิชันอิน/เอาต์สําหรับกล่องโต้ตอบแล้ว เพิ่มพารามิเตอร์ showDialog แล้ว ตอนนี้กล่องโต้ตอบจะควบคุมการแสดงผลของตัวเอง (ซึ่งช่วยให้กล่องโต้ตอบแสดงภาพเคลื่อนไหวช่วงอินโทรและเอาต์โทรได้เมื่อแสดง/ซ่อนกล่องโต้ตอบ) โปรดทราบว่าระบบจะไม่แสดงภาพเคลื่อนไหวตอนจบเมื่อผู้ใช้ออกจากกล่องโต้ตอบด้วยการปัดเพื่อปิด นอกจากนี้ เรายังได้เพิ่มค่าเริ่มต้นสำหรับสถานะใน SwipeToDismissBox overload ที่เพิ่มเข้ามาใหม่ (I682a0)
• เราได้เปลี่ยน ToggleChip และ SplitToggleChip เพื่อรองรับ i18n และ a11y ได้ดียิ่งขึ้น โดยจะไม่มีค่าเริ่มต้นสำหรับช่อง toggleControl อีกต่อไป นอกจากนี้ เรายังได้เปลี่ยน ToggleChipDefaults เพื่อให้เมธอดต่อไปนี้แสดงผล ImageVector แทน Icon (โปรดทราบว่าเมธอดเหล่านี้เปลี่ยนรูปแบบเป็นอักษรตัวพิมพ์เล็กเนื่องจากไม่ได้แสดงผล @Composable อีกต่อไป) 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 ลงใน Scaffold การเพิ่ม PageIndicator ลงใน Scaffold โดยตรงอาจช่วยให้มั่นใจได้ว่า PageIndicator จะแสดงในอุปกรณ์ทรงกลมได้อย่างถูกต้อง (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 (ข้อความโค้งของ Foundation) และ curvedText (ข้อความโค้งที่รองรับวัสดุของ Wear) (Ib776a)
• ทำให้ฝั่งสำหรับ PositionIndicator กำหนดค่าได้ ตอนนี้คุณกําหนดค่าตําแหน่งของ PositionIndicator พื้นฐานเป็น End (คำนึงถึงทิศทางเลย์เอาต์), OppositeRsb (พิจารณาการหมุนหน้าจอเพื่อวางตําแหน่งตรงข้ามกับ RSB จริง) หรือซ้ายและขวาแบบสัมบูรณ์ได้แล้ว (I2f1f3)
• สำหรับ SwipeToDismissBox เราได้เปลี่ยนชื่อ SwipeDismissTarget.Original เป็น SwipeToDismissValue.Default และ SwipeDismissTarget.Dismissal เป็น SwipeToDismissValue.Dismissed นอกจากนี้ เรายังได้ย้าย SwipeToDismissBoxDefaults.BackgroundKey และ SwipeToDismissBoxDefaults.ContentKey ไปไว้ที่ SwipeToDismissKeys.Background และ SwipeToDismissKeys.Content ตามลำดับ (I47a36)
• เราได้เพิ่มโหมดอ่านอย่างเดียวลงในเครื่องมือเลือกสำหรับหน้าจอที่มีเครื่องมือเลือกหลายรายการซึ่งแก้ไขได้ทีละรายการ เมื่อเครื่องมือเลือกเป็นแบบอ่านอย่างเดียว เครื่องมือจะแสดงตัวเลือกที่เลือกอยู่ในปัจจุบันและป้ายกำกับ (หากมี) (I879de)
• SwipeToDismissBoxState ได้รับการรีแฟกทอริงเพื่อจำกัดขอบเขตของ ExperimentalWearMaterialApi ไว้ที่ Modifier.swipeable และ SwipeableState ซึ่งตอนนี้ใช้ภายในแล้ว ตอนนี้ SwipeToDismissBoxState มีสมาชิก currentValue, targetValue, isAnimationRunning และ snapTo เพื่อรองรับกรณีการใช้งานทั่วไปแล้ว โปรดแจ้งให้เราทราบหากต้องการเพิ่มพร็อพเพอร์ตี้อื่นๆ และแก้ไขลักษณะการทำงานของ SwipeableState ในกรณีที่ระยะปัดอยู่ภายในข้อผิดพลาดในการปัดเศษของจุดยึด (I58302)

การแก้ไขข้อบกพร่อง

• โค้ดที่แก้ไขและเรียบง่ายขึ้นเพื่อตรวจหาว่าเนื้อหาของ ScalingLazyColumn เลื่อนได้หรือไม่ (ใช้เพื่อตัดสินใจว่าจะแสดงแถบเลื่อนหรือไม่) (I7bce0)
• แก้ไขข้อบกพร่องในตัวบ่งชี้ตำแหน่งเมื่อใช้กับสถานะมากกว่า 1 สถานะและสลับระหว่างสถานะต่างๆ (I320b5)
• เราได้อัปเดตแบบอักษร/แบบตัวพิมพ์ของธีม Compose สำหรับ Wear OS เริ่มต้นให้สอดคล้องกับหลักเกณฑ์ UX ล่าสุด โปรดทราบว่าตอนนี้ display1 (40.sp) และ display2 (34.sp) มีขนาดเล็กกว่าค่าก่อนหน้า และมีการอัปเดตเล็กน้อยอื่นๆ อีกหลายรายการเกี่ยวกับความสูงของบรรทัดและการเว้นวรรคบรรทัด (Ie3077)
• เราได้เพิ่มการต้านทานให้กับ SwipeToDismissBox เพื่อให้การเคลื่อนไหวเกิดขึ้นเมื่อปัดเพื่อปิดเท่านั้น และจะไม่เกิดการเคลื่อนไหวในทิศทางตรงข้ามเลย (Ifdfb9)
• เราได้เปลี่ยนค่าพารามิเตอร์เริ่มต้นบางค่าสำหรับฟังก์ชัน CircularProgressIndicator เพื่อให้สอดคล้องกับคำแนะนำ UX ของ Material Design ใน Wear สำหรับเวอร์ชัน Spinner/Indeterminant เราได้อัปเดตขนาด (40->24.dp), indicatorColor (primary->onBackground), ความโปร่งใสของ trackColor (30%->10%) และความกว้างของเส้น (4->3dp) แล้ว สำหรับเวอร์ชันความคืบหน้า/กำหนดได้ เราได้อัปเดตความโปร่งใสของ trackColor (30%->10%) แล้ว (I659cc)
• เราได้อัปเดตพารามิเตอร์การปรับขนาดเริ่มต้นของ ScalingLazyColumn ให้สอดคล้องกับข้อกำหนด UX ของ Material Design ใน Wear เวอร์ชันล่าสุด ในแง่ภาพ การดำเนินการนี้จะส่งผลให้รายการในลิสต์เริ่มปรับขนาดให้ใกล้กับตรงกลางของลิสต์มากขึ้น แต่ปรับขนาดที่ขอบของลิสต์ให้เล็กลงกว่าก่อนหน้านี้ (Ica8f3)
• การปรับ ScalingLazyColumnDefaults.snapFlingBehavior บางอย่างเพื่อปรับปรุงช่วงท้ายของภาพเคลื่อนไหว (If3260)

เวอร์ชัน 1.0.0-alpha18

9 มีนาคม 2022

androidx.wear.compose:compose-foundation:1.0.0-alpha18, androidx.wear.compose:compose-material:1.0.0-alpha18 และ androidx.wear.compose:compose-navigation:1.0.0-alpha18 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha18 มีการคอมมิตเหล่านี้

การเปลี่ยนแปลง API

• การปรับปรุง PositionIndicator หลายรายการ: เปลี่ยนชื่อ ShowResult เป็น PositionIndicatorVisibility การปรับปรุงประสิทธิภาพบางอย่างเพื่อหลีกเลี่ยงการคํานวณซ้ำเมื่อไม่จําเป็น (Iaed9d)
• อัปเดตการระบายสีที่แนะนำสำหรับ SplitToggleChip แล้ว ตอนนี้ SplitToggleChip มีพื้นหลังสีทึบเมื่อเลือกหรือยกเลิกการเลือก โดยสีของ ToggleControl จะเป็นตัวบ่งชี้หลักว่าคอมโพเนนต์ดังกล่าวเลือกไว้หรือไม่ เราได้เพิ่ม ToggleDefaults.splitToggleChipColors() ใหม่เพื่อรองรับรูปแบบสีใหม่ นอกจากนี้ เรายังลดความซับซ้อนของเมธอด toggleChipColors() โดยการนํา splitBackgroundOverlayColor (I7e66e) ออก
• เราได้เพิ่ม unadjustedSize ลงใน ScalingLazyListItemInfo เนื่องจากการคำนวณขนาดสินค้าเดิมโดยใช้ขนาดที่ปรับขนาดและปัจจัยการปรับขนาดนั้นไม่ปลอดภัยเนื่องจากความแม่นยำของคณิตศาสตร์แบบลอย (I54657, b/221079441)
• เพิ่ม HorizontalPageIndicator ซึ่งแสดงจํานวนหน้าทั้งหมดและหน้าเว็บที่เลือก อาจเป็นแบบเส้นตรงหรือโค้ง ขึ้นอยู่กับรูปร่างของอุปกรณ์ และยังรองรับรูปร่างของตัวบ่งชี้ที่กำหนดเอง ซึ่งจะกำหนดลักษณะการแสดงผลของตัวบ่งชี้แต่ละรายการ (Iac898)
• เราได้อัปเดต PickerState เพื่อให้อัปเดต numberOfOptions ได้ ซึ่งรองรับกรณีการใช้งาน เช่น DatePicker เมื่อจำนวนวันในหนึ่งเดือนเปลี่ยนแปลงตามเดือนที่เลือก พารามิเตอร์คอนสตรัคเตอร์สำหรับ PickerState ได้เปลี่ยนเป็น initialNumberOfOptions ตามลำดับ (Iad066)
• ซ่อน PositionIndicator เมื่อเป็นแถบเลื่อนและเลื่อนไม่ได้ (Id0a7f)
• ตอนนี้คอมโพเนนต์กล่องโต้ตอบแบบเต็มหน้าจอจะแสดง PositionIndicator และ Vignette เพื่อให้สอดคล้องกับ Scaffold นอกจากนี้ เรายังใช้ ScalingLazyColumn แทน Column ซึ่งหมายความว่าตอนนี้เนื้อหาของกล่องโต้ตอบจะอยู่ใน ScalingLazyListScope (และโดยปกติจะต้องอยู่ในรายการ { /* content */ }) กล่องโต้ตอบรองรับพารามิเตอร์ verticalArrangement ตามความเหมาะสม (Idea13)
• เราได้เปลี่ยนชื่อพร็อพเพอร์ตี้ toggleIcon ของ ToggleChip และ SplitToggleChip เป็น toggleControl เพื่อให้สอดคล้องกับ Material Design มากขึ้น เพื่อช่วยนักออกแบบและนักพัฒนาซอฟต์แวร์ในการไปยังส่วนต่างๆ ของ API (If5921, b/220129803)
• เราได้เพิ่มรายการ caption3 ใหม่ลงในการจัดประเภทธีมวัสดุของ Wear โดย caption3 คือแบบอักษรขนาดเล็กที่ใช้สำหรับข้อความแบบยาวพิเศษ เช่น ข้อความทางกฎหมาย (I74b13, b/220128356)

การแก้ไขข้อบกพร่อง

• หยุดภาพเคลื่อนไหวการจับคู่เมื่อเราไปถึงจุดหมาย (Idb69d)
• สร้างภาพเคลื่อนไหวการเปลี่ยนแปลงใน PositionIndicator (I94cb9)
• จากความคิดเห็นเกี่ยวกับ UI/UX เราได้เปลี่ยนการ ScalingLazyColumn การจัดกึ่งกลางอัตโนมัติเพื่อให้มีพื้นที่เพียงพอที่จะเลื่อนรายการที่มีดัชนี ScalingLazyListState.initialCenterItemIndex ขึ้นไปไปยังตรงกลางของวิวพอร์ตได้ วิธีนี้ช่วยให้นักพัฒนาแอปวางรายการเกี่ยวกับรายการหนึ่งๆ ได้ 1-2 รายการไว้ตรงกลางตั้งแต่แรก ซึ่งจะเลื่อนไปไว้ตรงกลางไม่ได้ ซึ่งหมายความว่า ScalingLazyColumn ที่ปรับให้อยู่ตรงกลางอัตโนมัติจะเลื่อนอยู่เหนือ initialCenterItemIndex/initialCenterItemScrollOffset ไม่ได้ (I22ee2)
• เราได้เพิ่มการสาธิตสำหรับเครื่องมือเลือกวันที่และแก้ไขข้อบกพร่องใน PickerState ซึ่งระบบไม่ได้ใช้ initiallySelectedOption จนกว่าเครื่องมือเลือกจะแสดง (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) เพื่อเปิดใช้การรองรับการจับคู่ (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)

การแก้ไขข้อบกพร่อง

• เราได้เปลี่ยน initialCenterItemIndex เริ่มต้นของ ScalingLazyListState จาก 0->1 ซึ่งหมายความว่าระบบจะวางรายการที่ 2 (index == 1) ไว้ตรงกลางวิวพอร์ตเมื่อเริ่มต้น และวางรายการที่ 1 (index == 0) ไว้ก่อนหน้านั้น เว้นแต่จะมีการลบล้างการสร้างสถานะด้วย ScalingLazyListState.rememberScalingLazyListState(initialCenterItemIndex =) วิธีนี้ช่วยให้เอฟเฟกต์ภาพเริ่มต้นดีขึ้นโดยอัตโนมัติ เนื่องจากวิวพอร์ตส่วนใหญ่จะเต็มไปด้วยรายการในรายการ (I0c623, b/217344252)
• เราได้ลด ScalingLazyColumn เริ่มต้น extraPadding ที่ระบุไว้เพื่อให้มีรายการในรายการจำนวนมากพอที่จะวาด (แม้ว่าเราจะปรับขนาดรายการบางรายการให้เล็กลง) จาก 10% เป็น 5% วิธีนี้จะช่วยหลีกเลี่ยงการคอมโพสิทรายการในลิสต์เพิ่มเติมที่อาจไม่ปรากฏในวิวพอร์ต หากมีการใช้ scalingParams ที่ไม่เป็นไปตามมาตรฐาน (เช่น การขยายขนาดที่รุนแรงมากขึ้น) นักพัฒนาแอปสามารถปรับการเว้นวรรคเพิ่มเติมได้โดยใช้ viewportVerticalOffsetResolver (I76be4)
• แก้ไขปัญหาเกี่ยวกับ TimeText หลายบรรทัดในอุปกรณ์สี่เหลี่ยมจัตุรัส (Ibd3fb)
• เราได้แก้ไข ScalingLazyColumn เพื่อไม่ให้กินพื้นที่ทั้งหมดในองค์ประกอบหลักอีกต่อไป แต่จะใช้ขนาดจากขนาดของเนื้อหาแทน ซึ่งสอดคล้องกับลักษณะการทํางานของ LazyColumn หากต้องการคืนค่าลักษณะการทำงานแบบเก่า ให้ส่ง Modifier.fillMaxSize() ไปยัง ScalingLazyColumn - หมายเหตุ: การเปลี่ยนแปลงนี้ยังไม่สมบูรณ์และจะได้รับการแก้ไขในการเปลี่ยนแปลงติดตามผลในรุ่นอัลฟ่ารุ่นถัดไป (I3cbfa)

เวอร์ชัน 1.0.0-alpha15

26 มกราคม 2022

androidx.wear.compose:compose-foundation:1.0.0-alpha15, androidx.wear.compose:compose-material:1.0.0-alpha15 และ androidx.wear.compose:compose-navigation:1.0.0-alpha15 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha15 มีการคอมมิตเหล่านี้

การเปลี่ยนแปลง API

• เราได้เพิ่มพร็อพเพอร์ตี้ใหม่ autoCentering ลงใน ScalingLazyColumn แล้ว เมื่อเป็น "จริง" (ค่าเริ่มต้น) ตัวเลือกนี้จะตรวจสอบว่ารายการทั้งหมด รวมถึงรายการแรกและรายการสุดท้ายจะเลื่อนได้เพื่อให้ปรากฏตรงกลางวิวพอร์ตของรายการ โปรดทราบว่าหากใช้การกึ่งกลางอัตโนมัติ คุณอาจต้องตั้งค่าระยะห่างจากขอบของเนื้อหาแนวตั้งเป็น 0.dp หากระบุทั้งการกึ่งกลางอัตโนมัติและการเว้นวรรคเนื้อหาแนวตั้ง ทั้งสองอย่างจะทำให้มีพื้นที่เพิ่มเติมก่อนรายการแรกและหลังรายการสุดท้ายของรายการ ซึ่งช่วยให้เลื่อนรายการได้มากขึ้น (I2a282, b/214922490)
• เราได้เพิ่มคอมโพเนนต์ Dialog ซึ่งช่วยให้คอมโพสิเบิลใดก็ตามทริกเกอร์กล่องโต้ตอบแบบเต็มหน้าจอที่วางอยู่ด้านบนของเนื้อหาอื่นๆ ได้ เมื่อแสดง กล่องโต้ตอบจะรองรับการปัดเพื่อปิด และจะแสดงเนื้อหาของรายการหลักในเบื้องหลังระหว่างการใช้ท่าทางปัด เนื้อหาของกล่องโต้ตอบควรเป็น Alert หรือ Confirmation (เปลี่ยนชื่อจากคอมโพเนนต์ AlertDialog และ ConfirmationDialog ก่อนหน้านี้) โดย Alert, Confirmation และ Dialog ทั้งหมดอยู่ในแพ็กเกจ androidx.wear.compose.material.dialog การแจ้งเตือนและการยืนยันสามารถใช้เป็นปลายทางการนำทางได้ นอกจากนี้ ยังเพิ่ม ColumnScope ลงในพารามิเตอร์การแจ้งเตือนและการยืนยันตามความจำเป็น (Ia9014)
• เราได้นํา onSurfaceVariant2 ออกจากสีธีม Material ของ Compose สำหรับ 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 จะเพิ่มปลายทางลงในลําดับชั้นการเขียนก่อนที่จะถึงสถานะวงจร CREATED ซึ่งส่งผลให้เกิด IllegalStateException การแก้ไขนี้เป็นข้อกําหนดเบื้องต้นในการอัปเดตการพึ่งพา navigation-compose เป็น 2.4.0-beta02 และเวอร์ชันที่ใหม่กว่า (I40a2b, b/207328687)

• เพิ่มคลาส Drawables enum สำหรับรับทรัพยากร Drawable ภายในไลบรารี 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)

• เราได้เพิ่มคอมโพสิชันใหม่ 2 รายการสำหรับแสดงกล่องโต้ตอบ ดังนี้ AlertDialog จะรอการตอบกลับจากผู้ใช้และแสดงชื่อ ไอคอน ข้อความ และ 1) ปุ่ม 2 ปุ่มสำหรับตัวเลือกแบบบวก/ลบง่ายๆ หรือ 2) ชิปที่ซ้อนกันแนวตั้งหรือชิปสลับเพื่อตัวเลือกที่ยืดหยุ่นมากขึ้น ConfirmationDialog จะแสดงการตอบกลับพร้อมการหมดเวลา กล่องโต้ตอบแบบง่ายนี้มีช่องสำหรับชื่อและไอคอน (เคลื่อนไหว) (Ic2cf8)

การเปลี่ยนแปลง API

• เพิ่มหน่วย (มิลลิวินาที) ลงในค่าระยะเวลาของกล่องโต้ตอบที่แนะนำ (I09b48)

เวอร์ชัน 1.0.0-alpha11

17 พฤศจิกายน 2021

androidx.wear.compose:compose-foundation:1.0.0-alpha11, androidx.wear.compose:compose-material:1.0.0-alpha11 และ androidx.wear.compose:compose-navigation:1.0.0-alpha11 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha11 มีการคอมมิตเหล่านี้

ฟีเจอร์ใหม่

• เราได้เพิ่มคอมโพเนนต์เครื่องมือเลือกที่ช่วยให้ผู้ใช้เลือกรายการจากรายการแบบเลื่อนได้ โดยค่าเริ่มต้น รายการที่เลือกได้จะแสดงซ้ำ "แบบไม่จำกัด" ทั้งใน 2 ทิศทาง เพื่อให้ดูเหมือนทรงกระบอกหมุนที่มองจากด้านข้าง เราจะเพิ่ม 2 ฟีเจอร์ในรุ่นที่ใหม่กว่า ได้แก่ การยึดค่าหลังจากปัด/ปัดผ่าน และการเพิ่มฟังก์ชันลงใน PickerState เพื่อตั้งค่า/เลื่อนไปยังค่าปัจจุบัน (I6461b)

การเปลี่ยนแปลง API

• เพิ่ม ScalingLazyItemScope และตัวแก้ไขใหม่บางรายการ ได้แก่ fillParentMaxSize/fillParentMaxWidth/fillParentMaxHeight เพื่ออนุญาตให้ปรับขนาดรายการในรายการตามขนาดของคอนเทนเนอร์หลัก คุณตั้งค่ารายการให้เต็มขนาดของรายการหลักหรือบางส่วนก็ได้ ซึ่งจะแสดงฟังก์ชันที่มีอยู่แล้วใน LazyRow/Column (I4612f)
• เพิ่มการรองรับ ScalingLazyColumn เพื่ออนุญาตให้รายการมีคีย์ นอกจากนี้ ยังเพิ่มเมธอดที่สะดวกเพื่อให้เพิ่มรายการจากอาร์เรย์และลิสต์ได้ (Ic1f89)

การแก้ไขข้อบกพร่อง

• ตัวอย่างเพิ่มเติมสำหรับ TimeText (I8cb64)

เวอร์ชัน 1.0.0-alpha10

3 พฤศจิกายน 2021

androidx.wear.compose:compose-foundation:1.0.0-alpha10, androidx.wear.compose:compose-material:1.0.0-alpha10 และ androidx.wear.compose:compose-navigation:1.0.0-alpha10 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha10 มีการคอมมิตเหล่านี้

ฟีเจอร์ใหม่

• เพิ่ม InlineSlider สำหรับ Wear Compose InlineSlider ช่วยให้ผู้ใช้เลือกจากช่วงค่าได้ ช่วงของตัวเลือกจะแสดงเป็นแถบระหว่างค่าต่ำสุดและสูงสุดของช่วง ซึ่งผู้ใช้จะเลือกค่าใดค่าหนึ่งได้ (If0148)

• ลองใช้ Compose สำหรับ Codelab ของ WearOS ใหม่

การเปลี่ยนแปลง API

• ตอนนี้ Macrobenchmark มี minSdkVersion เป็น 23 (If2655)

การแก้ไขข้อบกพร่อง

• อัปเดตการจัดการการเปลี่ยนผ่านใน SwipeDismissableNavHost ใน SideEffect (I04994, b/202863359)
• อัปเดตการจัดการการเปลี่ยนผ่านใน SwipeDismissableNavHost (I1cbe0, b/202863359)

เวอร์ชัน 1.0.0-alpha09

27 ตุลาคม 2021

androidx.wear.compose:compose-foundation:1.0.0-alpha09, androidx.wear.compose:compose-material:1.0.0-alpha09 และ androidx.wear.compose:compose-navigation:1.0.0-alpha09 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha09 มีการคอมมิตเหล่านี้

ฟีเจอร์ใหม่

• เราได้เปิดตัวตัวอย่างสำหรับนักพัฒนาแอปของ Compose ใน Wear OS แล้ว โปรดดูบล็อกโพสต์ของเราซึ่งจะอธิบายคอมโพสิเบิลหลักและลิงก์ไปยังแหล่งข้อมูลเพิ่มเติมเพื่อเริ่มใช้งาน

การเปลี่ยนแปลง API

• เราได้เพิ่มการรองรับเพื่อให้นักพัฒนาแอปปรับแต่งสีทั้งหมดในธีมสี Material Design ของ Wear ได้ (I4759b, b/199754668)

การแก้ไขข้อบกพร่อง

• เพิ่มตัวอย่าง SwipeToDismissBox ที่เก็บสถานะไว้ (Ibaffe)
• เพิ่มลิงก์ไปยังคู่มือ developer.android.com จาก KDocs สำหรับ CurvedText, TimeText และ SwipeToDismissBox (I399d4)
• ตอนนี้ SwipeDismissableNavHost จะแสดงข้อผิดพลาดหากไม่มีจุดหมายปัจจุบัน (บ่งบอกว่า NavGraph ไม่ได้สร้างขึ้นด้วยฟังก์ชันยูทิลิตี wear.compose.navigation.composable) (I91403)
• เพิ่มเอกสารประกอบและตัวอย่างเพิ่มเติมสำหรับการใช้แหล่งข้อมูลเวลาใน TimeText (I4f6f0)

เวอร์ชัน 1.0.0-alpha08

13 ตุลาคม 2021

androidx.wear.compose:compose-foundation:1.0.0-alpha08, androidx.wear.compose:compose-material:1.0.0-alpha08 และ androidx.wear.compose:compose-navigation:1.0.0-alpha08 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha08 มีการคอมมิตเหล่านี้

การเปลี่ยนแปลง API

• เราได้เปลี่ยนชื่อพร็อพเพอร์ตี้ body ของ AppCard และ TitleCard เป็น content และย้ายไปไว้ที่ท้ายรายการพร็อพเพอร์ตี้เพื่อให้ระบุเป็นแลมบ์ดาต่อท้ายได้ และเปลี่ยนชื่อ bodyColor เป็น contentColor เพื่อให้สอดคล้องกับชื่อสล็อตใหม่ (I57e78)

การแก้ไขข้อบกพร่อง

• เพิ่มลิงก์ไปยังคำแนะนำจาก KDocs สำหรับปุ่ม การ์ด ชิป ธีม ตัวบ่งชี้ตำแหน่ง และการปรับขนาดคอมโพเนนต์คอลัมน์แบบ Lazy ของ developer.android.com (I22428)
• แก้ไขข้อบกพร่องที่บางครั้ง SwipeToDismissBox ของ WearOS ไม่จัดการการปัด (I9387e)
• เพิ่มตัวอย่างสำหรับ Button, CompactButton, Chip, CompactChip, AppCard, TitleCard, ToggleButton, ToggleChip, SplitToggleChip (Iddc15)
• เพิ่มการทดสอบประสิทธิภาพแบบไมโครเบนช์มาร์กสำหรับ Card, Chip, ToggleChip, TimeText และ ScalingLazyColumn (If2fe9)

เวอร์ชัน 1.0.0-alpha07

29 กันยายน 2021

androidx.wear.compose:compose-foundation:1.0.0-alpha07, androidx.wear.compose:compose-material:1.0.0-alpha07 และ androidx.wear.compose:compose-navigation:1.0.0-alpha07 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha07 มีการคอมมิตเหล่านี้

ฟีเจอร์ใหม่

• เพิ่มคอมโพเนนต์ CurvedText ในวัสดุ ซึ่งเป็นคอมโพเนนต์ที่ช่วยให้นักพัฒนาแอปเขียนข้อความโค้งตามเส้นโค้งของวงกลมได้อย่างง่ายดาย (โดยปกติจะอยู่บริเวณขอบของหน้าจอทรงกลม) (I19593)

การเปลี่ยนแปลง API

• เพิ่มการทดสอบสําหรับ TimeText (Idfead)
• เปลี่ยน ArcPaddingValues เป็นอินเทอร์เฟซ (Iecd4c)
• เพิ่มภาพเคลื่อนไหวลงใน SwipeToDismissBox (I9ad1b)
• เพิ่มพารามิเตอร์ hasBackground ลงใน SwipeToDismissBox API เพื่อให้ปิดใช้ท่าทางสัมผัสการปัดได้เมื่อไม่มีเนื้อหาพื้นหลังที่จะแสดง (I313d8)
• ตอนนี้ rememberNavController() จะรับชุดอินสแตนซ์ Navigator ที่ไม่บังคับซึ่งจะเพิ่มลงใน NavController ที่แสดงผลเพื่อรองรับ Navigator ที่ไม่บังคับได้ดีขึ้น เช่น Navigator จากวัสดุการนำทางสำหรับ Accompanist (I4619e)
• อ้างอิง NamedNavArgument จาก navigation-common และนําข้อความออกจาก wear.compose.navigation (I43af6)

การแก้ไขข้อบกพร่อง

• แก้ไขข้อบกพร่องของ CurvedRow Test ในอุปกรณ์ขนาดเล็ก (If7941)
• แก้ไขการกะพริบที่อาจเกิดขึ้นในแถวโค้งเมื่อเนื้อหาอัปเดต และตรวจสอบว่าแถวโค้งได้รับการวัดอีกครั้ง (Ie4e06)
• ChipDefaults.gradientBackgroundChipColors() ได้รับการอัปเดตให้สอดคล้องกับการเปลี่ยนแปลงในข้อกำหนด UX ตอนนี้การไล่ระดับสีจะเริ่มต้นด้วย MaterialTheme.colors.primary ที่มีค่าอัลฟ่า 32.5% และลงท้ายด้วย MaterialTheme.colors.surface ที่มีค่าอัลฟ่า 0% บนพื้นหลังของ MaterialTheme.colors.surface ที่มีค่าอัลฟ่า 75% (Id1548)
• เราได้อัปเดตสีของ ToggleChips เมื่ออยู่ในสถานะที่เลือกเพื่อให้ตรงกับคำแนะนำเกี่ยวกับข้อกำหนด UX ของ Material Design ของ Wear เวอร์ชันล่าสุด เมื่อเลือกแล้ว ตอนนี้ ToggleChips จะมีพื้นหลังเป็นไล่ระดับสีจาก MaterialTheme.color.surface @ 0% alpha ที่ด้านซ้ายบน ไปจนถึง MaterialTheme.color.primary @ 32% alpha ที่ด้านขวาล่าง บนพื้นหลังของ MaterialTheme.color.surface @ 75% alpha ซึ่งทำให้ ToggleChip มีความแตกต่างระหว่าง "เลือกแล้ว" กับ "ยกเลิกการเลือกแล้ว" น้อยลง (Idd40b)

เวอร์ชัน 1.0.0-alpha06

15 กันยายน 2021

androidx.wear.compose:compose-foundation:1.0.0-alpha06, androidx.wear.compose:compose-material:1.0.0-alpha06 และ androidx.wear.compose:compose-navigation:1.0.0-alpha06 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha06 มีการคอมมิตเหล่านี้

ฟีเจอร์ใหม่

• เราได้เพิ่ม Scaffold ซึ่งเป็นคอมโพสิชันแอปพลิเคชันระดับบนสุดที่ให้โครงสร้างสำหรับจัดการตำแหน่ง PositionIndicators (เช่น การเลื่อนหรือระดับเสียง) พื้นที่ด้านบนของหน้าจอสำหรับแสดงเวลาและสถานะแอปพลิเคชัน และรองรับ Vignette เพื่อเบลอขอบด้านบนและด้านล่างของหน้าจอสำหรับเนื้อหาที่เลื่อนได้ พื้นที่หลักของ Scaffold คือตําแหน่งที่จะวางเนื้อหาแอปพลิเคชัน (I5e0bf)
• เพิ่มการใช้งาน TimeText สำหรับ Wear Compose (I5654c)

ไลบรารีการนําทางของ Wear Compose

• เราได้เพิ่มไลบรารีการนำทางของ Wear Compose เวอร์ชันแรก ซึ่งให้การผสานรวมระหว่างไลบรารีการนำทางของ Wear Compose กับ Androidx ซึ่งช่วยให้ไปยังส่วนต่างๆ ระหว่างฟังก์ชัน @Composable ที่เป็นปลายทางในแอปพลิเคชันได้อย่างง่ายดาย

• การเผยแพร่ครั้งแรกนี้ให้สิ่งต่อไปนี้

  • คอมโพสิชัน SwipeDismissableNavHost ที่โฮสต์กราฟการนำทางและให้การนําทางย้อนกลับผ่านท่าทางสัมผัสด้วยการปัด
  • ส่วนขยาย 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)
• อัปเดต SwipeToDismissBox เพื่อรองรับ rememberSaveable (Ie728b)
• เราได้เพิ่มการรองรับ reverseLayout ลงใน ScalingLazyColumn ซึ่งช่วยให้เปลี่ยนทิศทางของการเลื่อนและเลย์เอาต์ได้ (I9e2fc)
• เลิกใช้งาน performGesture และ GestureScope แล้ว ซึ่งแทนที่ด้วย performTouchInput และ TouchInjectionScope (Ia5f3f, b/190493367)
• เราได้เปลี่ยนชื่อ VignetteValue เป็น VignettePosition และเปลี่ยนชื่อ VignetteValue.Both เป็น VignettePosition.TopAndBottom (I57ad7)
• เราได้เปลี่ยนชื่อ ScalingLazyColumnState เป็น ScalingLazyListState, ScalingLazyColumnItemInfo เป็น ScalingLazyListItemInfo, ScalingLazyColumnLayoutInfo เป็น ScalingLazyListLayoutInfo และ ScalingLazyColumnScope เป็น ScalingLazyListScope ในกรณีที่เราตัดสินใจเพิ่มการใช้งาน ScalingLazyRow ในอนาคต (I22734)

การแก้ไขข้อบกพร่อง

• อัปเดตเอกสารประกอบของ CompactChip เพื่ออธิบายสิ่งที่จะเกิดขึ้นหากไม่ได้ระบุไอคอนหรือป้ายกำกับ (I4ba88)
• เราได้ทำการปรับเปลี่ยนบางอย่างในคอมโพเนนต์การ์ดของ Wear (I6b3d0)
  1. ระยะห่างระหว่างชื่อกับเนื้อหาใน TitleCard ลดลงจาก 8.dp เป็น 2.dp
  2. เปลี่ยนแบบอักษรส่วนหัวของ TitleCard จาก body เป็น title3
  3. เปลี่ยนการไล่สีพื้นหลังของการ์ดเพื่อให้พื้นหลังดูเข้มขึ้น

เวอร์ชัน 1.0.0-alpha05

1 กันยายน 2021

androidx.wear.compose:compose-foundation:1.0.0-alpha05 และ androidx.wear.compose:compose-material:1.0.0-alpha05 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha05 มีการคอมมิตเหล่านี้

การเปลี่ยนแปลง API

• ทำเครื่องหมาย ArcPaddingValues เป็น @Stable (I57deb)
• ตอนนี้ ScalingLazyColumnState ใช้อินเทอร์เฟซ ScrollableState ซึ่งช่วยให้นักพัฒนาซอฟต์แวร์เข้าถึงการเลื่อนคอมโพเนนต์แบบเป็นโปรแกรมได้ (I47dbc)

การแก้ไขข้อบกพร่อง

• เราได้ลดระยะห่างระหว่างไอคอนและข้อความในชิปและ ToggleChip เพื่อให้สอดคล้องกับการอัปเดตข้อกำหนด 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 มีการคอมมิตเหล่านี้

ฟีเจอร์ใหม่

• เพิ่ม SwipeToDismissBox และตัวแก้ไขที่ปัดได้ซึ่งสามารถใช้เพื่อรองรับท่าทางสัมผัสปัดไปทางขวาเพื่อปิด แม้ว่าจะไม่ได้ขึ้นอยู่กับคอมโพเนนต์การนําทาง แต่คาดว่าจะใช้เพื่อออกจากหน้าจอหนึ่งและไปยังอีกหน้าจอหนึ่ง เพิ่มการทดสอบการผสานรวมเพื่อสาธิตการปัดเพื่อปิด (I7bbaa)
• เราได้เพิ่มอินเทอร์เฟซ ScalingLazyColumnItemInfo และ ScalingLazyColumnLayoutInfo ลงในคลาส ScalingLazyColumnState เพื่อให้นักพัฒนาซอฟต์แวร์ทราบตําแหน่งและขนาดจริงของรายการใน ScalingLazyColumn หลังจากใช้การปรับขนาดแล้ว นอกจากนี้ เรายังได้แก้ไขข้อบกพร่องเกี่ยวกับวิธีคำนวณการปรับขนาดเมื่อใช้การเว้นวรรคเนื้อหา "ด้านบน" กับ ScalingLazyColumn (I27c07)

การเปลี่ยนแปลง API

• เพิ่มคลาส CurvedTextStyle เพื่อระบุตัวเลือกการจัดรูปแบบข้อความโค้ง คล้ายกับ TextStyle แต่ตอนนี้รองรับเฉพาะสี ขนาดแบบอักษร และพื้นหลัง เราจะเพิ่มตัวเลือกการจัดสไตล์อื่นๆ ในอนาคต (I96ac3)
• เราได้เพิ่มอินเทอร์เฟซ ScalingLazyColumnItemInfo และ ScalingLazyColumnLayoutInfo ลงในคลาส ScalingLazyColumnState เพื่อให้นักพัฒนาซอฟต์แวร์ทราบตําแหน่งและขนาดจริงของรายการใน ScalingLazyColumn หลังจากใช้การปรับขนาดแล้ว นอกจากนี้ เรายังแก้ไขข้อบกพร่องเกี่ยวกับวิธีคำนวณการปรับขนาดเมื่อใช้การเว้นวรรคเนื้อหา "ด้านบน" กับ ScalingLazyColumn ด้วย (I27c07)
• เพิ่ม @ExperimentalWearMaterialApi ไปยัง SwipeDismissTarget enum ซึ่งเป็นส่วนหนึ่งของ SwipeToDismissBox API (I48b5e)

การแก้ไขข้อบกพร่อง

• เพิ่มเนื้อหาทดสอบสำหรับ SwipeToDismissBox (I9febc)

เวอร์ชัน 1.0.0-alpha03

4 สิงหาคม 2021

androidx.wear.compose:compose-foundation:1.0.0-alpha03 และ androidx.wear.compose:compose-material:1.0.0-alpha03 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha03 มีคอมมิตเหล่านี้

การเปลี่ยนแปลง API

• เพิ่มคอมโพเนนต์ CurvedText ซึ่งช่วยให้นักพัฒนาแอปเขียนข้อความตามส่วนโค้งของวงกลมได้อย่างง่ายดาย (โดยปกติอยู่ที่ขอบของหน้าจอทรงกลม) (Id1267)
• เราได้เปลี่ยนชื่อ CardDefaults.imageBackgroundPainter() เป็น CardDefaults.imageWithScrimBackgroundPainter() เพื่อให้ชัดเจนว่าภาพพื้นหลังจะมีภาพพื้นหลังวางซ้อนอยู่ (I53206)
• การเพิ่มคอมโพเนนต์ ScalingLazyColumn ที่ให้คอมโพเนนต์รายการสำหรับ Wear Material ซึ่งให้มุมมองฟิชอายโดยเนื้อหารายการจะปรับขนาดให้เล็กลงและโปร่งใสเมื่อปรับขนาดไปยังขอบของคอมโพเนนต์ (I7070c)

การแก้ไขข้อบกพร่อง

• เราได้เปลี่ยนสีเริ่มต้นของเนื้อหา appName ใน AppCard เพื่อตอบสนองต่อการอัปเดตข้อกำหนด 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 ใหม่เพื่อวางคอมโพสิเบิลเป็นรูปโค้ง (I29941)
• เพิ่มการ์ดประเภทใหม่สําหรับใช้ในแอปพลิเคชัน (TitleCard) รวมถึงเพิ่มการรองรับการใช้รูปภาพเป็นพื้นหลังของการ์ดเพื่อเน้นเนื้อหา (I53b0f)

การเปลี่ยนแปลง API

• เพิ่มการรองรับการจัดแนวรัศมีให้กับ CurvedRow (คล้ายกับการจัดแนวแนวตั้งในแถว) (Id9de5)
• เพิ่มคลาส CurvedRow ใหม่ไปยังคอมโพสิเบิลที่จัดวางในรูปโค้ง (I29941)
• เพิ่มการ์ดประเภทใหม่สําหรับใช้ในแอปพลิเคชัน (TitleCard) รวมถึงเพิ่มการรองรับการใช้รูปภาพเป็นพื้นหลังของการ์ดเพื่อเน้นเนื้อหา (I53b0f)
• เพิ่มไอคอนเปิด/ปิด (ช่องทำเครื่องหมาย สวิตช์ และปุ่มตัวเลือก) ลงใน ToggleChipDefaults เพื่อให้นักพัฒนาซอฟต์แวร์กำหนดค่า ToggleChip และ SplitToggleChips ได้ง่ายขึ้น (I7b639)
• ระยะห่างจากขอบของเนื้อหาเริ่มต้นและสิ้นสุดสำหรับชิปได้รับการอัปเดตเพื่อให้เป็น 14.dp เสมอ ไม่ว่าจะมีไอคอนหรือไม่ก็ตาม (ก่อนหน้านี้คือ 12.dp หากมีไอคอนและ 14.dp หากไม่มี) (I34c86)

การแก้ไขข้อบกพร่อง

• เพิ่มการทดสอบสำหรับ CurvedRow (I93cdb)
• การเชื่อมโยง Dependency ของ Wear Compose กับ Compose 1.0.0-rc01 (Ie6bc9)
• เปลี่ยนการจัดการภาพพื้นหลังในการ์ดและชิปเพื่อให้ระบบครอบตัดรูปภาพแทนการยืดรูปภาพเพื่อรักษาสัดส่วนรูปภาพ (I29b41)
• เพิ่มการสาธิตและการทดสอบการผสานรวมสำหรับ Button และ ToggleButton (5e27ed2)
• เพิ่มการทดสอบชิปเพิ่มเติมเพื่อให้ครอบคลุมสีของเนื้อหาสำหรับชิปพื้นหลังรูปภาพ (Ia9183)

เวอร์ชัน 1.0.0-alpha01

1 กรกฎาคม 2021

androidx.wear.compose:compose-foundation:1.0.0-alpha01 และ androidx.wear.compose:compose-material:1.0.0-alpha01 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha01 มีการคอมมิตเหล่านี้

ฟีเจอร์ใหม่

Wear Compose เป็นไลบรารี Kotlin ที่ใช้ Compose ซึ่งรองรับ Material Design ของ Wear ซึ่งเป็นส่วนขยายของ Material Design สำหรับอุปกรณ์ที่สวมใส่ได้ของ WearOS รุ่นอัลฟ่าแรกนี้มีการใช้งานเบื้องต้นที่ใช้งานได้จริงของสิ่งต่อไปนี้

• ธีม Material - กำหนดค่าสี การจัดรูปแบบตัวอักษร และรูปร่างให้สอดคล้องกันสำหรับคอมโพเนนต์ที่ใช้จากไลบรารีนี้
• ชิป ชิปคอมแพค - ชิปเป็นรูปทรงสนามกีฬาและมีรูปแบบต่างๆ สำหรับใช้กับเนื้อหาไอคอน ป้ายกำกับ และป้ายกำกับรอง
• - ToggleChip, SplitToggleChip - ชิปประเภทพิเศษที่มีช่องสำหรับไอคอนเปิด/ปิดแบบ 2 สถานะ เช่น ปุ่มตัวเลือกหรือช่องทำเครื่องหมาย นอกจากนี้ SplitToggleChip ยังมีพื้นที่ที่แตะได้ 2 พื้นที่ ได้แก่ พื้นที่ที่คลิกได้ 1 พื้นที่และพื้นที่ที่เปิด/ปิดได้ 1 พื้นที่
• Button, CompactButton - ปุ่มมีรูปร่างเป็นวงกลม โดยมีช่องเนื้อหาเดียวสำหรับไอคอนหรือข้อความสั้นๆ (ไม่เกิน 3 อักขระ)
• ToggleButton - ปุ่มที่เปิดหรือปิดการดำเนินการ โดยมีช่องเดียวสำหรับไอคอนหรือข้อความสั้นๆ (ไม่เกิน 3 อักขระ)
• การ์ด, AppCard - สี่เหลี่ยมผืนผ้าที่มีมุมมน มีช่องสำหรับเนื้อหา เช่น ไอคอนแอป เวลา ชื่อ และเนื้อหา

เวอร์ชันในอนาคตจะขยายชุดวิดเจ็ตเพื่อรองรับเครื่องมือเลือก แถบเลื่อน รายการ ตัวบ่งชี้หน้า กล่องโต้ตอบ ตัวบ่งชี้การเลื่อน ข้อความแจ้ง และอื่นๆ ในการออกแบบ Material ของ Wear

นอกจากนี้ เราจะให้การสนับสนุนฟีเจอร์อื่นๆ สำหรับอุปกรณ์ที่สวมใส่ได้โดยเฉพาะ เช่น เลย์เอาต์และข้อความแบบโค้ง รวมถึงการสร้างโครงสร้างพื้นฐานเพื่อให้นักพัฒนาแอปสร้างแอป/การวางซ้อนสำหรับอุปกรณ์ที่สวมใส่ได้ง่าย

Material ของ Wear Compose ได้รับการออกแบบตามหลักการเดียวกับ Material ของ Compose แม้ว่าจะมุ่งเน้นไปที่อุปกรณ์ที่สวมใส่ได้ คุณควรใช้ไลบรารี Material ของ Wear Compose แทนไลบรารี Material ของ Compose เมื่อสร้างแอปสำหรับอุปกรณ์ที่สวมใส่ได้

ไลบรารี "Material" 2 รายการนี้ควรถือว่าใช้ร่วมกันไม่ได้และไม่ควรนำมาใช้ร่วมกันในแอปเดียวกัน หากนักพัฒนาแอปพบว่าตนเองได้รวมไลบรารี Compose Material ไว้ในรายการที่ตนพึ่งพา แสดงว่า a) มีคอมโพเนนต์ที่ขาดหายไปจากไลบรารี Compose Material ของ Wear โปรดแจ้งให้เราทราบว่าคุณต้องการอะไร หรือ b) คุณกำลังใช้คอมโพเนนต์ที่เราไม่แนะนำให้ใช้ในอุปกรณ์ที่สวมใส่ได้