新增必要的依附元件

本指南提供使用 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 的新專案，請按照下列步驟操作：

如果您位於「Welcome to Android Studio」視窗，請按一下「Start a new Android Studio project」。如果您已開啟 Android Studio 專案，請從選單列中依序選取「File」>「New」。
從「範本」選項中選取「XR」，然後選取「基本耳機活動」。
在「Configure your project」視窗中執行以下操作：
1. 設定「Application name」。
2. 選擇範例的「Project location」。
按一下「Finish」。
確認專案的 build.gradle 檔案設定正確無誤，如「Gradle 屬性檔案」中所述。