การเขียนใน Wear

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

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

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

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

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

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

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

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

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

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

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

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

ความคิดเห็น

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

สร้างรายการใหม่

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

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

เวอร์ชัน 1.0.0-alpha23

14 พฤษภาคม 2024

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

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

• เราได้อัปเดต API ของ ToggleButton และ RadioButton เพื่อให้กำหนดค่าสีที่ปิดใช้ได้ (If13a7)
• เราได้เพิ่ม CircularProgressIndicator ใหม่สำหรับ Material3 (Ib3bd7)

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

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

เวอร์ชัน 1.0.0-alpha22

1 พฤษภาคม 2024

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

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

• เราได้อัปเดต ColorScheme ของ Material3 (I7b2b8)
• เราได้อัปเดตสวิตช์ Material3 รวมถึงการเปลี่ยนสีบางอย่างด้วย ตอนนี้เครื่องหมายถูกจะตรงกับช่องทำเครื่องหมายที่ใช้ (Icac7b)

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

• อัปเดตการสาธิตการผสานรวมทั้งหมดเพื่อใช้ตัวแก้ไข rotaryScrollable ใหม่ (I25090)

เวอร์ชัน 1.0.0-alpha21

17 เมษายน 2024

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

• ระบบทริกเกอร์รุ่นนี้เนื่องจากปัญหาทางเทคนิคในรุ่นก่อนหน้า ซึ่งทำให้ไม่มี Jar แหล่งที่มา ไม่มีสัญญาผูกมัดใหม่ในรุ่นนี้

เวอร์ชัน 1.0.0-alpha20

3 เมษายน 2024

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

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

• เราได้ปรับอัลฟ่าของสถานะการกดคลื่นและโฟกัสไปที่คอนทราสต์ (I59f0a)
• เราได้เพิ่มระยะห่างระหว่างป้ายกำกับหลักและป้ายกำกับรองใน Button, ToggleButton และ RadioButton ตามการเปลี่ยนแปลงล่าสุดของรูปแบบตัวอักษรและความสูงของบรรทัด (I2c0ba)

เวอร์ชัน 1.0.0-alpha19

6 มีนาคม 2024

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

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

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

เวอร์ชัน 1.0.0-alpha18

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

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

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

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

เวอร์ชัน 1.0.0-alpha17

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

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

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

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

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

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

เวอร์ชัน 1.0.0-alpha16

24 มกราคม 2024

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

ฟีเจอร์ใหม่

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

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

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

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

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

เวอร์ชัน 1.0.0-alpha15

15 พฤศจิกายน 2023

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

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

• เราได้เปลี่ยนชื่อระดับพื้นฐาน SwipeToDismissBox เป็น BasicSwipeToDismissBox ซึ่งทำให้เห็นความแตกต่างระหว่างคอมโพเนนต์ระดับพื้นฐานกับ Material3 ระดับ SwipeToDismissBox อย่างชัดเจน คำสั่งหลังจะดึงสีจาก MaterialTheme เพื่อนำมาใช้ใน Scrim และมอบสิทธิ์การใช้งานที่เหลืออยู่ให้กับ BasicSwipeToDismissBox (Ibecfc)

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

• เราได้นำเลเยอร์ Material-core สำหรับปุ่ม Material3 ออกเพื่อปรับปรุงประสิทธิภาพ (I55555)

เวอร์ชัน 1.0.0-alpha14

18 ตุลาคม 2023

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

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

• เราได้นำพารามิเตอร์ indicatorStyle ออกจาก 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 สำหรับ TextButton แล้ว (I769dc)

เวอร์ชัน 1.0.0-alpha12

20 กันยายน 2023

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

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

• เราได้อัปเดต IconButton เพื่อใช้โทเค็นดีไซน์ Material (I3F137)
• เราได้อัปเดต IconToggleButton เพื่อใช้โทเค็นดีไซน์ Material (I7d263)
• เราได้เผยแพร่ตัวสร้างของ CheckboxColors, RadioButtonColors, SwitchColors ต่อสาธารณะ (I82b73)

เวอร์ชัน 1.0.0-alpha11

6 กันยายน 2023

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

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

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

เวอร์ชัน 1.0.0-alpha10

23 สิงหาคม 2023

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

ฟีเจอร์ใหม่

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

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

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

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

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

เวอร์ชัน 1.0.0-alpha09

9 สิงหาคม 2023

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

ฟีเจอร์ใหม่

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

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

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

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

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

เวอร์ชัน 1.0.0-alpha08

26 กรกฎาคม 2023

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

ฟีเจอร์ใหม่

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

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

• เราได้อัปเดตรูปร่างในธีมของ Wear Material 3 เพื่อใช้ตาม RoundedCornerShape แทนรูปร่าง (Idb133)
• เรากำหนดค่าความสูงสำหรับ Button ให้เป็นสาธารณะ (Idbfde)
• อัปเดตไฟล์ API เพื่อให้มีคำอธิบายประกอบสำหรับการระงับความเข้ากันได้ (I8e87a, b/287516207)
• เราได้อัปเดต InlineSliderColors ใน Material Compose ของ Wear 3 ให้มีตัวสร้างสาธารณะและพร็อพเพอร์ตี้สาธารณะ (I6B632)
• เราได้อัปเดตคลาสสีทั้งหมดใน Material ของ Wear Compose 3 ให้มีเครื่องมือสร้างสาธารณะและคุณสมบัติสาธารณะ (I17702)
• เราเผยแพร่ค่าคงที่ของระยะห่างจากขอบแนวตั้งและแนวนอนของปุ่มต่อสาธารณะ (Ieeaf7)

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

• ตอนนี้ปุ่มจะปรับความสูงของปุ่มเพื่อรองรับเนื้อหาที่เพิ่มขึ้นเนื่องจากมีแบบอักษรขนาดใหญ่เพื่อการช่วยเหลือพิเศษเมื่อจำเป็น (Iaf302)
• เราได้อัปเดตการสาธิตของปุ่มจำนวนหนึ่งเพื่อแก้ไขปัญหาในการเข้าถึง (I61ce9)
• ตอนนี้ Stepper และ InlineSlider รองรับการคลิกซ้ำเมื่อกดค้างแล้ว คุณจึงสามารถเพิ่ม/ลดค่าของ Stepper และ InlineSlider ได้อย่างรวดเร็วโดยกดปุ่ม + หรือ - ค้างไว้ (I27359)

เวอร์ชัน 1.0.0-alpha07

21 มิถุนายน 2023

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

ฟีเจอร์ใหม่

• เราได้เพิ่มคอมโพเนนต์ Stepper ลงในไลบรารี Material 3 ของ Compose สำหรับ Wear OS แล้ว เนื้อหานี้จะคล้ายกับ Material เวอร์ชันก่อนหน้า แต่ไม่แสดงความหมายของช่วงโดยค่าเริ่มต้นตามความคิดเห็นของนักพัฒนาแอป เราจะระบุ Modifier.rangeSemantics กรณีที่จำเป็นต้องใช้ความหมายของช่วง (Ic39fd)
• เราได้เพิ่ม curvedText ลงในไลบรารี Compose สำหรับ Material 3 ของ Wear OS (Ia8ae3)

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

• เราได้อัปเดต wear.compose.foundation เป็นทรัพยากร Dependency ของ API ของ wear.compose.material3 (I72004, b/285404743)

เวอร์ชัน 1.0.0-alpha06

7 มิถุนายน 2023

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

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

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

เวอร์ชัน 1.0.0-alpha05

24 พฤษภาคม 2023

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

ฟีเจอร์ใหม่

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

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

• เราได้ย้ายพารามิเตอร์ป้ายกำกับปุ่มไปยังส่วนท้ายเพื่อรองรับไวยากรณ์ lambda ต่อท้ายและนำพารามิเตอร์บทบาทออกแล้ว (เนื่องจากสามารถลบล้างได้โดยใช้ Modifier.semantics) ตัวสร้าง ButtonColors รายการเป็นแบบสาธารณะแล้ว (Ie1b6d)

เวอร์ชัน 1.0.0-alpha04

10 พฤษภาคม 2023

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

ฟีเจอร์ใหม่

• เราได้เพิ่ม IconButton ลงใน Material3 ซึ่งเป็นปุ่มวงกลมที่มีช่องเดียวสำหรับไอคอน/รูปภาพ มี 4 รูปแบบ ได้แก่ IconButton, FilledIconButton, FilledTonalIconButton และ OutlinedIconButton สำหรับ IconButton ขนาดต่างๆ เราขอแนะนำให้ใช้ Modifier.touchTargetAwareSize และ ExtraSmallButtonSize, SmallButtonSize, DefaultButtonSize และ LargeButtonSizeIcon ที่ให้ไว้ใน IconButtonDefaults นอกจากนี้เรายังมี IconButtonDefaults.iconSizeFor เพื่อกำหนดขนาดไอคอนที่แนะนำสำหรับขนาดปุ่มที่กำหนด (I721d4)

เวอร์ชัน 1.0.0-alpha03

19 เมษายน 2023

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

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

• เราได้เพิ่มคอมโพเนนต์ปุ่ม Material 3 ซึ่งเป็นปุ่มรูปทรงสนามกีฬาและมีชื่อเดิมว่า "ชิป" ในไลบรารี Material ของ Wear Compose (เปลี่ยนชื่อเป็น "ปุ่ม" เพื่อให้สอดคล้องกับไลบรารี Compose Material 3) ปุ่มเริ่มต้นมีพื้นหลังแบบสีเติมและมีปุ่มรูปแบบต่างๆ สำหรับ FilledTonal (พื้นหลังแบบปิดเสียง) เติมขอบ (โปร่งใสและมีเส้นขอบบาง) และผู้เผยแพร่โฆษณาย่อย (พื้นหลังโปร่งใสและไม่มีเส้นขอบ ใช้สำหรับการดำเนินการเสริมที่มีความโดดเด่นน้อยที่สุด) ปุ่มกลมสำหรับไอคอนพื้นฐานและเนื้อหาข้อความจะพร้อมใช้งานในรุ่นถัดไป (Ia6942)

เวอร์ชัน 1.0.0-alpha02

5 เมษายน 2023

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

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

• เราได้เพิ่ม DefaultTextStyle ลงในเนื้อหา Wear Compose 3 ซึ่งกำหนดค่า PlatformTextStyle.includeFontPadding เป็น true แล้ว (การตั้งค่าปัจจุบัน) ซึ่งจะช่วยให้เราซิงค์ข้อมูลการปิดระยะห่างจากขอบของแบบอักษรโดยค่าเริ่มต้นกับไลบรารี Compose ได้ในอนาคต (โปรดดูแก้ไขระยะห่างจากขอบของแบบอักษรใน Compose สำหรับพื้นหลัง) (I7e461)

เวอร์ชัน 1.0.0-alpha01

22 มีนาคม 2023

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

ฟีเจอร์ใหม่

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

  • ธีมวัสดุ - กำหนดค่ารูปแบบสี รูปแบบอักษร และรูปทรงที่สอดคล้องกันในองค์ประกอบต่างๆ ในไลบรารี ธีม 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 ไม่เกี่ยวข้องกันและไม่ควรรวมในแอปเดียวกัน เนื่องจากมีการอ้างอิงธีมที่แตกต่างกันซึ่งทําให้เกิดความไม่สอดคล้องกันที่ไม่คาดคิด

เวอร์ชัน 1.4

เวอร์ชัน 1.4.0-beta03

12 มิถุนายน 2024

ปล่อย androidx.wear.compose:compose-*:1.4.0-beta03 แล้ว เวอร์ชัน 1.4.0-beta03 มีสัญญาผูกมัดเหล่านี้

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

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

เวอร์ชัน 1.4.0-beta02

29 พฤษภาคม 2024

ปล่อย androidx.wear.compose:compose-*:1.4.0-beta02 แล้ว เวอร์ชัน 1.4.0-beta02 มีสัญญาผูกมัดเหล่านี้

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

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

เวอร์ชัน 1.4.0-beta01

14 พฤษภาคม 2024

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

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

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

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

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

เวอร์ชัน 1.4.0-alpha08

1 พฤษภาคม 2024

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

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

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

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

• เราได้อัปเดตระยะห่างจากขอบแนวนอนของ PositionIndicator เป็น 2dp (เดิมคือ 5dp) เพื่อแก้ไขข้อบกพร่องที่ PositionIndicator (แถบเลื่อน) ซ้อนทับเนื้อหาที่เลื่อนได้ โปรดทราบว่าการเปลี่ยนแปลงนี้คาดว่าจะทำให้ภาพหน้าจอที่มีอยู่ซึ่งมี PositionIndicator เสียหายเนื่องจากการเปลี่ยนแปลงของระยะห่างจากขอบ (I57472)
• เราได้ปรับปรุงเอกสารประกอบเกี่ยวกับ Rotary API ใหม่โดยอธิบายความแตกต่างระหว่างอุปกรณ์แบบหมุนความละเอียดสูงกับความละเอียดต่ำ (I63abe)
• เราได้แก้ไขข้อยกเว้นนอกช่วงใน SwipeDismissableNavHost ที่อาจทริกเกอร์เมื่อค่าอัลฟ่าแบบสอดแทรกน้อยกว่า 0 (Ib75a1, b/335782510)

เวอร์ชัน 1.4.0-alpha07

17 เมษายน 2024

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

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

• เราได้เพิ่ม Modifier.rotary ซึ่งเป็นตัวแก้ไขใหม่ที่เชื่อมต่อเหตุการณ์แบบหมุนกับคอนเทนเนอร์แบบเลื่อนได้ เพื่อให้ผู้ใช้เลื่อนผ่านเม็ดมะยมหรือขอบที่หมุนได้ในอุปกรณ์ Wear OS นอกจากนี้ ตอนนี้ ScalingLazyColumn และเครื่องมือเลือกยังรองรับการป้อนข้อมูลด้วยปุ่มหมุนโดยค่าเริ่มต้น โดยมีโอเวอร์โหลดใหม่ที่มีพารามิเตอร์ rotaryBehavior สําหรับระบุการกําหนดค่าการเลื่อนหรือสแนป หากตั้งค่าพารามิเตอร์ rotaryBehavior เป็นสแนป ขอแนะนำให้ทำการสแนปผ่านพารามิเตอร์ flingBehavior ด้วยสำหรับการเลื่อนด้วยการแตะ (I2ef6f)
• UserInput และ SideEffect จะมาแทนที่แหล่งที่มาการลากและวาง NestedScroll เพื่อรองรับคำจำกัดความแบบขยายของแหล่งที่มาเหล่านี้ ซึ่งตอนนี้จะมีภาพเคลื่อนไหว (เอฟเฟกต์ด้านข้าง) และล้อเลื่อนของเมาส์ (UserInput) รวมอยู่ด้วย (I40579)
• เราได้เพิ่ม SelectableChip และ SplitSelectableChip เพื่อทำให้ความแตกต่างระหว่างการควบคุมการสลับ เช่น Switch/Checkbox และการควบคุมที่เลือกได้ชัดเจนยิ่งขึ้น เช่น RadioButton การดำเนินการนี้จะแทนที่การโหลดที่มากเกินไปของ ToggleChip/SplitToggleChip ก่อนหน้านี้ด้วยพารามิเตอร์ selectionControl (Ia0217)
• อัปเดตตัวปรับแต่งระดับการเข้าถึงของ IndeterminateStrokeWidth ใน ProgressIndicatorDefaults เป็นแบบสาธารณะแล้ว (I5b5a4)

