Desain Material untuk XR

Membangun dengan komponen dan tata letak Material yang beradaptasi untuk XR
Update Terbaru Rilis Stabil Kandidat Rilis Rilis Beta Rilis Alfa
22 Oktober 2025 - - - 1.0.0-alpha12

Mendeklarasikan dependensi

Untuk menambahkan dependensi pada core XR Compose Material3, Anda harus menambahkan repositori Maven Google ke project Anda. Baca repositori Maven Google untuk mengetahui informasi selengkapnya.

Tambahkan dependensi untuk artefak yang diperlukan dalam file build.gradle bagi aplikasi atau modul Anda:

Groovy

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

Kotlin

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

Untuk informasi dependensi selengkapnya, lihat Menambahkan dependensi build.

Masukan

Masukan Anda membantu meningkatkan kualitas Jetpack. Beri tahu kami jika Anda menemukan masalah baru atau mempunyai masukan untuk meningkatkan kualitas library ini. Harap periksa masalah yang sudah diketahui dalam library ini sebelum membuat laporan baru. Anda dapat memberikan suara untuk masalah yang sudah diketahui dengan mengklik tombol bintang.

Laporkan masalah baru

Lihat dokumentasi Issue Tracker untuk informasi selengkapnya.

Versi 1.0

Versi 1.0.0-alpha12

22 Oktober 2025

androidx.xr.compose.material3:material3:1.0.0-alpha12 dirilis. Versi 1.0.0-alpha12 berisi commit ini.

Fitur Baru

  • Menambahkan SpaceModeToggleButton untuk beralih antara HomeSpace dan FullSpace (Ic6865)

Perbaikan Bug

  • Meningkatkan kualitas Toolbar XR (Ied1f5)

Versi 1.0.0-alpha11

27 Agustus 2025

androidx.xr.compose.material3:material3:1.0.0-alpha11 dirilis. Versi 1.0.0-alpha11 berisi commit ini.

Perbaikan Bug

  • Memperbaiki perilaku FAB di NavRail XR (Ibe20b)

Versi 1.0.0-alpha10

30 Juli 2025

androidx.xr.compose.material3:material3:1.0.0-alpha10 dirilis. Versi 1.0.0-alpha10 berisi commit ini.

Fitur Baru

  • Membuat penerapan XR dan ComponentOverride untuk Toolbar Horizontal dan Vertikal (0e9496c, dcfef96)

Perbaikan Bug

  • Memperbaiki dialog XR yang tidak menampilkan beberapa konten (c82e61b)

Versi 1.0.0-alpha08

20 Mei 2025

androidx.xr.compose.material3:material3:1.0.0-alpha08 dirilis. Versi 1.0.0-alpha08 berisi commit ini.

Perbaikan Bug

  • Memperbaiki error saat ListDetailPaneScaffold atau SupportingPaneScaffold tidak memiliki turunan (46df990)
  • Menurunkan minSdk Material XR menjadi 24 (6064706)

Versi 1.0.0-alpha07

7 Mei 2025

androidx.xr.compose.material3:material3:1.0.0-alpha07 dirilis. Versi 1.0.0-alpha07 berisi commit ini.

Perubahan API

  • Project yang dirilis dengan Kotlin 2.0 memerlukan KGP 2.0.0 atau yang lebih baru untuk digunakan. (Idb6b5)

Versi 1.0.0-alpha06

26 Maret 2025

androidx.xr.compose.material3:material3:1.0.0-alpha06 dirilis. Versi 1.0.0-alpha06 berisi commit ini.

Versi 1.0.0-alpha05

12 Maret 2025

androidx.xr.compose.material3:material3:1.0.0-alpha05 dirilis. Versi 1.0.0-alpha05 berisi commit ini.

Fitur Baru

  • TopAppBar dispatialisasi ke dalam Orbiter secara default saat menggunakan EnableXrComponentOverrides.
  • AlertDialog Material dispatialisasi ke dalam SpatialPanel secara default saat menggunakan EnableXrComponentOverrides.

Perubahan API

  • Mengganti nama jenis ComponentOverride menjadi Override, dan jenis ComponentOverrideContext menjadi OverrideScope (Id973c)

Perbaikan Bug

  • Memperbaiki aliasing dan scrimming yang salah pada NavigationRail dan NavigationBar yang dispatialisasi. (I9db52)

Versi 1.0.0-alpha04

26 Februari 2025

androidx.xr.compose.material3:material3:1.0.0-alpha04 dirilis. Versi 1.0.0-alpha04 berisi commit ini.

Fitur Baru

  • ListDetailPaneScaffold dan SupportingPaneScaffold menggunakan SpatialPanels secara default saat menggunakan EnableXrComponentOverrides (I166b0)

Perubahan API

  • Pengambil DefaultNavigationRailOrbiterProperties dan DefaultNavigationBarOrbiterProperties tidak lagi@Composable (I61618)
  • LocalNavigationRailOrbiterProperties dan LocalNavigationBarOrbiterProperties tidak lagi nullable (I61618)

Versi 1.0.0-alpha03

12 Februari 2025

androidx.xr.compose.material3:material3:1.0.0-alpha03 dirilis tanpa perubahan penting sejak versi alfa terakhir. Versi 1.0.0-alpha03 berisi commit ini.

Versi 1.0.0-alpha02

29 Januari 2025

androidx.xr.compose.material3:material3:1.0.0-alpha02 dirilis. Versi 1.0.0-alpha02 berisi commit ini.

Fitur Baru

  • Aktifkan penyesuaian properti Orbiter di XR NavigationBar dan NavigationRail. (Ic300f)

Perubahan API

  • Membuat kemampuan untuk mengganti ThreePaneScaffold di XR (Ib66f1)
  • Menerapkan penggantian Panel yang tidak beranimasi untuk XR (I7f620)
  • Menambahkan dan menggunakan anotasi eksperimental baru ExperimentalMaterial3ComponentOverrideApi (Ia1eaf)

Perbaikan Bug

  • Menyematkan dependensi Material3 XR pada XR Compose. (Ia02cc)

Versi 1.0.0-alpha01

12 Desember 2024

androidx.xr.compose.material3:material3:1.0.0-alpha01 dirilis.

Fitur Rilis Awal

Rilis developer awal Desain Material untuk XR. Dengan menggunakan library, komponen, dan tata letak adaptif Material 3 yang ada, perilaku UI spasial ditingkatkan. Anda dapat membangun langsung dengan komponen M3 XR, atau menyesuaikan penerapan saat ini dengan menambahkan wrapper EnableXrComponentOverrides. Pelajari lebih lanjut dalam panduan developer ini.

Adaptasi XR yang didukung:

Masalah Umum

  • ListDetailPaneScaffold dan SupportingPaneScaffold saat ini tidak mendukung beberapa panel spasial