Compose Material 3 thích ứng

  
Sử dụng thư viện thích ứng Material 3 để tạo giao diện người dùng thích ứng sẽ tự động điều chỉnh theo cấu hình cửa sổ hiện tại, chẳng hạn như các lớp kích thước cửa sổ hoặc tư thế thiết bị. Thư viện này cung cấp cả các phương thức triển khai mặc định của giàn giáo và các thành phần kết hợp cần thiết của khối xây dựng để tạo trải nghiệm tuỳ chỉnh của riêng bạn.
Bản cập nhật mới nhất Bản phát hành ổn định Bản phát hành dùng thử Bản phát hành beta Bản phát hành alpha
Ngày 12 tháng 12 năm 2024 1.0.0 - - 1.1.0-alpha08

Khai báo phần phụ thuộc

Để thêm một phần phụ thuộc trên Compose, bạn phải thêm kho lưu trữ Google Maven vào dự án. Đọc nội dung Kho lưu trữ Maven của Google để biết thêm thông tin.

Thêm các phần phụ thuộc cho cấu phần phần mềm bạn cần trong tệp build.gradle cho ứng dụng hoặc mô-đun:

Groovy

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"
}

Để biết thêm thông tin về các phần phụ thuộc, hãy xem bài viết Thêm phần phụ thuộc vào bản dựng.

Ý kiến phản hồi

Ý kiến phản hồi của bạn có thể giúp chúng tôi cải thiện Jetpack. Hãy cho chúng tôi biết nếu bạn phát hiện lỗi mới hoặc có ý tưởng cải thiện thư viện này. Vui lòng xem các lỗi hiện có trong thư viện này trước khi báo một lỗi mới. Bạn có thể thêm lượt bình chọn cho lỗi hiện có bằng cách nhấp vào nút dấu sao.

Báo lỗi mới

Xem tài liệu về Công cụ theo dõi lỗi để biết thêm thông tin.

Compose Material3 Adaptive Phiên bản 1.1

Phiên bản 1.1.0-alpha08

Ngày 12 tháng 12 năm 2024

Phát hành androidx.compose.material3.adaptive:adaptive-*:1.1.0-alpha08. Phiên bản 1.1.0-alpha08 bao gồm các thay đổi sau.

Thay đổi về API

  • Giới thiệu hàm currentWindowDpSize. (I99125, b/296300441)
  • Hiển thị PaneScaffoldParentData và ThreePaneScaffoldHorizontalOrder.toLtrOrder() (I2d6b7)
  • Xoá PaneScaffoldMotionScope và chuyển thành một trường trong PaneScaffoldTransitionScope. Đồng thời, hãy đổi tên thành PaneScaffoldMotionDataProvider và xoá quyền truy cập vào cấu trúc dữ liệu cơ bản của PaneMotionData – thay vào đó, hãy cung cấp phương thức getter và vòng lặp để truy cập dữ liệu. (Id8884)
  • Tạo cơ chế ghi đè cho ThreePaneScaffold để hỗ trợ việc triển khai tải không qua cửa hàng cho nhiều kiểu dáng thiết bị. (I5280f)
  • Đặt trạng thái mở rộng ngăn thành rỗng theo mặc định (Ia65f8, b/376394520)

Phiên bản 1.1.0-alpha07

Ngày 13 tháng 11 năm 2024

Phát hành androidx.compose.material3.adaptive:adaptive-*:1.1.0-alpha07. Phiên bản 1.1.0-alpha07 bao gồm các thay đổi sau.

Thay đổi về API

  • Xoá việc triển khai tay cầm kéo trong thư viện thích ứng và khuyến khích mọi người sử dụng phiên bản M3 của thư viện đó. Đồng thời, hãy giới thiệu một đối tượng sửa đổi để cung cấp khả năng kéo mở rộng ngăn cho một thành phần kết hợp có thể kéo được cung cấp. Ngoài ra, hãy ẩn DraggableState dưới dạng thông tin chi tiết về việc triển khai để chúng ta có thể thay đổi thông tin này sau nếu cần. (Ib50cd)
  • Di chuyển điểm truy cập của tuỳ chỉnh chuyển động ngăn từ các hàm của giàn giáo sang AnimatedPane theo phản hồi của UXR. (I10f72)
  • Giới thiệu tính năng hỗ trợ hất và thông số kỹ thuật ảnh động tuỳ chỉnh để mở rộng ngăn. (Ie207d, b/362584341)

