Wear Compose Material 3

  
เขียนแอปพลิเคชัน Jetpack Compose สำหรับอุปกรณ์ Wear OS โดย ระบุฟังก์ชันเพื่อรองรับขนาดอุปกรณ์และท่าทางการนำทางที่แตกต่างกัน โดยใช้ระบบการออกแบบ Material 3 Expressive
อัปเดตล่าสุด รุ่นที่เสถียร รุ่นที่อาจได้รับการเผยแพร่ รุ่นเบต้า รุ่นอัลฟ่า
27 สิงหาคม 2025 1.5.0 - - -

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

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

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

ดึงดูด

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

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

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

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

Kotlin

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

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

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

    // NOTE: DO NOT INCLUDE dependencies on androidx.wear.compose:compose-material
    // or androidx.compose.material:material.
    // androidx.wear.compose:compose-material3 is designed as a replacement,
    // not an addition, to both of these other libraries.
    // If there are features from that you feel are missing from
    // androidx.wear.compose:compose-material3, please raise a bug to let us know.
}

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

ความคิดเห็น

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

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

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

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

เวอร์ชัน 1.5.0

27 สิงหาคม 2025

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

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

เปิดตัวไลบรารี Wear Compose Material 3 เป็นครั้งแรก ซึ่งรองรับระบบการออกแบบ Material 3 Expressive ใหม่ รุ่นนี้มีฟีเจอร์ต่อไปนี้

  • อัปเดต MaterialTheme และการจัดธีมสีแบบไดนามิก
  • คอมโพเนนต์ AppScaffold, ScreenScaffold, HorizontalPagerScaffold และ VerticalPagerScaffold ใหม่เพื่อจัดวางโครงสร้างของหน้าจอและประสานงานภาพเคลื่อนไหว ScrollIndicator, TimeText, HorizontalPageIndicator และ VerticalPageIndicator
  • การเปลี่ยนรูปร่าง IconButton, TextButton, IconToggleButton และ TextToggleButton พร้อมรูปแบบต่างๆ ที่เคลื่อนไหวเมื่อกดหรือเลือก
  • EdgeButton ซึ่งมีรูปร่างพิเศษที่ออกแบบมาสำหรับด้านล่างของหน้าจอ
  • ButtonGroup ใช้ปุ่มกลุ่มที่สื่อความหมายในแถวที่เปลี่ยนรูปร่างเมื่อแตะ
  • AlertDialog และ ConfirmationDialog ที่มีรูปแบบต่างๆ สำหรับเนื้อหาในกล่องโต้ตอบเพิ่มเติม
  • TimePicker และ DatePicker
  • ตัวบ่งชี้ความคืบหน้า ได้แก่ CircularProgressIndicator (มีรูปแบบที่แบ่งกลุ่ม) ArcProgressIndicator และ LinearProgressIndicator

นอกจากนี้ Wear Compose Foundation 1.5.0 ยังมีสิ่งต่อไปนี้ด้วย

  • TransformingLazyColumn ซึ่งเป็นรายการที่เลื่อนในแนวตั้งแบบเลื่อนเรื่อยๆ ที่รองรับการปรับขนาดและภาพเคลื่อนไหวแบบมอร์ฟ
  • รองรับการแบ่งหน้าใน Wear Compose Foundation ด้วย HorizontalPager และ VerticalPager
  • กลุ่มโฟกัสแบบลำดับชั้น - ใช้เพื่อใส่คำอธิบายประกอบที่ Composable ในแอปพลิเคชันเพื่อติดตามส่วนที่ใช้งานอยู่ของ Composition และประสานงานโฟกัส

อ่านเพิ่มเติมเกี่ยวกับ (Material 3 Expressive สำหรับ Wear OS)

เวอร์ชัน 1.5.0-rc02

13 สิงหาคม 2025

androidx.wear.compose:compose-*:1.5.0-rc02 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.5.0-rc02 มีการเปลี่ยนแปลงเหล่านี้

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

  • แก้ไขข้อบกพร่องใน TimePicker ที่สตริงแบบยาวที่แปลเป็นภาษาต่างๆ สำหรับระยะเวลา (AM/PM) อาจทำให้เลย์เอาต์เสีย (I0fa81)

เวอร์ชัน 1.5.0-rc01

30 กรกฎาคม 2025

androidx.wear.compose:compose-*:1.5.0-rc01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.5.0-rc01 มีการเปลี่ยนแปลงเหล่านี้

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

  • ตอนนี้ TimePicker จะทำงานตามภาษาของผู้ใช้โดยสมบูรณ์ โดยใช้ DateFormat.getBestDateTimePattern เพื่อกำหนดลำดับและเนื้อหาของตัวเลือกและตัวคั่น การเปลี่ยนแปลงนี้จะแก้ไขลำดับคอลัมน์ที่ไม่ถูกต้องสำหรับภาษา CJK, แก้ไขปัญหาเลย์เอาต์ RTL ในภาษาต่างๆ เช่น ภาษาอาหรับ, ใช้ตัวคั่นที่แปลแล้ว และรองรับทั้งรูปแบบ 0-11 และ 1-12 ชั่วโมงตามภาษา (I5d543)
  • DatePicker ตอนนี้จะแสดงเดือนเป็นตัวเลขในบางภาษา เช่น CJK เพื่อหลีกเลี่ยงการผสมรูปแบบตัวเลขและรูปแบบภาษา (เช่น 2025 | 07 | 02 แทน 2025 | 7月 | 02) การเปลี่ยนแปลงนี้ใช้ฮิวริสติกที่ตรวจสอบว่าภาษาใช้คำต่อท้ายทางภาษาสำหรับปีหรือไม่ หากใช้ ระบบจะเปลี่ยนรูปแบบเดือนจากข้อความ (MMM) เป็นตัวเลข (MM) เพื่อให้สอดคล้องกัน (Ia93fe)
  • ตอนนี้พื้นที่แนวตั้งสำหรับส่วนหัวในคอมโพเนนต์ Picker จะคงที่ ซึ่งจะช่วยป้องกันการเลื่อนที่มองเห็นได้เมื่อเลือกคอลัมน์ Picker โดยเฉพาะในโหมด Talkback (I7f8b7)
  • แก้ไขข้อบกพร่องด้านการช่วยเหลือพิเศษที่เกิดจากการวาด HorizontalPageIndicator และ VerticalPageIndicator แบบเต็มหน้าจอ ตัวบ่งชี้หน้าจะไม่แสดงแบบเต็มหน้าจออีกต่อไป และจะวางตำแหน่งโดยอัตโนมัติเมื่อใช้กับ HorizontalPagerScaffold หรือ VerticalPagerScaffold เมื่อไม่ได้ใช้โครงสร้าง Pager ให้ระบุการจัดแนวอย่างชัดเจนโดยใช้ modifier = Modifier.align(Alignment.BottomCenter) กับ HorizontalPageIndicator และ modifier =Modifier.align(Alignment.CenterEnd) กับ VerticalPageIndicator (I3a0ad)
  • ตอนนี้ทิศทางการปัดใน SwipeToReveal จะสอดคล้องกันทั้งสำหรับ LayoutDirections ที่เป็น LTR และ RTL (I6d427)
  • คืนค่าการจัดกึ่งกลางในแนวตั้ง SwipeToReveal สำหรับการดำเนินการ หาก hasPartiallyRevealedState = true ผู้โทรควรตั้งค่า RevealState เป็น RevealValue.Covered เมื่อมีการเลื่อน (I6473d)
  • SwipeDismissableNavHost ตอนนี้จะตัดเนื้อหาสำหรับ API 36 ขึ้นไปได้อย่างถูกต้องแล้ว (Ib9a44)

เวอร์ชัน 1.5.0-beta06

16 กรกฎาคม 2025

androidx.wear.compose:compose-*:1.5.0-beta06 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.5.0-beta06 มีการเปลี่ยนแปลงเหล่านี้

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

  • แก้ไขEdgeButtonภาพเคลื่อนไหวเมื่อ LazyColumn หรือ ScalingLazyColumn มีreverseLayout = true (I46a1a)
  • แก้ไขข้อบกพร่องใน ScreenScaffold ที่การแตะเพื่อสำรวจไม่ทำงานใน TalkBack หากมีการระบุ ScrollIndicator/PageIndicator (I6dcee)
  • TransformingLazyColumn อนุญาตให้เปลี่ยนรูปร่างจาก TransformationSpec ได้แล้วโดยอ่านค่า itemHeight ที่ TransformationSpec ระบุไว้ในเครื่องมือระบายสีพื้นหลัง (I6a599)
  • การเปลี่ยนสีเมื่อเปิด/ปิดใช้ภาพเคลื่อนไหวสำหรับ IconButton ให้สอดคล้องกับ IconToggleButton (Ife10a)
  • นำการยึดส่วนขั้นต่ำใน CircularProgressIndicator ออกเพื่อหลีกเลี่ยงการกระโดดที่เห็นได้ชัดไปยังขนาดจุดขั้นต่ำเมื่อเคลื่อนไหว การเปลี่ยนแปลงนี้จะทำให้ไม่ได้ใช้พารามิเตอร์ targetProgress ใน drawCircularProgressIndicator อีกต่อไป (I33309)
  • ตอนนี้ตัวเลือกมีบทบาทเชิงความหมาย ValuePicker ซึ่งโปรแกรมอ่านหน้าจอใช้เพื่อทำให้ตัวเลือกเข้าถึงได้ง่ายขึ้น นอกจากนี้ เครื่องมือเลือกยังมีการอัปเดตป้ายกำกับการคลิกเพื่อการช่วยเหลือพิเศษ ซึ่งจะแยกความแตกต่างระหว่างการปรับค่าในโหมดอ่านอย่างเดียวกับการเลือกค่าปัจจุบันในโหมดอื่นๆ (I33309)

