XR용 Material Design

XR에 맞게 조정되는 Material 구성요소 및 레이아웃으로 빌드
최근 업데이트 안정화 버전 출시 후보 버전 베타 버전 알파 버전
2025년 10월 22일 - - - 1.0.0-alpha12

종속 항목 선언

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

Kotlin

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

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

의견

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

새로운 문제 제출하기

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

버전 1.0

버전 1.0.0-alpha12

2025년 10월 22일

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

새로운 기능

  • HomeSpace와 FullSpace 간 전환을 위한 SpaceModeToggleButton 추가 (Ic6865)

버그 수정

버전 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에는 이러한 커밋이 포함되어 있습니다.

새로운 기능

  • ListDetailPaneScaffold 및 SupportingPaneScaffold는 EnableXrComponentOverrides 사용 시 기본적으로 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 적응:

알려진 문제

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