Wear Compose

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

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

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

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

Groovy

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

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

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

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

Kotlin

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

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

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

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

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

ความคิดเห็น

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

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

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

Wear Compose เวอร์ชัน 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)

เวอร์ชัน 1.5.0-alpha14

23 เมษายน 2025

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

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

  • ย้ายข้อกําหนดของ Material SwipeToReveal ทั้งหมดใน Foundation SwipeToReveal ไปยังแพ็กเกจ Material แล้ว เช่น RevealValue, RevealDirection, RevealActionType, RevealState, rememberRevealState นักพัฒนาซอฟต์แวร์ควรเปลี่ยนการนําเข้าคลาสและฟังก์ชันเหล่านี้จาก androidx.wear.compose.foundation เป็น androidx.wear.compose.material (Ib7cb8)
  • อัปเดต API ของ HierarchicalFocusCoordinator ให้เป็นตัวแก้ไขแทนคอมโพสิเบิล
  • หมายเหตุการย้ายข้อมูล
    • HierarchicalFocusCoordinator(function, content) สามารถแทนที่ได้โดยเพิ่ม Modifier.hierarchicalFocus(function()) ลงใน content หรือคอมโพสิเบิลที่ล้อมรอบ
    • ActiveFocusListener { if (it) focusRequester.requestFocus() } แทนที่ได้ด้วยการเพิ่ม Modifier.hierarchicalFocusRequester(focusRequester)
    • การใช้งาน ActiveFocusListener อื่นๆ ที่พบได้น้อยจะใช้พารามิเตอร์ใหม่ใน Modifier.hierarchicalFocus ได้
    • focusRequester(rememberActiveFocusRequester()) แทนที่ได้ด้วย hierarchicalFocusRequester()
    • val focusRequester = rememberActiveFocusRequester() สามารถแทนที่ด้วย remember { FocusRequester() } และเพิ่ม Modifier.hierarchicalFocusRequester(focusRequester) (Ie319a)

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

  • เราได้เพิ่มเกณฑ์ความเร็วที่ท่าทางสัมผัสการปัดต้องเกินเพื่อทริกเกอร์การเปลี่ยนแปลงสถานะสำหรับคอมโพเนนต์ SwipeToReveal, BasicSwipeToDismissBox และ SwipeDismissableNavHost (สำหรับ SwipeDismissableNavHost จะเป็น API 35 ลงมาเท่านั้น) (If47bf)
  • แก้ไขปัญหาภาพเคลื่อนไหวเมื่อมีการเพิ่มรายการใหม่ลงใน TransformingLazyColumn (I589b2)

เวอร์ชัน 1.5.0-alpha13

9 เมษายน 2025

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

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

  • โปรเจ็กต์ที่เผยแพร่ด้วย Kotlin 2.0 ต้องใช้ KGP 2.0.0 ขึ้นไป (Idb6b5)
  • เพิ่มพร็อพเพอร์ตี้ targetPage ลงใน PagerState (I4de8b)

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

  • ป้องกันการจัดองค์ประกอบใหม่โดยไม่จำเป็นระหว่างการย้อนกลับแบบคาดคะเน (Iecd6d)
  • แก้ไขพร็อพเพอร์ตี้ isScrollable ของ ScrollInfoProvider ให้แสดงค่าปัจจุบัน (Icbfb8)

เวอร์ชัน 1.5.0-alpha12

26 มีนาคม 2025

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

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

  • ปรับปรุงการใช้งาน SwipeToReveal เริ่มต้นของ gestureInclusion ให้ละเว้นเฉพาะท่าทางสัมผัสหากสถานะของคอมโพเนนต์เป็น "ครอบคลุม" (I7e3d6)
  • สําหรับ SwipeToReveal ให้เปลี่ยน bidirectionalGestureInclusion เป็น val แทนฟังก์ชัน และเพิ่ม @FloatRange ลงในพารามิเตอร์ edgeZoneFraction ใน gestureInclusion (Ica7c3)

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

  • เปลี่ยน SwipeToReveal bidirectionalGestureInclusion ให้แสดงผลออบเจ็กต์แทนคลาส (I29597)
  • ปิดใช้การสัมผัสเมื่อทำการทดสอบภายใต้ RoboElectric (I58bd1)
  • อัปเดตระยะห่างจากขอบ SwipeToReveal ระหว่างเนื้อหากับปุ่มดำเนินการ รวมถึงระยะห่างจากขอบระหว่างไอคอนกับข้อความของปุ่มดำเนินการ (Ic46cb)

