新增必要的依附元件

本指南提供使用 Jetpack XR SDK 建立 Android XR 應用程式的操作說明。本課程將介紹 Android Studio 中建構沉浸式 XR 體驗所需的必要依附元件和專案設定。

相容性

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

新增依附元件

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

範例

以下是 Hello Android XR 範例的程式碼片段，其中顯示了包含所有 Jetpack XR SDK 依附元件的 build.gradle 檔案範例：

dependencies {
    val composeBom = platform(libs.androidx.compose.bom)
    implementation(composeBom)
    implementation(libs.impress)
    implementation(libs.androidx.arcore)
    implementation(libs.androidx.scenecore)
    implementation(libs.androidx.compose)
    implementation(libs.kotlinx.coroutines.guava)

    implementation(libs.material)
    implementation(libs.androidx.compose.material3)
    implementation(libs.androidx.adaptive.android)
    implementation(libs.androidx.concurrent.futures)
    implementation(libs.androidx.compose.runtime)
    implementation(libs.androidx.activity.compose)

    debugImplementation(libs.androidx.compose.ui.tooling)

    screenshotTestImplementation(libs.androidx.compose.ui.tooling)
}

以下是對應的 libs.toml 檔案範例：

[versions]
androidx-runtime = "1.8.0-alpha06"
agp = "8.6.1"
arcore = "1.0.0-alpha01"
compose = "1.0.0-alpha01"
impress = "0.0.1"
kotlinxCoroutinesGuava = "1.9.0"
scenecore = "1.0.0-alpha01"
kotlin = "2.0.21"
concurrentFuturesKtx = "1.2.0"
activityCompose = "1.10.0-beta01"
composeBom = "2024.11.00"
material = "1.12.0"
screenshot = "0.0.1-alpha08"
adaptiveAndroid = "1.0.0"

[libraries]
androidx-arcore = { module = "androidx.xr.arcore:arcore", version.ref = "arcore" }
androidx-compose = { module = "androidx.xr.compose:compose", version.ref = "compose" }
androidx-scenecore = { module = "androidx.xr.scenecore:scenecore", version.ref = "scenecore" }
impress = { module = "com.google.ar:impress", version.ref = "impress" }
kotlinx-coroutines-guava = { module = "org.jetbrains.kotlinx:kotlinx-coroutines-guava", version.ref = "kotlinxCoroutinesGuava" }
androidx-compose-material3 = { module = "androidx.compose.material3:material3" }
material = { module = "com.google.android.material:material", version.ref = "material" }
androidx-compose-ui-tooling = { module = "androidx.compose.ui:ui-tooling" }
androidx-concurrent-futures = { module = "androidx.concurrent:concurrent-futures-ktx", version.ref = "concurrentFuturesKtx" }
androidx-activity-compose = { group = "androidx.activity", name = "activity-compose", version.ref = "activityCompose" }
androidx-compose-runtime = { module = "androidx.compose.runtime:runtime", version.ref = "androidx-runtime" }
androidx-compose-bom = { group = "androidx.compose", name = "compose-bom", version.ref = "composeBom" }

請參閱 Hello Android XR 範例。

使用基本耳機活動範本在 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. 確認專案的 build.gradle 檔案設定正確無誤，如「Gradle 屬性檔案」中所述。