Jetpack XR SDK をセットアップする

対象となる XR デバイス
このガイダンスは、次のようなタイプの XR デバイス向けのエクスペリエンスを構築する際に役立ちます。
XR ヘッドセット
有線 XR グラス
オーディオ&
ディスプレイ グラス

ビルドを開始する前に、Jetpack XR SDK を設定する必要があります。各セクションの手順に沿って、SDK を使用して開発環境をセットアップします。

Android SDK の互換性を確認する

Jetpack XR SDK を使用するには、アプリで Android minSdk 24 と compileSdk 34 以降を使用する必要があります。

ライブラリの依存関係を追加する

アプリに必要な依存関係は、構築するエクスペリエンスと XR デバイスの種類によって異なります。アプリの依存関係を追加する方法については、以下のセクションをご覧ください。

没入型エクスペリエンス(XR ヘッドセットと XR グラス)用のライブラリ依存関係を追加する

まず、次のリファレンス ガイドを参照して、必要な各ライブラリに必要な依存関係と互換性の問題を理解します。

次に、必要な依存関係をアプリの build.gradle.kts ファイルに追加します。

Groovy

dependencies {
    implementation "androidx.xr.runtime:runtime:1.1.0-alpha02"
    implementation "androidx.xr.scenecore:scenecore:1.1.0-alpha01"
    implementation "androidx.xr.compose:compose:1.0.0-beta02"
    implementation "androidx.xr.compose.material3:material3:1.0.0-alpha17"
    implementation "androidx.xr.arcore:arcore:1.1.0-alpha01"
}

Kotlin

dependencies {
    implementation("androidx.xr.runtime:runtime:1.1.0-alpha02")
    implementation("androidx.xr.scenecore:scenecore:1.1.0-alpha01")
    implementation("androidx.xr.compose:compose:1.0.0-beta02")
    implementation("androidx.xr.compose.material3:material3:1.0.0-alpha17")
    implementation("androidx.xr.arcore:arcore:1.1.0-alpha01")
}

コードの圧縮を有効にする(省略可)

ProGuard を使用してビルドのコードの圧縮と難読化を有効にする場合は、Android Extensions for XR ライブラリへの依存関係も追加する必要があります。これは、Jetpack XR alpha05 以降を使用するプロジェクトで必要です。

モジュールの build.gradle.kts ファイルに次の compileOnly 依存関係を追加します。

Groovy

dependencies {
    // ... other dependencies
    compileOnly "com.android.extensions.xr:extensions-xr:1.4.0"
}

Kotlin

dependencies {
    // ... other dependencies
    compileOnly("com.android.extensions.xr:extensions-xr:1.4.0")
}

拡張エクスペリエンス(オーディオ グラスとディスプレイ グラス)のライブラリ依存関係を追加する

まず、次のリファレンス ガイドを参照して、必要な各ライブラリに必要な依存関係と互換性の問題を理解します。

次に、アプリの build.gradle.kts ファイルに必要な依存関係を追加します。

Groovy

dependencies {
    implementation "androidx.xr.runtime:runtime:1.1.0-alpha02"
    implementation "androidx.xr.glimmer:glimmer:1.0.0-alpha22"
    implementation "androidx.xr.glimmer:glimmer-google-fonts:1.0.0-alpha22"
    implementation "androidx.xr.projected:projected:1.0.0-alpha14"
    implementation "androidx.xr.arcore:arcore:1.1.0-alpha01"
}

Kotlin

dependencies {
    implementation("androidx.xr.runtime:runtime:1.1.0-alpha02")
    implementation("androidx.xr.glimmer:glimmer:1.0.0-alpha22")
    implementation("androidx.xr.glimmer:glimmer-google-fonts:1.0.0-alpha22")
    implementation("androidx.xr.projected:projected:1.0.0-alpha14")
    implementation("androidx.xr.arcore:arcore:1.1.0-alpha01")
}