เวอร์ชัน 1.5.0-alpha11

12 มีนาคม 2025

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

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

  • อัปเดต PagerState โดยนํา Compose Foundation PagerState ออกจากคลาสพื้นฐานและเพิ่มพร็อพเพอร์ตี้ currentPage, currentPageOffsetFraction และ pageCount อัปเดตอินเทอร์เฟซ GestureInclusion โดยเปลี่ยนชื่อเมธอดเป็น ignoreGestureStart (I4ae07)
  • เพิ่ม requireOffset ลงใน SwipeToDismissBoxState เป็นวิธีแนะนำในการรับค่าออฟเซ็ต SwipeToDismissBoxState (I21042)
  • เพิ่ม CurvedModifier.semantics ซึ่งรองรับคำอธิบายเนื้อหาและดัชนีการเรียกดูในขั้นต้น (I0b093)
  • เราได้เพิ่ม CurvedModifier.clearAndSetSemantics เพื่อเป็นวิธีปิดความหมายแบบโค้ง CurvedText จะยังคงใช้ข้อความเป็นคำอธิบายเนื้อหาเริ่มต้น แต่ timeTextCurvedText และ timeTextSeparator จะไม่ประกาศเนื้อหาในตอนนี้ (I4b568)
  • เปลี่ยนชื่อการจัดการท่าทางการปัดเริ่มต้นของ HorizontalPager เป็น PagerDefaults.gestureInclusion แล้ว ตอนนี้ลักษณะการทำงานเริ่มต้นจะละเว้นเฉพาะท่าทางสัมผัสด้วยการปัดที่เริ่มต้นที่ขอบด้านซ้ายของหน้าแรก และเฉพาะในกรณีที่ Talkback ปิดอยู่เท่านั้น ในกรณีอื่นๆ ลักษณะการทำงานเริ่มต้นคือตัวเลื่อนจะไม่ละเว้นท่าทางสัมผัสด้วยการปัด ดังนั้นตัวเลื่อนจะไม่พร้อมใช้งานสำหรับตัวแฮนเดิลการปัดเพื่อปิด (Iee486)
  • เพิ่มการเลื่อนแบบหมุนสำหรับ rotaryScrollable api เพิ่มการเลื่อนผ่านและการเลื่อนที่ซ้อนกันลงในลักษณะการเลื่อน rotaryScrollable การเปลี่ยนแปลงนี้ควรทำให้การเลื่อนแบบ Overscroll และการเลื่อนแบบซ้อนกันมีประสิทธิภาพเทียบเท่ากันระหว่างการเลื่อนด้วยการสัมผัสกับการเลื่อนด้วยปุ่มหมุน (I71926)
  • เพิ่มการรองรับโซนการปัดขอบใน SwipeToReveal ตอนนี้ลักษณะการทำงานเริ่มต้นของ Foundation SwipeToReveal คือไม่อนุญาตให้ปัดเมื่อท่าทางสัมผัสเริ่มต้นจากขอบ ตอนนี้ลักษณะการทำงานเริ่มต้นของ SwipeToReveal ใน Material3 จะไม่อนุญาตให้ปัดเมื่อท่าทางสัมผัสเริ่มต้นจากขอบเมื่อตั้งค่า SwipeDirection เป็นทิศทางเดียว (I32ef0)
  • ตอนนี้ TLC ใช้ contentPadding ว่างโดยค่าเริ่มต้นแทนที่จะวางรายการแรกและรายการสุดท้ายไว้ตรงกลาง (I77ab7)

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

  • ไลบรารี Wear Compose ได้รับการอัปเดตเป็นคอมไพเลอร์ Kotlin 2.0 แล้ว (I2de79)
  • แก้ไขตัวอย่าง LetterSpacing ที่โค้งบนฐาน (Iebf7c)

