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

対象となる XR デバイス
このガイダンスは、次のようなタイプの XR デバイス向けのエクスペリエンスを構築する際に役立ちます。
[
XR Headsets
]
有線 XR グラス
[
AI Glasses
]

ビルドを開始する前に、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.0.0-alpha12"
    implementation "androidx.xr.scenecore:scenecore:1.0.0-alpha13"
    implementation "androidx.xr.compose:compose:1.0.0-alpha12"
    implementation "androidx.xr.compose.material3:material3:1.0.0-alpha16"
    implementation "androidx.xr.arcore:arcore:1.0.0-alpha12"

    // For compatibility with guava, use these dependencies:
    implementation "androidx.xr.arcore:arcore-guava:1.0.0-alpha12"
    implementation "androidx.xr.runtime:runtime-guava:1.0.0-alpha12"
    implementation "androidx.xr.scenecore:scenecore-guava:1.0.0-alpha13"

    // For compatibility with rxjava3, use these dependencies:
    implementation "androidx.xr.arcore:arcore-rxjava3:1.0.0-alpha12"
    implementation "androidx.xr.runtime:runtime-rxjava3:1.0.0-alpha12"
}

Kotlin

dependencies {
    implementation("androidx.xr.runtime:runtime:1.0.0-alpha12")
    implementation("androidx.xr.scenecore:scenecore:1.0.0-alpha13")
    implementation("androidx.xr.compose:compose:1.0.0-alpha12")
    implementation("androidx.xr.compose.material3:material3:1.0.0-alpha16")
    implementation("androidx.xr.arcore:arcore:1.0.0-alpha12")

    // For compatibility with guava, use these dependencies:
    implementation("androidx.xr.arcore:arcore-guava:1.0.0-alpha12")
    implementation("androidx.xr.runtime:runtime-guava:1.0.0-alpha12")
    implementation("androidx.xr.scenecore:scenecore-guava:1.0.0-alpha13")

    // For compatibility with rxjava3, use these dependencies:
    implementation("androidx.xr.arcore:arcore-rxjava3:1.0.0-alpha12")
    implementation("androidx.xr.runtime:runtime-rxjava3:1.0.0-alpha12")
}

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

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

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

Groovy

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

Kotlin

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

拡張エクスペリエンス(AI グラス)のライブラリの依存関係を追加する

まず、以下のリファレンス ガイドで、必要なライブラリごとの必要な依存関係と互換性の問題について確認してください。

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

Groovy

dependencies {
    implementation "androidx.xr.runtime:runtime:1.0.0-alpha12"
    implementation "androidx.xr.glimmer:glimmer:1.0.0-alpha11"
    implementation "androidx.xr.glimmer:glimmer-google-fonts:1.0.0-alpha11"
    implementation "androidx.xr.projected:projected:1.0.0-alpha06"
    implementation "androidx.xr.arcore:arcore:1.0.0-alpha12"
}

Kotlin

dependencies {
    implementation("androidx.xr.runtime:runtime:1.0.0-alpha12")
    implementation("androidx.xr.glimmer:glimmer:1.0.0-alpha11")
    implementation("androidx.xr.glimmer:glimmer-google-fonts:1.0.0-alpha11")
    implementation("androidx.xr.projected:projected:1.0.0-alpha06")
    implementation("androidx.xr.arcore:arcore:1.0.0-alpha12")
}