เขียน Material3 แบบปรับอัตโนมัติ

  
ใช้ไลบรารีแบบปรับอัตโนมัติของ Material 3 เพื่อสร้าง UI แบบปรับอัตโนมัติ ซึ่งจะปรับตัวโดยอัตโนมัติตามกรอบเวลาปัจจุบัน เช่น คลาสขนาดหน้าต่างหรือลักษณะการทำงานของอุปกรณ์ ห้องสมุดจะมี ทั้งการใช้งานนั่งร้านเริ่มต้นและ Composable ขององค์ประกอบที่ใช้สร้างสรรค์ที่จำเป็น เพื่อสร้างประสบการณ์ที่กำหนดเอง
อัปเดตล่าสุด รุ่นที่เสถียร ตัวเลือกถอนการอ้างสิทธิ์ รุ่นเบต้า รุ่นอัลฟ่า
4 กันยายน 2024 1.0.0 - - 1.1.0-alpha02

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

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

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

ดึงดูด

dependencies {
    implementation "androidx.compose.material3.adaptive:adaptive:1.1.0-alpha02"
    implementation "androidx.compose.material3.adaptive:adaptive-layout:1.1.0-alpha02"
    implementation "androidx.compose.material3.adaptive:adaptive-navigation:1.1.0-alpha02"
}

Kotlin

dependencies {
    implementation("androidx.compose.material3.adaptive:adaptive:1.1.0-alpha02")
    implementation "androidx.compose.material3.adaptive:adaptive-layout:1.1.0-alpha02"
    implementation "androidx.compose.material3.adaptive:adaptive-navigation:1.1.0-alpha02"
}

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

ความคิดเห็น

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

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

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

เขียน Material3 Adaptive Version 1.1

เวอร์ชัน 1.1.0-alpha02

4 กันยายน 2024

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

ฟีเจอร์ใหม่

  • ผู้ผลิตรองรับการปรับแต่งการเคลื่อนไหว (I0bf9c), (I80e66) ในการเปลี่ยนแปลงการเคลื่อนที่เริ่มต้นระหว่างที่มีการเปลี่ยนแปลงสถานะของโครงยึดแบบปรับเปลี่ยนได้ ผู้ผลิตสามารถเลือกจากชุดการเปลี่ยนเริ่มต้นเข้าและออก หรือจะใช้การเปลี่ยนที่กำหนดเองโดยเฉพาะด้วยข้อมูลที่ให้ไว้ผ่านขอบเขตการเคลื่อนไหวใหม่
  • ใช้ภาพเคลื่อนไหวแบบจางลงของแฮนเดิลการลากสำหรับการขยายแผง (46e3c69)
  • ทำให้เป็นที่จดจำ PaneExpansionState บันทึกได้ (61ff76f)

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

  • เพิ่ม APis การขยายแผงที่ขาดหายไปลงในนั่งร้าน (Ic5bc0)
  • ThreePaneScaffoldDestinationItem.content เปลี่ยนชื่อเป็น contentKey เปลี่ยนอาร์กิวเมนต์ประเภทเริ่มต้น rememberListDetailPaneScaffoldNavigator และ rememberSupportingPaneScaffoldNavigator จาก Nothing เป็น Any (I58749)
  • ทำเครื่องหมายว่า ThreePaneScaffoldState เสถียร (I64aec)
  • กําหนดขอบเขตพารามิเตอร์แฮนเดิลสำหรับการลาก (Ic0aa2)

เวอร์ชัน 1.1.0-alpha01

21 สิงหาคม 2024

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

ฟีเจอร์ใหม่

  • เปิดตัวการรองรับการขยายแผงของนั่งร้านแบบปรับเปลี่ยนได้

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

  • แนะนำ API การขยายแผงต่อสาธารณะ (I301d6)
  • แนะนำ ThreePaneScaffoldState เพื่อควบคุมการเปลี่ยนค่าของแผง เพิ่มโอเวอร์โหลดของ ListDetailPaneScaffold และ SupportingPaneScaffold ซึ่งยอมรับสถานะนี้ (I5db3b)
  • แนะนำคีย์การขยายแผงและอินเทอร์เฟซผู้ให้บริการหลัก (Id621f)

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

  • แก้ไขการคำนวณพาร์ติชันที่ไม่ถูกต้องเมื่อมีบานพับที่ยกเว้น (9dfd483)

เขียน Material3 Adaptive Version 1.0

เวอร์ชัน 1.0.0