Sửa lỗi

  • Khắc phục các vấn đề về tính năng dự đoán thao tác quay lại khi huỷ. (36a3e0a), (b/369899645)

Phiên bản 1.1.0-alpha06

Ngày 30 tháng 10 năm 2024

Phát hành androidx.compose.material3.adaptive:adaptive-*:1.1.0-alpha06. Phiên bản 1.1.0-alpha06 bao gồm các thay đổi sau.

Thay đổi về API

  • Thêm FloatRange vào PaneScaffoldTransitionScope.motionProgress. (Iac0dd)
  • Thay đổi loại tham số của trình điều hướng thành loại chung trong các giàn có thể điều hướng. (I1da6e)

Phiên bản 1.1.0-alpha05

Ngày 16 tháng 10 năm 2024

Phát hành androidx.compose.material3.adaptive:adaptive-*:1.1.0-alpha05. Phiên bản 1.1.0-alpha05 bao gồm các thay đổi sau.

Thay đổi về API

  • Giới thiệu lớp thông số kỹ thuật ảnh động để đảm bảo hành vi chuyển động nhất quán hơn và khả năng mở rộng trong tương lai. (I2d3cc)
  • Cung cấp loại chuyển động và đổi tên currentXXXXX trong PaneMotionData thành originXXXX. (I7c61a)

Phiên bản 1.1.0-alpha04

Ngày 2 tháng 10 năm 2024

Phát hành androidx.compose.material3.adaptive:adaptive-*:1.1.0-alpha04. Phiên bản 1.1.0-alpha04 bao gồm các thay đổi sau.

Tính năng mới

  • Thêm tính năng hỗ trợ xem trước thao tác quay lại vào NavigableListDetailPaneScaffold và NavigableSupportingPaneScaffold. (I4dc21, b/359616816)

Thay đổi về API

  • Thêm ThreePaneScaffoldState vào ThreePaneScaffoldNavigator Các phương thức điều hướng đã được tạo suspend để hỗ trợ điều hướng bằng ảnh động. Thêm seekBack để hỗ trợ một số trạng thái điều hướng (ví dụ: xem trước thao tác quay lại). (I5a651, b/359616816)
  • Thêm MutableThreePaneScaffoldState để kiểm soát quá trình chuyển đổi giữa các giá trị của giàn giáo. ThreePaneScaffoldState hiện có đã được đặt ở chế độ chỉ có thể đọc. (Idb3c6)
  • Hiển thị các phương thức triển khai chuyển động ngăn mặc định (I95a7b)
  • Bật tính năng đặt neo ban đầu của trạng thái mở rộng ngăn (Ie41b3, b/362350560)

Sửa lỗi

  • Thực thi kích thước mục tiêu chạm tối thiểu 48x48 dp của tay cầm kéo (7ce6635, b/366018217)
  • Khôi phục vị trí neo sau khi thay đổi cấu hình (3c9fc6b, b/362353672)

Phiên bản 1.1.0-alpha03

Ngày 18 tháng 9 năm 2024

Phát hành androidx.compose.material3.adaptive:adaptive-*:1.1.0-alpha03. Phiên bản 1.1.0-alpha03 bao gồm các thay đổi sau.

Phiên bản 1.1.0-alpha02

Ngày 4 tháng 9 năm 2024

Phát hành androidx.compose.material3.adaptive:adaptive-*:1.1.0-alpha02. Phiên bản 1.1.0-alpha02 bao gồm các thay đổi sau.

Tính năng mới

  • Hỗ trợ tuỳ chỉnh chuyển động (I0bf9c), (I80e66) để nhà sáng tạo có thể thay đổi chuyển động mặc định trong quá trình thay đổi trạng thái của giàn giáo thích ứng. Nhà sáng tạo có thể chọn trong số các hiệu ứng chuyển đổi vào và ra mặc định, hoặc triển khai hiệu ứng chuyển đổi tuỳ chỉnh thuần tuý bằng thông tin được cung cấp thông qua phạm vi chuyển động mới.
  • Triển khai ảnh động mờ của các tay nắm kéo mở rộng ngăn (46e3c69)
  • Cho phép lưu PaneExpansionState đã ghi nhớ (61ff76f)

