Материальный дизайн для XR

Создавайте проекты с использованием компонентов и макетов Material Design, адаптированных для XR.
Последнее обновление Стабильный релиз Предварительная версия для выпуска Бета-версия Альфа-версия
28 января 2026 г. - - - 1.0.0-alpha14

Объявление зависимостей

Чтобы добавить зависимость от ядра XR Compose Material3, необходимо добавить репозиторий Google Maven в ваш проект. Для получения дополнительной информации ознакомьтесь с информацией в репозитории Google Maven .

Добавьте зависимости для необходимых артефактов в файл build.gradle вашего приложения или модуля:

классный 

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

Котлин 

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

Для получения дополнительной информации о зависимостях см. раздел «Добавление зависимостей сборки» .

Обратная связь

Ваши отзывы помогают улучшить Jetpack. Сообщите нам, если вы обнаружите новые проблемы или у вас есть идеи по улучшению этой библиотеки. Пожалуйста, ознакомьтесь с существующими проблемами в этой библиотеке, прежде чем создавать новую. Вы можете проголосовать за существующую проблему, нажав кнопку со звездочкой.

Создать новую задачу

Для получения более подробной информации см. документацию по системе отслеживания ошибок .

Версия 1.0

Версия 1.0.0-alpha14

28 января 2026 г.

Выпущена версия androidx.xr.compose.material3:material3:1.0.0-alpha14 . Версия 1.0.0-alpha14 содержит следующие коммиты .

Версия 1.0.0-alpha13

3 декабря 2025 г.

Выпущена версия androidx.xr.compose.material3:material3:1.0.0-alpha13 . Версия 1.0.0-alpha13 содержит следующие коммиты .

Новые функции

  • Создание реализации XR и ComponentOverride для WideNavigationRail и ModalWideNavigationRail ( I1e86d , b/407769444 )
  • Теперь NavigationSuiteScaffold , ListDetailPaneScaffold и SupportingPaneScaffold используют recommendedContentBoxInFullSpace для установки своих размеров по умолчанию ( Ic54f1 , b/388111668 , b/394913962 , b/394913962 ).

Версия 1.0.0-alpha12

22 октября 2025 г.

Выпущена версия androidx.xr.compose.material3:material3:1.0.0-alpha12 . Версия 1.0.0-alpha12 содержит следующие коммиты .

Новые функции

  • Добавлена SpaceModeToggleButton для переключения между HomeSpace и FullSpace ( Ic6865 )

Исправлены ошибки

  • Улучшение панелей инструментов XR ( Ied1f5 )

Версия 1.0.0-alpha11

27 августа 2025 г.

Выпущена версия androidx.xr.compose.material3:material3:1.0.0-alpha11 . Версия 1.0.0-alpha11 содержит следующие коммиты .

Исправлены ошибки

  • Исправлена ​​ошибка в работе кнопки FAB в XR NavRail ( Ibe20b ).

Версия 1.0.0-alpha10

30 июля 2025 г.

Выпущена версия androidx.xr.compose.material3:material3:1.0.0-alpha10 . Версия 1.0.0-alpha10 содержит следующие коммиты .

Новые функции

  • Создание реализации XR и ComponentOverride для горизонтальной и вертикальной панели инструментов ( 0e9496c , dcfef96 )

Исправлены ошибки

  • Исправлена ​​ошибка, из-за которой диалоговое окно XR не отображало часть содержимого ( c82e61b )

Версия 1.0.0-alpha08

20 мая 2025 г.

Выпущена версия androidx.xr.compose.material3:material3:1.0.0-alpha08 . Версия 1.0.0-alpha08 содержит следующие коммиты .

Исправлены ошибки

  • Исправлена ​​ошибка, приводящая к сбою, когда ListDetailPaneScaffold или SupportingPaneScaffold не имеют дочерних элементов ( 46df990 )
  • Нижний предел материала XR minSdk до 24 ( 6064706 )

Версия 1.0.0-alpha07