เวอร์ชัน 1.4.0-alpha06

3 เมษายน 2024

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

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

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

เวอร์ชัน 1.4.0-alpha05

20 มีนาคม 2024

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

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

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

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

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

เวอร์ชัน 1.4.0-alpha04

6 มีนาคม 2024

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

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

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

เวอร์ชัน 1.4.0-alpha03

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

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

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

• เลิกใช้งาน Wrapper Modifier.inspectable แล้ว API นี้จะทําให้ตัวแก้ไขของคุณเป็นโมฆะมากเกินกว่าที่จำเป็น จึงไม่แนะนำให้ใช้ในขณะนี้ ขอแนะนำให้นักพัฒนาซอฟต์แวร์ใช้เมธอด inspectableProperties() ใน ModifierNodeElement หากต้องการแสดงพร็อพเพอร์ตี้ของตัวปรับแต่งในเครื่องมือ (Ib3236)

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

• เราได้แก้ไขข้อบกพร่องในเอกสารสำหรับคำอธิบายประกอบ WearPreview* แล้ว (Id526d)

เวอร์ชัน 1.4.0-alpha02

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

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

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

• เราได้แก้ไขข้อบกพร่องในการปัดเพื่อแสดง ซึ่งทำให้คุณสามารถโต้ตอบ (และยกเลิก) การดำเนินการที่คอมมิตกับรายการหนึ่งๆ ได้ด้วยการเริ่มปัดรายการอื่น (Ide059)
• เราได้อัปเดต ListHeader ให้รองรับการปรับความสูงเมื่อเนื้อหาต้องมีความสูงเพิ่มเติมเพื่อรองรับแบบอักษรขนาดใหญ่ (I7290c, b/251166127)

เวอร์ชัน 1.4.0-alpha01

24 มกราคม 2024

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

ฟีเจอร์ใหม่

• เราได้เพิ่มภาพเคลื่อนไหวของรายการไปยัง SwipeDismissableNavHost สำหรับการเปลี่ยนในแอปแล้ว (cfeb79a)
• ขณะนี้ PositionIndicator แสดงโดยค่าเริ่มต้นเมื่อแสดงหน้าจอครั้งแรก เราทำการเปลี่ยนแปลงนี้เพื่อช่วยให้ปฏิบัติตามหลักเกณฑ์ด้านคุณภาพของ Wear ซึ่งหมายความว่าคุณจะต้องอัปเดตการทดสอบภาพหน้าจอในหน้าจอที่มี PositionIndicator เนื่องจาก PositionIndicator จะไม่แสดงขึ้นก่อนหน้านี้ (419cef7)

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

• เราได้เพิ่ม Ripple API ใหม่ในไลบรารี wear:compose-material และ wear:compose-material3 ซึ่งแทนที่ rememberRipple ที่เลิกใช้งานแล้ว และเพิ่ม CompositionLocal ชั่วคราวคือ LocalUseFallbackRippleImplementation เพื่อเปลี่ยนคอมโพเนนต์ Material ไปใช้ API ของ rememberRipple/RippleTheme ที่เลิกใช้งานแล้ว เราจะนำการตั้งค่านี้ออกในรุ่นที่มีความเสถียรรุ่นถัดไปและมีไว้เพื่อเป็นตัวช่วยในการย้ายข้อมูลชั่วคราวในกรณีที่คุณให้ RippleTheme ที่กำหนดเองเท่านั้น ดูข้อมูลการย้ายข้อมูลและความเป็นมาเพิ่มเติมเบื้องหลังการเปลี่ยนแปลงนี้ได้ที่ developer.android.com (af92b21)
• เราได้อัปเดต ColorScheme ให้จะเปลี่ยนแปลงไม่ได้ ทำให้การอัปเดตสีแต่ละสีมีประสิทธิภาพน้อยลง แต่การใช้สีร่วมกันจะมีประสิทธิภาพมากขึ้น การเปลี่ยนแปลงนี้คือแอปส่วนใหญ่จะไม่อัปเดตสีแยกเป็นกรณีการใช้งานหลัก รูปแบบเช่นนี้ยังคงเป็นไปได้แต่จะมีการจัดเรียงใหม่มากกว่าเดิม ด้วยเหตุนี้ เราจึงลดจำนวนการสมัครใช้บริการของรัฐลงเป็นอย่างมากผ่านโค้ด Material ทั้งหมด และจะส่งผลต่อต้นทุนการเริ่มต้นและรันไทม์ของ Use Case มาตรฐานมากขึ้น (f5c48b7)
• เนื้อหา Wear และคอมโพเนนต์ Wear Material3 ที่แสดง MutableInteractionSource ใน API ได้รับการอัปเดตเพื่อแสดง MutableInteractionSource ที่เป็นค่าว่างซึ่งมีค่าเริ่มต้นเป็น Null ไม่มีการเปลี่ยนแปลงทางความหมายที่นี่: การส่งค่า Null หมายความว่าคุณไม่ต้องการรอน MutableInteractionSource และจะสร้างขึ้นภายในคอมโพเนนต์หากจำเป็น การเปลี่ยนเป็น Null จะทำให้คอมโพเนนต์บางรายการไม่จัดสรร MutableInteractionSource เลย และช่วยให้คอมโพเนนต์อื่นๆ สร้างอินสแตนซ์แบบ Lazy Loading ได้เมื่อจำเป็นเท่านั้น ซึ่งจะช่วยปรับปรุงประสิทธิภาพของคอมโพเนนต์เหล่านี้ หากคุณไม่ได้ใช้ MutableInteractionSource ที่คุณส่งไปยังคอมโพเนนต์เหล่านี้ ขอแนะนำให้คุณส่ง null แทน เราขอแนะนำให้คุณทำการเปลี่ยนแปลงที่คล้ายกันในคอมโพเนนต์ของคุณเองด้วย (f8fa920)
• เราได้อัปเดต rememberExpandableState เพื่อบันทึกสถานะที่ขยายได้ วิธีนี้ช่วยให้มั่นใจได้ว่าข้อมูลจะได้รับการจัดเก็บเมื่อไปยังหน้าจออื่นและจะได้รับการกู้คืนเมื่อกลับมาที่หน้าจอเดิม (5c80095)

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

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

เวอร์ชัน 1.3

เวอร์ชัน 1.3.1

3 เมษายน 2024

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

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

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

เวอร์ชัน 1.3.0

24 มกราคม 2024

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

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

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

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

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

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

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

คำแนะนำในการใช้งาน

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

เวอร์ชัน 1.3.0-rc01

10 มกราคม 2024

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

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

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

  วันที่

  

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

เวอร์ชัน 1.3.0-beta02

13 ธันวาคม 2023

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

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

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

เวอร์ชัน 1.3.0-beta01

15 พฤศจิกายน 2023

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

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

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

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

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

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

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

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

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

เวอร์ชัน 1.3.0-alpha08

18 ตุลาคม 2023

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

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

• เราได้เพิ่ม Flag แต่ละรายการลงในโอเวอร์โหลด PositionIndicator เพื่อควบคุมภาพเคลื่อนไหวที่แตกต่างกัน: showFadeInAnimation, showFadeOutAnimation และ showPositionAnimation API ก่อนหน้านี้เลิกใช้งานแล้วและส่งต่อการเรียกใช้ไปยัง API ใหม่ ด้วยเหตุผลด้านประสิทธิภาพและเพื่อความสอดคล้อง UX เมื่อใช้ PositionIndicator กับรายการที่เลื่อนได้ เราขอแนะนำให้ปิดการตั้งค่าสถานะ showFadeInAnimation และ showPositionAnimation หากใช้ PositionIndicator เป็นตัวบ่งชี้แบบสแตนด์อโลน เช่น สำหรับการเปลี่ยนแปลงระดับเสียง เราขอแนะนำให้เปิดภาพเคลื่อนไหวทั้ง 3 รายการ (I44294)
• เราเลิกใช้งานสื่อการเรียนการสอนของชั้นเรียน SwipeToDismissBoxState, SwipeToDismissValue และ edgeSwipeToDismiss แล้วหลังจากย้ายข้อมูลฟังก์ชันแบบปัดเพื่อปิดไปยัง wear.compose.foundation โปรดแทนที่ด้วยค่าที่เทียบเท่า wear.compose.foundation (Iee8c9)

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

• เราได้อัปเดตโปรไฟล์พื้นฐานสําหรับไลบรารีพื้นฐานสำหรับ Wear Compose, วัสดุ และไลบรารีการนำทาง (Idb060)
• เราได้เปลี่ยนกลับการเปลี่ยนแปลงลักษณะการทำงานสำหรับ PositionIndicator ที่ใช้ใน CL ก่อนหน้า เช่น PositionIndicator มีภาพเคลื่อนไหวเมื่อแสดงหน้าจอครั้งแรก เราตั้งใจจะทำการเปลี่ยนแปลงที่คล้ายกันนี้ในรุ่นอัลฟ่า 1.4 ตอนต้น เพื่อให้แสดง PositionIndicator ในตอนแรกแต่ไม่มีภาพเคลื่อนไหว (I41843)
• เราพบปัญหาด้านประสิทธิภาพบางอย่างใน PositionIndicator (I1c654, b/302399827)
• เราได้ปรับปรุงประสิทธิภาพของการใช้งานเริ่มต้นของผู้ให้บริการสถานะการสำรวจด้วยการแตะเพื่อใช้ State<Boolean> แทนสถานะที่ได้มา (Ieec4d)
• เราได้ตั้งค่าสี่เหลี่ยมผืนผ้า systemGestureExclusion รูปสำหรับ Android 13 ขึ้นไป (Ib1f4b)

เวอร์ชัน 1.3.0-alpha07

4 ตุลาคม 2023

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

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

• เราได้เพิ่มการติดธงแต่ละรายการลงใน PositionIndicator เพื่อควบคุมภาพเคลื่อนไหวต่างๆ ได้แก่ showFadeInAnimation, showFadeOutAnimation และ showPositionAnimation API ก่อนหน้านี้เลิกใช้งานแล้วและส่งต่อการเรียกใช้ไปยัง API ใหม่ ด้วยเหตุผลด้านประสิทธิภาพและเพื่อความสอดคล้อง UX เมื่อใช้ PositionIndicator กับรายการที่เลื่อนได้ เราขอแนะนำให้ปิดการตั้งค่าสถานะ showFadeInAnimation และ showPositionAnimation หากใช้ PositionIndicator เป็นตัวบ่งชี้แบบสแตนด์อโลน เช่น สำหรับการเปลี่ยนแปลงระดับเสียง เราขอแนะนำให้เปิดภาพเคลื่อนไหวทั้ง 3 รายการ (Ia2d63)

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

• เราได้ปรับปรุงการปัดเพื่อแสดงการเคลื่อนไหวด้วยการเพิ่มภาพเคลื่อนไหวที่ค่อยๆ จางลงในข้อความการทำงานหลัก และการจางลงการดำเนินการรอง/การเปลี่ยนสัดส่วนไอคอนเมื่อขยายแบบเต็มการปัด (Ib7223)
• ขอแนะนำให้ทำให้การทำงาน "ปัดเพื่อดู" เข้าถึงได้ และเราได้เพิ่มการดำเนินการการช่วยเหลือพิเศษที่กำหนดเองลงในตัวอย่าง "การปัดเพื่อแสดง" แล้ว (I42224)
• เราได้ปรับปรุงประสิทธิภาพของ SwipeToDismissBox ซึ่งรวมถึงการเปลี่ยนโครงสร้างภายในโค้ดเพื่อให้มั่นใจว่าตรรกะเริ่มต้นจะไม่ทริกเกอร์การจัดองค์ประกอบใหม่ ตอนนี้ SwipeToDismissBox ถูกวาดเป็นขนาดเต็มหน้าจอ (Ie0aa2)
• เราได้แก้ไขข้อบกพร่องเมื่อ PositionIndicator หายไปอย่างไม่ถูกต้อง (I2091a)
• ปรับปรุงประสิทธิภาพของ PositionIndicator ด้วยการเพิ่มประสิทธิภาพการจัดองค์ประกอบใหม่ ต่อมาเราได้เพิ่ม Flag ใหม่สำหรับควบคุมภาพเคลื่อนไหว (fadeIn, fadeOut และ positionChange) แล้ว (ดูการเปลี่ยนแปลง API) (Ifac7d)
• เราได้เพิ่มการทดสอบ Microbenchmark สำหรับ PositionIndicator (Idf875)

เวอร์ชัน 1.3.0-alpha06

20 กันยายน 2023

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

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

• เราได้เพิ่มการสนับสนุนสำหรับ Modifier.edgeSwipeToDismiss ด้วย SwipeToReveal (I95774, b/293444286)
• เราได้เพิ่มตัวอย่างสำหรับสื่อการเรียนการสอนของชั้นเรียน SwipeToRevealChip และ SwipeToRevealCard (Ieb974)
• เราได้อัปเดตโปรไฟล์พื้นฐานสำหรับไลบรารี Wear Compose Foundation และ Material (I1dd1f)

เวอร์ชัน 1.3.0-alpha05

6 กันยายน 2023

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

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

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

เวอร์ชัน 1.3.0-alpha04

23 สิงหาคม 2023

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

ฟีเจอร์ใหม่

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

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

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

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

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

เวอร์ชัน 1.3.0-alpha03

9 สิงหาคม 2023

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

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

• เราได้เพิ่ม Composable ใหม่ 2 รายการใน Material สำหรับการใช้ SwipeToReveal กับการ์ดและชิป Composable เหล่านี้เป็นไปตามคำแนะนำ UX ที่แนะนำในคอมโพเนนต์และช่วยให้นักพัฒนาแอปใช้ SwipeToReveal กับคอมโพเนนต์ที่มีอยู่ใน Wear Material ได้ง่ายขึ้น (I7ec65)
• เราได้เปิดใช้คำอธิบายประกอบ FloatRange เป็นข้อจำกัด API ตามที่ได้ระบุไว้ในความคิดเห็นก่อนหน้านี้แล้ว (Icb401)

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