เวอร์ชัน 1.5.0-alpha10

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

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

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

  • ทำให้ SwipeToRevealDefaults เป็นสาธารณะ (I0c34c)
  • เราได้แทนที่พารามิเตอร์ swipeToDismissEdgeZoneFraction ใน HorizontalPager แล้ว แต่เราได้เปิดตัวพารามิเตอร์ใหม่ gestureInclusion แทน ซึ่งสามารถใช้เพื่อเรียกใช้ลักษณะการปัดเพื่อปิดที่จำเป็น gestureInclusion จะรับอินสแตนซ์ของ GestureInclusion ซึ่งจะตัดสินใจว่าเหตุการณ์การเลื่อนที่ตามมาควรดำเนินการต่อหรือไม่ การอนุญาตท่าทางสัมผัสหมายความว่า Pager จะใช้ท่าทางสัมผัสนั้น มิเช่นนั้นระบบจะจัดการท่าทางสัมผัสที่อื่น เช่น โดยใช้ตัวแฮนเดิลการปัดเพื่อปิด ลักษณะการทำงานเริ่มต้นแบบใหม่คือ ไม่อนุญาตให้ใช้ท่าทางสัมผัสที่ขอบด้านซ้ายสุดของหน้าแรกในเพจเจอร์ และอนุญาตให้ปัดเพื่อปิดในภูมิภาคนี้ได้ หน้าอื่นๆ ทั้งหมดจะอนุญาตให้ Pager ใช้ท่าทางสัมผัสทั้งหมด ซึ่งหมายความว่าจะเรียกใช้ "ปัดเพื่อปิด" ไม่ได้ หากต้องการใช้การปัดเพื่อปิดในหน้าเว็บทั้งหมด ให้ระบุอินสแตนซ์ GestureInclusion ที่กําหนดเอง (ดู PagerDefaults.disableLeftEdgeOnFirstPage) ซึ่งไม่สนใจหน้าปัจจุบัน การเปลี่ยนแปลงที่ทำให้เกิดข้อขัดข้องอีกอย่างหนึ่งที่เรานำมาใช้ในตอนนี้คือคอมโพเนนต์ Pager จะไม่แสดงแบบเต็มหน้าจอโดยค่าเริ่มต้นอีกต่อไป แต่จะเพิ่ม Modifier.fillMaxSize() เพื่อให้แสดงลักษณะการทำงานนี้ (I9d3aa)
  • เราได้เปลี่ยนชื่อ createAnchors เป็น createRevealAnchors ใน API การปัดไปเพื่อแสดง(If5999)
  • เราได้นํา RevealScope ออกจาก API Swipe-to-Reveal แล้ว (Ie4ad5)
  • เราได้นํา "กำลังแสดง" และ "แสดงแล้ว" ออกจาก RevealValue ใน API การปัดเพื่อแสดง (I8dbc5)
  • เราได้เปลี่ยนชื่อ SwipeDirection เป็น RevealDirection ใน API ของการปัดเพื่อแสดง (I7472f)
  • เราได้เปลี่ยนลายเซ็นของพารามิเตอร์ positionalThreshold ของฟังก์ชัน rememberRevealState ของ SwipeToReveal (I29c0a)
  • เราได้เพิ่มพารามิเตอร์ overscrollEffect ใหม่ลงใน ScalingLazyColumn, TransformingLazyColumn และ ScreenScaffold (I0cee8)
  • เมื่อใช้ PagerDefaults#snapFlingBehaviour ระบบจะแทนที่พารามิเตอร์ pagerSnapDistance ด้วยพารามิเตอร์ Int maxFlingPages ซึ่งสามารถใช้เพื่อระบุจํานวนหน้าสูงสุดที่ Pager ควรแสดง (I8cfc0)
  • ตอนนี้ Wear Pager มี PagerScope ของตัวเองแล้ว แทนที่จะใช้ Compose Foundation PagerScope (I9195b)
  • เราได้เพิ่มการรองรับ lineHeight ในข้อความโค้ง (I1c936)
  • เราได้เพิ่ม initialAnchorItemIndex และ initialAnchorItemOffset ลงใน TransformingLazyColumnState และ rememberTransformingLazyColumnState เพื่อให้ระบุตำแหน่งการเลื่อนเริ่มต้นใน TransformationLazyColumn ได้ (I0a0d5)
  • เลิกใช้งาน runWithTimingDisabled และใช้ runWithMeasurementDisabled แทน ซึ่งอธิบายลักษณะการทํางานได้ชัดเจนกว่า โดยเมตริกทั้งหมดจะหยุดชั่วคราว นอกจากนี้ ให้แสดงซุปเปอร์คลาส MicrobenchmarkScope เนื่องจากคุณไม่สามารถประกาศฟังก์ชัน runWithMeasurementDisabled อีกครั้งเพื่อเปิดการเข้าถึงได้ เนื่องจากฟังก์ชันดังกล่าวอยู่ภายในบรรทัด (I9e23b, b/389149423, b/149979716)
  • เราได้เพิ่ม TransformingLazyColumnItemScrollProgress.Unspecified ลงใน API เพื่อหลีกเลี่ยงการบรรจุใน TransformingLazyColumnItemScrollProgress (I0835d)

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

  • ปรับปรุง Kdoc สำหรับ CurvedTextStyle (Id45e3)
  • เราได้ทำให้ SwipeableV2 (เป็นส่วนหนึ่งของการใช้งาน SwipeToReveal) เป็นภายในแทนที่จะเป็นสาธารณะ แต่จำกัดไว้เฉพาะกลุ่มไลบรารี (Idbb94)
  • เราได้เพิ่มการทดสอบลงใน HierarchicalFocusCoordinator (I1ce54, b/395548918) แล้ว
  • เราได้ปรับปรุง SwipeToReveal ในตัวอย่างการแต่งหน้าด้วยรองพื้น (I5f307)
  • แก้ไขข้อมูลเชิงความหมายของแกนเลื่อนสำหรับ verticalScrollAxisRange ใน TransformingLazyColumn เพื่อความสามารถในการเข้าถึง (I68123)
  • ปรับปรุงประสิทธิภาพของรีแอ็กชันการสัมผัสแบบหมุนใน Wear4 ขึ้นไปด้วยการนําเธรดพื้นหลังที่ไม่จําเป็นออก (I39cfe)
  • เปลี่ยน SwipeDismissableNavHost ไปใช้ PredictiveBackNavHost ใน API 36 ขึ้นไปเท่านั้น (I59bed)
  • เราได้เพิ่มการป้องกันการขัดข้องเมื่อเข้าถึงการตั้งค่า "ลดการเคลื่อนไหว" (I01e2c)
  • เราได้ติดตั้งใช้งานการอ่านล่วงหน้าสำหรับ TransformingLazyColumn เพื่อลดการกระตุก (Icca88)

