Jetpack XR SDK を使ってみる

このガイドでは、Jetpack XR SDK を使用して Android XR アプリケーションを作成する手順について説明します。没入型 XR エクスペリエンスを構築するための、Android Studio の必須の依存関係とプロジェクトのセットアップについて説明します。

互換性

Jetpack XR SDK には minSdk が 24 必要で、SDK 34 以降にコンパイルする必要があります。

依存関係を追加する

Jetpack XR SDK の各ライブラリに必要な依存関係と互換性の問題については、次のリファレンス ガイドをご覧ください。

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

Groovy

dependencies {
    implementation "androidx.xr.runtime:runtime:1.0.0-alpha06"
    implementation "androidx.xr.scenecore:scenecore:1.0.0-alpha07"
    implementation "androidx.xr.compose:compose:1.0.0-alpha07"
    implementation "androidx.xr.compose.material3:material3:1.0.0-alpha11"
    implementation "androidx.xr.arcore:arcore:1.0.0-alpha06"

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

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

Kotlin

dependencies {
    implementation("androidx.xr.runtime:runtime:1.0.0-alpha06")
    implementation("androidx.xr.scenecore:scenecore:1.0.0-alpha07")
    implementation("androidx.xr.compose:compose:1.0.0-alpha07")
    implementation("androidx.xr.compose.material3:material3:1.0.0-alpha11")
    implementation("androidx.xr.arcore:arcore:1.0.0-alpha06")

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

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

Hello Android XR サンプルをご覧ください。

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

ビルドで 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")
}

Basic Headset Activity テンプレートを使用して Android Studio で新しいアプリを作成する

Jetpack Compose for XR を含む新規プロジェクトを作成する手順は、次のとおりです。

  1. [Welcome to Android Studio] ウィンドウが開いている場合は、[Start a new Android Studio project] をクリックします。Android Studio プロジェクトをすでに開いている場合は、メニューバーで [File] > [New] を選択します。
  2. [テンプレート] オプションから [XR]、[Basic Headset Activity] の順に選択します。
  3. [Configure your project] ウィンドウで、以下を行います。
    1. [Application name] を設定します。
    2. サンプルの [Project location] を選択します。
  4. [Finish] をクリックします。
  5. Gradle プロパティ ファイルの説明に沿って、プロジェクトの build.gradle ファイルが正しく構成されていることを確認します。