• เราได้ย้ายตรรกะการเลื่อนเริ่มต้นของ ScalingLazyColumn ภายใน onGloballyPositioned() (Ic90f1)
• ตอนนี้เราใช้ drawWithCache ใน PositionIndicator, ProgressIndicator และ SelectionControls เพื่อเพิ่มประสิทธิภาพการจัดสรรโรคหลอดเลือดสมอง (I5f225, b/288234617)
• เราได้แก้ไขการทำเครื่องหมายในช่องทำเครื่องหมายในสถานะถูกปิดใช้งานแล้ว (Ib25bf)
• เราได้อัปเดต Placeholder เพื่ออนุญาตให้รีเซ็ตเพื่อแสดงตัวยึดตำแหน่งหากเนื้อหาไม่อยู่ในสถานะพร้อมอีกต่อไป (Ibd820)
• เราได้ทำการแก้ไขบางอย่างสำหรับการทดสอบ Placeholder ที่ไม่น่าเชื่อถือ (Idb560)

เวอร์ชัน 1.3.0-alpha02

26 กรกฎาคม 2023

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

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

• เราได้จัดเตรียม ExpandableStateMapping ซึ่งเป็นวิธีใหม่ในการสร้าง ExpandableStates สำหรับกรณีที่ต้องสร้างตามคำขอ โดยไม่จำเป็นต้องอยู่ในขอบเขต @Composable (Iff9e0)
• ย้ายข้อมูล SwipeToDismissBox จาก androidx.wear.compose.material ไปยังแพ็กเกจ androidx.wear.compose.foundation แล้ว (I275fb)
• อัปเดตไฟล์ API เพื่อให้มีคำอธิบายประกอบสำหรับการระงับความเข้ากันได้ (I8e87a, b/287516207)
• เรากำหนดค่าความสูงสำหรับ Chip, CompactChip และ ToggleChip ให้เป็นสาธารณะ (Idbfde)
• เราทำให้ระยะห่างจากขอบทั้งแนวตั้งและแนวนอนสําหรับ Chip และ CompactChip เป็นแบบสาธารณะ (Ieeaf7)
• เพิ่มฟังก์ชันเพื่อปิดการจัดการการปัดใน SwipeDismissableNavHost ผ่านพารามิเตอร์ userSwipeEnabled ใหม่ (Id2a0b, b/230865655)
• เราได้อัปเดตไลบรารีการนำทางของ Wear Compose เพื่อใช้ SwipeToDismissBox ใหม่จากพื้นฐาน Wear Compose (I4ff8e)

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

• เราได้แก้ไขข้อบกพร่องของ z-order ที่ expandedItem ไม่แสดงเนื้อหาที่ถูกต้องหลังจากคลิกการทำงานของปุ่มเมื่อมีปุ่ม (I1899d, b/289991514)
• ปรับปรุงการจัดการโฟกัสของ SwipeToDismissBox (และ SwipeDismissableNavHost) โดยใช้ HierarchicalFocusCoordinator (I45362, b/277852486)
• เราได้แก้ไขการจัดการท่าทางสัมผัสใน SwipeableV2 แล้ว (I89737)
• เราได้สรุปโปรไฟล์พื้นฐานสำหรับรุ่น 1.2 ของเราเรียบร้อยแล้ว (รหัส 5740)
• หลังจากย้ายข้อมูล SwipeToDismissBox ไปยัง Foundation แล้ว ระบบใช้ Material SwipeToDismissBox ไปยัง "มูลนิธิ" และระบุค่าสีเริ่มต้นจากธีม (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 เป็นทรัพยากร Dependency ของ API ของ wear.compose.material (I72004, b/285404743) แล้ว
• เราได้แก้ไขข้อบกพร่องใน SwipeToDismissBox ตอนนี้ระบบส่งคีย์พื้นหลังและคีย์เนื้อหาไปยังบล็อกจำเพื่อสร้างตัวแก้ไขใหม่เมื่อเนื้อหาหรือพื้นหลังมีการเปลี่ยนแปลง (Ib876c, b/280392104)
• เราได้อัปเดต TimeText ให้ใช้ภาษาเมื่อเลือกรูปแบบสำหรับเวลา 12 หรือ 24 ชั่วโมง (If4a3d)
• เราได้แก้ไขความไม่สอดคล้องกันในพารามิเตอร์เริ่มต้นของ contentScrimColor แล้ว SwipeToDismissBox รายการ (I2d70f)
• เราได้ปรับปรุงการจัดการการเคลื่อนไหวใน SwipeToReveal (I28fb7)

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

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

เวอร์ชัน 1.2

เวอร์ชัน 1.2.1

18 ตุลาคม 2023

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

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

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

เวอร์ชัน 1.2.0

9 สิงหาคม 2023

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

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

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

เวอร์ชัน 1.2.0-rc01

26 กรกฎาคม 2023

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

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

• เราได้สรุปโปรไฟล์พื้นฐานของรุ่น 1.2 (Id5740) แล้ว

เวอร์ชัน 1.2.0-beta02

7 มิถุนายน 2023

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

ฟีเจอร์ใหม่

• เราได้เพิ่มตัวแปร LocalReduceMotion CompositionLocal ทดลองใหม่ ซึ่งจะปิดใช้การปรับสเกลและการจางลงใน ScalingLazyColumn (I58024)

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

• เราได้อัปเดตโปรไฟล์พื้นฐานสำหรับ Wear Compose Foundation และไลบรารี Material(I4725d)
• เราได้แก้ไขความไม่สอดคล้องกันของค่าเริ่มต้นสำหรับพารามิเตอร์ SwipeToDismissBox contentScrimColor (I2d70f)
• เราได้แก้ไขค่าเริ่มต้น DefaultTextStyle ที่ใช้สำหรับการตั้งค่า IncludeFontPadding (I737ed)

เวอร์ชัน 1.2.0-beta01

24 พฤษภาคม 2023

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

ฟีเจอร์ Compose สำหรับ Wear OS 1.2

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

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

ฟีเจอร์ใหม่

• เราได้เพิ่มการสนับสนุนการทดลองสำหรับการปรับขนาดที่ปิดและภาพเคลื่อนไหวที่ค่อยๆ จางลงเมื่อเปิดการตั้งค่าReduce_motion (I58024)

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

• ปรับปรุงเอกสารประกอบสำหรับ angularWidthDp ใน CurvedSize.kt (Iab75c)
• ขณะนี้ SwipeDismissableNavHost จะบันทึกคำเตือนพร้อมสาเหตุที่เป็นไปได้ของ Backstack ที่ว่างเปล่า การดำเนินการนี้มีไว้เพื่อป้องกันไม่ให้เกิดข้อขัดข้องที่ไม่คาดคิดซึ่งเกิดจาก IllegalArgumentException ที่ระบบโยนเมื่อแบ็กสแต็กว่างเปล่า (I04a81, b/277700155)

เวอร์ชัน 1.2.0-alpha10

10 พฤษภาคม 2023

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

ฟีเจอร์ใหม่

• เราได้เพิ่มการรองรับฟีเจอร์ "ปัดเพื่อแสดง" เพื่อเป็นวิธีเข้าถึงการดำเนินการรอง รูปแบบนี้ช่วยเสริมรูปแบบ "กดค้าง" ซึ่งเป็นวิธีที่ผู้ใช้แสดงการกระทำรอง (ที่แตกต่างกัน) ได้ (I60862)

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

• เราได้เพิ่ม RevealScope ไปยัง Action Composable ใน SwipeToReveal ซึ่งช่วยให้เข้าถึงออฟเซ็ตที่มีการแสดงการดำเนินการเพิ่มเติม (I3fd56)

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

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

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

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

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

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

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

เวอร์ชัน 1.2.0-alpha09

19 เมษายน 2023

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

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

• เพิ่ม angularSizeDp ไปยัง CurvedModifier API เพื่อตั้งค่าความกว้างมุมเชิงมุมใน DP (I89a52)

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

• เราได้แก้ไขปัญหาเกี่ยวกับการช่วยเหลือพิเศษในการสาธิตเครื่องมือเลือกเวลา(Id0eb7)

เวอร์ชัน 1.2.0-alpha08

5 เมษายน 2023

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

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

• เราได้เปลี่ยนชื่อ ExpandableItemsState เป็น ExpandableState (If85ea)
• เราได้เพิ่ม expandableButton เพื่อลดความซับซ้อนในการสร้างปุ่มที่ยุบเมื่อขยายเนื้อหา รวมถึงอัปเดตตัวอย่างที่ขยายได้ (Iae309)

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

• ตัวอย่างที่ขยายได้ที่ปรับปรุงแล้วเพื่อแสดงความเป็นไปได้เพิ่มเติม ภาพเคลื่อนไหวที่แก้ไขแล้วของ expandableItem เพื่อรักษาเนื้อหาให้อยู่ตรงกลางผ่านภาพเคลื่อนไหว (I2f637)
• อัปเดต ToggleControls เพื่อหลีกเลี่ยงการจัดองค์ประกอบใหม่เพิ่มเติมเมื่อทำให้สีเคลื่อนไหวด้วยตนเองโดยใช้สถานะ (I5d319)

เวอร์ชัน 1.2.0-alpha07

22 มีนาคม 2023

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

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

• เราได้ย้ายคอมโพเนนต์รายการที่ขยายได้ (เพิ่มใน 1.2.0-alpha06) จากสื่อการเรียนการสอนของชั้นเรียนไปยังองค์ประกอบพื้นฐาน เนื่องจากองค์ประกอบเหล่านี้ไม่มีการอ้างอิงถึง MaterialTheme อย่างมีความหมาย (Ib0525)

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

• เราได้แก้ไขข้อขัดข้องที่เกิดขึ้นในหน้าจอโดยใช้ PickerGroup โดยตรวจสอบว่า PickerGroup จัดการโฟกัสได้อย่างถูกต้องเมื่อไม่มีเครื่องมือเลือกโฟกัสอยู่ นอกจากนี้ ยังเพิ่มการรองรับการเลื่อน RSB ในการสาธิตเครื่องมือเลือกของเราอีกด้วย (If8c19)
• เราได้ปรับปรุงการเปลี่ยนบทพูด กล่าวคือ การเปลี่ยนบทนำจะราบรื่นยิ่งขึ้นเพื่อให้ตรงกับการเปลี่ยนช่วงนอก (Ib5af9)
• เราได้เพิ่ม DefaultTextStyle ลงใน Wear Compose ซึ่งกำหนดค่าเริ่มต้นให้กับพร็อพเพอร์ตี้ PlatformTextStyle.includeFontPadding เป็น true (นี่คือการตั้งค่าปัจจุบัน) ซึ่งจะช่วยให้เราซิงค์ข้อมูลการปิดระยะห่างจากขอบของแบบอักษรโดยค่าเริ่มต้นกับไลบรารีของ Compose ได้ในอนาคต โปรดดู (แก้ไขระยะห่างจากขอบของแบบอักษรใน Compose) สำหรับพื้นหลัง (I2aee8)
• เปลี่ยนกลับทรัพยากร Dependency ของ UpsideDownCake ผ่าน activity-compos ที่บล็อกการเผยแพร่แอปไปยัง Google Play Store (I6443D)

เวอร์ชัน 1.2.0-alpha06

8 มีนาคม 2023

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

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

• เพิ่มคอมโพเนนต์ CurvedBox ซึ่งจะวางคอมโพเนนต์ซ้อนกันในโลกโค้ง (I29200)
• เพิ่มรายการที่ขยายได้ - คอมโพเนนต์ใหม่ 2 รายการเพื่อรองรับกลุ่มรายการที่ขยายได้ใน ScalingLazyColumn หรือรายการที่ขยายได้รายการเดียว เช่น ข้อความที่เพิ่มจำนวนบรรทัด (I95dd5)
• เราได้เพิ่มคำอธิบายประกอบที่กำหนดเองสำหรับการแสดงตัวอย่าง Composable ในหน้าจอ Wear โดย WearPreviewSmallRound แสดงตัวอย่าง Composable ในอุปกรณ์ทรงกลมขนาดเล็ก WearPreviewLargeRound แสดงตัวอย่าง Composable ในอุปกรณ์ทรงกลมขนาดใหญ่ WearPreviewSquare แสดงตัวอย่าง Composable ในอุปกรณ์สี่เหลี่ยมจัตุรัส นอกจากนี้ คำอธิบายประกอบและคำอธิบายประกอบแบบหลายตัวอย่างต่อไปนี้ WearPreviewFontScales จะแสดงตัวอย่าง Composable ในอุปกรณ์ Wear ที่มีแบบอักษรหลายขนาด ขณะที่ WearPreviewDevices แสดงตัวอย่าง Composable ในอุปกรณ์ Wear ที่แตกต่างกัน หากต้องการใช้ตัวอย่างเหล่านี้ คุณต้องใช้ Android Studio เวอร์ชันล่าสุด (Giraffe Canary 6) ขึ้นไป โปรดทราบว่าหากคำอธิบายประกอบเหล่านี้ไม่เหมาะสมกับวัตถุประสงค์ของคุณ ก็จะยังคงใช้ตัวอย่างและรองรับการปรับแต่งเพิ่มเติมผ่านพารามิเตอร์ได้ (I397ff)
• เราได้ทำเครื่องหมาย HierarchicalFocusCoordinator เป็นเวอร์ชันทดลองในขณะที่ระบบพิจารณาว่าเป็นเวอร์ชันที่แนะนำที่จะอยู่ในไลบรารีการเขียนหลัก เนื่องจากมีความเกี่ยวข้องในวงกว้าง (I3a768)

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

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

เวอร์ชัน 1.2.0-alpha05

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

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

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

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

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

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

เวอร์ชัน 1.2.0-alpha04

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

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

ฟีเจอร์ใหม่

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

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

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

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

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

เวอร์ชัน 1.2.0-alpha03

25 มกราคม 2023

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

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

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

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

• เลิกใช้งาน PositionIndicator เนื้อหาการกำหนดเป้าหมาย API ScalingLazyColumn แล้ว โปรดอัปเดตเป็น Foundation.Lazy ScalingLazyColumn นอกจากนี้ ได้เพิ่มช่อง anchorType ลงใน ScalingLazyListLayoutInfo (I29d95)
• ทำเครื่องหมาย ScalingLazyColumn ว่าเลิกใช้งานแล้วในแพ็กเกจ Material ของ Wear Compose (I16d34)
• เราได้อัปเดตตัวแก้ไข ScrollAway เพื่อใช้ ScalingLazyListState จาก Wear Compose Foundation.Lazy และเลิกใช้งานโอเวอร์โหลดที่ใช้ ScalingLazyListState จากเนื้อหา Wear Compose (Ifc42c)
• เราได้อัปเดต Dialog API ไปใช้ ScalingLazyListState จาก Foundation.Lazy และเลิกใช้งานโอเวอร์โหลดที่ใช้ Material ScalingLazyListState (Ic8960) แล้ว
• เราได้อัปเดต 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 ของ Compose ใน Android จะเรียกใช้การส่งเลย์เอาต์สำหรับแต่ละเฟรมเมื่อเรียกใช้เฟรมเพื่อเข้าสู่โหมดไม่มีการใช้งาน (เช่น ผ่าน waitForIdle) ซึ่งอาจส่งผลต่อการทดสอบที่ยืนยันในแต่ละเฟรมของภาพเคลื่อนไหวในเลย์เอาต์ (I8ea08, b/222093277)
• เพิ่มพารามิเตอร์ minLines ลงใน Wear Text เพื่อพฤติกรรมที่สอดคล้องกันกับ BasicText (I24874)
• ตั้งค่า CompactChipTapTargetPadding เป็นแบบสาธารณะแล้วเพื่อให้ปรากฏในเอกสารประกอบ (If1e70, b/234119038)

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

• ปิดใช้บิลด์หลายแพลตฟอร์มสำหรับแพ็กเกจ wear.compose (Iad3d7)
• แก้ไข kdocs สำหรับ scrollToOption (I6f9a0)
• PlaceholderState.rememberPlaceholderState() อัปเดตให้ใช้ rememberUpdatedState ว่ารัฐจะอัปเดตหาก onContentReady lambda (I02635, b/260343754)
• เราได้แก้ไขปัญหาการกระตุกของข้อความที่พบในคอมโพเนนต์ Picker โดยการใช้ประโยชน์จากกลยุทธ์การเรียบเรียงใหม่ที่เพิ่มลงใน Modifier.graphicsLayer (I99302)
• เราได้แก้ไขข้อบกพร่องที่ทำให้เกิดภาพกะพริบในการสาธิต DatePicker (I660bd) แล้ว
• เราได้ปรับปรุงการเข้าถึงสำหรับการสาธิตเครื่องมือเลือกวันที่แบบ 12 ชั่วโมง (I05e12)
• เราได้อัปเดตการสาธิตเครื่องมือเลือกเวลาและวันที่เพื่อให้เครื่องมือเลือกไม่ได้รับผลกระทบจากการเปลี่ยนแปลง RSB เมื่อไม่ได้เลือก (I4aecb)

เวอร์ชัน 1.2.0-alpha01

7 ธันวาคม 2022

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

ฟีเจอร์ใหม่

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

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

• เราได้เพิ่ม HierarchicalFocusCoordinator Composable เพื่อเปิดใช้การทำเครื่องหมายแผนผังย่อยขององค์ประกอบเป็นเปิดใช้โฟกัสหรือปิดใช้โฟกัส (I827cb)
• เราได้เพิ่มพร็อพเพอร์ตี้ใหม่เพื่อลบล้างบทบาทเชิงความหมายสำหรับ ToggleButton (I67132)
• เราได้ปรับปรุง TimeTextDefaults.TimeFormat12Hours เพื่อนำ AM/PM ใน TimeText ออก การดำเนินการนี้จะเปลี่ยนค่าเริ่มต้นของพารามิเตอร์ timeSource ใน TimeText API (I1eb7f)
• เราได้ขยาย Picker API เพื่อปรับปรุงการเข้าถึงสำหรับหน้าจอที่มีตัวเลือกหลายรายการ มีพร็อพเพอร์ตี้ใหม่ userScrollEnabled เพื่อควบคุมว่าเครื่องมือเลือกเปิดใช้งานสำหรับการเลื่อนผู้ใช้หรือไม่ (I3c3aa)

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

• เราได้เปลี่ยนความกว้างเส้นขอบเริ่มต้นของ OutlinedButton/OutlinedCompactButton จาก 2.dp เป็น 1.dp เพื่อให้ตรงกับข้อกำหนดของ UX สุดท้าย (Icf84d)
• เราได้เพิ่ม autoCentering topPadding โดยประมาณเมื่อเนื้อหาว่างเปล่า เพื่อลดผลกระทบของรายการแรกที่เพิ่มไปยัง ScalingLazyColumn ที่ว่างเปล่าซึ่งจะปรากฏขึ้นเพื่อให้เลื่อนเข้าไป การเปลี่ยนแปลงนี้จะคำนวณระยะห่างจากขอบด้านบนที่ต้องใช้โดยสมมติว่ารายการความสูงเริ่มต้น 0.dp สำหรับ ScalingLazyListAnchorType.ItemStart ฟังก์ชันนี้จะคำนวณระยะห่างจากขอบด้านบนที่ถูกต้อง สำหรับ ScalingLazyListAnchorType.ItemCenter การคำนวณนี้จะไม่ถูกต้อง เนื่องจากจำเป็นต้องมีความสูงของรายการเพื่อปรับขนาดเนื้อหาให้ถูกต้อง ซึ่งส่งผลให้มีการเลื่อนขนาดเล็กลงตามความสูงจริงของรายการ (I239a4)
• เราได้อัปเดต Scrim พื้นหลังที่ใช้กับภาพเคลื่อนไหว SwipeToDismiss เพื่อให้ตรงกับแพลตฟอร์ม Wear (I9003e)
• เราได้แก้ไข PositionIndicator การจัดการ LazyListState และ ScalingLazyListState สำหรับรายการขนาด 0 เพื่อหลีกเลี่ยงการหารด้วย 0 ข้อผิดพลาด (Ic28dd)

เวอร์ชัน 1.1

เวอร์ชัน 1.1.2

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

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

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

• เราได้แก้ไขข้อบกพร่องที่ทำให้เกิดการจัดองค์ประกอบใหม่ที่ไม่จำเป็นใน ScalingLazyListState.centerItemIndex โดยตรวจสอบว่าได้พุชการอัปเดตเฉพาะเมื่อค่ามีการเปลี่ยนแปลงจริงๆ เท่านั้น (Ia9f38)

เวอร์ชัน 1.1.1

11 มกราคม 2023

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

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

• PlaceholderState.rememberPlaceholderState() อัปเดตให้ใช้ rememberUpdatedState ว่ารัฐจะอัปเดตหาก onContentReady lambda (I02635, b/260343754)

เวอร์ชัน 1.1.0

7 ธันวาคม 2022

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

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

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

ฟีเจอร์ใหม่

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

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

• เราได้เปลี่ยนความกว้างเส้นขอบเริ่มต้นของ OutlinedButton/OutlinedCompactButton จาก 2.dp เป็น 1.dp เพื่อให้ตรงกับข้อกำหนดของ UX สุดท้าย (Icf84d)
• เราได้เพิ่ม autoCentering topPadding โดยประมาณเมื่อเนื้อหาว่างเปล่า เพื่อลดผลกระทบของรายการแรกที่เพิ่มไปยัง ScalingLazyColumn ที่ว่างเปล่าซึ่งจะปรากฏขึ้นเพื่อให้เลื่อนเข้าไป การเปลี่ยนแปลงนี้จะคำนวณระยะห่างจากขอบด้านบนที่ต้องใช้โดยสมมติว่ารายการความสูงเริ่มต้น 0.dp สำหรับ ScalingLazyListAnchorType.ItemStart ฟังก์ชันนี้จะคำนวณระยะห่างจากขอบด้านบนที่ถูกต้อง สำหรับ ScalingLazyListAnchorType.ItemCenter การคำนวณนี้จะไม่ถูกต้อง เนื่องจากจำเป็นต้องมีความสูงของรายการเพื่อปรับขนาดเนื้อหาให้ถูกต้อง ซึ่งส่งผลให้มีการเลื่อนขนาดเล็กลงตามความสูงจริงของรายการ (I239a4)
• เราได้อัปเดต Scrim พื้นหลังที่ใช้กับภาพเคลื่อนไหว SwipeToDismiss เพื่อให้ตรงกับแพลตฟอร์ม Wear (I9003e)
• เราได้แก้ไข PositionIndicator การจัดการ LazyListState และ ScalingLazyListState สำหรับรายการขนาด 0 เพื่อหลีกเลี่ยงการหารด้วย 0 ข้อผิดพลาด (Ic28dd)

เวอร์ชัน 1.1.0-rc01

9 พฤศจิกายน 2022

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

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

• เราได้เพิ่มกฎโปรไฟล์พื้นฐานสำหรับ Placeholders, ScrollAway, RadioButton, Switch, Checkbox, OutlinedButton, OutlinedCompactButton, OutlinedChip และ OutlinedCompactChip แล้ว (I8249C)
• เราได้แก้ไขข้อบกพร่องใน Modifier.scrollAway โดยหาก itemIndex ที่ระบุไม่ถูกต้อง (เช่น หากดัชนีรายการนั้นอยู่นอกช่วง) TimeText จะยังคงปรากฏ (I2137a)
• เราได้อัปเดตภาพเคลื่อนไหว SwipeToDismissBox ให้ตรงกับการใช้งานแพลตฟอร์มแล้ว หลังจากบีบภาพเคลื่อนไหวครั้งแรก หน้าจอก็จะเลื่อนออกไปทางขวาเมื่อมีการทริกเกอร์การปิด (I41d34)
• เพื่อเป็นการเพิ่มประสิทธิภาพ เราได้อัปเดต Modifier.scrollAway ให้อ่านเฉพาะ scrollState ภายในบล็อกการวัดเพื่อหลีกเลี่ยงการเขียนตัวแก้ไขใหม่หลังจากการวัดอีกครั้งแต่ละครั้ง (I4c6f1)
• เราได้เพิ่มเอกสารประกอบและตัวอย่างไปยังตัวยึดตำแหน่งเพื่อแสดงการจัดลำดับที่ถูกต้องสำหรับ Modifier.placeholder และ Modifier.placeholderShimmer เมื่อใช้กับ Composable เดียวกัน (Ie96f4, b/256583229)
• เราได้เปลี่ยนความกว้างเส้นขอบเริ่มต้นของ OutlinedCompactChip/OutlinedChip จาก 2.dp เป็น 1.dp เพื่อให้ตรงกับข้อกำหนดของ UX สุดท้าย (Ib3d8e)
• เราได้แก้ไขข้อบกพร่องใน rememberPickerState ตรงที่ไม่มีการบันทึกอินพุตที่อัปเดต ดังนั้น Composable จึงไม่อัปเดตหลังจากมีการเปลี่ยนแปลงอินพุต (I49ff6, b/255323197)
• เราได้อัปเดต UI บางส่วนในตัวยึดตำแหน่ง 1) เปลี่ยนการไล่ระดับสีแวววาวเป็น 1.5 เท่าของขนาดหน้าจอ 2) เพิ่มการค่อยๆ เปลี่ยน (ลูกบาศก์เบซิเยร์) และ 3) เร่งภาพเคลื่อนไหวแบบเลื่อนออก (250 มิลลิวินาที) (Id29c1)
• เราได้แก้ไขข้อบกพร่องของ UI ในเอฟเฟกต์ placeholderWipeOff ที่พื้นหลังของชิปและการ์ดเลื่อนออกเร็วขึ้นเล็กน้อยเนื่องจากไม่ได้นำตำแหน่งคอมโพเนนต์บนหน้าจอมาพิจารณา (I2c7cb)
• เราได้อัปเดตการวาดพื้นหลังของตัวยึดตําแหน่งเพื่อรวมสีต่างๆ แทนการเลือกเลเยอร์เหล่านั้นเมื่อเป็นไปได้ เพื่อลดความเสี่ยงในการผสานชั้นอัลฟ่าของเลเยอร์ต่างๆ ที่ครอบตัดแล้วไม่ให้สีที่อยู่เบื้องหลังสามารถแสดงออกมาตรงขอบพื้นหลังของตัวยึดตําแหน่ง (I2ea26)
• เราได้แก้ไขการคำนวณ ScalingLazyListState.centerItemIndex/centerItemOffset เพื่อที่ว่า หากมี 2 รายการอยู่ที่ด้านข้างของเส้นกึ่งกลางวิวพอร์ต รายการแรกที่ใกล้ที่สุดจะถือเป็น centerItem (I30709, b/254257769)
• เราได้แก้ไขข้อบกพร่องใน ScalingLazyListState.layoutInfo.visibleItemsInfo ซึ่งรายงานการชดเชยที่ไม่ถูกต้องในระหว่างการเริ่มต้น ScalingLazyColumn ตอนนี้ระบบจะส่งคืนรายการที่ว่างเปล่าจนกว่ารายการทั้งหมดจะแสดงและมีออฟเซ็ตที่ถูกต้อง การตรวจสอบ ScalingLazyListState.layoutInfo.visibleItemsInfo.isNotEmpty() จะยืนยันว่าการเริ่มต้น ScalingLazyColumn เสร็จสมบูรณ์และแสดงรายการได้ (I3a3b8)

