添加必要的依赖项

本指南介绍了如何使用 Jetpack XR SDK 创建 Android XR 应用。它涵盖了在 Android Studio 中构建沉浸式 XR 体验所需的基本依赖项和项目设置。

兼容性

Jetpack XR SDK 需要 minSdk 为 24，并且必须编译到 SDK 34 或更高级别。

添加依赖项

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

然后，将必要的依赖项添加到应用的 build.gradle.kts 文件中：

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-alpha04"
    implementation "androidx.xr.scenecore:scenecore:1.0.0-alpha04"
    implementation "androidx.xr.compose:compose:1.0.0-alpha04"
    implementation "androidx.xr.compose.material3:material3:1.0.0-alpha08"
    implementation "androidx.xr.arcore:arcore:1.0.0-alpha04"
}

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-alpha04")
    implementation("androidx.xr.scenecore:scenecore:1.0.0-alpha04")
    implementation("androidx.xr.compose:compose:1.0.0-alpha04")
    implementation("androidx.xr.compose.material3:material3:1.0.0-alpha08")
    implementation("androidx.xr.arcore:arcore:1.0.0-alpha04")
}

请参阅 Hello Android XR 示例。

使用“基本头戴式耳机 activity”模板在 Android Studio 中创建新应用

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

  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. 根据 Gradle 属性文件中所述的方法，验证项目的 build.gradle 文件配置是否正确。