XR용 Material Design

XR에 맞게 조정되는 Material 구성요소 및 레이아웃으로 빌드

최근 업데이트	안정화 버전	출시 후보 버전	베타 버전	알파 버전
2026년 3월 25일	-	-	-	1.0.0-alpha16

종속 항목 선언

XR Compose Material3 Core의 종속 항목을 추가하려면 프로젝트에 Google Maven 저장소를 추가해야 합니다. 자세한 내용은 Google Maven 저장소 를 읽어보세요.

다음과 같이 앱 또는 모듈의 build.gradle 파일에 필요한 아티팩트의 종속 항목을 추가합니다.

Groovy

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

Kotlin

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

종속 항목에 관한 자세한 내용은 빌드 종속 항목 추가를 참고하세요.

의견

제출하신 의견은 Jetpack을 개선하는 데 도움이 됩니다. 새로운 문제를 발견하거나 라이브러리 개선을 위한 아이디어가 있다면 Google에 알려 주세요. 새 문제를 제출하기 전에 이 라이브러리의 기존 문제를 살펴보시기 바랍니다. 별표 버튼을 클릭하여 기존 문제에 투표할 수 있습니다.

새로운 문제 제출하기

자세한 내용은 Issue Tracker 문서를 참고하세요.

버전 1.0

버전 1.0.0-alpha16

2026년 3월 25일

androidx.xr.compose.material3:material3:1.0.0-alpha16이 출시되었습니다. 버전 1.0.0-alpha16에 포함된 커밋을 확인하세요.

API 변경사항

position, offset, offsetType, alignment, elevation 대신 OrbiterAnchorPoint + VolumeOffset 또는 OrbiterPoseProvider를 사용하도록 Orbiter를 변경했습니다. 또한 shouldRenderInNonSpatial 매개변수를 삭제했습니다. 개발자가 비공간에서 Orbiter를 렌더링하지 않으려면 if 문으로 Orbiter를 래핑하고 SpatialCapabilities를 확인해야 합니다. (I9fbb3, b/462428503)

버전 1.0.0-alpha15

2026년 2월 25일

androidx.xr.compose.material3:material3:1.0.0-alpha15이 출시되었습니다. 버전 1.0.0-alpha15에 포함된 커밋을 확인하세요.

API 변경사항

레이아웃 방향 인식을 위한 하위 공간 수정자 패딩 변경사항 (I53e25, b/475290780, b/474410590)

버전 1.0.0-alpha14

2026년 1월 28일

androidx.xr.compose.material3:material3:1.0.0-alpha14이 출시되었습니다. 버전 1.0.0-alpha14에 포함된 커밋을 확인하세요.

버전 1.0.0-alpha13

2025년 12월 3일

androidx.xr.compose.material3:material3:1.0.0-alpha13이 출시되었습니다. 버전 1.0.0-alpha13에 포함된 커밋을 확인하세요.

새로운 기능

WideNavigationRail 및 ModalWideNavigationRail용 XR 구현 및 ComponentOverride를 만듭니다. (I1e86d, b/407769444)
NavigationSuiteScaffold, ListDetailPaneScaffold, SupportingPaneScaffold는 이제 recommendedContentBoxInFullSpace를 사용하여 기본 크기를 설정합니다. (Ic54f1, b/388111668, b/394913962, b/394913962)

버전 1.0.0-alpha12

2025년 10월 22일

androidx.xr.compose.material3:material3:1.0.0-alpha12이 출시되었습니다. 버전 1.0.0-alpha12에 포함된 커밋을 확인하세요.

새로운 기능

HomeSpace와 FullSpace 간에 전환하기 위한 SpaceModeToggleButton을 추가했습니다. (Ic6865)

버그 수정

XR 툴바를 개선합니다. (Ied1f5)

버전 1.0.0-alpha11

2025년 8월 27일

androidx.xr.compose.material3:material3:1.0.0-alpha11이 출시되었습니다. 버전 1.0.0-alpha11에 포함된 커밋을 확인하세요.

버그 수정

XR NavRail에서 FAB의 동작을 수정합니다. (Ibe20b)

버전 1.0.0-alpha10

2025년 7월 30일

androidx.xr.compose.material3:material3:1.0.0-alpha10이 출시되었습니다. 버전 1.0.0-alpha10에 포함된 커밋을 확인하세요.