เวอร์ชัน 1.5.0-beta05

2 กรกฎาคม 2025

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

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

  • อัปเดตเอกสารเพื่อชี้แจงการใช้งาน Modifier.edgeSwipeToDismiss (I78cb5)
  • แก้ไขข้อบกพร่องที่อาจแสดงรายการที่เปิดเผยหลายรายการพร้อมกับ SwipeToReveal ในรายการแบบเลซี่ (I1d4f6)
  • ตอนนี้ระบบจะปรับขนาดรูปร่างคอนเทนเนอร์ใน TransformingLazyColumn เพื่อหลีกเลี่ยงการตัดเนื้อหา (I9221a)
  • ป้ายกำกับ TimePicker และ DatePicker สำหรับชั่วโมง/นาที/วินาที หรือปี/เดือน/วัน มีความหมายของส่วนหัวสำหรับโปรแกรมอ่านหน้าจอแล้ว (I77d8b)
  • นำการหยุดชั่วคราวระหว่างลูปใน CircularProgressIndicator ที่ไม่แน่นอน (Iaf0bb) ออกแล้ว
  • แก้ไขข้อบกพร่องของภาพเคลื่อนไหวใน TransformingLazyColumn เมื่อนำรายการออก (I73034)
  • แก้ไขการจัดการรายการยึดใน TransformingLazyColumn เมื่อนำรายการออก (I841a8)
  • PickerGroup จะเคลื่อนไหวตัวเลือกในแนวนอนเมื่อเปิดการจัดกึ่งกลางอัตโนมัติและเปลี่ยนตัวเลือกที่เลือก (จัดกึ่งกลาง) (Ic82c4)

เวอร์ชัน 1.5.0-beta04

18 มิถุนายน 2025

androidx.wear.compose:compose-*:1.5.0-beta04 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.5.0-beta04 มีการเปลี่ยนแปลงเหล่านี้

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

  • แก้ไขข้อบกพร่องของเลย์เอาต์ใน TransformingLazyColumn ซึ่งตอนนี้เนื้อหาที่พอดีกับหน้าจอจะจัดแนวอย่างถูกต้องจากด้านบนของหน้าจอ (I80115)
  • แก้ไขปัญหาเกี่ยวกับ TransformingLazyColumn ที่รายการด้านล่างมีการปรับขนาดอย่างไม่ถูกต้องเมื่อเลื่อนไปที่ด้านล่างสุดของรายการที่มี EdgeButton ตอนนี้ความคืบหน้าในการเลื่อนจะใช้การไล่ระดับสีเมื่อกู้คืนเลย์เอาต์ (Iea375)
  • TransformingLazyColumn จะอ่านความสูงของรายการภายในเครื่องมือวาดภาพพื้นหลัง ซึ่งช่วยให้ TransformationSpecs ที่กำหนดเองสามารถใช้การมอร์ฟได้ (I022f0)
  • SwipeToReveal ตอนนี้จะจัดกึ่งกลางการดำเนินการที่แสดงในแนวตั้งได้อย่างถูกต้องแล้ว (I4419b)
  • แก้ไขข้อบกพร่องใน SwipeToReveal ที่ทำให้ทำงานร่วมกับการปัดเพื่อปิดอย่างถูกต้องไม่ได้ หากทั้งมุมมองและ Compose อยู่บนหน้าจอ (I5dc0e)
  • แก้ไขข้อบกพร่องที่ทำให้การดำเนินการ SwipeToReveal มีการวาดด้วยออฟเซ็ตแนวตั้งเมื่อเลื่อน (I29444)
  • ตอนนี้ AlertDialog, ConfirmationDialog, OpenOnPhoneDialog และ SwipeToReveal จะปัดขึ้นระยะขอบและขนาดที่คำนวณเป็นเปอร์เซ็นต์ของขนาดหน้าจอ (I76367)
  • ButtonDefaults.outlinedButtonBorder จะอัปเดตตามการเปลี่ยนแปลงสถานะที่เปิด/ปิดใช้ size(If2ddd)
  • แก้ไขข้อบกพร่องใน EdgeButton ความสูงที่เกิดขึ้นในหน้าจอที่ซับซ้อนซึ่งมี Pager และ ScreenScaffold (I946e3)
  • แก้ไขเงื่อนไขการแข่งขันที่อาจทำให้ภาพเคลื่อนไหวของตัวยึดตำแหน่งหยุดทำงาน (I53530)
  • ปรับปรุงประสิทธิภาพ HorizontalPageIndicator และ VerticalPageIndicator โดยการวาดลงใน Canvas (Ifae1e)
  • ปรับรูปร่างของ EdgeButton เพื่อให้การเปลี่ยนระหว่างจุดไข่ปลาและวงกลมที่ประกอบกันเป็นโครงร่างราบรื่นยิ่งขึ้น (I7721e)
  • แก้ไขข้อบกพร่องใน LevelIndicator ที่ทำให้ภาพเคลื่อนไหวหยุดทำงานเนื่องจากการจัดองค์ประกอบใหม่ที่ไม่จำเป็น (I45d08)

เวอร์ชัน 1.5.0-beta03

4 มิถุนายน 2025

androidx.wear.compose:compose-*:1.5.0-beta03 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.5.0-beta03 มีการเปลี่ยนแปลงเหล่านี้

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

  • OpenOnPhoneDialog จะประกาศเฉพาะข้อความใต้ TalkBack และข้ามความหมายของไอคอน เราได้อัปเดต OpenOnPhoneDialogDefaults เพื่อนำพารามิเตอร์ iconContentDescription และ contentDescription ออกจาก icon() นอกจากนี้ ConfirmationDialogDefaults ยังมีพารามิเตอร์ตัวแก้ไขใน SuccessIcon และ FailureIcon ที่ใช้ร่วมกันได้แล้ว (Id2ae2)

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

  • เปลี่ยนลำดับที่เราใช้เอฟเฟกต์ของพารามิเตอร์ SurfaceTransformation ก่อนหน้านี้ การเปลี่ยนรูปแบบที่ใช้กับคอมโพเนนต์ Wear Material3 จะดำเนินการดังนี้: เครื่องมือวาดพื้นหลัง, การเปลี่ยนรูปแบบคอนเทนเนอร์, การเปลี่ยนรูปแบบเนื้อหา ตอนนี้ 2 รายการแรกจะกลับด้าน และเราจะใช้ตัวแก้ไขที่ส่งผ่านระหว่าง 2 รายการนี้ ดังนั้นจึงได้รับผลกระทบจากการเปลี่ยนรูปแบบคอนเทนเนอร์ ซึ่งจะแก้ไขกรณีต่างๆ เช่น การใช้เอฟเฟกต์การสั่นไหวของตัวยึดตำแหน่งกับองค์ประกอบใน TLC โดยใช้พารามิเตอร์การเปลี่ยนรูป (I786cf)
  • RevealState.Saver ได้รับการเพิ่มเพื่อใช้ในการคืนค่าสถานะของ SwipeToReveal เมื่อมีการสร้างกิจกรรมหรือกระบวนการขึ้นใหม่ ตอนนี้ฟังก์ชัน rememberRevealState จะใช้โปรแกรมประหยัดนี้โดยค่าเริ่มต้น (Ie0ecb)
  • SwipeToReveal ปุ่มการกระทําหลักและรองควรมีค่าเริ่มต้นเป็น ButtonDefault.Height (แก้ไขข้อบกพร่องที่ปุ่มเหล่านี้เติมความสูงสูงสุดสำหรับปุ่มที่สูงกว่า) (Ibfba1)
  • เปลี่ยน SwipeToReveal เพื่อรีเซ็ตคอมโพเนนต์สุดท้ายที่มีการโต้ตอบ เมื่อมีการปัดขวาท่าทางสัมผัส (Ia8450)
  • SwipeToReveal มีการเปลี่ยนแปลงเพื่อให้มีสถานะเป็น Revealing เมื่อตำแหน่งสิ้นสุดของการปัดอยู่ระหว่างจุดยึดที่เปิดเผยและจุดยึดที่เปิดเผยแล้ว และอยู่ใกล้กับจุดยึดที่เปิดเผยมากกว่า (If4458)
  • ตอนนี้เนื้อหาของ ButtonGroup จะกลับด้านอย่างถูกต้องในเลย์เอาต์ RTL (Ib378d)
  • AnimatedText รองรับทิศทางข้อความจากขวาไปซ้ายแล้ว (I4533c)
  • TransformingLazyColumn จะปรับขนาดรายการอย่างถูกต้องเมื่อนำรายการด้านล่างออก (Idacab)
  • TransformingLazyColumn ตอนนี้จะทำการวัดเพียงครั้งเดียว ซึ่งช่วยปรับปรุงประสิทธิภาพด้วยการลดเวลาเฟรม (I501a1)

