XR のマテリアル デザイン

XR に適応するマテリアル コンポーネントとレイアウトでビルドする
最新の更新 安定版リリース リリース候補版 ベータ版リリース アルファ版リリース
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 改善の参考にさせていただきます。新しい問題が見つかった場合や、このライブラリを改善するアイデアをお持ちの場合は、お知らせください。新しい問題を報告していただく前に、このライブラリの既存の問題をご確認ください。スターボタンをクリックすると、既存の問題に投票できます。

新しい問題を報告する

詳細については、Issue Tracker のドキュメントをご覧ください。

バージョン 1.0

バージョン 1.0.0-alpha16

2026 年 3 月 25 日

androidx.xr.compose.material3:material3:1.0.0-alpha16 がリリースされました。バージョン 1.0.0-alpha16 に含まれる commit については、こちらをご覧ください。

API の変更

  • Orbiter が、position、offset、offsetType、alignment、elevation ではなく、OrbiterAnchorPoint + VolumeOffset または OrbiterPoseProvider を使用するように変更されました。また、shouldRenderInNonSpatial パラメータが削除されました。Orbiter を非空間でレンダリングしない場合は、Orbiter を if ステートメントでラップし、SpatialCapabilities を確認する必要があります。（I9fbb3、b/462428503）

バージョン 1.0.0-alpha15

2026 年 2 月 25 日

androidx.xr.compose.material3:material3:1.0.0-alpha15 がリリースされました。バージョン 1.0.0-alpha15 に含まれる commit については、こちらをご覧ください。

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 に含まれる commit については、こちらをご覧ください。

バージョン 1.0.0-alpha13

2025 年 12 月 3 日

androidx.xr.compose.material3:material3:1.0.0-alpha13 がリリースされました。バージョン 1.0.0-alpha13 に含まれる commit については、こちらをご覧ください。

新機能

  • 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 に含まれる commit については、こちらをご覧ください。

新機能

  • 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 に含まれる commit については、こちらをご覧ください。

バグの修正

  • XR NavRail での FAB の動作を修正しました（Ibe20b）

バージョン 1.0.0-alpha10

2025 年 7 月 30 日

androidx.xr.compose.material3:material3:1.0.0-alpha10 がリリースされました。バージョン 1.0.0-alpha10 に含まれる commit については、こちらをご覧ください。

新機能

  • 水平ツールバーと垂直ツールバーの 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 に含まれる commit については、こちらをご覧ください。

バグの修正

  • 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 に含まれる commit については、こちらをご覧ください。

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 に含まれる commit については、こちらをご覧ください。

バージョン 1.0.0-alpha05

2025 年 3 月 12 日

androidx.xr.compose.material3:material3:1.0.0-alpha05 がリリースされました。バージョン 1.0.0-alpha05 に含まれる commit については、こちらをご覧ください。

新機能

  • 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 に含まれる commit については、こちらをご覧ください。

新機能

  • EnableXrComponentOverrides を使用すると、ListDetailPaneScaffold と SupportingPaneScaffold でデフォルトで SpatialPanels が使用されるようになりました（I166b0）

API の変更

  • DefaultNavigationRailOrbiterProperties と DefaultNavigationBarOrbiterProperties のゲッターが @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 に含まれる commit については、こちらをご覧ください。

バージョン 1.0.0-alpha02

2025 年 1 月 29 日

androidx.xr.compose.material3:material3:1.0.0-alpha02 がリリースされました。バージョン 1.0.0-alpha02 に含まれる commit については、こちらをご覧ください。

新機能

  • XR NavigationBar と NavigationRail で Orbiter プロパティをカスタマイズできるようになりました。(Ic300f)

API の変更

  • XR で ThreePaneScaffold をオーバーライドする機能を作成しました（Ib66f1）
  • XR 用にアニメーションなしの Pane オーバーライドを実装しました（I7f620）
  • 新しい試験運用版アノテーション ExperimentalMaterial3ComponentOverrideApi を追加して使用しました（Ia1eaf）

バグの修正

  • Material3 XR の依存関係を XR Compose に固定しました。(Ia02cc)

バージョン 1.0.0-alpha01

2024 年 12 月 12 日

androidx.xr.compose.material3:material3:1.0.0-alpha01 がリリースされました。

初回リリースの機能

XR のマテリアル デザインのデベロッパー向け初回リリース。既存の Material 3 ライブラリを使用して、コンポーネントとアダプティブ レイアウトが空間 UI の動作で強化されています。M3 XR コンポーネントで直接ビルドすることも、EnableXrComponentOverrides ラッパーを追加して現在の実装を適応させることもできます。詳しくは、こちらのデベロッパー ガイドをご覧ください。

サポートされている XR の適応:

既知の問題

  • ListDetailPaneScaffold と SupportingPaneScaffold は現在、複数の空間パネルをサポートしていません。