Material Design dla XR

Tworzenie komponentów i układów Material, które dostosowują się do XR
Najnowsza aktualizacja Wersja stabilna Wersja kandydująca do publikacji Wersja beta Wersja Alfa
22 października 2025 r. - - - 1.0.0-alpha12

Deklarowanie zależności

Aby dodać zależność od podstawowego komponentu XR Compose Material3, musisz dodać do projektu repozytorium Google Maven. Więcej informacji znajdziesz w repozytorium Maven Google.

Dodaj zależności dotyczące potrzebnych artefaktów w pliku build.gradle aplikacji lub modułu:

Odlotowe

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

Więcej informacji o zależnościach znajdziesz w artykule Dodawanie zależności kompilacji.

Opinia

Twoja opinia pomoże nam ulepszyć Jetpacka. Jeśli odkryjesz nowe problemy lub masz pomysły na ulepszenie tej biblioteki, daj nam znać. Zanim utworzysz nowy problem, zapoznaj się z dotychczasowymi problemami w tej bibliotece. Możesz dodać swój głos do istniejącego problemu, klikając przycisk gwiazdki.

Tworzenie nowego problemu

Więcej informacji znajdziesz w dokumentacji narzędzia Issue Tracker.

Wersja 1.0

Wersja 1.0.0-alpha12

22 października 2025 r.

Publikacja androidx.xr.compose.material3:material3:1.0.0-alpha12 Wersja 1.0.0-alpha12 zawiera te zmiany.

Nowe funkcje

  • Dodano SpaceModeToggleButton do przełączania się między HomeSpace a FullSpace (Ic6865)

Poprawki błędów

  • Ulepszanie pasków narzędzi XR (Ied1f5)

Wersja 1.0.0-alpha11

27 sierpnia 2025 roku

Publikacja androidx.xr.compose.material3:material3:1.0.0-alpha11 Wersja 1.0.0-alpha11 zawiera te zmiany.

Poprawki błędów

  • Naprawiono działanie FAB w XR NavRail (Ibe20b)

Wersja 1.0.0-alpha10

30 lipca 2025 r.

Publikacja androidx.xr.compose.material3:material3:1.0.0-alpha10 Wersja 1.0.0-alpha10 zawiera te zmiany.

Nowe funkcje

  • Tworzenie implementacji XR i ComponentOverride dla paska narzędzi w pionie i poziomie (0e9496c, dcfef96)

Poprawki błędów

  • Naprawiono problem z niewyświetlaniem niektórych treści w oknie XR (c82e61b)

Wersja 1.0.0-alpha08

20 maja 2025 r.

Publikacja androidx.xr.compose.material3:material3:1.0.0-alpha08 Wersja 1.0.0-alpha08 zawiera te zmiany.

Poprawki błędów

  • Naprawiono błąd, który występował, gdy element ListDetailPaneScaffold lub SupportingPaneScaffold nie miał elementów podrzędnych (46df990).
  • Obniżenie minimalnej wersji pakietu Material XR do 24 (6064706)

Wersja 1.0.0-alpha07

7 maja 2025 r.

Publikacja androidx.xr.compose.material3:material3:1.0.0-alpha07 Wersja 1.0.0-alpha07 zawiera te zmiany.

Zmiany w interfejsie API

  • Projekty wydane w Kotlinie 2.0 wymagają użycia KGP w wersji 2.0.0 lub nowszej. (Idb6b5)

Wersja 1.0.0-alpha06

26 marca 2025 r.

Publikacja androidx.xr.compose.material3:material3:1.0.0-alpha06 Wersja 1.0.0-alpha06 zawiera te zmiany.

Wersja 1.0.0-alpha05

12 marca 2025 r.

Publikacja androidx.xr.compose.material3:material3:1.0.0-alpha05 Wersja 1.0.0-alpha05 zawiera te zmiany.

Nowe funkcje

  • TopAppBar jest domyślnie przestrzenne w przypadku korzystania z EnableXrComponentOverrides.
  • Materiał AlertDialog jest domyślnie przestrzenny w SpatialPanel podczas korzystania z EnableXrComponentOverrides.

Zmiany w interfejsie API

  • Zmiana nazwy typów ComponentOverride na Override, a typów ComponentOverrideContext na OverrideScope (Id973c)

Poprawki błędów

  • Poprawianie aliasingu i nieprawidłowego cieniowania w przypadku przestrzennych NavigationRail i NavigationBar. (I9db52)

Wersja 1.0.0-alpha04

26 lutego 2025 r.

Publikacja androidx.xr.compose.material3:material3:1.0.0-alpha04 Wersja 1.0.0-alpha04 zawiera te zmiany.

Nowe funkcje

  • ListDetailPaneScaffold i SupportingPaneScaffold domyślnie używają SpatialPanels podczas korzystania z EnableXrComponentOverrides (I166b0)

Zmiany w interfejsie API

  • Gettery DefaultNavigationRailOrbiterProperties i DefaultNavigationBarOrbiterProperties nie są już@Composable (I61618)
  • Pola LocalNavigationRailOrbiterProperties i LocalNavigationBarOrbiterProperties nie mogą już mieć wartości null (I61618)

Wersja 1.0.0-alpha03

12 lutego 2025 r.

androidx.xr.compose.material3:material3:1.0.0-alpha03 nie zawiera żadnych istotnych zmian w porównaniu z ostatnią wersją alfa. Wersja 1.0.0-alpha03 zawiera te zmiany.

Wersja 1.0.0-alpha02

29 stycznia 2025 r.

Publikacja androidx.xr.compose.material3:material3:1.0.0-alpha02 Wersja 1.0.0-alpha02 zawiera te zmiany.

Nowe funkcje

  • Włącz dostosowywanie właściwości Orbiter na urządzeniach XR NavigationBar i NavigationRail. (Ic300f)

Zmiany w interfejsie API

  • Umożliwienie zastąpienia ThreePaneScaffold na XR (Ib66f1)
  • Implementowanie niezanimowanego zastąpienia panelu w przypadku XR (I7f620)
  • Dodano i użyto nowej eksperymentalnej adnotacji ExperimentalMaterial3ComponentOverrideApi (Ia1eaf)

Poprawki błędów

  • Przypnij zależność Material3 XR od XR Compose. (Ia02cc)

Wersja 1.0.0-alpha01

12 grudnia 2024 r.

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

Funkcje pierwszej wersji

Pierwsza wersja Material Design dla XR dla deweloperów. Korzystając z istniejącej biblioteki Material 3, komponenty i układy adaptacyjne są ulepszane o zachowania interfejsu przestrzennego. Możesz tworzyć bezpośrednio za pomocą komponentów M3 XR lub dostosować obecną implementację, dodając element opakowujący EnableXrComponentOverrides. Więcej informacji znajdziesz w tym przewodniku dla programistów.

Obsługiwane adaptacje XR:

Znane problemy

  • Komponenty ListDetailPaneScaffold i SupportingPaneScaffold nie obsługują obecnie wielu paneli przestrzennych.