7 мая 2025 г.

Выпущена версия androidx.xr.compose.material3:material3:1.0.0-alpha07 . Версия 1.0.0-alpha07 содержит следующие коммиты .

Изменения в API

  • Для использования проектов, выпущенных с Kotlin 2.0, требуется KGP 2.0.0 или более поздняя версия. ( Idb6b5 )

Версия 1.0.0-alpha06

26 марта 2025 г.

Выпущена версия androidx.xr.compose.material3:material3:1.0.0-alpha06 . Версия 1.0.0-alpha06 содержит следующие коммиты .

Версия 1.0.0-alpha05

12 марта 2025 г.

Выпущена версия androidx.xr.compose.material3:material3:1.0.0-alpha05 . Версия 1.0.0-alpha05 содержит следующие коммиты .

Новые функции

  • При использовании EnableXrComponentOverrides TopAppBar по умолчанию пространственно размещается в объекте Orbiter.
  • При использовании EnableXrComponentOverrides диалоговое окно Material AlertDialog по умолчанию преобразуется в SpatialPanel .

Изменения в API

  • Переименовать типы ComponentOverride в Override , а типы ComponentOverrideContext в OverrideScope ( Id973c )

Исправлены ошибки

  • Исправлены ошибки сглаживания и некорректное отображение границ на пространственно ориентированных NavigationRail и NavigationBar . ( I9db52 )

Версия 1.0.0-alpha04

26 февраля 2025 г.

Выпущена версия androidx.xr.compose.material3:material3:1.0.0-alpha04 . Версия 1.0.0-alpha04 содержит следующие коммиты .

Новые функции

  • ListDetailPaneScaffold и SupportingPaneScaffold по умолчанию используют SpatialPanels при применении EnableXrComponentOverrides ( I166b0 ).

Изменения в API

  • Геттеры DefaultNavigationRailOrbiterProperties и DefaultNavigationBarOrbiterProperties больше не являются @Composable ( I61618 )
  • LocalNavigationRailOrbiterProperties и LocalNavigationBarOrbiterProperties больше не допускают значения null ( I61618 ).

Версия 1.0.0-alpha03

12 февраля 2025 г.

Выпущена версия androidx.xr.compose.material3:material3:1.0.0-alpha03 без существенных изменений по сравнению с предыдущей альфа-версией. Версия 1.0.0-alpha03 содержит следующие коммиты .

Версия 1.0.0-alpha02

29 января 2025 г.

Выпущена версия androidx.xr.compose.material3:material3:1.0.0-alpha02 . Версия 1.0.0-alpha02 содержит следующие коммиты .

Новые функции

  • Включите возможность настройки свойств Orbiter на панели навигации XR NavigationBar и NavigationRail . ( Ic300f )

Изменения в API

  • Создать возможность переопределения ThreePaneScaffold в XR ( Ib66f1 )
  • Реализовать переопределение неанимированной панели для XR ( I7f620 )
  • Добавьте и используйте новую экспериментальную аннотацию ExperimentalMaterial3ComponentOverrideApi ( Ia1eaf )

Исправлены ошибки

  • Зависимость Material3 XR от XR Compose. ( Ia02cc )

Версия 1.0.0-alpha01

12 декабря 2024 г.

Выпущена версия androidx.xr.compose.material3:material3:1.0.0-alpha01 .

Особенности первоначального выпуска

Первый релиз Material Design для XR для разработчиков. Используя существующую библиотеку Material 3, компоненты и адаптивные макеты дополнены пространственными особенностями пользовательского интерфейса. Вы можете создавать компоненты непосредственно с помощью компонентов M3 XR или адаптировать свою текущую реализацию, добавив обертку EnableXrComponentOverrides . Подробнее см. в этом руководстве для разработчиков .

Поддерживаемые адаптации XR:

Известные проблемы

  • В настоящее время ListDetailPaneScaffold и SupportingPaneScaffold не поддерживают несколько пространственных панелей.