Thay đổi về API

  • Thêm các API mở rộng ngăn bị thiếu vào các giàn giáo (Ic5bc0)
  • Đổi tên ThreePaneScaffoldDestinationItem.content thành contentKey. Đã thay đổi đối số loại mặc định rememberListDetailPaneScaffoldNavigator và rememberSupportingPaneScaffoldNavigator từ Nothing thành Any. (I58749)
  • Đánh dấu ThreePaneScaffoldState là phiên bản ổn định (I64aec)
  • Đặt tham số tay nắm kéo trong phạm vi (Ic0aa2)

Phiên bản 1.1.0-alpha01

Ngày 21 tháng 8 năm 2024

Phát hành androidx.compose.material3.adaptive:adaptive-*:1.1.0-alpha01. Phiên bản 1.1.0-alpha01 bao gồm các thay đổi sau.

Tính năng mới

  • Giới thiệu tính năng hỗ trợ mở rộng ngăn của các giàn giáo thích ứng.

Thay đổi về API

  • Ra mắt API mở rộng ngăn cho công chúng (I301d6)
  • Giới thiệu ThreePaneScaffoldState để kiểm soát quá trình chuyển đổi giá trị ngăn. Thêm các phương thức nạp chồng của ListDetailPaneScaffold và SupportingPaneScaffold chấp nhận trạng thái này. (I5db3b)
  • Giới thiệu khoá mở rộng ngăn và giao diện trình cung cấp khoá (Id621f)

Sửa lỗi

  • Khắc phục lỗi tính toán phân vùng không chính xác khi bản lề bị loại trừ. (9dfd483)

Compose Material3 Adaptive Phiên bản 1.0

Phiên bản 1.0.0

Ngày 4 tháng 9 năm 2024

Phát hành androidx.compose.material3.adaptive:adaptive-*:1.0.0. Phiên bản 1.0.0 bao gồm các thay đổi sau.

Các tính năng chính của phiên bản 1.0.0

  • Hàm có khả năng kết hợp một dòng currentWindowSize(), collectFoldingFeaturesAsState() và currentWindowAdaptiveInfo() để lấy thông tin cửa sổ bắt buộc nhằm điều chỉnh ứng dụng, chẳng hạn như kích thước cửa sổ và các tính năng gập.
  • ListDetailPaneScaffold và SupportingPaneScaffold để cung cấp hai bố cục chuẩn Material3 sẽ tự động điều chỉnh theo các cấu hình cửa sổ khác nhau. Hai khung đó cũng có thể tuỳ chỉnh hoàn toàn để phù hợp với nhiều nhu cầu của nhà sáng tạo.
  • ThreePaneScaffoldNavigator và các hàm ghi nhớ liên quan, rememberListDetailPaneScaffoldNavigator() và rememberSupportingPaneScaffoldNavigator() để cung cấp các giải pháp điều hướng trong một giàn đỡ thích ứng, có thể hiển thị nhiều đích đến điều hướng cùng một lúc, so với chế độ thiết lập một đích đến tại một thời điểm phổ biến trong thế giới không thích ứng.
  • Ảnh động Material3 tích hợp, mặc định khi thay đổi trạng thái giàn đỡ thích ứng.

Phiên bản 1.0.0-rc01

Ngày 21 tháng 8 năm 2024

Phát hành androidx.compose.material3.adaptive:adaptive-*:1.0.0-rc01. Phiên bản 1.0.0-rc01 bao gồm các thay đổi sau.

Sửa lỗi

  • Khắc phục lỗi tính toán phân vùng không chính xác khi bản lề bị loại trừ. (9dfd483)

Phiên bản 1.0.0-beta04

Ngày 26 tháng 6 năm 2024

Phát hành androidx.compose.material3.adaptive:adaptive-*:1.0.0-beta04. Phiên bản 1.0.0-beta04 bao gồm các thay đổi sau.

Sửa lỗi

  • Khắc phục vấn đề khi các giới hạn bản lề được cập nhật, bố cục không được cập nhật tương ứng. (71e9cf1)

Phiên bản 1.0.0-beta03

Ngày 12 tháng 6 năm 2024

Phát hành androidx.compose.material3.adaptive:adaptive-*:1.0.0-beta03. Phiên bản 1.0.0-beta03 bao gồm các thay đổi sau.

Sửa lỗi

  • Khắc phục sự cố do việc phân giải phần phụ thuộc không chính xác trong phiên bản beta02.