เวอร์ชัน 1.5.0-beta02

20 พฤษภาคม 2025

androidx.wear.compose:compose-*:1.5.0-beta02 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.5.0-beta02 มีการเปลี่ยนแปลงเหล่านี้

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

  • อัปเดตโปรไฟล์พื้นฐานสำหรับไลบรารี Foundation, Material และ Material3 (I53f06)
  • แก้ไขข้อบกพร่องใน TransformingLazyColumn ซึ่งรายการจะปรับขนาดเมื่อนำรายการด้านล่างออก (Idacab)
  • แก้ไขข้อบกพร่องเกี่ยวกับ TransformingLazyColumn เมื่อรายการติดอยู่ที่ด้านบนหรือด้านล่างของรายการ (I49d00)
  • OpenOnPhoneDialog ใน TalkBack ควรประกาศข้อความโค้งแทนคำอธิบายเนื้อหาไอคอน (I4efe8)
  • แก้ไขข้อบกพร่องใน SwipeToReveal ซึ่งจะรายงาน Anchor ที่ไม่ถูกต้องใน RevealState.currentValue เมื่อตั้งค่า hasPartiallyRevealedState เป็น "false" (I9c7cf)
  • ตอนนี้ปุ่มเลิกทำ SwipeToReveal จะเป็น ButtonDefaults.Height โดยค่าเริ่มต้น (I1f6c8)
  • BasicSwipeToDismissBox ได้รับการปรับปรุงประสิทธิภาพโดยการเลิกใช้ Canvas สำหรับการวาดเลเยอร์มืด (I68f2c)
  • แก้ไขข้อบกพร่องด้านการช่วยเหลือพิเศษในแถบเลื่อน ซึ่งเปอร์เซ็นต์ที่ประกาศไม่ตรงกับค่าหลังการอัปเดต (I91146)
  • แก้ไขข้อบกพร่องในการติดตั้งใช้งาน placeholderShimmer (Iee39b
  • TransformingLazyColumn ได้รับการปรับปรุงโดยการเพิ่มประสิทธิภาพการคำนวณ ScrollProgress ขึ้น 30% (I4c4cb)

เวอร์ชัน 1.5.0-beta01

7 พฤษภาคม 2025

androidx.wear.compose:compose-*:1.5.0-beta01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.5.0-beta01 มีการเปลี่ยนแปลงเหล่านี้

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

Wear Compose 1.5.0-beta01 มีไลบรารี Wear Compose Material3 ซึ่งรองรับระบบการออกแบบ UI ใหม่ที่เรียกว่า Material 3 Expressive เราขอแนะนำให้อัปเกรดจาก Material เป็น Material3 เพื่อใช้การออกแบบภาพใหม่ในแอป และรับประโยชน์จากคอมโพเนนต์ใหม่ๆ ดังนี้

  • MaterialTheme เพื่อดูรูปแบบสี ตัวอักษร และรูปร่างที่อัปเดตและขยายเพิ่มเติมเพื่อเพิ่มทั้งความลึกและความหลากหลายให้กับการออกแบบ
  • การจัดธีมสีแบบไดนามิกซึ่งจะสร้างรูปแบบสีสำหรับแอปโดยอัตโนมัติให้ตรงกับสีของหน้าปัด
  • คอมโพเนนต์ใหม่จะปรับให้เข้ากับหน้าจอขนาดใหญ่ขึ้นโดยอัตโนมัติโดยค่าเริ่มต้น
  • การเปลี่ยนรูปร่าง - คอมโพเนนต์ปุ่มกลม เช่น IconButton, TextButton, IconToggleButton และ TextToggleButton รองรับรูปแบบต่างๆ ที่เคลื่อนไหวเมื่อกดหรือเลือก
  • EdgeButton - ปุ่มใหม่ที่ขอบหน้าจอซึ่งมีรูปร่างพิเศษที่ออกแบบมาสำหรับด้านล่างของหน้าจอ
  • โครงร่าง - แนะนำ AppScaffold และ ScreenScaffold เพื่อวางโครงสร้างของหน้าจอและประสานงานภาพเคลื่อนไหว ScrollIndicator และ TimeText
  • ปุ่ม - รองรับปุ่มรูปทรงคล้ายสนามกีฬาจำนวนมากพร้อมคอนเทนเนอร์แบบยืดหยุ่นแบบช่องเดียวและแบบหลายช่องสำหรับปุ่มที่มีไอคอนและป้ายกำกับ CheckboxButton และ SwitchButton จะแสดงเมื่อจำเป็นต้องใช้ปุ่มเปิด/ปิด ส่วน RadioButton คือปุ่มเลือกที่ใช้ได้ (นอกจากนี้ยังมีปุ่มเปิด/ปิดและปุ่มเลือกแบบ "แยก")
  • ButtonGroup - ใช้ปุ่มกลุ่มที่แสดงออกในแถวซึ่งเปลี่ยนรูปร่างเมื่อแตะ
  • AlertDialog รูปแบบต่างๆ รองรับปุ่มตกลง/ยกเลิกหรือ EdgeButton
  • ConfirmationDialog พร้อมแสดงข้อความที่มีการหมดเวลา โดยรองรับภาพเคลื่อนไหวพิเศษสำหรับรูปแบบต่างๆ ที่สำเร็จ ล้มเหลว และเปิดในโทรศัพท์
  • ตัวเลือก - รองรับรูปแบบ TimePicker และ DatePicker รวมถึงคอมโพเนนต์ตัวเลือกและ PickerGroup สำหรับสร้างหน้าจอตัวเลือกของคุณเอง
  • ProgressIndicators - รองรับตัวบ่งชี้ความคืบหน้าแบบวงกลมและแบบเส้น (CircularProgressIndicator มีรูปแบบที่แบ่งกลุ่มและไม่แน่นอน)
  • การ์ด - มีการ์ดหลายรูปแบบให้เลือกใช้ รวมถึง TitleCard ซึ่งมีเลย์เอาต์เฉพาะสำหรับการ์ดที่มีชื่อ เวลา คำบรรยาย หรือช่องเนื้อหา TitleCard ยังสามารถใส่ภาพพื้นหลังเพื่อเสริมความหมายของข้อมูลในการ์ดได้ด้วย
  • เครื่องมือเปลี่ยนหน้า - คอมโพเนนต์ HorizontalPagerScaffold, VerticalPagerScaffold และ AnimatedPage จะประสานงานภาพเคลื่อนไหว HorizontalPageIndicator และ VerticalPagerIndicator HorizontalPager และ VerticalPager จะเปิดตัวในไลบรารี Wear Compose Foundation
  • ตัวยึดตำแหน่ง - วาดรูปร่างโครงร่างเหนือคอมโพเนนต์ในกรณีที่ไม่มีเนื้อหาชั่วคราว
  • แถบเลื่อนและตัวควบคุมแบบขั้น - ทั้งแถบเลื่อนและตัวควบคุมแบบขั้นช่วยให้ผู้ใช้เลือกจากช่วงของค่าได้ แถบเลื่อนมีขนาดกะทัดรัดกว่าและสามารถแบ่งส่วนได้ ในขณะที่ Stepper เป็นคอมโพเนนต์แบบเต็มหน้าจอที่มักใช้ร่วมกับ StepperLevelIndicator
  • SwipeToReveal - ใช้เพื่อเพิ่มการดำเนินการเพิ่มเติมไปยัง Composable เมื่อมีการปัดจากขวาไปซ้าย

นอกจากนี้ Wear Compose Foundation 1.5.0-beta01 ยังมีคอมโพเนนต์ใหม่ดังนี้

  • TransformingLazyColumn - รายการแบบเลื่อนแนวตั้งที่โหลดแบบเลื่อนและรองรับภาพเคลื่อนไหวการปรับขนาดและการเปลี่ยนรูป
  • กลุ่มโฟกัสแบบลำดับชั้น - ใช้เพื่อใส่คำอธิบายประกอบที่สามารถคอมโพสในแอปพลิเคชัน เพื่อติดตามส่วนที่ใช้งานอยู่ของคอมโพสและประสานงานโฟกัส
  • Pager - คอมโพเนนต์ HorizontalPager และ VerticalPager สร้างขึ้นบนคอมโพเนนต์ Compose Foundation พร้อมการเพิ่มประสิทธิภาพเฉพาะ Wear เพื่อปรับปรุงประสิทธิภาพและปฏิบัติตามหลักเกณฑ์ของ Wear OS

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

  • อัปเดต Hierarchical Focus API - เปลี่ยนชื่อ Modifier.hierarchicalFocus เป็น Modifier.hierarchicalFocusGroup และนำพารามิเตอร์การเรียกกลับออก นำการโอเวอร์โหลดของ Modifier.hierarchicalFocusRequester ออกด้วยพารามิเตอร์ FocusRequester สร้าง CompositionLocal, LocalScreenIsActive ใหม่เพื่อให้คอมโพเนนต์สามารถแจ้งและตรวจสอบได้ว่าหน้าจอใดที่ใช้งานอยู่ (I5ff7c)
  • เลิกใช้งาน SwipeToReveal จาก Wear Compose Foundation เพื่อให้ใช้ API SwipeToReveal ใน Wear Compose Material และ Wear Compose Material3 แทน โปรดแทนที่การนำเข้า Wear Foundation SwipeToReveal ด้วยการนำเข้า Wear Compose Material/ Wear Compose Material3 เพื่อใช้ API ต่อไป (Ia147d)
  • ย้ายการอ้างอิง SwipeToReveal Material3 ของ Wear Compose ใน Foundation ไปยังแพ็กเกจ Material3 เช่น RevealValue, RevealDirection, RevealActionType, RevealState, rememberRevealState นักพัฒนาแอปควรเปลี่ยนการนำเข้าคลาสและฟังก์ชันเหล่านี้จาก androidx.wear.compose.foundation เป็น androidx.wear.compose.material3 (I640e6)
  • อัปเดต Wear Compose Material3 SwipeToReveal API ดังนี้ เพิ่มพารามิเตอร์ primaryAction, onFullSwipe, secondaryAction, undoPrimaryAction, undoSecondaryAction และ hasPartiallyRevealedState ลงใน Composable SwipeToReveal; นำความสามารถในการปรับแต่ง positionalThreshold และ animationSpec ออกจาก RevealState; นำ lastActionType, revealThreshold และความกว้างออกจาก RevealState; เปลี่ยนตัวสร้าง RevealState ให้ยอมรับ RevealDirection แทนการยึด; นำฟังก์ชัน createRevealAnchors, การยึด และ bidirectionalAnchors ออก; เปลี่ยนชื่อฟังก์ชัน SwipeToRevealScope primaryAction, secondaryAction, undoPrimaryAction และ undoSecondaryAction เป็น PrimaryActionButton, SecondaryActionButton, UndoActionButton และเปลี่ยนให้เป็นฟังก์ชัน Composable; ทำเครื่องหมาย RevealActionType เป็นภายใน (I885d0)
  • อัปเดต SwipeToReveal API เพิ่มเติมดังนี้ เปลี่ยนชื่อ onFullSwipe เป็น onSwipePrimaryAction เปลี่ยนชื่อ SwipeToRevealNonAnchoredSample เพื่อระบุการใช้พารามิเตอร์ hasPartiallyRevealedState นำ actionButtonHeight ออกเนื่องจากค่าเริ่มต้นคือความสูงเริ่มต้นของปุ่ม และสามารถตั้งค่าความสูงที่สูงกว่าได้โดยใช้ตัวแก้ไข นำ SmallActionButtonHeight ออกจาก SwipeToRevealDefaults ทำให้พารามิเตอร์ค่าในตัวสร้าง RevealValue และ RevealDirection เป็นแบบส่วนตัว (I465ce)

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

  • แก้ไขการจัดการ ScreenScaffold ของ EdgeButton เพื่อให้หลังจากนำรายการ TransformingLazyColumn ออกแล้ว EdgeButton จะเคลื่อนไหวไปยังตำแหน่งที่ถูกต้อง (I6d366)
  • อัปเดตทรัพยากร Dependency ของ Wear Compose ในไลบรารี Compose เป็นเวอร์ชัน 1.8.0 (I2ef3f)
  • อัปเดตการเคลื่อนไหวของ CircularProgressIndicator ที่ไม่แน่นอนเพื่อไม่ให้เกิดการถดถอยชั่วคราวอีกต่อไป (Ieddb1)
  • แก้ไขSwipeDismissableNavHostข้อบกพร่อง - โฟกัสไม่เปลี่ยนอย่างถูกต้องหลังจากปัดกลับ ทำให้การป้อนข้อมูลแบบหมุนล้มเหลว (สำหรับ API 36 ขึ้นไปซึ่งใช้การปัดกลับแบบคาดการณ์) (Ieddb1)
  • เอกสารประกอบที่แก้ไขแล้วสำหรับ Hierarchical Focus API (Idf2ff)
  • อัปเดตเอกสารประกอบสำหรับปุ่มและการ์ดเพื่อระบุวิธีที่ containerPainter และ disabledContainerPainter ลบล้าง containerColor และ disabledContainerColor (I4a453)
  • เปลี่ยนกลับการเปลี่ยนแปลงใน TimeText ในรุ่นก่อนหน้า ซึ่งย้าย BroadcastReceiver ไปยัง Worker Thread เนื่องจากทำให้เกิดปัญหาสำหรับแอปที่จัดการการทำงานแบบหลายเธรดของตนเองในระหว่างการนำทาง (I34d02)
  • อัปเดตตัวอย่าง Picker เพื่อนำการเรียกใช้ remember ที่ไม่จำเป็นออก และใช้ rememberUpdatedState ใน Picker แทนเพื่อจดจำฟังก์ชัน Lambda contentDescription ล่าสุด (Icb5b1)
  • อัปเดตรูปแบบข้อความใน TimePicker และ DatePicker เพื่อให้การเปลี่ยนแบบอักษรไม่ทำให้ข้อความถูกตัดอีกต่อไป (I26194)
  • ListHeader และ ListSubHeader จะจัดข้อความเป็นกึ่งกลางและจัดชิดซ้ายตามลำดับโดยค่าเริ่มต้น (I78339)
  • อัปเดตตัวอย่างและเดโมของ Foundation และ Material Swipe to Reveal เพื่อประกาศการดำเนินการเพื่อการช่วยเหลือพิเศษที่กำหนดเอง (ต้องเพิ่มการดำเนินการที่กำหนดเองเป็นความหมายในเนื้อหา ไม่ใช่ใน SwipeToReveal Composable เอง) (Ie92a3)
  • อัปเดตค่าเริ่มต้นที่MaxLinesตั้งไว้ในEdgeButtonเนื้อหาตามขนาด โดยตอนนี้ค่าเริ่มต้นคือ 1 สำหรับขนาดเล็กพิเศษ 2 สำหรับขนาดเล็กและขนาดกลาง และ 3 สำหรับขนาดใหญ่ (Ie35f6)
  • LocalReduceMotion เพื่อให้ระบบลงทะเบียนผู้สังเกตการณ์เพียงครั้งเดียวเพื่อปรับปรุงประสิทธิภาพ (Ib1979)
  • ลดจำนวนการวาดใหม่ใน ScrollIndicator เพื่อปรับปรุงประสิทธิภาพ (Ia7a67)
  • แก้ไขข้อบกพร่องใน TransformingLazyColumn ซึ่งรายการที่มองเห็นได้ด้านบนในรายการจะปรับขนาดไม่ถูกต้องเมื่อ EdgeButton มีความสูงเต็ม (I30580)

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

เวอร์ชัน 1.0.0-alpha37

23 เมษายน 2025

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

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

  • นำ scrollTransform ออกจาก API สาธารณะ ใช้ตัวแก้ไข transformedHeight และ graphicsLayer ร่วมกันหากต้องการฟังก์ชันเดียวกัน (Ie181d)
  • แทนที่ Composable ImageButton และ ImageCard ด้วยการโอเวอร์โหลด Button และ Card/TitleCard ตามลำดับ เปลี่ยนชื่อ imageButtonColors เป็น buttonWithContainerPainterColors และ imageCardColors เป็น cardWithContainerPainterColors เพิ่ม ButtonDefaults.scrimBrush และ CardDefaults.scrimBrush สาธารณะแล้ว เปลี่ยนชื่อปุ่ม imageBackgroundGradientStartColor และ imageBackgroundGradientEndColor เป็น scrimGradientStartColor และ scrimGradientEndColor เปลี่ยนชื่อ CardDefaults.ImageContentPadding เป็น CardDefaults.CardWithContainerPainterContentPadding (I7b8b6) แล้ว
  • Picker และ PickerGroup จะใช้ contentDescription เป็น Lambda เพื่อหลีกเลี่ยงการจัดองค์ประกอบที่ไม่จำเป็น (I002dd)

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

  • แก้ไขปัญหาที่ CircularProgressIndicator ที่ไม่แน่นอนจะสั่นระหว่างภาพเคลื่อนไหวหากความกว้างไม่เท่ากับความสูง (I76bfe)
  • แก้ไขปัญหาเลย์เอาต์ปุ่มขอบในขนาดที่ไม่ถูกต้อง ตอนนี้จะป้องกันการอัปเดตเลย์เอาต์ของปุ่มขอบเมื่อความสูงเป็น NaN (I32b93)
  • เพิ่มมุมกวาดสูงสุดใน OpenOnPhoneDialog เพื่อให้ข้อความ "ดูโทรศัพท์" เริ่มต้นไม่ถูกตัดเมื่อใช้ขนาดแบบอักษรที่ใหญ่ที่สุด (I90af9)

เวอร์ชัน 1.0.0-alpha36

9 เมษายน 2025

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

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

  • แทนที่ ButtonDefaults.imageBackgroundButtonColors ด้วย ImageButton, ButtonDefaults.imageButtonColors, ButtonDefaults.containerPainter และ ButtonDefaults.disabledContainerPainter แล้ว และการเปลี่ยนแปลงที่คล้ายกันสำหรับบัตร ระบบจะนำจิตรกรออกจาก ButtonColors และ CardColors (I8c6a1)
  • อัปเดตตัวยึดตำแหน่งเพื่อลดความซับซ้อนของ API ตอนนี้เรามีตัวแก้ไข 2 รายการ ได้แก่ Modifier.placeholderShimmer เพื่อใช้เอฟเฟกต์ระยิบระยับในระดับคอมโพเนนต์ และ Modifier.placeholder เพื่อใช้มาสก์บนเนื้อหาที่ยังไม่ได้โหลด (Iaee7a)

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

  • ผสานรวมการเลื่อนเลยขอบลงใน ScrollIndicator (Icfb7f)
  • แก้ไขพื้นหลังว่างเปล่าและกล่องโต้ตอบที่ขาดหายไปเมื่อเปิดกล่องโต้ตอบ Material3 (Ice597)
  • แก้ไขปัญหาใน FadingExpandingLabel เมื่อข้อความครอบคลุมหลายบรรทัด (I04eb7)
  • อัปเดตระยะห่างจากขอบระหว่างป้ายกำกับหลักและป้ายกำกับรองในปุ่ม (I99b7b)
  • ArcLarge ลดจาก 20sp เป็น 18sp และมีการอัปเดตระยะห่างระหว่างตัวอักษรใน ArcLarge และ ArcSmall ตอนนี้ ConfirmationDialog/OpenOnPhoneDialog ใช้ ArcLarge เริ่มต้นแทนที่จะลบล้างเป็น 18sp (Id39a8)

การอัปเดตการขึ้นต่อกัน

  • ตอนนี้ไลบรารีนี้กำหนดเป้าหมายเป็นระดับภาษา Kotlin 2.0 และต้องใช้ KGP 2.0.0 ขึ้นไป (Idb6b5)

เวอร์ชัน 1.0.0-alpha35

26 มีนาคม 2025

androidx.wear.compose:compose-material3:1.0.0-alpha35 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha35 มีการเปลี่ยนแปลงเหล่านี้

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

  • AlertDialog ตอนนี้ระบบจะลดระยะห่างจากขอบด้านบนโดยค่าเริ่มต้นเมื่อมีการระบุไอคอน ซึ่งจะช่วยให้ใช้ขนาดหน้าจอที่มีอยู่ได้อย่างมีประสิทธิภาพสูงสุด (Ief06c)
  • เปลี่ยนชื่อ PagerScaffoldDefaults.FadeOutAnimation เป็น PagerScaffoldDefaults.FadeOutAnimationSpec แล้ว เปลี่ยนชื่อพารามิเตอร์หน้าใน AnimatedPage เป็น pageIndex แล้ว (I701f2)
  • อัปเดตการตั้งชื่อสำหรับ SurfaceTransformation ของ TransformingLazyColumn - แยก applyTransformation เป็น applyContainerTransformation และ applyContentTransformation และเปลี่ยนชื่อ createBackgroundPainter เป็น createContainerPainter การอัปเดตการตั้งชื่อเพิ่มเติมสำหรับ TransformationSpec และ ResponsiveTransformationSpec (I1c534)
  • เปลี่ยนชื่อ AppScaffold backgroundColor เป็น containerColor แล้ว (I4e63f)

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

  • แก้ไขปัญหาใน FadingExpandingLabel ที่ข้อความขยายไม่ถูกต้องในบางครั้ง (I0e773)
  • ArcLarge ลดลงจาก 20sp เป็น 18sp และมีการอัปเดตระยะห่างตัวอักษรใน ArcLarge และ ArcSmall ConfirmationDialog/OpenOnPhoneDialog จะใช้ ArcLarge เริ่มต้นแทนการลบล้างเป็น 18sp (Id39a8)
  • อัปเดตภาพเคลื่อนไหวของส่วนหัวสำหรับ DatePicker และ TimePicker เพื่อให้ภาพเคลื่อนไหวแบบเลือนออกและเลือนเข้าทำงานเป็นภาพเคลื่อนไหวแบบสปริงเดียว (I68963)
  • เพิ่มประสิทธิภาพPagerScaffoldโดยหลีกเลี่ยงการอ่าน currentPageOffsetFraction ใน AnimatedPage ที่ใช้ร่วมกันได้ (I433ef)
  • เราได้อัปเดตสเกลประเภททั้งหมดให้มีตัวเลขสัดส่วนโดยค่าเริ่มต้น เนื่องจากเราเห็นว่านี่เป็นกรณีการใช้งานที่พบบ่อยที่สุด และการใช้รูปแบบตารางโดยค่าเริ่มต้นทำให้มีช่องว่างมากเกินไประหว่างคู่ตัวเลขบางคู่ TimePicker และ DatePicker ยังคงใช้กับ FontFeatureSetting=tnum สำหรับตัวเลขตาราง (I88929)
  • แก้ไขโฟกัสอินพุต RSB เริ่มต้นสำหรับ TimePicker และ DatePicker (I1c773)
  • อัปเดตข้อความเริ่มต้นใน OpenOnPhoneDialog เป็น "ตรวจสอบโทรศัพท์" (I00a3f)
  • อัปเดตความหนาของ ArcLarge และ ArcMedium จาก 600 เป็น 599 เพื่อแก้ปัญหาที่ระบบถือว่าความหนา 600 เป็นตัวหนา (I2a51d)
  • อัปเดตSwipeToRevealระยะห่างจากขอบระหว่างเนื้อหากับปุ่มการทำงาน รวมถึงระยะห่างจากขอบระหว่างไอคอนกับข้อความของปุ่มการทำงาน (Ic46cb)

เวอร์ชัน 1.0.0-alpha34

12 มีนาคม 2025

androidx.wear.compose:compose-material3:1.0.0-alpha34 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha34 มีการเปลี่ยนแปลงเหล่านี้

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

  • PagerScaffold จะไม่ปล่อยคอมโพเนนต์ Pager อีกต่อไป แต่จะต้องระบุผ่าน content Composable แทน ตอนนี้ AnimatedPage และ snapWithSpringFlingBehaviour พร้อมใช้งานแล้ว และสามารถใช้ร่วมกับ Wear Foundation Pager เพื่อให้ได้ลักษณะการทำงานของ M3 PagerScaffold ก่อนหน้า (ดูตัวอย่างที่อัปเดตแล้ว) (Ia4724)
  • อัปเดต PagerState โดยนำ PagerState ของ Compose Foundation ออกเป็นคลาสพื้นฐาน และเพิ่มพร็อพเพอร์ตี้ currentPage, currentPageOffsetFraction และ pageCount อัปเดตอินเทอร์เฟซ GestureInclusion โดยเปลี่ยนชื่อเมธอดเป็น ignoreGestureStart (I4ae07)
  • ตอนนี้มีการอธิบายประกอบFloatRange(0, 360)พารามิเตอร์มุมกวาดด้วย FloatRange(0, 360) (I7e636)LevelIndicator
  • เราได้เพิ่ม CurvedModifier.clearAndSetSemantics เพื่อเป็นวิธีปิดความหมายโค้ง CurvedText ยังคงตั้งค่าเริ่มต้นให้คำอธิบายเนื้อหาเป็นข้อความ แต่ timeTextCurvedText และ timeTextSeparator จะไม่อ่านเนื้อหาของตัวเองแล้ว (I4b568)
  • เพิ่มพารามิเตอร์สีพื้นหลังและเนื้อหาเริ่มต้นลงใน AppScaffold (I56652)
  • เปลี่ยนชื่อการจัดการท่าทางสัมผัสการปัดเริ่มต้นของ HorizontalPager เป็น PagerDefaults.gestureInclusion แล้ว ตอนนี้ลักษณะการทำงานเริ่มต้นคือการไม่สนใจท่าทางสัมผัสการปัดที่เริ่มจากขอบด้านซ้ายของหน้าแรกเท่านั้น และจะเกิดขึ้นเมื่อปิด Talkback แล้วเท่านั้น ในกรณีอื่นๆ ลักษณะการทำงานเริ่มต้นคือเพจเจอร์จะไม่สนใจท่าทางสัมผัสการปัด ดังนั้นตัวแฮนเดิลการปัดเพื่อปิดจะไม่พร้อมใช้งาน (Iee486)
  • เพิ่มพารามิเตอร์ SurfaceTransformation ลงในคอมโพเนนต์ปุ่ม การ์ด และส่วนหัวของรายการ เพื่อให้สามารถใช้การเปลี่ยนพื้นหลังและเนื้อหาที่แตกต่างกันเมื่อใช้ในคอนเทนเนอร์ที่เปลี่ยนลักษณะของรายการตามตำแหน่ง เช่น TransformingLazyColumn (Iabe3f)
  • เราได้อัปเดตพร็อพเพอร์ตี้ "public const val" ใน Wear Compose Material3 API เป็น "public val" เพื่อหลีกเลี่ยงการแทรกค่า (Ib0f32)
  • เพิ่มการรองรับโซนการปัดจากขอบไปยัง SwipeToReveal ตอนนี้ลักษณะการทำงานเริ่มต้นของ Foundation SwipeToReveal คือการไม่อนุญาตให้ปัดเมื่อท่าทางสัมผัสเริ่มต้นจากขอบ ตอนนี้ลักษณะการทำงานเริ่มต้นของ Material3 SwipeToReveal’ คือการไม่อนุญาตให้ปัดเมื่อท่าทางสัมผัสเริ่มต้นจากขอบ เมื่อตั้งค่า SwipeDirection เป็นทิศทางเดียว (I32ef0)
  • เพิ่ม FadingExpandingLabel composable ซึ่งช่วยให้ข้อความค่อยๆ ปรากฏขึ้นพร้อมกับภาพเคลื่อนไหวทีละบรรทัด (Ic60fa)
  • TransformingLazyColumn ตอนนี้จะใช้ contentPadding ที่ว่างเปล่าโดยค่าเริ่มต้นแทนการวางรายการแรกและรายการสุดท้ายไว้ตรงกลาง (I77ab7)
  • นำ SwipeToReveal ของ rememberRevealState ออกจากไลบรารี Wear Compose Material3 (I8c0e0)

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

  • ไลบรารี Wear Compose ได้รับการอัปเดตเป็นคอมไพเลอร์ Kotlin 2.0 แล้ว (I2de79)
  • การรองรับมุมที่ไม่กลมของ ScrollIndicator และ PageIndicator ถูกนำออกจาก Material3 แล้ว นอกจากนี้ การรองรับหน้าจอสี่เหลี่ยมจัตุรัสยังไม่ใช่ส่วนหนึ่งของข้อกำหนดของ Wear OS อีกต่อไป ดูข้อมูลเพิ่มเติมได้ที่คู่มือการเริ่มต้นใช้งาน (I9a852)
  • เราได้อัปเดตCurvedTextStyleที่ใช้ใน ConfirmationDialogDefaults และ OpenOnPhoneDialogDefaults ให้ใช้การจัดรูปแบบข้อความ ArcLarge ที่มีขนาด 18sp และระยะห่างระหว่างตัวอักษร 1.8sp (Ic9ced)
  • Card, ListHeader, RadioButton, CheckboxButton, SwitchButton จะไม่จำกัดความสูงของเนื้อหาโดยค่าเริ่มต้นอีกต่อไป หากจำเป็น ให้ใช้ Modifier.height(IntrinsicSize.Min) เพื่อกู้คืนลักษณะการทำงานก่อนหน้าหากจำเป็น (I80bb8)
  • เราได้อัปเดตสีเริ่มต้นของ TimeText และ ScrollIndicator ให้มีโทนสีเทามากขึ้น เนื่องจากเมื่อใช้ OnBackground (สีขาว) โดยตรงจะทำให้มีน้ำหนักภาพมากเกินไปเมื่อเทียบกับเนื้อหาอื่นๆ บนหน้าจอ เช่น ชื่อ (I8b36f)
  • เราได้ลดระยะหมดเวลาสำหรับการเคลื่อนไหวของ TimeText และ ScrollIndicator ในคอมโพเนนต์ Scaffold เป็น 2 วินาที (I52021)
  • เราได้อัปเดตการเคลื่อนไหวของกล่องโต้ตอบเพื่อให้ขนาดของพื้นหลังของกล่องโต้ตอบซิงค์กับการปัดเพื่อปิด (I925a9)
  • เพิ่มการสาธิต M3 SwipeToReveal โดยใช้ตัวปรับแต่ง edgeSwipeToDismiss (I02b07)
  • เราได้เพิ่มส่วนหัวใน DatePicker และ TimePicker ใน TalkBack เพื่อให้ผู้ใช้ทราบว่าต้องเลื่อนเพื่อตั้งวันที่/เวลา (Id738d)
  • AnimatedText จะเป็นไปตามการตั้งค่าลดภาพเคลื่อนไหว (Ib6578)
  • การเพิ่มประสิทธิภาพเพื่อใช้ AppScaffold สำหรับเนื้อหากล่องโต้ตอบของ Display ได้รับการปรับปรุงเพื่อให้แสดงกล่องโต้ตอบหลายกล่องซ้อนกันได้ (I1209c)

เวอร์ชัน 1.0.0-alpha33

26 กุมภาพันธ์ 2025

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

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

  • เราได้นำพารามิเตอร์ป้ายกำกับออกจาก primaryAction และ secondaryAction ของ SwipeToRevealScope แล้ว นักพัฒนาแอปควรเพิ่มความหมายของการดำเนินการที่กำหนดเองลงในเนื้อหาของคอมโพเนนต์ SwipeToReveal โดยตรง (Ia67f3)
  • เราได้นำคำนำหน้า "ปุ่ม" ออกจากฟังก์ชันขนาด รูปแบบข้อความ และสีใน IconToggleButtonDefaults และ TextToggleButtonDefaults (I5471d)
  • เราได้นำ LocalMinimumInteractiveComponentEnforcement เวอร์ชันทดลอง (I4ad8a) ออกแล้ว
  • เราได้แทนที่ PickerGroupScope DSL ด้วย Composable ด้วยเหตุนี้ เราจึงนำเมธอด pickerGroupItem ออกจาก PickerGroupScope และเพิ่ม @Composable PickerGroupItem แทน ซึ่งควรใช้เพื่อเพิ่ม Picker ไปยัง PickerGroup นอกจากนี้ เรายังอัปเดตประเภทของพารามิเตอร์ PickerGroup 'content' เป็น @Composable PickerGroupScope.() -> Unit ด้วย (Ic6aec)
  • เราได้เพิ่มLevelIndicatorโอเวอร์โหลดสำหรับค่าเศษส่วน และเพิ่มคำนำหน้า Stepper ให้กับโอเวอร์โหลดที่มีพารามิเตอร์ช่วง (ซึ่งเหมาะสำหรับใช้กับคอมโพเนนต์ Stepper) (If4234)
  • เราได้เพิ่ม TransformingLazyColumnTransformationSpec ลงใน API ซึ่งช่วยให้กำหนดการเปลี่ยนรูปแบบที่แน่นอนซึ่งเกิดขึ้นกับรายการขณะเลื่อนผ่าน TLC ได้ (I21856)
  • เราได้อัปเดต IconButtonShapes, IconToggleButtonShapes, TextButtonShapes และ TextToggleButtonShapes ให้สอดคล้องกับคลาส Compose/Material3 (I5a081)
  • เราได้เพิ่มพารามิเตอร์ overscrollEffect ลงใน ScalingLazyColumn, TransformingLazyColumn และ ScreenScaffold (I0cee8)
  • เราได้เปลี่ยนชื่อพารามิเตอร์ swipeDirection เป็น revealDirection ใน rememberRevealState (I7472f)
  • ตอนนี้ Wear Pager มี PagerScope ของตัวเองแล้วแทนที่จะใช้ Compose PagerScope (I9195b)
  • เราได้นำ LinearProgressIndicatorContent composable ออกแล้ว โปรดใช้ LinearProgressIndicator โดยตรงเพื่อให้ระบบเคลื่อนไหวการเปลี่ยนแปลงค่าต่างๆ โดยค่าเริ่มต้น (I2c4ad)
  • เราได้นำ CircularProgressIndicatorStatic composable ออกและเพิ่มฟังก์ชัน DrawScope สาธารณะ drawCircularProgressIndicator ที่มีฟังก์ชันเดียวกัน โปรดใช้ CircularProgressIndicator โดยตรงเพื่อให้การเปลี่ยนแปลงเคลื่อนไหวโดยค่าเริ่มต้น แต่สร้างคอมโพสเซอร์ของคุณเองจาก drawCircularProgressIndicator หากต้องการภาพเคลื่อนไหวที่กำหนดเอง (Ie762f)
  • เราได้จัดลำดับพารามิเตอร์ใหม่ใน DrawScope.drawCircularProgressIndicator เพื่อย้ายพารามิเตอร์ targetProgress ขึ้นไป (I8ab92)
  • เราได้อัปเดต OpenOnPhoneDialog API เพื่อให้มีความชัดเจนและสอดคล้องกับกล่องโต้ตอบอื่นๆ มากขึ้น พารามิเตอร์ show เปลี่ยนชื่อเป็น visible แล้ว และตอนนี้ผู้โทรจะเป็นผู้ระบุ curvedText แทนที่จะใช้ค่าเริ่มต้น (Idec2d)
  • เราได้เปลี่ยนชื่อ openOnPhoneCurvedText เป็น openOnPhoneDialogCurvedText (I65bdd)
  • เราได้เพิ่ม ScrollIndicatorColors สำหรับการระบุสีที่กำหนดเองให้กับ ScrollIndicator (I9eb8c)
  • อนุญาตให้กำหนดค่าสีที่ใช้ในการวาดพื้นหลังด้านหลัง TimeText (I9f5d9)
  • อัปเดตการพิมพ์ ArcLarge, ArcMedium และ ArcSmall เป็น CurvedTextStyle (Iffc41)
  • เราได้นำ ScreenScaffoldDefaults.contentPaddingWithEdgeButton ออกแล้ว (Ia923e)
  • เราได้เพิ่ม errorDim ลงใน ColorScheme สำหรับข้อผิดพลาดที่มีลำดับความสำคัญสูงหรือการดำเนินการฉุกเฉิน เช่น การแจ้งเตือนด้านความปลอดภัย ภาพซ้อนทับของกล่องโต้ตอบที่ล้มเหลว หรือปุ่มหยุด (I70998)

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

  • เราได้ปักหมุด wear.compose.material3 เป็นเวอร์ชัน 1.15.0 ของ androidx.core.core (I132e9)
  • เราได้ปรับปรุงประสิทธิภาพของ Dialog โดยใช้ AppScaffold เพื่อวาง Dialog ซ้อนทับเนื้อหาอื่นๆ บนหน้าจอ (I1b9a4)
  • ลดระยะห่างจากขอบแนวตั้งภายในของ EdgeButton (I1a5bb)
  • เราได้เพิ่มความหมายของปุ่มลงในปุ่มแถบเลื่อน (I80cc6)

เวอร์ชัน 1.0.0-alpha32

29 มกราคม 2025

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

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

  • ใน CurvedTextStyle เราได้แบ่งระยะห่างระหว่างตัวอักษรออกเป็นระยะห่างระหว่างตัวอักษรตามเข็มนาฬิกาและระยะห่างระหว่างตัวอักษรทวนเข็มนาฬิกา ค่านี้เป็นข้อกำหนดเนื่องจากตัวอักษรที่หมุนตามเข็มนาฬิกาจะกางออกจากเส้นฐาน ในขณะที่ตัวอักษรที่หมุนทวนเข็มนาฬิกาจะกางเข้า (จึงต้องมีระยะห่างตัวอักษรที่มากขึ้น) (I4b848)
  • เราได้อัปเดต IconButtonShapes, IconToggleButtonShapes, TextButtonShapes และ TextToggleButtonShapes เพื่อปรับปรุงความสอดคล้องกันในไลบรารี Material3 นอกจากนี้ การเปลี่ยนแปลงนี้ยังเปิดตัวการแคชรูปร่างเพื่อลดจำนวนการจัดสรรด้วย (I049fc)
  • เราได้นำพารามิเตอร์ pressedShapeCornerSizeFraction ออกจากเมธอด variantAnimatedShape ใน IconToggleButton และ TextToggleButton (I58a65)
  • เราจะเปิดตัวการปรับปรุงการแสดงข้อความโค้ง (รวมถึง TimeText) ซึ่งใช้กับหน้าจอที่ไม่ใช่ทรงกลมไม่ได้ นอกจากนี้ การรองรับหน้าจอที่ไม่ใช่ทรงกลมก็ไม่ได้เป็นส่วนหนึ่งของข้อกำหนดของ Wear OS อีกต่อไป ดูข้อมูลเพิ่มเติมได้ที่คู่มือการเริ่มต้นใช้งาน (I1cc1c)
  • เราได้อัปเดต ButtonGroupScope ของ ButtonGroup โดยแทนที่ ButtonGroupItem ที่ใช้ DSL ด้วย Modifier.weight, Modifier.minWidth และ Modifier.enlargeOnPress (I16c3c)
  • ใน ButtonGroup API เราได้อัปเดต ButtonGroupScope ใหม่ที่อิงตามตัวแก้ไข: ตอนนี้ enlargeOnPress มีชื่อว่า animateWidth และใช้ InteractionSource แทน MutableInteractionSource เนื่องจากไม่จำเป็นต้องเปลี่ยนแปลง นอกจากนี้ เรายังเพิ่มค่าคงที่สาธารณะ ButtonGroupDefaults.DefaultMinWidth ซึ่งเป็นความกว้างขั้นต่ำเริ่มต้นของปุ่มใน ButtonGroup ด้วย (Ie27ec)
  • เราได้อัปเดต ListHeaderDefaults.contentColor ให้ขึ้นต้นด้วยตัวอักษรพิมพ์เล็กเนื่องจากเป็นพร็อพเพอร์ตี้ที่ประกอบได้ (I125a5)
  • เราได้เพิ่มพารามิเตอร์คำอธิบายเนื้อหาลงใน SliderDefaults.DecreaseIcon และ SliderDefaults.IncreaseIcon โดยมีค่าเริ่มต้นที่เหมาะสม (I2e1a7)
  • เราได้เปลี่ยนชื่อพารามิเตอร์ spacing ใน Picker และ PickerGroup เป็น verticalSpacing (Ib75cc)
  • เราได้นำ ConfirmationDialogDefaults.successText และ failureText ออกแล้วเนื่องจากคาดว่าผู้โทรของ ConfirmationDialog จะระบุสตริงที่มีบริบทเพิ่มเติม นอกจากนี้ เรายังเปลี่ยนชื่อ confirmationCurvedText เป็น confirmationDialogCurvedText ด้วย สุดท้ายนี้ เราได้เปลี่ยนชื่อพารามิเตอร์ Dialog show เป็น visible เพื่อให้สอดคล้องกับการอัปเดตกล่องโต้ตอบอื่นๆ ที่เพิ่งดำเนินการไป (I10074)
  • IconButton เปลี่ยนชื่อ disabledImageOpacity เป็น DisabledImageOpacity (I5f94a)

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

  • เราได้แก้ไขข้อบกพร่องในEdgeButtonภาพเคลื่อนไหวเพื่อให้ใช้ขนาดที่ถูกต้องในแต่ละเฟรม (Id3b58)
  • แก้ไขปัญหาที่ animateContentSize ไม่ทำงานกับ Button (Ib18a0)
  • เราได้เปลี่ยนขนาดประเภท "ชื่อขนาดใหญ่" ให้มีขนาดแบบอักษร 18dp (Ic9d52)
  • เราได้อัปเดตการเว้นวรรค AlertDialog และขนาดไอคอน (Iac28c)
  • เราได้แก้ไขความไม่สอดคล้องกันในเบรกพอยต์ของหน้าจอขนาดใหญ่ (หน้าจอที่มีขนาดตั้งแต่ 225dp ขึ้นไปถือเป็นหน้าจอขนาดใหญ่) (I36474)
  • แก้ไขข้อบกพร่องเล็กๆ น้อยๆ ในการวางตำแหน่งปุ่ม (I952c2)

เวอร์ชัน 1.0.0-alpha31

15 มกราคม 2025

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

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

  • เราได้อัปเดตไลบรารี Wear Compose ทั้งหมดเป็นโหมด "API ที่ชัดเจน" แล้ว (Iebf9f)
  • เราได้อัปเดต API ScreenScaffold และ EdgeButton เพื่อให้ระบุระยะขอบของเนื้อหาบนหน้าจอที่มี EdgeButton ได้ง่ายขึ้น ใน API ใหม่ size ของ EdgeButton จะส่งไปยัง EdgeButton เท่านั้น และ ScreenScaffold จะใช้พารามิเตอร์ edgeButtonSpacing สำหรับการเว้นวรรคระหว่าง EdgeButton กับเนื้อหารายการ (I424fd)
  • ใน DatePicker เราได้เปลี่ยนชื่อพารามิเตอร์ minDate เป็น maxDate และ minValidDate เป็น maxValidDate ใน DatePickerColors เราได้เปลี่ยนชื่อพารามิเตอร์ selectedPickerContentColor เป็น activePickerContentColor และ unselectedPickerContentColor เป็น inactivePickerContentColor (Iba17b)
  • เราได้อัปเดตค่าเริ่มต้นของ ArcProgressIndicator เป็น strokeWidth=6dp และแนะนำ diameter = 81.24% ของความสูงหน้าจอ (I6f248)
  • เราได้อัปเดต Confirmation API เพื่อให้สอดคล้องกับการใช้งานในรูปแบบกล่องโต้ตอบ ตอนนี้ Composable มีชื่อว่า ConfirmationDialog และมีการอัปเดตที่เกี่ยวข้องกับการตั้งชื่อสีและคลาสเริ่มต้น นอกจากนี้ เรายังได้เปลี่ยนชื่อพารามิเตอร์ show เป็น visible เพื่อให้เข้ากันได้กับ Compose Animation API อื่นๆ นอกจากนี้ เรายังได้เปิดตัว ConfirmationDialogContent, SuccessConfirmationDialogContent, FailureConfirmationDialogContent สำหรับกรณีที่นักพัฒนาแอปต้องการปรับแต่งภาพเคลื่อนไหวของกล่องโต้ตอบอินโทร/เอาต์โทร (Iaeb33)
  • เราได้อัปเดต CircularProgressIndicatorContent เป็น CircularProgressIndicatorStatic (CircularProgressIndicator แบบไม่มีภาพเคลื่อนไหว) เพื่อให้ตอนนี้ใช้สร้าง CircularProgressIndicator ด้วยภาพเคลื่อนไหวที่กำหนดเองได้แล้ว (I1346f)
  • เราได้แก้ไขการจัดลำดับพารามิเตอร์ใน ArcProgressIndicator โดยวางพารามิเตอร์ตัวแก้ไขไว้ก่อน (I4656a)
  • ปรับปรุง SwipeToReveal API เพื่อรับพารามิเตอร์ช่องข้อความสําหรับป้ายกํากับของการกระทํา (ยกเว้นการกระทํารอง) และเพื่อนําพารามิเตอร์ป้ายกํากับออกจากการกระทําเลิกทํา (I5b3db)

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

  • เราได้แก้ไขข้อบกพร่องที่ทำให้ระบบทริกเกอร์การสั่นLongPressมากกว่า 1 ครั้งใน Button, Card, IconButton, TextButton (Ia8b0f)
  • การเปลี่ยนแปลง UX ของ AlertDialog - ตอนนี้ปุ่มยืนยันและปุ่มปิดมีขนาดเล็กลงในหน้าจอขนาดใหญ่ นอกจากนี้ เรายังเพิ่มระยะห่างใต้ปุ่มยืนยันและปุ่มปิดด้วย (I4f066)
  • เราได้เปลี่ยนข้อกำหนดของภาพเคลื่อนไหวของป้ายกำกับปุ่มการทำงานของคอมโพเนนต์ SwipeToReveal (Ib87fb)
  • เปลี่ยน SwipeToReveal เพื่อขยายคอนเทนเนอร์พร้อมกับแสดงข้อความ (I44cf8)
  • ปรับปรุง SwipeToReveal เพื่อให้การตอบสนองแบบสัมผัสเมื่อการปัดผ่านเกณฑ์ที่การกระทำหลักได้รับการยืนยัน (I23efe)
  • เราได้อัปเดต SwipeToReveal เพื่อแสดงเครื่องหมายจุดไข่ปลาเมื่อข้อความล้นโดยค่าเริ่มต้นสำหรับการดำเนินการหลักและการเลิกทำ (I71f5a)
  • เราได้แก้ไขปัญหาที่ทำให้ภาพเคลื่อนไหว ButtonGroup กระตุกแล้ว (I63f8f)
  • เราได้เพิ่มความหมายของข้อความลงใน AnimatedText (I6063c)
  • ตอนนี้กล่องโต้ตอบจะรีเซ็ตการปรับขนาดพื้นหลังเมื่อนำกล่องโต้ตอบออกจากคอมโพสิต (หากไม่มีการแก้ไขนี้ หน้าจอเปิดอาจอยู่ในสถานะที่ลดขนาดลง) (Id24ac)
  • เราได้เพิ่มภาพเคลื่อนไหวการเปลี่ยนรูปร่างให้กับปุ่มในคอมโพเนนต์ Stepper (Id6ed3)

เวอร์ชัน 1.0.0-alpha30

11 ธันวาคม 2024

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

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

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

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

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

เวอร์ชัน 1.0.0-alpha29

13 พฤศจิกายน 2024

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

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

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

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

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

เวอร์ชัน 1.0.0-alpha28

30 ตุลาคม 2024

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

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

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

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

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

เวอร์ชัน 1.0.0-alpha27

16 ตุลาคม 2024

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

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

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

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

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

เวอร์ชัน 1.0.0-alpha26

2 ตุลาคม 2024

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

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

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

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

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

เวอร์ชัน 1.0.0-alpha25

18 กันยายน 2024

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

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

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

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

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

เวอร์ชัน 1.0.0-alpha24

4 กันยายน 2024

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

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

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

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

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

เวอร์ชัน 1.0.0-alpha23

14 พฤษภาคม 2024

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

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

  • เราได้อัปเดต 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

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

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

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

เวอร์ชัน 1.0.0-alpha21

17 เมษายน 2024

androidx.wear.compose:compose-material3:1.0.0-alpha21 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha21 มีการเปลี่ยนแปลงเหล่านี้

  • การเผยแพร่นี้เกิดขึ้นเนื่องจากปัญหาทางเทคนิคในการเผยแพร่ครั้งก่อนที่ทำให้ไม่มีไฟล์ JAR ของแหล่งที่มา ไม่มีคอมมิตใหม่ในรุ่นนี้

เวอร์ชัน 1.0.0-alpha20

3 เมษายน 2024

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

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

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

เวอร์ชัน 1.0.0-alpha19

6 มีนาคม 2024

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

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

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

เวอร์ชัน 1.0.0-alpha18

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

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

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

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

เวอร์ชัน 1.0.0-alpha17

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

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

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

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

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

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

เวอร์ชัน 1.0.0-alpha16

24 มกราคม 2024

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

ฟีเจอร์ใหม่

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

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

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

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

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

เวอร์ชัน 1.0.0-alpha15

15 พฤศจิกายน 2023

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

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

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

เวอร์ชัน 1.0.0-alpha13

4 ตุลาคม 2023

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

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

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

เวอร์ชัน 1.0.0-alpha12

20 กันยายน 2023

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

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

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

เวอร์ชัน 1.0.0-alpha11

6 กันยายน 2023

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

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

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

เวอร์ชัน 1.0.0-alpha10

23 สิงหาคม 2023

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

ฟีเจอร์ใหม่

  • เพิ่ม HorizontalPageIndicator ในไลบรารี Wear Material3 (Ifee99)

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

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

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

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

เวอร์ชัน 1.0.0-alpha09

9 สิงหาคม 2023

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

ฟีเจอร์ใหม่

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

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

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

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

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

เวอร์ชัน 1.0.0-alpha08

26 กรกฎาคม 2023

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

ฟีเจอร์ใหม่

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

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

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

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

  • เราได้อัปเดต wear.compose.foundation ให้เป็น API Dependency ของ 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 (เราได้เปลี่ยนชื่อเป็นปุ่มเพื่อให้สอดคล้องกับไลบรารี Material 3 ของ Compose) ปุ่มเริ่มต้นมีพื้นหลังแบบทึบ และมีปุ่มรูปแบบต่างๆ สำหรับ FilledTonal (พื้นหลังแบบปิดเสียง) แบบมีเส้นขอบ (โปร่งใสที่มีเส้นขอบบาง) และแบบย่อย (พื้นหลังโปร่งใสและไม่มีเส้นขอบ ใช้สำหรับการดำเนินการเสริมที่มีความโดดเด่นน้อยที่สุด) ปุ่มกลมสำหรับไอคอนและเนื้อหาข้อความแบบง่ายจะพร้อมใช้งานในการเปิดตัวในอนาคต (Ia6942)

เวอร์ชัน 1.0.0-alpha02

5 เมษายน 2023

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

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

เวอร์ชัน 1.0.0-alpha01

22 มีนาคม 2023

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

ฟีเจอร์ใหม่

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

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

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

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