เวอร์ชัน 1.5.0-alpha09

29 มกราคม 2025

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

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

  • ใน CurvedTextStyle เราได้แยกระยะห่างระหว่างตัวอักษรออกเป็นระยะห่างระหว่างตัวอักษรตามเข็มนาฬิกาและทวนเข็มนาฬิกา การดำเนินการนี้จำเป็นเนื่องจากตัวอักษรที่เขียนตามเข็มนาฬิกาจะกระจายออกจากเส้นฐาน ส่วนตัวอักษรที่เขียนทวนเข็มนาฬิกาจะกระจายเข้าหากัน (จึงต้องเว้นระยะตัวอักษรให้มากขึ้น) (I4b848)
  • CompositionLocal LocalReduceMotion ได้รับการปรับปรุงให้แสดงผลบูลีนแทนออบเจ็กต์ ReduceMotion อินเทอร์เฟซ ReduceMotion เลิกใช้งานแล้วในตอนนี้ การเรียกใช้ก่อนหน้านี้ เช่น LocalReduceMotion.current.enabled() สามารถแทนที่ด้วย LocalReduceMotion.current (I4937f)
  • ใน PagerDefaults นั้น snapAnimationSpec ได้เปลี่ยนชื่อเป็น SnapAnimationSpec แล้ว (I20c9a)

เวอร์ชัน 1.5.0-alpha08

