Compose Material3

  
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 cho phù hợp với cửa sổ hiện tại các cấu hình như lớp kích thước cửa sổ hoặc tư thế thiết bị. Thư viện cung cấp cả cách triển khai scaffold mặc định và thành phần kết hợp khối xây dựng cần thiết để tạo ra 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 4 tháng 9 năm 2024 1.0.0 - - 1.1.0-alpha02

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.

Phiên bản thích ứng của Compose Material3 1.1

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

  • Tính năng tuỳ chỉnh chuyển động (I0bf9c), (I80e66) được hỗ trợ để nhà sản xuất 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 một nhóm các hiệu ứng chuyển đổi vào và thoát mặc định, hoặc triển khai các hiệu ứng chuyển đổi tuỳ chỉnh thuần tuý bằng thông tin được cung cấp qua phạm vi chuyển động mới.
  • Triển khai ảnh động mờ dần của ô điều khiển kéo mở rộng ngăn (46e3c69)
  • Đảm bảo PaneExpansionState có thể lưu (61ff76f)

Thay đổi về API

  • Thêm APis mở rộng ngăn bị thiếu vào scaffolds (Ic5bc0)
  • Đổi tên ThreePaneScaffoldDestinationItem.content thành contentKey. Đã thay đổi đối số loại mặc định của rememberListDetailPaneScaffoldNavigator và rememberSupportingPaneScaffoldNavigator từ Nothing thành Any. (I58749)
  • Đánh dấu ThreePaneScaffoldState là ổn định (I64aec)
  • Đặt tham số ô điều khiển 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

  • Ra mắt tính năng hỗ trợ mở rộng ngăn của scaffolds thích ứng.

Thay đổi về API

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

Sửa lỗi

  • Sửa lỗi tính toán phân vùng không chính xác khi bản lề bị loại trừ xuất hiện. (9dfd483)

Phiên bản thích ứng 1.0 của Compose Material3

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

  • Các hàm có khả năng kết hợp một dòng currentWindowSize(), collectFoldingFeaturesAsState() và currentWindowAdaptiveInfo() để lấy thông tin cần thiết về cửa sổ nhằm điều chỉnh các ứng dụng, chẳng hạn như kích thước cửa sổ và tính năng gập.
  • ListDetailPaneScaffold và SupportingPaneScaffold để cung cấp 2 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 giàn giáo đó cũng hoàn toàn có thể tuỳ chỉnh để phù hợp với nhu cầu khác nhau của nhà sản xuất.
  • ThreePaneScaffoldNavigator và các hàm ghi nhớ có liên quan rememberListDetailPaneScaffoldNavigator() và rememberSupportingPaneScaffoldNavigator() để cung cấp các giải pháp điều hướng trong một scaffold 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.
  • Các ảnh động mặc định, tích hợp sẵn trong Material3 khi thay đổi trạng thái Scaffold 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

  • Sửa lỗi tính toán phân vùng không chính xác khi bản lề bị loại trừ xuất hiện. (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 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 các sự cố do độ 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)
  • Đặt API thích ứng ở chế độ không thử nghiệm (I1d038)
  • Đặt API bố cục thích ứng ở chế độ không thử nghiệm (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)
  • Đưa danh sách bản lề vào hoạt động kiểm tra tính 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

  • Bảo mật giao diện phạm vi. (Iefa57)
  • Giới thiệu AnimatedPaneScope. (I62d73, b/332750742)
  • Đảm bảo AdaptStrategy kín và ổn định. (Ia28b2)
  • Ra mắt phương thức sao chép của PaneScaffoldDirective. (I9291f)
  • Đánh dấu ThreePaneScaffoldScope dưới dạng thử nghiệm. (I9d527)
  • Cung cấp các API Scaffold 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

  • Làm cho chiều rộng ưu tiên mặc định trở nên thích ứng và có thể tuỳ chỉnh. (Ic3abc)
  • Đổi tên các hàm tính toán lệnh scaffold. (I10855)
  • Xoá khoảng đệm và phần lồng ghép khỏi API scaffold. (I786f8)
  • Thêm các phương thức ghi nhớ của trình điều hướng mà 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ố scaffold. (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 trống 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 chế độ trượt bị trì hoãn 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