Material Design dla XR

Twórz za pomocą 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
19 maja 2026 r. - - - 1.0.0-alpha17

Deklarowanie zależności

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

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

Groovy

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

Kotlin

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

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

Prześlij opinię

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

Utwórz nowy problem

Więcej informacji znajdziesz w dokumentacji narzędzia do śledzenia problemów Issue Tracker documentation.

Wersja 1.0

Wersja 1.0.0-alpha17

19 maja 2026 r.

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

Zmiany w interfejsie API

  • Zmieniliśmy Orbiter, aby zamiast pozycji, przesunięcia, typu przesunięcia, wyrównania i wysokości używał OrbiterAnchorPoint + VolumeOffset lub OrbiterPoseProvider. Usunęliśmy też parametr shouldRenderInNonSpatial. Jeśli deweloper nie chce, aby orbiter renderował się w przestrzeni nieprzestrzennej, powinien umieścić go w instrukcji warunkowej i sprawdzić SpatialCapabilities. (I9fbb3)
  • Dodaliśmy modyfikatory ruchome. Te modyfikatory działają obecnie w przypadku SpatialPanels i SpatialExternalSurface. W przyszłości będą obsługiwane w przypadku SpatialGltfModel i wszystkich SubspaceComposables. (I9a3cd)

Wersja 1.0.0-alpha16

25 marca 2026 r.

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

Zmiany w interfejsie API

  • Zmieniliśmy Orbiter, aby zamiast position, offset, offsetType, alignment i wysokości używał OrbiterAnchorPoint + VolumeOffset lub OrbiterPoseProvider. Usunęliśmy też parametr shouldRenderInNonSpatial. Jeśli deweloper nie chce, aby orbiter renderował się w przestrzeni nieprzestrzennej, powinien umieścić go w instrukcji warunkowej i sprawdzić SpatialCapabilities. (I9fbb3, b/462428503)

Wersja 1.0.0-alpha15

25 lutego 2026 r.

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

Zmiany w interfejsie API

Wersja 1.0.0-alpha14

28 stycznia 2026 r.

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

Wersja 1.0.0-alpha13

3 grudnia 2025 r.

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

Nowe funkcje

  • Utwórz implementację XR i ComponentOverride dla WideNavigationRail i ModalWideNavigationRail (I1e86d, b/407769444)
  • NavigationSuiteScaffold, ListDetailPaneScaffold i SupportingPaneScaffold używają teraz recommendedContentBoxInFullSpace do ustawiania domyślnych rozmiarów (Ic54f1, b/388111668, b/394913962, b/394913962)

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

  • Dodaliśmy 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

  • Poprawianie działania pływającego przycisku czynności 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

  • Utwórz implementację XR i ComponentOverride dla paska narzędzi poziomego i pionowego (0e9496c, dcfef96)

Poprawki błędów

  • Naprawianie problemu z wyś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

  • Naprawianie awarii, gdy ListDetailPaneScaffold lub SupportingPaneScaffold nie mają elementów podrzędnych (46df990)
  • Obniżanie minimalnego poziomu interfejsu API 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 opublikowane w Kotlinie 2.0 wymagają do użycia KGP 2.0.0 lub nowszego. (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

  • Gdy używasz EnableXrComponentOverrides, TopAppBar jest domyślnie przestrzenny w orbiterze.
  • Gdy używasz EnableXrComponentOverrides, AlertDialog Material jest domyślnie przestrzenny w SpatialPanel.

Zmiany w interfejsie API

  • Zmienianie nazw typów ComponentOverride na Override i typów ComponentOverrideContext na OverrideScope (Id973c)

Poprawki błędów

  • Naprawianie problemów z aliasingiem i nieprawidłowym przyciemnianiem w przestrzennych elementach 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 gdy używasz EnableXrComponentOverrides (I166b0)

Zmiany w interfejsie API

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

Wersja 1.0.0-alpha03

12 lutego 2025 r.

Publikacja androidx.xr.compose.material3:material3:1.0.0-alpha03 bez istotnych zmian od ostatniej wersji 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łączanie dostosowywania właściwości Orbiter w XR NavigationBar i NavigationRail. (Ic300f)

Zmiany w interfejsie API

  • Tworzenie możliwości zastępowania ThreePaneScaffold w XR (Ib66f1)
  • Implementowanie niezmienianego zastępowania panelu w XR (I7f620)
  • Dodawanie i używanie nowej eksperymentalnej adnotacji ExperimentalMaterial3ComponentOverrideApi (Ia1eaf)

Poprawki błędów

  • Przypinanie zależności 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. Dzięki istniejącej bibliotece Material 3 komponenty i układy adaptacyjne są wzbogacone o zachowania przestrzennego interfejsu. Możesz tworzyć bezpośrednio za pomocą komponentów M3 XR lub dostosować bieżącą implementację, dodając otoczkę EnableXrComponentOverrides. Więcej informacji znajdziesz w tym przewodniku dla deweloperów.

Obsługiwane adaptacje XR:

Znane problemy

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