15 มกราคม 2025

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

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

  • เราได้อัปเดตไลบรารี Wear Compose ทั้งหมดเป็นโหมด "API แบบระบุ" แล้ว (Iebf9f)
  • เราได้ทําให้พารามิเตอร์ภาพเคลื่อนไหวแบบสแน็ปของโปรแกรมเลื่อนหน้าเป็นส่วนหนึ่งของ PagerDefaults (Ifff64)
  • เราได้เพิ่มพารามิเตอร์ออฟเซตเป็น SwipeToDismissBoxState แล้ว (I586bd)

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

  • ตอนนี้การโต้ตอบการสัมผัสแบบแพลตฟอร์มแบบหมุนจะใช้กับ Wear OS เวอร์ชันหลังจาก V (Idb03e)

เวอร์ชัน 1.5.0-alpha07

11 ธันวาคม 2024

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

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

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

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

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

เวอร์ชัน 1.5.0-alpha06

13 พฤศจิกายน 2024

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

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

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

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

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

เวอร์ชัน 1.5.0-alpha05

30 ตุลาคม 2024

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

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

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

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

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

เวอร์ชัน 1.5.0-alpha04

16 ตุลาคม 2024

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

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

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

เวอร์ชัน 1.5.0-alpha03

2 ตุลาคม 2024

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

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

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

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

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

เวอร์ชัน 1.5.0-alpha02

18 กันยายน 2024

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

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

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

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

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

เวอร์ชัน 1.5.0-alpha01

4 กันยายน 2024

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

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

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

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

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

เวอร์ชัน 1.4

เวอร์ชัน 1.4.1

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

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

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

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

เวอร์ชัน 1.4.0

4 กันยายน 2024

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

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

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

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

เวอร์ชัน 1.4.0-rc01

21 สิงหาคม 2024

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

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

เวอร์ชัน 1.4.0-beta03

12 มิถุนายน 2024

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

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

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

เวอร์ชัน 1.4.0-beta02

29 พฤษภาคม 2024

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

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

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

เวอร์ชัน 1.4.0-beta01

14 พฤษภาคม 2024

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

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

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

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

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

เวอร์ชัน 1.4.0-alpha08

1 พฤษภาคม 2024

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

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

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

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

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

เวอร์ชัน 1.4.0-alpha07

17 เมษายน 2024

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

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

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

เวอร์ชัน 1.4.0-alpha06

3 เมษายน 2024

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

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

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

เวอร์ชัน 1.4.0-alpha05

20 มีนาคม 2024

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

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

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

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

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

เวอร์ชัน 1.4.0-alpha04

6 มีนาคม 2024

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

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

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

เวอร์ชัน 1.4.0-alpha03

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

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

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

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

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

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

เวอร์ชัน 1.4.0-alpha02

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

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

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

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

เวอร์ชัน 1.4.0-alpha01

24 มกราคม 2024

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

ฟีเจอร์ใหม่

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

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

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

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

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

เวอร์ชัน 1.3

เวอร์ชัน 1.3.1

3 เมษายน 2024

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

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

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

เวอร์ชัน 1.3.0

24 มกราคม 2024

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

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

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

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

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

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

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

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

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

เวอร์ชัน 1.3.0-rc01

10 มกราคม 2024

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

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

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

    ข้อความที่ถูกตัดที่มุม
    รูปที่ 1: ข้อความที่ถูกตัดออกที่มุม
    ข้อความไม่ได้รับการครอบตัด
    รูปที่ 2: ข้อความไม่ถูกตัด

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

เวอร์ชัน 1.3.0-beta02

13 ธันวาคม 2023

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

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

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

เวอร์ชัน 1.3.0-beta01

15 พฤศจิกายน 2023

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

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

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

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

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

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

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

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

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

เวอร์ชัน 1.3.0-alpha08

18 ตุลาคม 2023

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

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

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

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

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

เวอร์ชัน 1.3.0-alpha07

4 ตุลาคม 2023

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

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

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

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

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

เวอร์ชัน 1.3.0-alpha06

20 กันยายน 2023

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

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

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

เวอร์ชัน 1.3.0-alpha05

6 กันยายน 2023

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

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

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

เวอร์ชัน 1.3.0-alpha04

23 สิงหาคม 2023

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