새로운 기능

가로 및 세로 툴바용 XR 구현 및 ComponentOverride를 만듭니다. (0e9496c, dcfef96)

버그 수정

일부 콘텐츠가 표시되지 않는 XR 대화상자를 수정합니다. (c82e61b)

버전 1.0.0-alpha08

2025년 5월 20일

androidx.xr.compose.material3:material3:1.0.0-alpha08이 출시되었습니다. 버전 1.0.0-alpha08에 포함된 커밋을 확인하세요.

버그 수정

ListDetailPaneScaffold 또는 SupportingPaneScaffold에 하위 요소가 없는 경우 발생하는 비정상 종료 문제를 수정합니다. (46df990)
Material XR minSdk를 24로 낮춥니다. (6064706)

버전 1.0.0-alpha07

2025년 5월 7일

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

2025년 3월 26일

androidx.xr.compose.material3:material3:1.0.0-alpha06이 출시되었습니다. 버전 1.0.0-alpha06에 포함된 커밋을 확인하세요.

버전 1.0.0-alpha05

2025년 3월 12일

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

2025년 2월 26일

androidx.xr.compose.material3:material3:1.0.0-alpha04이 출시되었습니다. 버전 1.0.0-alpha04에 포함된 커밋을 확인하세요.

새로운 기능

EnableXrComponentOverrides를 사용하는 경우 ListDetailPaneScaffold 및 SupportingPaneScaffold는 기본적으로 SpatialPanels를 사용합니다. (I166b0)

API 변경사항

DefaultNavigationRailOrbiterProperties 및 DefaultNavigationBarOrbiterProperties getter는 더 이상@Composable (I61618)이 아닙니다.
LocalNavigationRailOrbiterProperties 및 LocalNavigationBarOrbiterProperties는 더 이상 null을 허용하지 않습니다. (I61618)

버전 1.0.0-alpha03

2025년 2월 12일

androidx.xr.compose.material3:material3:1.0.0-alpha03이 지난 알파 이후 눈에 띄는 변경사항 없이 출시되었습니다. 버전 1.0.0-alpha03에 포함된 커밋을 확인하세요.

버전 1.0.0-alpha02

2025년 1월 29일

androidx.xr.compose.material3:material3:1.0.0-alpha02이 출시되었습니다. 버전 1.0.0-alpha02에는 이러한 커밋이 포함되어 있습니다.

새로운 기능

XR NavigationBar 및 NavigationRail에서 Orbiter 속성의 맞춤설정을 사용 설정합니다. (Ic300f)

API 변경사항

XR에서 ThreePaneScaffold를 재정의하는 기능을 만듭니다. (Ib66f1)
XR용 비애니메이션 패널 재정의를 구현합니다. I7f620
새로운 실험용 주석 ExperimentalMaterial3ComponentOverrideApi를 추가하고 사용합니다. (Ia1eaf)

버그 수정

XR Compose에 Material3 XR의 종속 항목을 고정합니다. (Ia02cc)

버전 1.0.0-alpha01

2024년 12월 12일

androidx.xr.compose.material3:material3:1.0.0-alpha01이 출시되었습니다.

최초 출시의 기능

XR용 Material Design의 최초 개발자 출시입니다. 기존 Material 3 라이브러리를 사용하여 구성요소와 적응형 레이아웃이 공간 UI 동작으로 향상됩니다. M3 XR 구성요소로 직접 빌드하거나 EnableXrComponentOverrides 래퍼를 추가하여 현재 구현을 조정할 수 있습니다. 이 개발자 가이드에서 자세히 알아보세요.

지원되는 XR 조정은 다음과 같습니다.

NavigationSuiteScaffold를 비롯한 모든 Compose 레이아웃의 탐색 레일은 XR Orbiter에 자동으로 조정됩니다. 자세한 내용은 Material Design 가이드라인을 참고하세요.
NavigationSuiteScaffold를 비롯한 모든 Compose 레이아웃의 탐색 메뉴는 XR Orbiter에 자동으로 조정됩니다. 자세한 내용은 Material Design 가이드라인을 참고하세요.

알려진 문제

ListDetailPaneScaffold 및 SupportingPaneScaffold는 현재 여러 공간 패널을 지원하지 않습니다.