เวอร์ชัน 1.1.0-beta01

24 ตุลาคม 2022

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

ฟีเจอร์ Compose สำหรับ Wear OS 1.1

1.1.0-beta01 ของ Compose สำหรับ Wear OS ระบุว่าไลบรารีรุ่นนี้มีฟีเจอร์สมบูรณ์และ API ล็อกอยู่

• รุ่น Wear Compose 1.1 มีฟังก์ชันใหม่ต่อไปนี้
  • เครื่องมือเลือก - ปรับปรุงการเข้าถึงเครื่องมือเลือก เพื่อให้ไปยังส่วนต่างๆ ของหน้าจอที่มีตัวเลือกหลายรายการได้ด้วยโปรแกรมอ่านหน้าจอ และเข้าถึงคำอธิบายเนื้อหาได้
  • ตอนนี้พารามิเตอร์เครื่องมือเลือก contentDescription จะใช้กับตัวเลือกเครื่องมือเลือกที่เลือกเท่านั้น และใช้สตริงที่เป็นค่าว่าง (ในคอมมิตก่อนหน้า คุณต้องส่งการแมปจากตัวเลือกไปยังคําอธิบายเนื้อหา แต่ใช้เฉพาะตัวเลือกที่เลือกเท่านั้น)
  • ตอนนี้รายการในเครื่องมือเลือกจะอยู่ในแนวกึ่งกลางเสมอ การแก้ไขข้อบกพร่องเมื่อตั้งค่า gradientRatio เป็น 0 จะทำให้เกิดผลข้างเคียงจากการเปลี่ยนการจัดข้อความ
  • Chip/ToggleChip - เราได้อัปเดตการไล่ระดับสีเริ่มต้นสำหรับ Chip/ToggleChip เพื่อให้เป็นไปตามข้อกำหนด UX ล่าสุด ChipDefaults.gradientBackgroundChipColors ได้รับการอัปเดตให้เริ่มจาก 50% ของภาษาหลัก แทนที่จะเป็น 32.5%
  • Chip/ToggleChip - เพิ่มโอเวอร์โหลดสำหรับการแก้ไขรูปร่างชิป
  • Chip/Button/ToggleButton - เพิ่มสไตล์เส้นขอบใหม่สำหรับชิปและปุ่ม รวมถึง Composable ของ OutlinedChip และ OutlinedButton ที่มี Chip/Button แบบโปร่งใสพร้อมเส้นขอบบาง
  • การ์ด - อัปเดตการไล่ระดับสีเริ่มต้นสำหรับการ์ดให้สอดคล้องกับข้อกำหนด UX ล่าสุด CardDefaults.cardBackgroundPainter ได้รับการอัปเดตให้เริ่มจาก 30% ของหลักและสิ้นสุดที่ 20% ของ onSurfaceVariant (จากเดิม 20% เป็น 10% onSurfaceVariant) ToggleChip.toggleChipColors เปลี่ยนจากการไล่ระดับสีแบบเส้นตรงของพื้นผิว 75% เป็นพื้นผิวหลัก 32.5% เป็นพื้นผิว 0% เป็นพื้นผิว 50% หลัก
  • Button/ToggleButton - เพิ่มคุณสมบัติสำหรับการแก้ไขรูปร่างของปุ่ม
  • ธีม - อัปเดตสีเริ่มต้นจำนวนหนึ่งใน MaterialTheme เพื่อปรับปรุงการช่วยเหลือพิเศษเนื่องจากสีเดิมมีคอนทราสต์ไม่เพียงพอซึ่งทำให้ผู้ใช้แยกความแตกต่างระหว่างพื้นหลังของชิป/การ์ด/ปุ่มจากสีพื้นหลังของธีมได้
  • InlineSlider/Stepper - เพิ่มบทบาทของปุ่มเพื่อให้ Talkback ระบุได้ว่าเป็นปุ่ม
  • นั่งร้าน - PositionIndicator มีการวางตำแหน่งและปรับขนาดเพื่อให้ใช้พื้นที่ที่จำเป็นเท่านั้น วิธีนี้มีประโยชน์ เช่น หากมีการเพิ่มข้อมูลเชิงอรรถศาสตร์ ตอนนี้ TalkBack จะได้รับขอบเขตที่ถูกต้องของ PositionIndicator บนหน้าจอ
  • CurvedText/TimeText - เพิ่ม Modifier.scrollAway ซึ่งเลื่อนรายการในแนวตั้ง/ออกจากมุมมอง ตามสถานะการเลื่อน (มีการโหลดมากเกินไปเพื่อให้ทำงานกับ Column, LazyColumn และ ScalingLazyColumn) โดยปกติ ScrollAway จะใช้ในการเลื่อน TimeText ออกจากมุมมองเมื่อผู้ใช้เริ่มเลื่อนรายการขึ้นด้านบน
  • CurvedText/TimeText - เพิ่มการรองรับ fontFamily, fontStyle และ fontSynthesis ใน CurvedTextStyle ซึ่งใช้งานได้ใน curvedText และ basicCurvedText
  • CurvedText/TimeText - เพิ่ม fontWeight ลงในเครื่องมือสร้างและวิธีคัดลอกใน CurvedTextStyle
  • ToggleControls - เพิ่มตัวควบคุมปุ่มสลับ Checkbox, Switch และ RadioButton แบบเคลื่อนไหวสำหรับใช้กับ ToggleChip และ SplitToggleChip ซึ่งอาจใช้แทนไอคอนแบบคงที่ของ ToggleChipDefaults (switchIcon, checkboxIcon และ radioIcon)
  • ตัวยึดตำแหน่ง - เพิ่มการสนับสนุนตัวยึดตำแหน่งแบบทดลอง โดยมีเอฟเฟกต์ภาพ 3 แบบที่แตกต่างกันซึ่งออกแบบมาให้ทำงานร่วมกัน
  • ก่อนอื่น เอฟเฟกต์แปรงพื้นหลังตัวยึดตำแหน่งที่ใช้ในคอนเทนเนอร์ เช่น ชิปและการ์ด เพื่อวาดบนพื้นหลังปกติเมื่อรอให้เนื้อหาโหลด
  • ใช้ตัวแก้ไขที่ 2 (Modifier.placeholder()) เพื่อวาดวิดเจ็ตตัวยึดตำแหน่งรูปทรงสนามกีฬาที่ด้านบนของเนื้อหาที่กําลังโหลด
  • ขั้นที่ 3 เอฟเฟกต์การไล่ระดับสี/แวววาวแบบปรับแต่งได้ (Modifier.placeholderShimmer()) ที่จะแสดงทับเอฟเฟกต์อื่นๆ เพื่อแสดงให้ผู้ใช้เห็นว่าเรากำลังรอให้ข้อมูลโหลดอยู่
    • เอฟเฟ็กต์ทั้งหมดเหล่านี้ได้รับการออกแบบให้ประสานกัน ให้ประกายระยิบระยับ และทำให้ตัดกันเป็นเรียบ
