開始使用 Jetpack XR SDK

本指南說明如何使用 Jetpack XR SDK 建立 Android XR 應用程式。內容涵蓋在 Android Studio 中建構沉浸式 XR 體驗時，必要的依附元件和專案設定。

相容性

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

新增依附元件

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

• XR 執行階段
• Jetpack SceneCore
• 適用於 XR 的 Jetpack Compose
• XR 專用 Material Design
• 適用於 Jetpack XR 的 ARCore

然後在應用程式的 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-alpha06"
    implementation "androidx.xr.compose:compose:1.0.0-alpha06"
    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-alpha06")
    implementation("androidx.xr.compose:compose:1.0.0-alpha06")
    implementation("androidx.xr.compose.material3:material3:1.0.0-alpha10")
    implementation("androidx.xr.arcore:arcore:1.0.0-alpha05")
}

請參閱 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.0.0"
}

注意： 您必須使用 compileOnly 做為這項依附元件。使用 implementation 或 api 會導致應用程式在執行階段停止運作。

使用 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 屬性檔案」中所述。