Wear Compose Material 3

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

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

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

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

ดึงดูด

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

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

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

    // For Wear preview annotations
    implementation("androidx.wear.compose:compose-ui-tooling:1.5.0-beta03")
    
    // 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-beta03")

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

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

    // 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-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 รายการแรกจะกลับหัว และเราจะใช้ตัวปรับเปลี่ยนที่ส่งผ่านระหว่างรายการดังกล่าว ดังนั้นรายการดังกล่าวจะได้รับผลกระทบจากการเปลี่ยนรูปแบบคอนเทนเนอร์ การแก้ไขนี้จะช่วยแก้ปัญหาต่างๆ เช่น การใช้เอฟเฟกต์ระยิบระยับของตัวยึดตําแหน่งกับองค์ประกอบใน TLC โดยใช้พารามิเตอร์การเปลี่ยนรูปแบบ (I786cf)
  • เพิ่ม RevealState.Saver เพื่อใช้กู้คืนสถานะของ SwipeToReveal เมื่อสร้างกิจกรรมหรือกระบวนการอีกครั้ง ตอนนี้ฟังก์ชัน rememberRevealState ใช้ Saver นี้โดยค่าเริ่มต้น (Ie0ecb)
  • ปุ่มการดําเนินการหลักและรอง SwipeToReveal ควรมีค่าเริ่มต้นเป็น ButtonDefault.Height (แก้ไขข้อบกพร่องที่ปุ่มเหล่านี้ใช้ความสูงสูงสุดสําหรับปุ่มที่สูงกว่า) (Ibfba1)
  • เปลี่ยน SwipeToReveal เพื่อรีเซ็ตคอมโพเนนต์ล่าสุดที่มีการโต้ตอบด้วยเมื่อใช้ท่าทางปัดไปทางขวา (Ia8450)
  • SwipeToReveal มีการเปลี่ยนแปลงให้อยู่ในสถานะ Revealing เมื่อตำแหน่งสิ้นสุดของการปัดอยู่ตรงกลางระหว่างจุดยึดที่แสดงและที่แสดงอยู่ และอยู่ใกล้กับจุดยึดที่แสดง (If4458)
  • ตอนนี้เนื้อหาของ ButtonGroup กลับด้านอย่างถูกต้องในเลย์เอาต์ RTL แล้ว (Ib378d)
  • ขณะนี้ AnimatedText รองรับการวางแนวข้อความ RTL แล้ว (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 เป็น "เท็จ" (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 มีการคอมมิตเหล่านี้

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

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

  • MaterialTheme สำหรับชุดสี การจัดวางตัวอักษร และรูปร่างที่อัปเดตและขยายการให้บริการเพื่อเพิ่มความลึกและความหลากหลายให้กับการออกแบบ
  • ธีมสีแบบไดนามิกซึ่งจะสร้างรูปแบบสีให้แอปโดยอัตโนมัติเพื่อให้เข้ากับสีของหน้าปัด
  • คอมโพเนนต์ใหม่จะปรับให้เหมาะกับหน้าจอขนาดใหญ่ขึ้นโดยอัตโนมัติโดยค่าเริ่มต้น
  • การเปลี่ยนรูปร่าง - คอมโพเนนต์ปุ่มกลม เช่น IconButton, TextButton, IconToggleButton และ TextToggleButton รองรับรูปแบบต่างๆ ที่เคลื่อนไหวเมื่อกดหรือเลือก
  • EdgeButton - ปุ่มใหม่ที่แนบไปกับขอบที่มีรูปร่างพิเศษซึ่งออกแบบมาสำหรับด้านล่างของหน้าจอ
  • Scaffolds - แนะนำ 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
  • ตัวยึดตําแหน่ง - วาดโครงร่างรูปทรงเหนือคอมโพเนนต์สําหรับกรณีที่ไม่มีเนื้อหาชั่วคราว
  • แถบเลื่อนและตัวควบคุมค่า - ทั้งแถบเลื่อนและตัวควบคุมค่าช่วยให้ผู้ใช้เลือกจากช่วงค่าได้ แถบเลื่อนมีขนาดกะทัดรัดกว่าและแบ่งกลุ่มได้ ส่วนตัวควบคุมขั้นตอนเป็นคอมโพเนนต์แบบเต็มหน้าจอที่มักจะจับคู่กับ StepperLevelIndicator
  • SwipeToReveal - ใช้เพื่อเพิ่มการดำเนินการเพิ่มเติมลงในคอมโพสิเบิลเมื่อปัดไปจากขวาไปซ้าย

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

  • TransformingLazyColumn - รายการแบบเลื่อนแนวตั้งแบบ Lazy ที่รองรับการปรับขนาดและภาพเคลื่อนไหวการเปลี่ยนรูปแบบ
  • กลุ่มโฟกัสตามลําดับชั้น - ใช้เพื่อกำกับเนื้อหาคอมโพสิเบิลในแอปพลิเคชัน เพื่อติดตามส่วนที่ใช้งานอยู่ขององค์ประกอบและประสานโฟกัส
  • 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 แล้ว และใช้ SwipeToReveal API ใน Wear Compose Material และ Wear Compose Material3 แทน โปรดแทนที่การนําเข้า Wear Foundation SwipeToReveal ด้วยการนําเข้า Wear Compose Material/ Wear Compose Material3 เพื่อใช้ API ต่อไป (Ia147d)
  • ย้าย SwipeToReveal ของ Wear Compose Material3 ที่ใช้ 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 ลงในคอมโพสิชัน SwipeToReveal นำความสามารถในการปรับแต่ง positionalThreshold และ animationSpec ออกจาก RevealState นำ lastActionType, revealThreshold และ width ออกจาก RevealState เปลี่ยนคอนสตรัคเตอร์ RevealState ให้ยอมรับ RevealDirection แทนที่จะเป็นจุดยึด นำฟังก์ชัน createRevealAnchors, จุดยึด และ bidirectionalAnchors ออก เปลี่ยนชื่อฟังก์ชัน SwipeToRevealScope primaryAction, secondaryAction, undoPrimaryAction และ undoSecondaryAction เป็น PrimaryActionButton, SecondaryActionButton, UndoActionButton และเปลี่ยนเป็นฟังก์ชัน Composable ทำเครื่องหมาย RevealActionType เป็นภายใน (I885d0)
  • อัปเดต SwipeToReveal API เพิ่มเติมดังนี้ เปลี่ยนชื่อ onFullSwipe เป็น onSwipePrimaryAction เปลี่ยนชื่อ SwipeToRevealNonAnchoredSample เพื่อระบุการใช้พารามิเตอร์ hasPartiallyRevealedState นำ actionButtonHeight ออก เนื่องจากค่าเริ่มต้นคือความสูงเริ่มต้นของ Button และสามารถตั้งค่าความสูงที่ใหญ่ขึ้นได้โดยใช้ตัวแก้ไข นำ SmallActionButtonHeight ออกจาก SwipeToRevealDefaults ทำให้พารามิเตอร์ค่าในคอนสตรัคเตอร์ RevealValue และ RevealDirection เป็นแบบส่วนตัว (I465ce)

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

  • แก้ไขการจัดการ EdgeButton ของ ScreenScaffold เพื่อให้ EdgeButton เคลื่อนไหวเข้าที่หลังจากนำรายการ TransformingLazyColumn ออก (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 ไปยังเธรดสำหรับงาน เนื่องจากทำให้เกิดปัญหาในแอปที่จัดการการแยกชุดข้อความของตนเองระหว่างการนําทาง (I34d02)
  • อัปเดตตัวอย่างเครื่องมือเลือกเพื่อนำการเรียกใช้การจดจำที่ไม่จำเป็นออก และใช้ rememberUpdatedState ในเครื่องมือเลือกเพื่อจดจำฟังก์ชัน 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)
  • แทนที่คอมโพสิเบิล 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)

การอัปเดตทรัพยากร Dependency

  • ตอนนี้ไลบรารีนี้กำหนดเป้าหมายเป็นภาษา 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 โดยนํา Compose Foundation PagerState ออกจากคลาสพื้นฐานและเพิ่มพร็อพเพอร์ตี้ currentPage, currentPageOffsetFraction และ pageCount อัปเดตอินเทอร์เฟซ GestureInclusion โดยเปลี่ยนชื่อเมธอดเป็น ignoreGestureStart (I4ae07)
  • ตอนนี้พารามิเตอร์มุมการกวาด LevelIndicator ได้รับการกำกับเนื้อหาด้วย FloatRange(0, 360) แล้ว (I7e636)
  • เราได้เพิ่ม 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 คือไม่อนุญาตให้ปัดเมื่อท่าทางสัมผัสเริ่มต้นจากขอบ ตอนนี้ลักษณะการทำงานเริ่มต้นของ SwipeToReveal’ ใน Material3 คือไม่อนุญาตให้ปัดเมื่อท่าทางสัมผัสเริ่มต้นจากขอบ เมื่อตั้งค่า SwipeDirection เป็นทิศทางเดียว (I32ef0)
  • เพิ่มคอมโพสิเบิล FadingExpandingLabel ซึ่งช่วยให้ข้อความค่อยๆ ปรากฏขึ้นทีละบรรทัดด้วยภาพเคลื่อนไหว (Ic60fa)
  • ตอนนี้ TransformingLazyColumn ใช้ contentPadding ว่างโดยค่าเริ่มต้นแทนการวางรายการแรกและรายการสุดท้ายไว้ตรงกลาง (I77ab7)
  • นำ rememberRevealState ของ SwipeToReveal ออกจากไลบรารี Material3 ของ Wear Compose (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 ในคอมโพเนนต์สแคฟเฟิลดเป็น 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)
  • เราได้นําคำนำหน้า "Button" ออกจากฟังก์ชันขนาด รูปแบบข้อความ และสีใน IconToggleButtonDefaults และ TextToggleButtonDefaults แล้ว (I5471d)
  • เราได้นํา LocalMinimumInteractiveComponentEnforcement (I4ad8a) เวอร์ชันทดลองออกแล้ว
  • เราได้แทนที่ PickerGroupScope DSL ด้วยคอมโพสิเบิล ด้วยเหตุนี้ เราจึงนําเมธอด pickerGroupItem ออกจาก PickerGroupScope และเพิ่ม @Composable PickerGroupItem แทน ซึ่งควรใช้เพื่อเพิ่มเครื่องมือเลือกลงใน PickerGroup นอกจากนี้ เรายังได้อัปเดตประเภทพารามิเตอร์ "content" ของ PickerGroup เป็น @Composable PickerGroupScope.() -> Unit ด้วย (Ic6aec)
  • เราได้เพิ่มการโอเวอร์โหลด LevelIndicator สำหรับค่าทศนิยม และเพิ่มคำนำหน้า Stepper ไปยังการโอเวอร์โหลดเหล่านั้นซึ่งมีพารามิเตอร์ช่วง (ซึ่งเหมาะสำหรับใช้กับคอมโพเนนต์ Stepper) (If4234)
  • เราได้เพิ่ม TransformingLazyColumn ของ TransformationSpec ลงใน 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 ออกแล้ว โปรดใช้ LinearProgressIndicator โดยตรงเพื่อให้การเปลี่ยนแปลงค่าแสดงเป็นภาพเคลื่อนไหวโดยค่าเริ่มต้น (I2c4ad)
  • เราได้นํา CircularProgressIndicatorStatic แบบคอมโพสิเบิลออกและเพิ่มฟังก์ชัน 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) แล้ว
  • เราได้ปรับปรุงประสิทธิภาพของกล่องโต้ตอบโดยใช้ AppScaffold เพื่อวางซ้อนกล่องโต้ตอบบนเนื้อหาอื่นๆ บนหน้าจอ (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 ด้วย สุดท้ายนี้ เราได้เปลี่ยนชื่อพารามิเตอร์กล่องโต้ตอบ 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)
  • เราได้อัปเดต ScreenScaffold และ EdgeButton API เพื่อให้ระบุการเว้นวรรคเนื้อหาบนหน้าจอที่มี 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 ให้สอดคล้องกับการใช้งานเป็นกล่องโต้ตอบ ตอนนี้คอมโพสิเบิลเปลี่ยนชื่อเป็น 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 ให้แสดงเครื่องหมายจุด 3 จุดเมื่อข้อความแสดงเกินขอบโดยค่าเริ่มต้นสําหรับการดําเนินการหลักและการเลิกทำ (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 ซึ่งเนื้อหาสำหรับช่องเหล่านี้จะสร้างได้ตามปกติจากคอมโพสิชันไอคอน (Id35da)
  • เราได้อัปเดต dynamicColorScheme โดยนําพารามิเตอร์ defaultColorScheme ที่ไม่บังคับออก และตอนนี้จะแสดงผล ColorScheme แบบ Null ได้ ซึ่งหมายความว่าผู้เรียกใช้ต้องจัดการกรณีสำรองอย่างชัดเจนเมื่อไม่ได้ระบุชุดรูปแบบสีแบบไดนามิก (I6d62e)
  • เราได้อัปเดตขนาดไอคอนใน ButtonDefaults เพื่อใช้กับ CompactButton CompactButton ที่มีเฉพาะไอคอนควรใช้ ButtonDefaults.SmallIconSize = 24.dp ส่วนCompactButton ที่มีทั้งไอคอนและข้อความควรใช้ ButtonDefaults.ExtraSmallIconSize = 20.dp ขอแนะนำให้ CompactButton ตัดเนื้อหา (แทนที่จะแสดงเต็มความกว้างสูงสุด) และอัปเดตตัวอย่างเพื่อแสดงข้อมูลดังกล่าว (I0582c)
  • เราได้เพิ่ม EdgeButtonDefaults ที่มีขนาดไอคอนที่แนะนำสำหรับ EdgeButtonSizes 4 รายการที่แตกต่างกัน นอกจากนี้ เรายังได้อัปเดตเลย์เอาต์ EdgeButton เพื่อให้มีระยะห่างจากขอบด้านล่างมากกว่าระยะห่างจากขอบด้านบนเล็กน้อย ซึ่งช่วยปรับปรุงลักษณะที่ปรากฏของทั้งเนื้อหาไอคอนและข้อความ (Id772a)
  • เราได้เพิ่มการเคลื่อนไหวลงใน LinearProgressIndicator และแสดง LinearProgressIndicatorContent ซึ่งให้เนื้อหาภาพที่ไม่มีภาพเคลื่อนไหว (Idee99)
  • เราได้เพิ่มคอมโพสิชัน CircularProgressIndicatorContent ใหม่เพื่อแสดงเนื้อหาภาพ CircularProgressIndicator โดยไม่ให้มีภาพเคลื่อนไหว (Ie33d4)
  • TransformingLazyColumn เพิ่มองค์ประกอบ LocalTransformingLazyColumnItemScope ใหม่ ซึ่งตอนนี้ Card, Button และ ListHeader ใช้เพื่อเปลี่ยนรูปร่างโดยอัตโนมัติเมื่อวางไว้ใน TransformingLazyColumn ผู้โทรสามารถปิดใช้การเปลี่ยนรูปแบบอัตโนมัติได้โดยใช้ TransformExclusion wrapper ใหม่ (I1652f)
  • เราได้อัปเดตประเภทของ ButtonDefaults.shape เป็น RoundedCornerShape (Iccdf2) แล้ว

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

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

เวอร์ชัน 1.0.0-alpha29

13 พฤศจิกายน 2024

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

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

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

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

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

เวอร์ชัน 1.0.0-alpha28

30 ตุลาคม 2024

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

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

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

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

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

เวอร์ชัน 1.0.0-alpha27

16 ตุลาคม 2024

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

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

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

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

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

เวอร์ชัน 1.0.0-alpha26

2 ตุลาคม 2024

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

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

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

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

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

เวอร์ชัน 1.0.0-alpha25

18 กันยายน 2024

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

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

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

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

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

เวอร์ชัน 1.0.0-alpha24

4 กันยายน 2024

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

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

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

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

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

เวอร์ชัน 1.0.0-alpha23

14 พฤษภาคม 2024

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

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

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

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

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

เวอร์ชัน 1.0.0-alpha22

1 พฤษภาคม 2024

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

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

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

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

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

เวอร์ชัน 1.0.0-alpha21

17 เมษายน 2024

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

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

เวอร์ชัน 1.0.0-alpha20

3 เมษายน 2024

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

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

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

เวอร์ชัน 1.0.0-alpha19

6 มีนาคม 2024

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

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

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

เวอร์ชัน 1.0.0-alpha18

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

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

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

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

เวอร์ชัน 1.0.0-alpha17

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

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

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

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

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

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

เวอร์ชัน 1.0.0-alpha16

24 มกราคม 2024

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

ฟีเจอร์ใหม่

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

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

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

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

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

เวอร์ชัน 1.0.0-alpha15

15 พฤศจิกายน 2023

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

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

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

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

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

เวอร์ชัน 1.0.0-alpha14

18 ตุลาคม 2023

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

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

  • เราได้นําพารามิเตอร์ indicatorStyle ออกจาก Material3 HorizontalPageIndicator แล้ว โดยระบบจะเป็นไปตามรูปร่างของหน้าจออุปกรณ์ (แนวนอนหรือกลม) (I83728)
  • เราได้แยกสีสำหรับ SplitToggleButton ออกจากสีสำหรับ ToggleButton โดยการเพิ่มคลาส SplitToggleButtonColors ใหม่ (I78bee)

เวอร์ชัน 1.0.0-alpha13

4 ตุลาคม 2023

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

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

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

เวอร์ชัน 1.0.0-alpha12

20 กันยายน 2023

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

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

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

เวอร์ชัน 1.0.0-alpha11

6 กันยายน 2023

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

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

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

เวอร์ชัน 1.0.0-alpha10

23 สิงหาคม 2023

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

ฟีเจอร์ใหม่

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

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

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

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

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

เวอร์ชัน 1.0.0-alpha09

9 สิงหาคม 2023

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

ฟีเจอร์ใหม่

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

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

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

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

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

เวอร์ชัน 1.0.0-alpha08

26 กรกฎาคม 2023

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

ฟีเจอร์ใหม่

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

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

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

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

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

เวอร์ชัน 1.0.0-alpha07

21 มิถุนายน 2023

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

ฟีเจอร์ใหม่

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

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

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

เวอร์ชัน 1.0.0-alpha06

7 มิถุนายน 2023

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

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

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

เวอร์ชัน 1.0.0-alpha05

24 พฤษภาคม 2023

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

ฟีเจอร์ใหม่

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

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

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

เวอร์ชัน 1.0.0-alpha04

10 พฤษภาคม 2023

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

ฟีเจอร์ใหม่

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

เวอร์ชัน 1.0.0-alpha03

19 เมษายน 2023

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

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

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

เวอร์ชัน 1.0.0-alpha02

5 เมษายน 2023

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

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

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

เวอร์ชัน 1.0.0-alpha01

22 มีนาคม 2023

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

ฟีเจอร์ใหม่

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

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

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

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