• อัปเดตทรัพยากร Dependency ของ Compose จาก 1.2 เป็น 1.3 แล้ว

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

• ตอนนี้คุณระบุพารามิเตอร์แบบอักษร (fontFamily, fontWeight, fontStyle และ fontSynthesis) โดยตรงเป็นพารามิเตอร์ของ curvedText (Idc422) ได้แล้ว

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

• curveText และ basicCurvedText จะทำงานอย่างถูกต้องกับ talkback (มีโหนด UI เขียนที่มีขนาดเหมาะสมและมีการวาง (แต่ว่างเปล่า) ที่เกี่ยวข้อง โดยใช้ข้อความเป็นคำอธิบายเนื้อหา) (I7af7c, b/210721259)
• แก้ไขข้อบกพร่องของ Picker เมื่อ PickerState.repeatedItems = false เพื่อเพิ่มการตั้งค่าที่ชัดแจ้งของพารามิเตอร์ autoCentering ในเครื่องมือเลือกภายใน ScalingLazyColumn เพื่อให้แน่ใจว่าจะเลื่อนตัวเลือก 0 ไปยังกึ่งกลางของมุมมองได้ (I8a4d7)

เวอร์ชัน 1.1.0-alpha07

5 ตุลาคม 2022

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

ฟีเจอร์ใหม่

• เราได้เพิ่มการรองรับตัวยึดตำแหน่งเวอร์ชันทดลอง โดยมีเอฟเฟกต์ภาพ 3 แบบที่แตกต่างกันซึ่งออกแบบมาให้ทำงานร่วมกัน ก่อนอื่น เอฟเฟกต์แปรงพื้นหลังตัวยึดตำแหน่งที่ใช้ในคอนเทนเนอร์ เช่น ชิปและการ์ด เพื่อวาดบนพื้นหลังปกติเมื่อรอให้เนื้อหาโหลด ใช้ตัวแก้ไขที่ 2 (Modifier.placeholder()) เพื่อวาดวิดเจ็ตตัวยึดตำแหน่งรูปทรงสนามกีฬาที่ด้านบนของเนื้อหาที่กําลังโหลด ขั้นที่ 3 เอฟเฟกต์การไล่ระดับสี/แวววาวแบบปรับแต่งได้ (Modifier.placeholderShimmer()) ที่จะแสดงทับเอฟเฟกต์อื่นๆ เพื่อแสดงให้ผู้ใช้เห็นว่าเรากำลังรอให้ข้อมูลโหลดอยู่ เอฟเฟ็กต์ทั้งหมดเหล่านี้ได้รับการออกแบบให้ประสานกัน ให้ประกายระยิบระยับ และทำให้ตัดกันเป็นเรียบ (I3c339)

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

• เพิ่มการรองรับ fontWeight, fontFamily, fontStyle และ fontSynthesis ใน CurvedTextStyle ใช้ได้บน curvedText และ basicCurvedText โดยสามารถใช้พารามิเตอร์เหล่านั้นเพื่อระบุแบบอักษรและรูปแบบที่จะใช้ในข้อความโค้งได้ (Iaa1a8),(I72759)
• อัปเดตพารามิเตอร์ออฟเซ็ตของ Modifier.scrollAway เป็น Dp เพื่อให้สอดคล้องกับ Modifier.offset (ก่อนหน้านี้เป็นพิกเซล) พร้อมเปลี่ยนโครงสร้างภายในโค้ดเป็น LayoutModifier เพื่อประสิทธิภาพ (I9f94b)
• เราได้เปลี่ยนชื่อ RadioButton’s circleColor เป็น ringColor ใน API การควบคุมการสลับแบบใหม่ (I28fa9)
• เราได้เพิ่มส่วนควบคุมการสลับภาพเคลื่อนไหวของ Checkbox, Switch และ RadioButton เพื่อใช้กับ ToggleChip และ SplitToggleChip ซึ่งอาจใช้แทนไอคอนแบบคงที่ของ ToggleChipDefaults (switchIcon, checkboxIcon และ radioIcon) (I8a8c4)

เวอร์ชัน 1.1.0-alpha06

21 กันยายน 2022

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

ฟีเจอร์ใหม่

• เราได้เพิ่ม Modifier.scrollAway ซึ่งเลื่อนรายการในแนวตั้ง/ออกจากมุมมอง โดยอิงตามสถานะการเลื่อน (โดยมีการโหลดมากเกินไปเพื่อให้ทำงานกับ Column, LazyColumn และ ScalingLazyColumn) โดยทั่วไปแล้ว ScrollAway จะใช้เพื่อเลื่อน TimeText ออกจากมุมมองเมื่อผู้ใช้เริ่มเลื่อนรายการขึ้นไปด้านบน (I61766)

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

• ตอนนี้ PositionIndicator มีการวางตำแหน่งและปรับขนาดเพื่อให้ใช้พื้นที่ว่างที่จำเป็นเท่านั้น วิธีนี้มีประโยชน์ เช่น หากมีการเพิ่มข้อมูลเชิงอรรถศาสตร์ ตอนนี้ TalkBack จะได้รับขอบเขตที่ถูกต้องของ PositionIndicator บนหน้าจอ (Ie6106, b/244409133)

เวอร์ชัน 1.1.0-alpha05

7 กันยายน 2022

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

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

• เพิ่มบทบาทของปุ่มใน InlineSlider และ Stepper แล้ว เพื่อให้ TalkBack จดจำบทบาทเหล่านั้นว่าเป็นปุ่มได้ (Icb46c, b/244260275)
• เราได้แก้ไขลำดับ Z ของสัญญาณบอกสถานะและตัวแสดงหน้าในนั่งร้านแล้ว ตัวบ่งชี้จะอยู่ด้านบนของวิกเน็ตต์ ขอบมืดจึงจะไม่บดบังหากยังมีวิกเน็ตต์อยู่ (Ib988f, b/244207528)

เวอร์ชัน 1.1.0-alpha04

24 สิงหาคม 2022

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

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

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

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

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

เวอร์ชัน 1.1.0-alpha03

10 สิงหาคม 2022

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

ฟีเจอร์ใหม่

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

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

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

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

• เราได้แก้ไขขนาดของพื้นที่ควบคุมการเปิด/ปิดของ ToggleChip เนื่องจากไม่ตรงกับข้อกำหนด UX ข้อกำหนด UX กำหนดให้มีแป้นเว้นวรรค 4.dp ระหว่างป้ายกำกับและพื้นที่ไอคอนควบคุมการสลับ 24x24.dp โดยให้มีความกว้างรวม 28.dp อย่างไรก็ตาม การติดตั้งใช้งานระบุพื้นที่ควบคุมการสลับ 36x24.dp อย่างไม่ถูกต้อง ซึ่งส่งผลให้พื้นที่ 8.dp ของป้ายกำกับข้อความที่ใช้ได้หายไป หมายเหตุ: การแก้ไขข้อบกพร่องนี้จะทำให้มีพื้นที่เพิ่มเติมสำหรับป้ายกำกับข้อความ และผลที่ได้จะส่งผล (เชิงบวก) ต่อการจัดวางข้อความสำหรับข้อความล้น หากมีการทดสอบภาพหน้าจอรวมถึง ToggleChips คุณอาจต้องอัปเดตการทดสอบเหล่านั้น (I514c8, b/240548670)

เวอร์ชัน 1.1.0-alpha02

27 กรกฎาคม 2022

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

ฟีเจอร์ใหม่

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

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

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

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

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

เวอร์ชัน 1.1.0-alpha01

29 มิถุนายน 2022

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

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

• ตอนนี้พารามิเตอร์ contentDescription ของเครื่องมือเลือกจะใช้กับตัวเลือกของเครื่องมือเลือกที่เลือกเท่านั้น และใช้สตริงที่เป็นค่าว่างได้ (ก่อนหน้านี้คุณต้องส่งการแมปจากตัวเลือกไปยังคําอธิบายเนื้อหา แต่ใช้เฉพาะตัวเลือกที่เลือกไว้เท่านั้น) (Ife6a7)
• เราได้ทำการปรับปรุงการเข้าถึงเครื่องมือเลือก เพื่อให้หน้าจอที่มีตัวเลือกหลายหน้าจอสามารถไปยังส่วนต่างๆ ด้วยโปรแกรมอ่านหน้าจอได้และสามารถเข้าถึงคำอธิบายเนื้อหาได้ (I64edb)

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

• เราได้อัปเดตกฎโปรไฟล์พื้นฐานที่แพ็กเกจมาพร้อมกับไลบรารี Wear Compose (I9c694)
• เราได้แก้ไขทิศทางการไล่ระดับสีสำหรับชิปในโหมดขวาไปซ้ายแล้ว จากด้านบนซ้าย->ขวาล่าง เปลี่ยนเป็นด้านบนขวา->ด้านล่างซ้าย (Ic2e77)
• เราได้อัปเดตการไล่ระดับสีเริ่มต้นสำหรับ Chip/ToggleChip/Card เพื่อให้สอดคล้องกับข้อกำหนด UX ล่าสุด ChipDefaults.gradientBackgroundChipColors ได้รับการอัปเดตให้เริ่มจาก 50% ของภาษาหลัก แทนที่จะเป็น 32.5% CardDefaults.cardBackgroundPainter ได้รับการอัปเดตให้เริ่มจาก 30% ของหลักและสิ้นสุดที่ 20% ของ onSurfaceVariant (จากเดิม 20% เป็น 10% onSurfaceVariant) ToggleChip.toggleChipColors เปลี่ยนจากการไล่ระดับสีแบบเส้นตรงของพื้นผิว 75% เป็นพื้นผิวหลัก 32.5% เป็นพื้นผิว 0% เป็นพื้นผิว 50% หลัก (I43bbd)
• เราได้เพิ่มสีพื้นหลัง (MaterialTheme.color.surface) ไว้หลัง Chip/ToggleChips ซึ่งมีพื้นหลังแบบไล่ระดับสีเพื่อให้มองเห็นได้อย่างถูกต้องในกรณีที่มักมีการใช้สีอ่อนด้านหลัง (Ibe1a4, b/235937657)
• ตอนนี้รายการในเครื่องมือเลือกจะอยู่ในแนวกึ่งกลางเสมอ การแก้ไขข้อบกพร่องเมื่อตั้งค่า gradientRatio เป็น 0 จะทำให้เกิดผลข้างเคียงจากการเปลี่ยนการจัดข้อความ (I712b8)

รุ่น 1.0

เวอร์ชัน 1.0.2

7 กันยายน 2022

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

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