4 กันยายน 2024

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

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

  • ฟังก์ชัน Composable แบบบรรทัดเดียว currentWindowSize(), collectFoldingFeaturesAsState() และ currentWindowAdaptiveInfo() เพื่อรับข้อมูลหน้าต่างที่จําเป็นในการปรับแอป เช่น ขนาดหน้าต่างและฟีเจอร์การพับ
  • ListDetailPaneScaffold และ SupportingPaneScaffold เพื่อระบุเลย์เอาต์หน้า Canonical ของ Material3 จำนวน 2 รูปแบบซึ่งจะปรับตัวเองโดยอัตโนมัติตามการกำหนดค่าหน้าต่างที่แตกต่างกัน นอกจากนี้ นั่งร้านทั้ง 2 แบบนี้ยังปรับแต่งได้ทั้งหมดเพื่อให้เหมาะกับความต้องการที่แตกต่างกันของผู้สร้างด้วย
  • ThreePaneScaffoldNavigator และฟังก์ชันการจดจำที่เกี่ยวข้อง, rememberListDetailPaneScaffoldNavigator() และ rememberSupportingPaneScaffoldNavigator() เพื่อมอบโซลูชันการนำทางภายในนั่งร้านแบบปรับเปลี่ยนได้ ซึ่งสามารถแสดงจุดหมายการนำทางหลายแห่งพร้อมกันได้ เมื่อเทียบกับการตั้งค่าแบบครั้งละ 1 จุดที่ใช้กันทั่วไปในโลกที่ไม่สามารถปรับตัวได้
  • ภาพเคลื่อนไหว Material3 ในตัวเริ่มต้นเมื่อเปลี่ยนสถานะนั่งร้านแบบปรับเปลี่ยนได้

เวอร์ชัน 1.0.0-rc01

21 สิงหาคม 2024

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

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

  • แก้ไขการคำนวณพาร์ติชันที่ไม่ถูกต้องเมื่อมีบานพับที่ยกเว้น (9dfd483)

เวอร์ชัน 1.0.0-beta04

26 มิถุนายน 2024

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

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

  • แก้ไขปัญหาที่เมื่อระบบอัปเดตขอบเขตของบานพับ เลย์เอาต์ไม่ได้รับการอัปเดตให้สอดคล้องกัน (71e9cf1)

เวอร์ชัน 1.0.0-beta03

12 มิถุนายน 2024

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

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

  • แก้ไขข้อขัดข้องที่เกิดจากการแก้ไขทรัพยากร Dependency ที่ไม่ถูกต้องในรุ่นเบต้า 02

เวอร์ชัน 1.0.0-beta02

29 พฤษภาคม 2024

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

เวอร์ชัน 1.0.0-beta01

14 พฤษภาคม 2024

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

เวอร์ชัน 1.0.0-alpha12

1 พฤษภาคม 2024

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

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

  • เพิ่มข้อมูล isFlat ไปยัง HingeInfo (Ie0516, b/333784198)
  • กำหนดให้ API แบบปรับอัตโนมัติไม่ใช่การทดสอบ (I1d038)
  • กำหนดให้ API เลย์เอาต์แบบปรับอัตโนมัติไม่ใช่การทดสอบ (Id23df)
  • เปลี่ยน BackNavigationBehavior จาก enum เป็นคลาสค่า (Id8757)

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

  • เปลี่ยนเศษส่วนการเปลี่ยนเป็น lambda (I6f5a9)
  • แก้ไขปัญหาสถานะเริ่มต้นของ SizeTracker (18326a9)
  • รวมรายการบานพับในการตรวจสอบความเท่ากันของ Posture (6687137)

เวอร์ชัน 1.0.0-alpha11

17 เมษายน 2024

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

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

  • ปิดผนึกอินเทอร์เฟซขอบเขต (Iefa57)
  • แนะนำ AnimatedPaneScope (I62d73, b/332750742)
  • ทำให้ AdaptStrategy ปิดสนิทและมั่นคง (Ia28b2)
  • แนะนำวิธีการคัดลอกของ PaneScaffoldDirective (I9291f)
  • ทำเครื่องหมายว่า ThreePaneScaffoldScope เป็นเวอร์ชันทดลอง (I9d527)
  • มี API นั่งร้านที่ใช้งานง่ายซึ่งรองรับการนำทาง (I263f0, b/321010778)

เวอร์ชัน 1.0.0-alpha10

3 เมษายน 2024

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

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

  • กำหนดให้ความกว้างเริ่มต้นที่ต้องการเป็นการปรับและปรับแต่งได้ (Ic3abc)
  • เปลี่ยนชื่อฟังก์ชันการคํานวณคำสั่ง Scaffold (I10855)
  • ลบระยะห่างจากขอบและส่วนที่ประกอบออกจาก API ของนั่งร้าน (I786f8)
  • เพิ่มตัวนำทางการจดจำวิธีการที่ไม่มีประเภททั่วไป (I607c3)

เวอร์ชัน 1.0.0-alpha09

20 มีนาคม 2024

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

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

  • เพิ่มช่องการเปลี่ยนแปลงสถานะลงใน ThreePaneScaffoldScope (I3d917)
  • เรียงลำดับพารามิเตอร์นั่งร้านใหม่ (I4dff5)
  • ระบุค่าเริ่มต้นของพารามิเตอร์ตัวแก้ไข AnimatedPane (I77dd7)

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

  • รวมขนาดที่กั้นระยะในการย้ายแผง (a3174ca)

เวอร์ชัน 1.0.0-alpha08

6 มีนาคม 2024

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

ฟีเจอร์ใหม่

  • ใช้การเลื่อนแบบหน่วงเวลาเมื่อสลับหน้าต่าง (I1a38e)

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

  • นำอินเทอร์เฟซ ThreePaneScaffoldState ออกแล้ว (I63f23)

เวอร์ชัน 1.0.0-alpha07

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