Material Design cho XR

Xây dựng bằng các thành phần và bố cục Material thích ứng với XR
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 30 tháng 7 năm 2025 - - - 1.0.0-alpha10

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

Để thêm một phần phụ thuộc trên lõi XR Compose Material3, 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 {
    // Use to implement XR Compose Material3
    implementation "androidx.xr.compose.material3:material3:1.0.0-alpha10"
}

Kotlin

dependencies {
    // Use to implement XR Compose Material3
   implementation("androidx.xr.compose.material3:material3:1.0.0-alpha10")
}

Để 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 1.0

Phiên bản 1.0.0-alpha10

Ngày 30 tháng 7 năm 2025

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

Tính năng mới

  • Tạo chế độ triển khai XR và ComponentOverride cho Thanh công cụ ngang và dọc (0e9496c, dcfef96)

Sửa lỗi

  • Khắc phục lỗi hộp thoại XR không hiển thị một số nội dung (c82e61b)

Phiên bản 1.0.0-alpha08

Ngày 20 tháng 5 năm 2025

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

Sửa lỗi

  • Khắc phục sự cố khi ListDetailPaneScaffold hoặc SupportingPaneScaffold không có phần tử con (46df990)
  • Giảm Material XR minSdk xuống 24 (6064706)

Phiên bản 1.0.0-alpha07

Ngày 7 tháng 5 năm 2025

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

Thay đổi về API

  • Các dự án được phát hành bằng Kotlin 2.0 yêu cầu sử dụng KGP 2.0.0 trở lên. (Idb6b5)

Phiên bản 1.0.0-alpha06

Ngày 26 tháng 3 năm 2025

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

Phiên bản 1.0.0-alpha05

Ngày 12 tháng 3 năm 2025

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

Tính năng mới

  • Theo mặc định, TopAppBar được không gian hoá thành một Orbiter khi sử dụng EnableXrComponentOverrides.
  • Theo mặc định, Material AlertDialog được không gian hoá thành SpatialPanel khi sử dụng EnableXrComponentOverrides.

Thay đổi về API

  • Đổi tên các loại ComponentOverride thành Override và các loại ComponentOverrideContext thành OverrideScope (Id973c)

Sửa lỗi

  • Khắc phục hiện tượng răng cưa và che phủ không chính xác trên NavigationRail và NavigationBar được không gian hoá. (I9db52)

Phiên bản 1.0.0-alpha04

Ngày 26 tháng 2 năm 2025

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

Tính năng mới

  • ListDetailPaneScaffold và SupportingPaneScaffold sử dụng SpatialPanels theo mặc định khi dùng EnableXrComponentOverrides (I166b0)

Thay đổi về API

  • Các phương thức getter DefaultNavigationRailOrbiterProperties và DefaultNavigationBarOrbiterProperties không còn là @Composable nữa (I61618)
  • LocalNavigationRailOrbiterProperties và LocalNavigationBarOrbiterProperties không còn có thể rỗng (I61618)

Phiên bản 1.0.0-alpha03

Ngày 12 tháng 2 năm 2025

androidx.xr.compose.material3:material3:1.0.0-alpha03 được phát hành mà không có thay đổi đáng kể nào kể từ bản phát hành alpha gần đây nhất. Phiên bản 1.0.0-alpha03 bao gồm các thay đổi sau.

Phiên bản 1.0.0-alpha02

Ngày 29 tháng 1 năm 2025

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

Tính năng mới

  • Cho phép tuỳ chỉnh các thuộc tính Orbiter trên NavigationBar và NavigationRail. (Ic300f)

Thay đổi về API

  • Tạo khả năng ghi đè ThreePaneScaffold trên XR (Ib66f1)
  • Triển khai chế độ ghi đè Pane không có ảnh động cho XR (I7f620)
  • Thêm và sử dụng chú thích thử nghiệm mới ExperimentalMaterial3ComponentOverrideApi (Ia1eaf)

Sửa lỗi

  • Ghim phần phụ thuộc của Material3 XR vào XR Compose. (Ia02cc)

Phiên bản 1.0.0-alpha01

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

Phát hành androidx.xr.compose.material3:material3:1.0.0-alpha01.

Các tính năng của bản phát hành ban đầu

Bản phát hành đầu tiên cho nhà phát triển của Material Design cho XR. Khi sử dụng thư viện Material 3 hiện có, các thành phần và bố cục thích ứng sẽ được cải thiện bằng các hành vi giao diện người dùng không gian. Bạn có thể tạo trực tiếp bằng các thành phần M3 XR hoặc điều chỉnh chế độ triển khai hiện tại bằng cách thêm trình bao bọc EnableXrComponentOverrides. Tìm hiểu thêm trong hướng dẫn dành cho nhà phát triển này.

Các chế độ điều chỉnh XR được hỗ trợ:

Lỗi đã biết

  • ListDetailPaneScaffold và SupportingPaneScaffold hiện không hỗ trợ nhiều bảng điều khiển không gian