• เราได้แก้ไขลำดับ Z ของสัญญาณบอกสถานะและตัวแสดงหน้าในนั่งร้านแล้ว ตัวบ่งชี้จะอยู่ด้านบนของวิกเน็ตต์ ขอบมืดจึงจะไม่บดบังหากยังมีวิกเน็ตต์อยู่ (Ib988f, b/244207528)

เวอร์ชัน 1.0.1

24 สิงหาคม 2022

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

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

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

เวอร์ชัน 1.0.0

27 กรกฎาคม 2022

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

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

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

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

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

เวอร์ชัน 1.0.0-rc02

22 มิถุนายน 2022

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

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

• เราได้แก้ไขทิศทางการไล่ระดับสีสำหรับการ์ดในโหมดขวาไปซ้าย (RTL) แล้ว การตั้งค่าก่อนหน้านี้คือด้านบนซ้าย->ขวาล่าง และตอนนี้อยู่ด้านบนขวา->ล่างซ้าย (Ic2e77)
• เราได้อัปเดตการไล่ระดับสีเริ่มต้นสำหรับ Chip/ToggleChip/Card เพื่อให้เป็นไปตามข้อกำหนด UX ล่าสุด ChipDefaults.gradientBackgroundChipColors ได้รับการอัปเดตให้เริ่มจาก 50% ของภาษาหลัก แทนที่จะเป็น 32.5% CardDefaults.cardBackgroundPainter ได้รับการอัปเดตให้เริ่มจาก 30% ของเวอร์ชันหลักและสิ้นสุดที่ 20% ของ onSurfaceVariant (จากเดิม 20% เป็น 10% ใน SurfaceVariant) ToggleChip.toggleChipColors เปลี่ยนจากการไล่ระดับสีแบบเส้นตรงของพื้นผิว 75% เป็นพื้นผิวหลัก 32.5% เป็นพื้นผิว 0% เป็นพื้นผิวหลัก 50% (I43bbd)
• เราได้เพิ่มสีพื้นหลัง (MaterialTheme.color.surface) ไว้หลัง Chip/ToggleChips ซึ่งมีพื้นหลังแบบไล่ระดับสีเพื่อให้มองเห็นได้อย่างถูกต้องในกรณีที่มักมีการใช้สีอ่อนด้านหลัง (Ibe1a4, b/235937657)
• เราได้อัปเดตกฎโปรไฟล์พื้นฐานที่แพ็กเกจมาพร้อมกับไลบรารี Wear Compose (I9c694)

เวอร์ชัน 1.0.0-rc01

15 มิถุนายน 2022

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

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

• ตอนนี้อินเทอร์เฟซในไลบรารีการเขียนที่สร้างขึ้นโดยใช้เมธอดอินเทอร์เฟซเริ่มต้น jdk8 (I5bcf1)

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

• เราได้นำการเรียก fillMaxWidth() ที่ชัดแจ้งในส่วนหัวของรายการออกแล้วเนื่องจากไม่จำเป็น และอาจทำให้เกิดปัญหาหาก ScalinglazyColumn มีคอมโพเนนต์ ListHeader() และ Chip() ปนกัน เนื่องจากความกว้างมีแนวโน้มที่จะเพิ่ม/หดลงเมื่อมีการเลื่อน ListHeader รายการเข้า/ออก (I37144, b/235074035)
• เราได้แก้ไขข้อบกพร่องใน ScalingLazyColumn ซึ่งอาจส่งผลให้รายการวาดไม่ถูกต้องจนกว่าจะมีการเลื่อน หากรายการที่ 0 มีขนาดใหญ่พอ (รวมถึงระยะห่างจากขอบ) (Ic6159, b/234328517)
• เราได้ทำการปรับเล็กน้อยในการค่อยๆ เปลี่ยนของ ScalingLazyColumn เนื่องจากรายการไปถึงขอบของหน้าจอเพื่อให้ตรงกับการอัปเดตข้อมูลจำเพาะ UX ค่าเดิม CubicBezierEasing(0.25f, 0.00f, 0.75f, 1.00f) -> ค่าใหม่ CubicBezierEasing(0.3f, 0f, 0.7f, 1f) หากต้องการรักษาลักษณะการทำงานเดิมไว้ คุณสามารถลบล้าง scalingParams ของ ScalingLazyColumn (Ie375c)
• เราได้เพิ่มระยะห่างจากขอบใน CompactChip เพื่อให้เป้าหมายการแตะมีขนาดอย่างน้อย 48.dp สูงตามหลักเกณฑ์การช่วยเหลือพิเศษของ Material ซึ่งอาจส่งผลกระทบต่อเลย์เอาต์ใดก็ตามที่คุณใช้ CompactChips เนื่องจากจะใช้พื้นที่เพิ่มเติม (I3d57C)

เวอร์ชัน 1.0.0-beta03

1 มิถุนายน 2022

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

ฟีเจอร์ใหม่

• เราทำให้ ScalingLazyColumn ทำงานในโหมดเขียน @Preview (I3b3b6, b/232947354)

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

• เราได้เปลี่ยนค่าเริ่มต้นสำหรับพร็อพเพอร์ตี้ ScalingLazyColumn.horizontalAlignment จาก "เริ่ม" เป็น CenterHorizontally เพื่อให้มั่นใจว่าเมื่อรายการไม่เต็มความกว้างของคอลัมน์ ระบบจะปรับแนวเพื่อให้แสดงได้สูงสุด วิธีเปลี่ยนกลับไปใช้ชุดลักษณะการทำงานก่อนหน้า horizontalAlignment = Alignment.Start(I9ed4b)

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

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

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

• เดโมใหม่เพื่อให้ภาพเคลื่อนไหวในการเพิ่มหรือนําข้อความเริ่มต้นใน TimeText ออก (I16d75)
• เพิ่มการทดสอบสำหรับ HorizontalPageIndicator.PagesState (I64ed0)
• การอัปเดต TimeText ให้ใกล้เคียงกับข้อกําหนด UX มากขึ้น (Ib7ea1)

เวอร์ชัน 1.0.0-beta02

18 พฤษภาคม 2022

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

ฟีเจอร์ใหม่

• ตอนนี้เครื่องมือเลือกจะตอบสนองต่อเหตุการณ์การเลื่อนเสมอแม้ว่าจะอยู่ในโหมดอ่านอย่างเดียว วิธีนี้จะช่วยให้ผู้ใช้ไม่ต้องเลือกเครื่องมือเลือกด้วยการแตะก่อนที่จะเลื่อนได้ ในโหมดอ่านอย่างเดียว ตัวเลือกอื่นนอกเหนือจากที่เลือกไว้ในปัจจุบันจะถูกบดบังด้วยชิมแปนซีใน gradientColor (I72925)
• เราได้เปลี่ยนลักษณะการทำงานของ UX ของ Chip/ToggleChip/CompactChip/SplitToggleChip เพื่อหยุดการทำงาน fillMaxWidth โดยค่าเริ่มต้น แต่โฆษณาจะขยายให้เหมาะสมกับเนื้อหาของตัวเองแทน หากต้องการเก็บลักษณะการทำงานก่อนหน้าไว้ ให้เพิ่ม modifier = Modifier.fillMaxWidth()(I60a2c, b/232206371)

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

• ตัวสร้าง CurvedTextStyle ที่ใช้ TextStyle ตอนนี้ก็ดำเนินการตาม fontWeight เช่นกัน(อาจเพิ่มลงในตัวสร้างและวิธีการคัดลอกในการแก้ไข API ในอนาคต) (Ieebb9)
• การปรับปรุงการปัดจากขอบ เมื่อมีการใช้ Modifier.edgeSwipeToDismiss และมีการทริกเกอร์การปัดไปทางซ้ายจากพื้นที่ขอบ จะไม่มีการเรียกใช้การปัดเพื่อปิดอีกต่อไปเมื่อทิศทางการปัดเปลี่ยนไปทางขวา ก่อนหน้านี้ สามารถทริกเกอร์การปัดเพื่อปิดได้ด้วยการปัดไปทางซ้ายแล้วปัดไปทางขวา (I916ea)
• ตอนนี้ HorizontalPageIndicator แสดงหน้าบนหน้าจอสูงสุด 6 หน้า หากมีมากกว่า 6 หน้า จะมีสัญญาณบอกสถานะขนาดครึ่งหนึ่งทางด้านซ้ายหรือขวา พร้อมด้วยการเปลี่ยนระหว่างหน้าอย่างราบรื่น (I2ac29)
• ปรับปรุงลักษณะการสแนปเริ่มต้นใน ScalingLazyColumn และ Picker (I49539)
• การปรับปรุงการปัดจากขอบ เมื่อใช้ Modifier.edgeSwipeToDismiss การปัดเพื่อปิดจะทริกเกอร์เฉพาะครั้งแรกที่แตะไปถึงขอบและปัดไปทางขวา ก่อนหน้านี้ การปัดเพื่อปิดสามารถทำได้โดยการเลื่อนจากส่วนใดก็ได้ของหน้าจอหากการเลื่อนมาถึงจุดเริ่มต้นแล้ว (I8ca2a)

เวอร์ชัน 1.0.0-beta01

11 พฤษภาคม 2022

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

ฟีเจอร์ Compose สำหรับ Wear OS 1.0

1.0.0-beta01 ของ Compose สำหรับ Wear OS คือเป้าหมายสำคัญเนื่องจากไลบรารีมีฟีเจอร์สมบูรณ์แล้ว และ API ล็อกอยู่

คอมโพเนนต์ Material ของ Wear Compose ในรุ่น 1.0 ประกอบด้วย

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

• ขอบมืด - ลักษณะหน้าจอที่ใช้ในนั่งร้านที่จะเบลอด้านบนและด้านล่างของหน้าจอเมื่อใช้เนื้อหาที่เลื่อนได้

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

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

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

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

• CurdRow และ CurdColumn - คล้ายกับ Row และ Column คือ curvedRow และ curvedColumn จะซ้อนกันภายใน CurvedLayout เพื่อจัดเลย์เอาต์องค์ประกอบได้ตามต้องการ สำหรับ curvedRow อาจระบุทิศทางของเลย์เอาต์เชิงมุมและการจัดแนวรัศมี สำหรับ curvedColumn อาจระบุการจัดแนวเชิงมุมและทิศทางรัศมี

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

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

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

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

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

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

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

• ตอนนี้ Stepper จะปิดปุ่มลดและเพิ่มเมื่อถึงขีดจำกัดที่ต่ำกว่า/บนแล้ว (และใช้ ContentAlpha.disabled กับ iconColor) (I4be9f)
• เราได้เพิ่มระยะห่างจากขอบ 1dp รอบเนื้อหาของเครื่องมือเลือกเมื่อวาดด้วยการไล่ระดับสีเพื่อไม่ให้เกิดการกระตุกในข้อความที่เห็นเมื่อปัด (I0b7b9)
• เพิ่มการทดสอบภาพหน้าจอสำหรับ PositionIndicator (I5e8bc)
• เพิ่มการทดสอบสำหรับ AppCard และ TitleCard (I85391, b/228869805)

เวอร์ชัน 1.0.0-alpha21

20 เมษายน 2022

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

ฟีเจอร์ใหม่

• เพิ่มตัวปรับแต่งแบบโค้งใหม่เพื่อระบุพื้นหลังขององค์ประกอบแบบโค้ง: CurvedModifier.background, .radialGradientBackground และ .angularGradientBackground (I8f392)
• อนุญาตให้ระบุโหมดข้อความเพิ่มเติมแบบโค้ง (คลิป/จุดไข่ปลา/มองเห็นได้) (I8e7aa)
• เพิ่มตัวแก้ไข CurvedModifier.weight แล้ว ซึ่งคล้ายกับตัวแก้ไขใน Compose ซึ่งใช้ได้กับเด็กที่มีแถวโค้งและ CurvedLayout (สำหรับความกว้าง) และองค์ประกอบย่อยของ CurveColumn (สำหรับความสูง) (I8abbd)
• เพิ่มตัวแก้ไข CurvedModifier.size, .angularSize และ .radialSize เพื่อระบุขนาดขององค์ประกอบที่โค้งแล้ว (I623c7)

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

