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

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

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

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

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

Kotlin

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

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

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

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

ビルドで 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-alpha09"
    implementation "androidx.xr.glimmer:glimmer:1.0.0-alpha02"
    implementation "androidx.xr.projected:projected:1.0.0-alpha03"
    implementation "androidx.xr.arcore:arcore:1.0.0-alpha09"
}

Kotlin

dependencies {
    implementation("androidx.xr.runtime:runtime:1.0.0-alpha09")
    implementation("androidx.xr.glimmer:glimmer:1.0.0-alpha02")
    implementation("androidx.xr.proejcted:projected:1.0.0-alpha03")
    implementation("androidx.xr.arcore:arcore:1.0.0-alpha09")
}