ฟีเจอร์ใหม่

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

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

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

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

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

เวอร์ชัน 1.3.0-alpha03

9 สิงหาคม 2023

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

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

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

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

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

เวอร์ชัน 1.3.0-alpha02

26 กรกฎาคม 2023

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

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

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

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

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

เวอร์ชัน 1.3.0-alpha01

21 มิถุนายน 2023

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

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

  • ตามที่ได้ประกาศไว้ใน 1.2.0-alpha07 และ 1.2.0-alpha10 ตอนนี้เรากำลังเปลี่ยน DefaultTextStyle เพื่อปิดการเยื้องแบบอักษรเพื่อให้สอดคล้องกันทั่วทั้งแพลตฟอร์ม Android วิธีนี้จะช่วยแก้ปัญหาการครอบตัดข้อความด้วยแบบอักษรขนาดใหญ่ในบางกรณี และอาจส่งผลต่อเลย์เอาต์หน้าจอด้วย จึงต้องมีการอัปเดตการทดสอบภาพหน้าจอ ตัวอย่างเช่น เราเห็นการคัดลอกข้อความที่นี่ (Ic6a86)
ข้อความที่ถูกตัดออกด้วยขนาดแบบอักษรขนาดใหญ่
รูปที่ 1: ข้อความถูกตัด
  • ซึ่งจะหายไปเมื่อปิดการเยื้องแบบอักษร
ข้อความไม่ถูกตัดออกเมื่อใช้แบบอักษรขนาดใหญ่
รูปที่ 2: ข้อความไม่ถูกตัด
  • เราได้อัปเดต wear.compose.foundation ให้เป็น API ที่ต้องพึ่งพาของ wear.compose.material แล้ว (I72004, b/285404743)
  • เราได้แก้ไขข้อบกพร่องใน SwipeToDismissBox แล้ว ตอนนี้ระบบจะส่งคีย์พื้นหลังและเนื้อหาไปยังบล็อกการจดจำเพื่อให้สร้างตัวแก้ไขใหม่เมื่อมีการเปลี่ยนแปลงเนื้อหาหรือพื้นหลัง (Ib876c, b/280392104)
  • เราได้อัปเดต TimeText ให้ใช้ภาษาเมื่อเลือกรูปแบบเวลา 12 หรือ 24 ชั่วโมง (If4a3d)
  • เราได้แก้ไขความไม่สอดคล้องในพารามิเตอร์เริ่มต้นของ SwipeToDismissBox contentScrimColor แล้ว (I2d70f)
  • เราได้ปรับปรุงการจัดการการเคลื่อนไหวใน SwipeToReveal (I28fb7)

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

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

เวอร์ชัน 1.2

เวอร์ชัน 1.2.1

18 ตุลาคม 2023

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

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

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

เวอร์ชัน 1.2.0

9 สิงหาคม 2023

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

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

เวอร์ชัน 1.2.0-rc01

26 กรกฎาคม 2023

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

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

  • เราได้สรุปโปรไฟล์พื้นฐานสำหรับรุ่น 1.2 (Id5740) แล้ว

เวอร์ชัน 1.2.0-beta02

7 มิถุนายน 2023

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

ฟีเจอร์ใหม่

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

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

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

เวอร์ชัน 1.2.0-beta01

24 พฤษภาคม 2023

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

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

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

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

ฟีเจอร์ใหม่

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

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

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

เวอร์ชัน 1.2.0-alpha10

10 พฤษภาคม 2023

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

ฟีเจอร์ใหม่

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

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

  • เราได้เพิ่ม RevealScope ลงในคอมโพสิชันการดำเนินการใน SwipeToReveal ซึ่งจะให้สิทธิ์เข้าถึงออฟเซตที่แสดงการดำเนินการเพิ่มเติม (I3fd56)

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

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

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

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

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

ข้อความที่ถูกตัดออกด้วยขนาดแบบอักษรขนาดใหญ่
รูปที่ 1: ข้อความถูกตัด
  • ซึ่งจะหายไปเมื่อปิดการเยื้องแบบอักษร