Phiên bản 1.0.0-beta02

Ngày 29 tháng 5 năm 2024

Phát hành androidx.compose.material3.adaptive:adaptive-*:1.0.0-beta02. Phiên bản 1.0.0-beta02 bao gồm các thay đổi sau.

Phiên bản 1.0.0-beta01

Ngày 14 tháng 5 năm 2024

Phát hành androidx.compose.material3.adaptive:adaptive-*:1.0.0-beta01. Phiên bản 1.0.0-beta01 bao gồm các thay đổi sau.

Phiên bản 1.0.0-alpha12

Ngày 1 tháng 5 năm 2024

Phát hành androidx.compose.material3.adaptive:adaptive-*:1.0.0-alpha12. Phiên bản 1.0.0-alpha12 bao gồm các thay đổi sau.

Thay đổi về API

  • Thêm thông tin isFlat vào HingeInfo (Ie0516, b/333784198)
  • Không thử nghiệm API thích ứng (I1d038)
  • Không thử nghiệm API bố cục thích ứng (Id23df)
  • Thay đổi BackNavigationBehavior từ một enum thành một lớp giá trị (Id8757)

Sửa lỗi

  • Thay đổi phân số chuyển đổi thành lambda (I6f5a9)
  • Khắc phục vấn đề về trạng thái ban đầu của SizeTracker (18326a9)
  • Thêm danh sách bản lề vào quy trình kiểm tra bằng nhau Posture (6687137)

Phiên bản 1.0.0-alpha11

Ngày 17 tháng 4 năm 2024

Phát hành androidx.compose.material3.adaptive:adaptive-*:1.0.0-alpha11. Phiên bản 1.0.0-alpha11 bao gồm các thay đổi sau.

Thay đổi về API

  • Làm kín giao diện phạm vi. (Iefa57)
  • Giới thiệu AnimatedPaneScope. (I62d73, b/332750742)
  • Làm cho AdaptStrategy kín và ổn định. (Ia28b2)
  • Giới thiệu phương thức sao chép của PaneScaffoldDirective. (I9291f)
  • Đánh dấu ThreePaneScaffoldScope là thử nghiệm. (I9d527)
  • Cung cấp các API giàn đỡ dễ sử dụng hỗ trợ điều hướng. (I263f0, b/321010778)

Phiên bản 1.0.0-alpha10

Ngày 3 tháng 4 năm 2024

Phát hành androidx.compose.material3.adaptive:adaptive-*:1.0.0-alpha10. Phiên bản 1.0.0-alpha10 bao gồm các thay đổi sau.

Thay đổi về API

  • Đặt chiều rộng ưu tiên mặc định thích ứng và có thể tuỳ chỉnh. (Ic3abc)
  • Đổi tên các hàm tính toán lệnh của giàn giáo. (I10855)
  • Xoá khoảng đệm và phần lồng ghép khỏi các API của giàn giáo. (I786f8)
  • Thêm các phương thức nhớ của trình điều hướng không có loại chung. (I607c3)

Phiên bản 1.0.0-alpha09

Ngày 20 tháng 3 năm 2024

Phát hành androidx.compose.material3.adaptive:adaptive-*:1.0.0-alpha09. Phiên bản 1.0.0-alpha09 bao gồm các thay đổi sau.

Thay đổi về API

  • Thêm các trường chuyển đổi trạng thái vào ThreePaneScaffoldScope. (I3d917)
  • Sắp xếp lại các tham số của giàn giáo. (I4dff5)
  • Cung cấp giá trị mặc định của tham số đối tượng sửa đổi AnimatedPane. (I77dd7)

Sửa lỗi

  • Thêm kích thước khoảng đệm vào chuyển động ngăn. (a3174ca)

Phiên bản 1.0.0-alpha08

Ngày 6 tháng 3 năm 2024

Phát hành androidx.compose.material3.adaptive:adaptive-*:1.0.0-alpha08. Phiên bản 1.0.0-alpha08 bao gồm các thay đổi sau.

Tính năng mới

  • Triển khai tính năng trượt trễ khi chuyển đổi ngăn. (I1a38e)

Thay đổi về API

  • Xoá giao diện ThreePaneScaffoldState. (I63f23)

Phiên bản 1.0.0-alpha07

Ngày 21 tháng 2 năm 2024