必要な依存関係を追加する

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

互換性

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

依存関係を追加する

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

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

Groovy

dependencies {
    
    // Required for Java
    implementation "com.google.guava:listenablefuture:1.0"
    // Required for Kotlin
    implementation "org.jetbrains.kotlinx:kotlinx-coroutines-guava:1.9.0"

    implementation "androidx.xr.runtime:runtime:1.0.0-alpha05"
    implementation "androidx.xr.scenecore:scenecore:1.0.0-alpha05"
    implementation "androidx.xr.compose:compose:1.0.0-alpha05"
    implementation "androidx.xr.compose.material3:material3:1.0.0-alpha10"
    implementation "androidx.xr.arcore:arcore:1.0.0-alpha05"
}

Kotlin

dependencies {
    
    // Required for Java
    implementation("com.google.guava:listenablefuture:1.0")
    // Required for Kotlin
    implementation("org.jetbrains.kotlinx:kotlinx-coroutines-guava:1.9.0")

    implementation("androidx.xr.runtime:runtime:1.0.0-alpha05")
    implementation("androidx.xr.scenecore:scenecore:1.0.0-alpha05")
    implementation("androidx.xr.compose:compose:1.0.0-alpha05")
    implementation("androidx.xr.compose.material3:material3:1.0.0-alpha10")
    implementation("androidx.xr.arcore:arcore:1.0.0-alpha05")
}

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

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]、[基本的なヘッドセット アクティビティ] の順に選択します。
  3. [Configure your project] ウィンドウで、以下を行います。
    1. [Application name] を設定します。
    2. サンプルの [Project location] を選択します。
  4. [Finish] をクリックします。
  5. Gradle プロパティ ファイルの説明に沿って、プロジェクトの build.gradle ファイルが正しく構成されていることを確認します。