• เรียงลำดับพารามิเตอร์ใหม่เพื่อให้แน่ใจว่าพื้นหลังอยู่ก่อนสีที่สอดคล้องกันใน Wear Compose API (I43208)
• นำออกตามเข็มนาฬิกาและ insideOut และแทนที่ด้วยค่าคงที่ที่สื่อความหมายได้ดีกว่าในคลาสใหม่ ตอนนี้สามารถรับรู้ LayoutDirection ทิศทางของเลย์เอาต์แบบโค้งได้ และจะรับค่าเดิมเมื่อไม่ได้ระบุ (If0e6a)
• เราได้แทนที่ autoCenter: Boolean ด้วย autoCenter: AutoCentringParams เพื่อแก้ไขปัญหา API ของ ScalingLazyColumn แล้ว (Ia9c90)
• เราได้เปลี่ยนชื่อ iconTintColor และ toggleControlTintColor เป็น iconColor และ toggleControlColor ทั่วทั้ง API (Chip/ToggleChip/Dialog/Slider/Stepper/...) เนื่องจากมีการใช้สีกับช่อง icon/toggleControl (Ied238)
• เขียน enum ของ PageIndicatorStyle ใหม่เป็นคลาสค่า (I2dc72)
• เราได้เพิ่ม RowScope/ColumnScope/BoxScope ลงในช่องโฆษณาบางส่วนใน Composable เพื่อระบุให้นักพัฒนาแอปทราบถึงการคาดคะเนของเลย์เอาต์ ซึ่งจะช่วยให้นักพัฒนาซอฟต์แวร์สามารถใช้ตัวปรับแต่งเพิ่มเติมในเนื้อหาช่องบางส่วนได้และไม่จำเป็นต้องเพิ่มองค์ประกอบเลย์เอาต์เพิ่มเติม นอกจากนี้ เรายังอัปเดตสี AppCard/TitleCard เล็กน้อยเพื่อให้ timeColor และ appColor มีค่าเริ่มต้นเป็น contentColor นอกจากนี้ ระบบยังคงลบล้างพร็อพเพอร์ตี้เหล่านี้ได้ทีละรายการหากจำเป็น (I26B59)
• ทำให้ออบเจ็กต์ SwipeToDismissBoxState.Companion เป็นแบบส่วนตัว (I39e84)
• แก้ไขลำดับพารามิเตอร์สำหรับ InlineSlider และ Stepper การเปลี่ยนแปลงง่ายๆ เพื่อให้เป็นไปตามหลักเกณฑ์ API (I11fec)
• เราได้นำออบเจ็กต์โปรแกรมประหยัดสำหรับ SwipeToDismissBoxState ออกแล้วเนื่องจากไม่มีการใช้งาน (Ifb54e)
• เราได้อัปเดต CompactChip ให้สอดคล้องกับข้อกำหนด UX ล่าสุด ระยะห่างจากขอบได้ลดลงเป็นแนวนอน = 12.dp และแนวตั้ง = 0.dp แบบอักษรของป้ายกำกับเปลี่ยนจากปุ่มเป็นคำอธิบายภาพ 1 เมื่อมีไอคอนและป้ายกำกับอยู่ ขนาดไอคอนที่แนะนำคือ 20x20 และมีขนาด 24x24 สำหรับชิปไอคอนที่กะทัดรัดเท่านั้น สำหรับกรณีการใช้งานของไอคอนเท่านั้น เรายังได้ตรวจสอบให้ไอคอนอยู่ในแนวกึ่งกลางแล้ว (Iea2be)
• เราได้เพิ่มช่องใหม่จำนวนหนึ่งลงใน ScalingLazyListLayoutInfo เพื่อให้นักพัฒนาแอปทราบจำนวน contentPadding และ autoCenteringPadding ที่มีการนำไปใช้แล้ว ซึ่งอาจเป็นประโยชน์สำหรับนักพัฒนาซอฟต์แวร์ในการคำนวณการปัด/เลื่อน (I7577b)
• เราได้ติดตั้งใช้งานการเปลี่ยนเข้า/ออกสำหรับกล่องโต้ตอบ เพิ่มพารามิเตอร์ showDialog แล้ว ตอนนี้กล่องโต้ตอบจะควบคุมระดับการมองเห็นของตัวเอง (ซึ่งทำให้กล่องโต้ตอบเรียกใช้ภาพเคลื่อนไหวช่วงอินโทรและเอาต์โทรเมื่อแสดง/ซ่อนกล่องโต้ตอบได้) โปรดทราบว่าภาพเคลื่อนไหวช่วงปิดท้ายจะไม่ทำงานเมื่อผู้ใช้ออกจากกล่องโต้ตอบผ่านการปัดเพื่อปิด นอกจากนี้ เรายังเพิ่มค่าเริ่มต้นสำหรับสถานะในการโอเวอร์โหลด SwipeToDismissBox ที่เพิ่งเพิ่มเมื่อเร็วๆ นี้ (I682a0)
• เราได้เปลี่ยน ToggleChip และ SplitToggleChip เพื่อไม่ให้มีค่าเริ่มต้นสำหรับช่อง toggleControl อีกต่อไปเพื่อให้รองรับ i18n และ a11y ได้ดียิ่งขึ้น เรายังได้เปลี่ยน ToggleChipDefaults เพื่อให้เมธอดต่อไปนี้แสดงผล ImageVector แทนที่จะเป็น Icon (โปรดทราบว่าเมื่อไม่แสดงผล @Composables แล้ว ระบบจึงเปลี่ยนให้ขึ้นต้นด้วยตัวพิมพ์เล็ก) SwitchIcon()->switchIcon(), CheckboxIcon->checkboxIcon() และ RadioIcon()->radioIcon() วิธีนี้ช่วยและสนับสนุนให้นักพัฒนาซอฟต์แวร์สร้าง Composable ของ Icon() ด้วยชุด contentDescription ที่เหมาะสม (I5bb5b)
• เราได้เพิ่มพารามิเตอร์ SwipeDismissableNavHostState ลงใน SwipeDismissableNavHost แล้ว วิธีนี้รองรับการใช้การปัดขอบบนหน้าจอที่ใช้เป็นปลายทางการนำทาง เนื่องจากตอนนี้สามารถรอก SwipeToDismissBoxState และใช้เพื่อเริ่มต้นทั้ง SwipeDismissableNavHostState และ Modifier.edgeSwipeToDismiss ในหน้าจอที่ต้องมีการเลื่อนขอบได้แล้ว (I819f5, b/228336555)

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

• ตรวจสอบว่ามีการอัปเดตเลย์เอาต์แบบโค้งเมื่อจำเป็น (Ie8bfa, b/229079150)
• แก้ไขข้อบกพร่องสำหรับ https://issuetracker.google.com/issues/226648931 (Ia0a0a, b/226648931)
• นำคำอธิบายประกอบการทดลองที่ไม่จำเป็นออก (I88d7e)

เวอร์ชัน 1.0.0-alpha20

6 เมษายน 2022

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

ฟีเจอร์ใหม่

• เพิ่มตัวแก้ไข edgeSwipeToDismiss สำหรับ SwipeToDismiss อนุญาตให้ swipeToDismiss ทำงานเฉพาะตรงขอบด้านซ้ายของวิวพอร์ตเท่านั้น ใช้เมื่อต้องการที่กึ่งกลางของหน้าจอจะต้องจัดการกับการแบ่งหน้าตามแนวนอนได้ เช่น การเลื่อนแผนที่แบบ 2 มิติ หรือการเลื่อนระหว่างหน้าต่างๆ ในแนวนอน (I3fcec, b/200699800)

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

• การนำ CurvedModifiers มาใช้พื้นฐานนี้ถือเป็นการเปิดโอกาสในการปรับแต่งเนื้อหาแบบโค้ง (แต่ยังไม่ให้บริการ CurvedModifiers และอาจสร้างตัวแก้ไขที่กำหนดเองในภายหลังได้) (I9b8df)
• EdgeSwipeเอกสารประกอบของตัวแก้ไขและค่าเริ่มต้นที่อัปเดตเพื่อให้เข้าใจได้ดียิ่งขึ้น (I6d00d)
• เพิ่ม PageIndicator ช่องลงในนั่งร้าน การเพิ่ม PageIndicator ลงใน Scaffold โดยตรงอาจทำให้เรารับรองว่าโฆษณาจะแสดงบนอุปกรณ์ที่เป็นวงกลมได้อย่างถูกต้อง (Ia6042)
• นำไอคอนเริ่มต้นออกจากพารามิเตอร์ InlineSlider และ Stepper ซึ่งจะช่วยให้นักพัฒนาแอปให้ความสำคัญกับข้อกำหนดด้านการแปลและการช่วยเหลือพิเศษมากขึ้น การใช้งานไอคอนเริ่มต้นจะแสดงในการสาธิตและตัวอย่าง (I7e6fd)
• แทนที่ชื่อพารามิเตอร์ต่อท้ายและนำหน้าด้วย "เริ่มต้น" และ "สิ้นสุด" ใน TimeText (Iaac32)
• เราได้เพิ่ม SwipeToDismissBox โอเวอร์โหลดที่มีพารามิเตอร์ onDismissed เพื่อรองรับการใช้งานทั่วไปในการทริกเกอร์เหตุการณ์การนำทางเมื่อท่าทางสัมผัสการปัดเสร็จสมบูรณ์ (I50353, b/226565726)
• นำคำอธิบายประกอบ ExperimentalWearMaterialApi ออกจากการใช้งาน TimeText (Ide520)
• เราได้ทำเครื่องหมายขอบเขตและอินเทอร์เฟซข้อมูลของ ScalingLazyList/Column เป็น "ปิดผนึก" เนื่องจากไม่มีวัตถุประสงค์ให้นักพัฒนาแอปภายนอกใช้งาน และวิธีนี้จะช่วยให้เราเพิ่มสมาชิกใหม่ๆ ได้ในอนาคตโดยไม่มีการเปลี่ยนแปลงการแบ่งไบนารี (I7d99f)
• เราได้เพิ่มพร็อพเพอร์ตี้ flingBehaviour ใหม่ลงในเครื่องมือเลือกและเมธอด PickerDefaults.flingBehaviour() เพื่อเปิดใช้การกําหนดค่าลักษณะการส่งเนื้อหา เช่น การเพิ่มการรองรับ RSB ตอนนี้ PickerState จะใช้อินเทอร์เฟซ ScrollableState (Ib89c7)

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

• อัปเดตกฎโปรไฟล์พื้นฐานของ Android Runtime (ART) สำหรับไลบรารี Wear Compose ART สามารถใช้กฎโปรไฟล์ในอุปกรณ์เพื่อรวบรวมชุดย่อยที่เจาะจงของแอปพลิเคชันได้ล่วงหน้าเพื่อปรับปรุงประสิทธิภาพของแอปพลิเคชัน โปรดทราบว่าการดำเนินการนี้จะไม่มีผลต่อแอปพลิเคชันที่แก้ไขข้อบกพร่องได้ (Iaa8ef)
• ปรับปรุงเอกสาร (I2c051)

เวอร์ชัน 1.0.0-alpha19

23 มีนาคม 2022

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

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

• เปลี่ยนชื่อ CurvedRow เป็น CurvedLayout และปรับปรุงใหม่ให้เป็นขอบเขตที่มี DSL แล้ว เมื่อใช้ DSL นี้ คุณจะระบุเลย์เอาต์แบบโค้งที่ซับซ้อนได้โดยใช้ชุดของ curvedRow และ curvedColumn แบบซ้อนกัน (ซึ่งเป็นเลย์เอาต์แบบโค้งที่เทียบเท่ากับแถวและคอลัมน์) ภายในองค์ประกอบเลย์เอาต์เหล่านี้สามารถใช้องค์ประกอบ 3 รายการ ได้แก่ curvedComposable (เพื่อเพิ่ม @Composable ใดก็ได้), basicCurvedText (ข้อความโค้งของรากฐาน) และ curvedText (ข้อความโค้งที่รับรู้ตัววัสดุ) (Ib776a)
• ทำให้ด้านของ PositionIndicator กำหนดค่าได้ ขณะนี้คุณสามารถกำหนดค่าตำแหน่งพื้นฐานของ PositionIndicator ให้เป็น End (ออกแบบทิศทางรับรู้), OppositeRsb (พิจารณาในการหมุนหน้าจอด้วย เพื่อกำหนดตำแหน่งให้ตรงข้ามกับ RSB จริง) หรือค่าสัมบูรณ์ของซ้าย & ขวา (I2f1f3)
• สำหรับ SwipeToDismissBox เราได้เปลี่ยนชื่อ SwipeDismissTarget โดยเปลี่ยนชื่อต้นฉบับเป็น SwipeToDismissValue.Default และ SwipeDismissTarget.Dismissal เป็น SwipeToDismissValue.Dismissed และได้ย้าย SwipeToDismissBoxDefaults.BackgroundKey และ SwipeToDismissBoxDefaults.ContentKey ไปยัง SwipeToDismissKeys.Background ใน SwipeToDismissKeys.Content ตามลำดับ (I47a36)
• เราได้เพิ่มโหมดอ่านอย่างเดียวลงในเครื่องมือเลือกสำหรับหน้าจอที่มีเครื่องมือเลือกหลายรายการ โดยจะแก้ไขเครื่องมือเลือกได้ครั้งละ 1 รายการเท่านั้น เมื่อเครื่องมือเลือกเป็นแบบอ่านอย่างเดียว เครื่องมือเลือกจะแสดงตัวเลือกที่เลือกในปัจจุบัน รวมทั้งป้ายกำกับหากมีการระบุไว้ (I879de)
• SwipeToDismissBoxState เปลี่ยนโครงสร้างภายในโค้ดเพื่อจำกัดขอบเขตของ ExperimentalWearMaterialApi เป็น Modifier.swipeable และ SwipeableState แล้ว ซึ่งขณะนี้จะใช้ภายใน ขณะนี้ SwipeToDismissBoxState มีสมาชิก currentValue, targetValue, isAnimationRunning และ snapTo เพื่อรองรับกรณีการใช้งานทั่วไป โปรดแจ้งให้เราทราบหากต้องการให้แสดงพร็อพเพอร์ตี้เพิ่มเติม รวมถึงแก้ไขลักษณะการทำงานของ SwipeableState ในกรณีที่ออฟเซ็ตการเลื่อนอยู่ภายในข้อผิดพลาดในการปัดเศษของ Anchor (I58302)

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

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

เวอร์ชัน 1.0.0-alpha18

9 มีนาคม 2022

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

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

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

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

• หยุดภาพเคลื่อนไหวของการสแนปเมื่อเราไปถึง (Idb69d)
• สร้างภาพเคลื่อนไหวใน PositionIndicator (I94cb9)
• ตามความคิดเห็นเกี่ยวกับ UI/UX เราได้เปลี่ยนแปลงการจัดกึ่งกลางอัตโนมัติของ ScalingLazyColumn ให้มีพื้นที่เพียงพอที่จะดูแลให้รายการที่มีดัชนี ScalingLazyListState.initialCenterItemIndex ขึ้นไปจะเลื่อนไปยังกึ่งกลางของวิวพอร์ตได้อย่างสมบูรณ์ วิธีนี้ช่วยให้นักพัฒนาแอปวางรายการเกี่ยวกับรายการนั้นไว้ตรงกลาง 1 หรือ 2 รายการได้ ซึ่งไม่สามารถเลื่อนตรงกลางได้ ซึ่งหมายความว่า ScalingLazyColumn ของ AutoCenter จะเลื่อนเหนือ initialCenterItemIndex/initialCenterItemScrollOffset (I22ee2) ไม่ได้
• เราได้เพิ่มการสาธิตสำหรับเครื่องมือเลือกวันที่ และแก้ไขข้อบกพร่องใน PickerState ซึ่งระบบไม่มีการใช้ EuropeanSelectedOption จนกว่าเครื่องมือเลือกวันที่จะปรากฏ (Id0d7e)
• เราได้เพิ่มระยะห่างจากขอบของเนื้อหาแนวนอนเริ่มต้นจาก 8 เป็น 10 dp เพื่อลดการตัดรายการ ScalingLazyColumn ที่กว้างขึ้นบนหน้าจอวงกลม (I0d609)
• ตรวจสอบว่า PositionIndicator ปรากฏขึ้นเมื่อเลื่อน (Ied9a2)

เวอร์ชัน 1.0.0-alpha17

23 กุมภาพันธ์ 2022

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

ฟีเจอร์ใหม่

• เราได้เพิ่มการรองรับการสแนปที่สามารถใช้กับ ScalingLazyColumn ตั้งค่า flingBehavior = ScalingLazyColumnDefaults.flingWithSnapBehavior(state) เพื่อเปิดใช้การรองรับ Snap (I068d3, b/217377069)
• เราได้เพิ่มการสาธิตสำหรับเครื่องมือเลือก เลือกเวลาในรูปแบบ 24 ชั่วโมงหรือ 12 ชั่วโมง (Ie5552)

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

• แก้ไขปัญหาเกี่ยวกับแบบอักษรและแบบอักษรที่กำหนดเอง TimeText รายการ รูปแบบในอุปกรณ์สี่เหลี่ยมจัตุรัส (Iea76e)
• ตอนนี้ ScalingLazyListLayoutInfo มี reverseLayout, viewportSize และพร็อพเพอร์ตี้การวางแนวที่ตรงกับพร็อพเพอร์ตี้จาก LazyListLayoutInfo (I4f258, b/217917020)
• ตอนนี้ ScalingLazyColumn มีที่พัก userScrollEnabled ที่ตรงกับจาก LazyList (I164d0, b/217912513)
• ตอนนี้เครื่องมือเลือกจะมีการไล่ระดับสีด้านบนและด้านล่างโดยค่าเริ่มต้น (Iab92a)

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

