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
30 lipca 2025 r. - - - 1.0.0-alpha10

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

Kotlin

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

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 nową kartę, 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-alpha10

30 lipca 2025 r.

Zostanie wycofaneandroidx.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 poziomie i pionie (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.

Zostanie wycofaneandroidx.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 zawierał elementów podrzędnych (46df990).
  • Obniżenie minimalnej wersji pakietu Material XR do 24 (6064706)

Wersja 1.0.0-alpha07

7 maja 2025 r.

Zostanie wycofaneandroidx.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.

Zostanie wycofaneandroidx.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.

Zostanie wycofaneandroidx.xr.compose.material3:material3:1.0.0-alpha05 Wersja 1.0.0-alpha05 zawiera te commity.

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 nazw typów ComponentOverride na Override i 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.

Zostanie wycofaneandroidx.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 commity.

Wersja 1.0.0-alpha02

29 stycznia 2025 r.

Zostanie wycofaneandroidx.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 urządzeniach XR (Ib66f1)
  • Implementowanie nieanimowanego zastąpienia panelu w przypadku XR (I7f620)
  • Dodawanie i używanie 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.

Zostanie wycofaneandroidx.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 otokę 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.