ข้อความไม่ถูกตัดออกเมื่อใช้แบบอักษรขนาดใหญ่
รูปที่ 2: ข้อความไม่ถูกตัด

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

เวอร์ชัน 1.2.0-alpha09

19 เมษายน 2023

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

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

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

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

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

เวอร์ชัน 1.2.0-alpha08

5 เมษายน 2023

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

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

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

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

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

เวอร์ชัน 1.2.0-alpha07

22 มีนาคม 2023

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

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

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

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

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

เวอร์ชัน 1.2.0-alpha06

8 มีนาคม 2023

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

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

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

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

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

เวอร์ชัน 1.2.0-alpha05

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

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

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

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

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

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

เวอร์ชัน 1.2.0-alpha04

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

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

ฟีเจอร์ใหม่

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

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

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

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

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

เวอร์ชัน 1.2.0-alpha03

25 มกราคม 2023

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

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

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

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

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

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

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

เวอร์ชัน 1.2.0-alpha02

11 มกราคม 2023

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

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

  • ตอนนี้การทดสอบ UI ของ Android Compose จะเรียกใช้การวางเลย์เอาต์สำหรับแต่ละเฟรมเมื่อเรียกใช้เฟรมเพื่อเข้าสู่สถานะไม่ทำงาน (เช่น ผ่าน waitForIdle) ซึ่งอาจส่งผลต่อการทดสอบที่ยืนยันในเฟรมแต่ละเฟรมของภาพเคลื่อนไหวของเลย์เอาต์ (I8ea08, b/222093277)
  • เพิ่มพารามิเตอร์ minLines ลงในข้อความ Wear เพื่อให้ทำงานได้สอดคล้องกันกับ BasicText (I24874)
  • CompactChipTapTargetPadding ได้รับการเผยแพร่แบบสาธารณะเพื่อให้ปรากฏในเอกสารประกอบ (If1e70, b/234119038)

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

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

เวอร์ชัน 1.2.0-alpha01

7 ธันวาคม 2022

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

ฟีเจอร์ใหม่

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

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

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

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

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

เวอร์ชัน 1.1

เวอร์ชัน 1.1.2

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

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

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

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

เวอร์ชัน 1.1.1

11 มกราคม 2023

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

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

  • PlaceholderState.rememberPlaceholderState() อัปเดตให้ใช้ rememberUpdatedState เพื่อให้สถานะอัปเดตหากเป็น Lambda onContentReady (I02635, b/260343754)

เวอร์ชัน 1.1.0

7 ธันวาคม 2022

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

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

ฟีเจอร์ใหม่

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

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

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

เวอร์ชัน 1.1.0-rc01

9 พฤศจิกายน 2022

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

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

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

เวอร์ชัน 1.1.0-beta01

24 ตุลาคม 2022

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

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

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

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

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

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

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

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

เวอร์ชัน 1.1.0-alpha07

5 ตุลาคม 2022

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

ฟีเจอร์ใหม่

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

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

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

เวอร์ชัน 1.1.0-alpha06

21 กันยายน 2022

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

ฟีเจอร์ใหม่

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

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

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

เวอร์ชัน 1.1.0-alpha05

7 กันยายน 2022

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

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

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

เวอร์ชัน 1.1.0-alpha04

24 สิงหาคม 2022

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

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

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

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

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

เวอร์ชัน 1.1.0-alpha03

10 สิงหาคม 2022

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

ฟีเจอร์ใหม่

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

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

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

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

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

เวอร์ชัน 1.1.0-alpha02

27 กรกฎาคม 2022

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

ฟีเจอร์ใหม่

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

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

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

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

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

เวอร์ชัน 1.1.0-alpha01

29 มิถุนายน 2022

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

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

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

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

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

รุ่น 1.0

เวอร์ชัน 1.0.2

7 กันยายน 2022

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

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

  • เราได้แก้ไขลําดับ z ของตำแหน่งและตัวบ่งชี้หน้าใน Scaffold แล้ว ตอนนี้ตัวบ่งชี้จะวางอยู่ด้านบนของขอบมืด จึงไม่ถูกบดบังโดยขอบมืดหากมี (Ib988f, b/244207528)

เวอร์ชัน 1.0.1

24 สิงหาคม 2022

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

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

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

