添加必要的依赖项

本指南提供了使用 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”模板创建新应用

要创建包含适用于 XR 的 Jetpack Compose 的新项目，请按以下步骤操作

  1. 如果您位于“欢迎使用 Android Studio”窗口中，请点击“新建 Android Studio 项目”。如果您已经打开了一个 Android Studio 项目，请从菜单栏中选择“文件 > 新建”。
  2. 从“模板”选项中选择“XR”，然后选择“基本头戴式设备 Activity”。
  3. 在“配置您的项目”窗口中，执行以下操作
    1. 设置“应用名称”。
    2. 为您的示例选择“项目位置”。
  4. 点击“完成”。
  5. 验证项目的 build.gradle 文件配置是否正确，如Gradle 属性文件中所述。