添加必要的依赖项

本指南介绍了如何使用 Jetpack XR SDK 创建 Android XR 应用。本课程介绍了 Android Studio 中用于构建沉浸式 XR 体验的基本依赖项和项目设置。

兼容性

Jetpack XR SDK 要求 minSdk 为 24,并且必须编译为 SDK 34 或更高版本

添加依赖项

请参阅以下参考指南,了解 Jetpack XR SDK 中每个库的必要依赖项和兼容性问题

示例

Hello Android XR 示例中的以下代码段展示了一个 build.gradle 示例文件,其中包含所有 Jetpack XR SDK 依赖项:

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 中使用基本头戴式设备 activity 模板创建新应用

如需创建支持 Jetpack Compose for XR 的新项目,请按以下步骤操作:

  1. 如果您位于 Welcome to Android Studio 窗口中,请点击 Start a new Android Studio project。如果您已打开 Android Studio 项目,请从菜单栏中依次选择 File > New
  2. Template 选项中选择 XR,然后选择 Basic Headset Activity
  3. Configure your project 窗口中,执行以下操作:
    1. 设置 Application name
    2. 选择示例的 Project location
  4. 点击 Finish
  5. 根据 Gradle 属性文件中所述的方法,验证项目的 build.gradle 文件配置是否正确。