เวอร์ชัน 1.0.0

27 กรกฎาคม 2022

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

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

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

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

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

เวอร์ชัน 1.0.0-rc02

22 มิถุนายน 2022

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

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

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

เวอร์ชัน 1.0.0-rc01

15 มิถุนายน 2022

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

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

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

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

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

เวอร์ชัน 1.0.0-beta03

1 มิถุนายน 2022

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

ฟีเจอร์ใหม่

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

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

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

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

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

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

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

เวอร์ชัน 1.0.0-beta02

18 พฤษภาคม 2022

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

ฟีเจอร์ใหม่

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

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

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

เวอร์ชัน 1.0.0-beta01

11 พฤษภาคม 2022

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

เวอร์ชัน 1.0.0-alpha21

20 เมษายน 2022

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

ฟีเจอร์ใหม่

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

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

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

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

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

เวอร์ชัน 1.0.0-alpha20

6 เมษายน 2022

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

ฟีเจอร์ใหม่

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

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

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

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

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

เวอร์ชัน 1.0.0-alpha19

23 มีนาคม 2022

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

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

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

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

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

เวอร์ชัน 1.0.0-alpha18

9 มีนาคม 2022

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

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

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

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

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

เวอร์ชัน 1.0.0-alpha17

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

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

ฟีเจอร์ใหม่

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

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

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

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

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

เวอร์ชัน 1.0.0-alpha16

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

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

ฟีเจอร์ใหม่

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

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

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

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

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

เวอร์ชัน 1.0.0-alpha15

26 มกราคม 2022

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

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

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

เวอร์ชัน 1.0.0-alpha14

12 มกราคม 2022

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

ฟีเจอร์ใหม่

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

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

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

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

    โดยวิธีการใหม่คือ scrollTo, animatedScrollTo, centerItemIndex และ centerItemOffset (I61b61)

  • เราได้เพิ่มตัวแฮนเดิลปุ่มย้อนกลับไปยัง SwipeDismissableNavHost เพื่อให้การกดย้อนกลับไปยังระดับก่อนหน้าในลําดับชั้นการนําทาง (I5b086, b/210205624)

เวอร์ชัน 1.0.0-alpha13

15 ธันวาคม 2021

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

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

  • เราได้ทําให้ RangeIcons เป็นภายใน (อ้างอิงภายในด้วย InlineSlider และ Stepper) (I927ec)

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

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

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

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

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

เวอร์ชัน 1.0.0-alpha12

1 ธันวาคม 2021

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

ฟีเจอร์ใหม่

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

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

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

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

เวอร์ชัน 1.0.0-alpha11

17 พฤศจิกายน 2021

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

ฟีเจอร์ใหม่

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

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

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

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

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

เวอร์ชัน 1.0.0-alpha10

3 พฤศจิกายน 2021

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

ฟีเจอร์ใหม่

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

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

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

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

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

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

เวอร์ชัน 1.0.0-alpha09

27 ตุลาคม 2021

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

ฟีเจอร์ใหม่

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

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

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

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

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

เวอร์ชัน 1.0.0-alpha08

13 ตุลาคม 2021

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

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

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

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

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

เวอร์ชัน 1.0.0-alpha07

29 กันยายน 2021

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

ฟีเจอร์ใหม่

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

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

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

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

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

เวอร์ชัน 1.0.0-alpha06

15 กันยายน 2021

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

ฟีเจอร์ใหม่

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

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

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

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

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

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

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

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

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

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

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

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

เวอร์ชัน 1.0.0-alpha05

1 กันยายน 2021

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

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

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

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

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

เวอร์ชัน 1.0.0-alpha04

18 สิงหาคม 2021

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

ฟีเจอร์ใหม่

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

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

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

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

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

เวอร์ชัน 1.0.0-alpha03

4 สิงหาคม 2021

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

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

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

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

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

เวอร์ชัน 1.0.0-alpha02

21 กรกฎาคม 2021

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

ฟีเจอร์ใหม่

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

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

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

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

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

เวอร์ชัน 1.0.0-alpha01

1 กรกฎาคม 2021

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

ฟีเจอร์ใหม่

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

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

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

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

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

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