• เราได้แก้ไข ScalingLazyColumn เพื่อไม่ให้เติมพื้นที่ทั้งหมดในระดับบนสุดอีกต่อไป แต่จะนำขนาดมาจากขนาดของเนื้อหาแทน การดำเนินการนี้สอดคล้องกับลักษณะการทำงานของ LazyColumn หากต้องการกู้คืนลักษณะการทำงานเดิม ให้ส่ง Modifier.fillMaxWidth()/width()/widthIn() ไปยัง ScalingLazyColumn (I51bf8)
• เราได้ปรับปรุงข้อความข้อยกเว้นใน SwipeDismissableNavHost.kt ที่จะถูกเรียกใช้หากแบ็กสแต็กการนำทางว่างเปล่า (I1b1dc)

เวอร์ชัน 1.0.0-alpha16

9 กุมภาพันธ์ 2022

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

ฟีเจอร์ใหม่

• เพิ่ม CircularProgressIndicator สัญญาณบอกสถานะความคืบหน้าจะแสดงความยาวของกระบวนการหรือเวลารอที่ไม่ระบุ รองรับช่องว่าง (ตัดออก) สำหรับ TimeText หรือคอมโพเนนต์อื่นๆ หากใช้งานแบบเต็มหน้าจอ (Iab8da)

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

• ตอนนี้เครื่องมือเลือกมีพารามิเตอร์ flingBehavior ค่าเริ่มต้นจะจัดไปยังตัวเลือกที่ใกล้ที่สุดเมื่อเลื่อน/ขว้าง (I09000)
• API จำนวนเต็มเพิ่มเติมสำหรับ inlineSlider และ Stepper (I1b5d6)

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

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

เวอร์ชัน 1.0.0-alpha15

26 มกราคม 2022

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

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

• เราได้เพิ่มพร็อพเพอร์ตี้ใหม่ autoCentering ลงใน ScalingLazyColumn เมื่อเป็นจริง (ค่าเริ่มต้น) วิธีนี้จะช่วยเลื่อนรายการทั้งหมด ซึ่งรวมถึงรายการแรกและสุดท้าย เพื่อให้รายการปรากฏตรงกลางวิวพอร์ตของรายการ โปรดทราบว่าหากใช้การจัดกึ่งกลางอัตโนมัติ คุณอาจต้องตั้งค่าระยะห่างจากขอบของเนื้อหาแนวตั้งเป็น 0.dp หากมีการจัดกึ่งกลางอัตโนมัติและระยะห่างจากขอบของเนื้อหาแนวตั้ง ก็จะทำให้มีพื้นที่ว่างเพิ่มเติมก่อนรายการแรกและหลังรายการสุดท้าย ซึ่งทำให้เลื่อนได้ไกลขึ้น (I2a282, b/214922490)
• เราได้เพิ่มคอมโพเนนต์ Dialog ที่ช่วยให้ Composable สามารถทริกเกอร์กล่องโต้ตอบแบบเต็มหน้าจอที่อยู่บนเนื้อหาอื่นๆ เมื่อแสดง กล่องโต้ตอบจะรองรับการปัดเพื่อปิดและจะแสดงเนื้อหาของผู้ปกครองในพื้นหลังระหว่างท่าทางสัมผัสการปัด เนื้อหาของกล่องโต้ตอบควรเป็น Alert หรือ Confirmation (เปลี่ยนชื่อจากคอมโพเนนต์ก่อนหน้า AlertDialog และ ConfirmationDialog) แต่ Alert, Confirmation และ Dialog ทั้งหมดอยู่ในแพ็กเกจ androidx.wear.compose.material.dialog ใช้การแจ้งเตือนและการยืนยันเป็นปลายทางการนำทางได้ นอกจากนี้ ได้เพิ่ม ColumnScope ในพารามิเตอร์การแจ้งเตือนและการยืนยันตามที่จำเป็น (Ia9014)
• เราได้นำ onSurfaceVariant2 ออกจาก Compose สำหรับสีธีม Material ของ WearOS และแทนที่การใช้งานในไลบรารีด้วย onSurfaceVariant แล้ว (Icd592)
• เพิ่มเมธอดในการเลือกตัวเลือกแบบเป็นโปรแกรมใน PickerState ตอนนี้สามารถระบุตัวเลือกที่เลือกไว้ในตอนแรกได้ด้วยเมื่อสร้าง PickerState (I92bdf)
• เราได้เพิ่มการรองรับการปรับแต่งลักษณะการสะบัดของ ScalingLazyColumn (I1ad2e, b/208842968)
• เราได้เพิ่ม NavController.currentBackStackEntryAsState() ลงในไลบรารี Wear.Compose.Navigation แล้ว (If9028, b/212739653)
• เพิ่ม Modifier.onRotaryScrollEvent() และ Modifier.onPreRotaryScrollEvent() สำหรับอุปกรณ์ Wear ที่มีปุ่มด้านข้าง (I18bf5, b/210748686)

เวอร์ชัน 1.0.0-alpha14

12 มกราคม 2022

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

ฟีเจอร์ใหม่

• เราได้เพิ่มวิธีการจำนวนหนึ่งลงใน ScalingLazyListState เพื่อให้นักพัฒนาซอฟต์แวร์สามารถควบคุมการเลื่อนไปยังรายการที่ต้องการ รวมถึงการตั้งค่ารายการเริ่มต้นและออฟเซ็ตด้วย

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

  มีการเพิ่มพร็อพเพอร์ตี้ anchorType: ScalingLazyListAnchorType = ScalingLazyListAnchorType.ItemCenter ลงใน ScalingLazyList เพื่อควบคุมว่ากึ่งกลาง (ScalingLazyListAnchorType.ItemCenter) หรือ Edge (ScalingLazyListAnchorType.ItemStart) ควรอยู่ในแนวเส้นกึ่งกลางของวิวพอร์ต

  ด้วยเหตุนี้ ScalingLazyListItemInfo.offset และ ScalingLazyListItemInfo.adjustedOffset จึงมีการเปลี่ยนแปลง และในตอนนี้จะแสดงค่าออฟเซ็ตของรายการที่เกี่ยวข้องกับทั้งตำแหน่งของรายการและ anchorType ของรายการ เช่น สำหรับ ScalingLazyColumn ที่มี anchorType เป็น ItemCenter และรายการที่กำหนดตำแหน่งตรงกลางที่เส้นกึ่งกลางของวิวพอร์ตจะเป็น 0

  เมธอดใหม่ได้แก่ scrollTo, animatedScrollTo, centerItemIndex และ centerItemOffset (I61b61)

• เราได้เพิ่มเครื่องจัดการปุ่มกลับลงใน SwipeDismissableNavHost เพื่อให้การกดกลับเป็นการนำทางไปยังระดับก่อนหน้าในลำดับชั้นการนำทาง (I5b086, b/210205624)

เวอร์ชัน 1.0.0-alpha13

15 ธันวาคม 2021

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

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

• เราทำ RangeIcons เป็นการภายใน (อ้างอิงภายในโดย InlineSlider และ Stepper) (I927ec)

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

• แก้ไขปัญหาที่ SwipeDismissableNavHost เพิ่มปลายทางไปยังลำดับชั้น Compose ก่อนที่จะมาถึงสถานะวงจร CREATED ซึ่งส่งผลให้เกิด IllegalStateException การแก้ไขนี้เป็นข้อกำหนดเบื้องต้นในการอัปเดตทรัพยากร Dependency จาก navigation-compose เป็น 2.4.0-beta02 ขึ้นไป (I40a2b, b/207328687)

• เพิ่มคลาส Drawables enum สำหรับการรับทรัพยากรที่ถอนออกได้ภายในไลบรารี Wear Compose ทำให้ไม่ต้องใช้การทบทวนอีกแล้ว การดำเนินการนี้แก้ไขข้อบกพร่องที่มีการนำเนื้อหาที่ถอนออกได้ในคลังออกเมื่อ minifyEnabled=true หรือ shrinkResources=true) (Ib2a98)

• เพิ่มการทดสอบสำหรับ Stepper ใน Wear Compose (I2d03a)

• เพิ่มตัวอย่างสำหรับ SwipeDismissableNavHost ในการนำทางของ Wear Compose (I85f06)

เวอร์ชัน 1.0.0-alpha12

1 ธันวาคม 2021

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

ฟีเจอร์ใหม่

• เราได้เพิ่มคอมโพเนนต์ Stepper ที่ให้ผู้ใช้สามารถเลือกจากช่วงค่าต่างๆ ได้ สเตปเปอร์เป็นการควบคุมแบบเต็มหน้าจอที่มีปุ่มเพิ่มและลดที่ด้านบนและด้านล่าง และมีช่องที่อยู่ตรงกลาง (อาจมีชิปหรือข้อความก็ได้) สามารถปรับแต่งไอคอนปุ่มได้หากจำเป็น (I625fe)

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

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

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

เวอร์ชัน 1.0.0-alpha11

17 พฤศจิกายน 2021

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

ฟีเจอร์ใหม่

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

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

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

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

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

เวอร์ชัน 1.0.0-alpha10

3 พฤศจิกายน 2021

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

ฟีเจอร์ใหม่

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

• ดู Compose ใหม่สำหรับ WearOS Codelab

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

• ตอนนี้การเปรียบเทียบมาโครมี minSdkVersion ที่ 23 (If2655)

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

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

เวอร์ชัน 1.0.0-alpha09

27 ตุลาคม 2021

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

ฟีเจอร์ใหม่

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

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

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

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

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

เวอร์ชัน 1.0.0-alpha08

13 ตุลาคม 2021

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

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

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

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

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

เวอร์ชัน 1.0.0-alpha07

29 กันยายน 2021

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

ฟีเจอร์ใหม่

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

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

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

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

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

เวอร์ชัน 1.0.0-alpha06

15 กันยายน 2021

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

ฟีเจอร์ใหม่

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

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

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

• รุ่นแรกนี้มีฟีเจอร์ต่างๆ ดังต่อไปนี้

  • SwipeDismissableNavHost Composable ที่โฮสต์กราฟการนำทางและแสดงการนำทางย้อนกลับผ่านท่าทางสัมผัสการปัด
  • ส่วนขยาย NavGraphBuilder.composable เพื่อช่วยในการสร้างกราฟการนำทาง
  • rememberSwipeDismissableNavController() เพื่ออนุญาตสถานะรอก

• ตัวอย่างการใช้งานที่เราสร้าง 2 หน้าจอและสลับไปมาระหว่างหน้าจอแต่ละแบบ

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

• การนำทางของ Wear Compose จัดไว้เป็นไลบรารีแยกต่างหากเพื่อให้แอปพลิเคชัน Wear Compose แบบง่ายที่ใช้การนำทางแบบใช้มือม้วนขึ้นเองไม่จำเป็นต้องใช้ไลบรารีการนำทางของ Androidx

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

• อัปเดต SwipeDismissableNavHost ให้รองรับแล้ว rememberSaveable โดยการตั้งค่าข้อมูลประจำตัวหลักสำหรับพื้นหลังและเนื้อหา (I746fd)
• เราได้เพิ่มอะแดปเตอร์ PositionIndicator ที่สามารถจัดการ LazyListState (I21b88)
• อัปเดต ScrollToOffBox เพื่อสนับสนุน RememberSaveable (Ie728b)
• เราได้เพิ่มการสนับสนุน ReverseLayout ใน ScalingLazyColumn การดำเนินการนี้ช่วยให้มีการกลับทิศทางการเลื่อนและเลย์เอาต์ (I9e2fc)
• เลิกใช้งาน performGesture และ GestureScope ซึ่งมี ถูกแทนที่ด้วย performTouchInput และ TouchInjectionScope (Ia5f3f, b/190493367)
• เราเปลี่ยนชื่อ VignetteValue เป็น VignettePosition และเปลี่ยนชื่อ VignetteValue โดยทั้ง 2 ประเภทเปลี่ยนชื่อเป็น VignettePosition.TopAndBottom (I57ad7)
• เราได้เปลี่ยนชื่อ ScalingLazyColumnState เป็น ScalingLazyListState, ScalingLazyColumnItemInfo เป็น ScalingLazyListItemInfo, ScalingLazyColumnLayoutInfo เป็น ScalingLazyListLayoutInfo และ ScalingLazyColumnScope เป็น ScalingLazyListScope ในกรณีที่ตัดสินใจเพิ่มการติดตั้งใช้งาน Scaling ในอนาคต (I22734)

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

• อัปเดตเอกสารประกอบของ CompactChip เพื่ออธิบายสิ่งที่จะเกิดขึ้นหากไม่ได้ระบุไอคอนหรือป้ายกำกับ (I4ba88)
• เราได้ทำการปรับเปลี่ยนบางอย่างในคอมโพเนนต์การ์ด Wear (I6B3d0)
  1. ระยะห่างของการ์ดไตเติ้ลระหว่างชื่อและเนื้อหาลดลงจาก 8.dp เป็น 2.dp
  2. เปลี่ยนแบบอักษรของส่วนหัว TitleCard จากเนื้อหาเป็น 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)

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

• เราได้ลดระยะห่างระหว่างไอคอนกับข้อความในชิปและ SwitchChip เพื่อให้สอดคล้องกันกับการอัปเดตข้อกำหนด UX (I83802)

เวอร์ชัน 1.0.0-alpha04

18 สิงหาคม 2021

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

ฟีเจอร์ใหม่

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

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

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

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

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

เวอร์ชัน 1.0.0-alpha03

4 สิงหาคม 2021

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

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

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

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

• เราเปลี่ยนสีเริ่มต้นของเนื้อหา appName ใน AppCard เพื่อตอบสนองต่อการอัปเดตข้อกำหนด UX ตอนนี้สีเริ่มต้นของ appName คือ MaterialTheme.colors.onSurfaceVariant นอกจากนี้ได้เพิ่มคำอธิบายเอกสารพารามิเตอร์ที่ขาดหายไปสำหรับช่องชื่อ (Ic4ad1)

เวอร์ชัน 1.0.0-alpha02

21 กรกฎาคม 2021

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

ฟีเจอร์ใหม่

• เพิ่มคลาส CurvedRow ใหม่ในการจัดวาง Composable ในโค้ง (I29941)
• เพิ่มการ์ดประเภทใหม่สำหรับใช้ในแอปพลิเคชัน (TitleCard) และเพิ่มการสนับสนุนสำหรับการมีรูปภาพเป็นพื้นหลังในการ์ดเพื่อเน้นเนื้อหา (I53b0f)

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

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

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

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

เวอร์ชัน 1.0.0-alpha01

1 กรกฎาคม 2021

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

ฟีเจอร์ใหม่

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

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

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

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

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

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