新增必要的依附元件

本指南提供相關操作說明，協助您使用 Jetpack XR SDK 建立 Android XR 應用程式。內容涵蓋在 Android Studio 中建構沉浸式 XR 體驗時，必要的依附元件和專案設定。

相容性

Jetpack XR SDK 需要 minSdk 24，且必須編譯為 SDK 34 以上版本。

新增依附元件

請參閱下列參考指南，瞭解 Jetpack XR SDK 中每個程式庫的必要依附元件和相容性問題：

然後在應用程式的 build.gradle.kts 檔案中新增必要依附元件： <0x0

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 中建立新應用程式

如要建立包含 XR 專用的 Jetpack Compose 的新專案，請按照下列步驟操作：

  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. 確認專案的 build.gradle 檔案設定無誤，如「Gradle 屬性檔案」中所述。