设置 Jetpack XR SDK

适用的 XR 设备
本指南可帮助您为以下类型的 XR 设备打造优质体验。
了解 XR 设备类型 →
扩展现实头戴设备
有线扩展现实眼镜
AI 眼镜
了解 XR 设备类型 →

在开始构建之前，您需要设置 Jetpack XR SDK。按照每个部分中的步骤，使用 SDK 设置开发环境。

检查 Android SDK 兼容性

Jetpack XR SDK 要求您的应用使用 Android minSdk 24 和 compileSdk 34 或更高版本。

添加库依赖项

应用所需的依赖项取决于您要构建的体验类型和 XR 设备。如需详细了解如何为应用添加依赖项，请参阅以下部分。

为沉浸式体验（XR 头戴设备和 XR 眼镜）添加库依赖项

首先，请参阅以下参考指南，了解每个必需库的必要依赖项和兼容性问题：

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

Groovy

dependencies {
    implementation "androidx.xr.runtime:runtime:1.0.0-alpha10"
    implementation "androidx.xr.scenecore:scenecore:1.0.0-alpha11"
    implementation "androidx.xr.compose:compose:1.0.0-alpha10"
    implementation "androidx.xr.compose.material3:material3:1.0.0-alpha14"
    implementation "androidx.xr.arcore:arcore:1.0.0-alpha10"

    // For compatibility with guava, use these dependencies:
    implementation "androidx.xr.arcore:arcore-guava:1.0.0-alpha10"
    implementation "androidx.xr.runtime:runtime-guava:1.0.0-alpha10"
    implementation "androidx.xr.scenecore:scenecore-guava:1.0.0-alpha11"

    // For compatibility with rxjava3, use these dependencies:
    implementation "androidx.xr.arcore:arcore-rxjava3:1.0.0-alpha10"
    implementation "androidx.xr.runtime:runtime-rxjava3:1.0.0-alpha10"
}

Kotlin

dependencies {
    implementation("androidx.xr.runtime:runtime:1.0.0-alpha10")
    implementation("androidx.xr.scenecore:scenecore:1.0.0-alpha11")
    implementation("androidx.xr.compose:compose:1.0.0-alpha10")
    implementation("androidx.xr.compose.material3:material3:1.0.0-alpha14")
    implementation("androidx.xr.arcore:arcore:1.0.0-alpha10")

    // For compatibility with guava, use these dependencies:
    implementation("androidx.xr.arcore:arcore-guava:1.0.0-alpha10")
    implementation("androidx.xr.runtime:runtime-guava:1.0.0-alpha10")
    implementation("androidx.xr.scenecore:scenecore-guava:1.0.0-alpha11")

    // For compatibility with rxjava3, use these dependencies:
    implementation("androidx.xr.arcore:arcore-rxjava3:1.0.0-alpha10")
    implementation("androidx.xr.runtime:runtime-rxjava3:1.0.0-alpha10")
}

启用代码缩减功能（可选）

如果您想使用 ProGuard 为 build 启用代码缩小和混淆功能，还必须添加对 Android 扩展程序（适用于 XR）库的依赖项。使用 Jetpack XR alpha05 或更高版本的项目需要此依赖项。

将以下 compileOnly 依赖项添加到模块的 build.gradle.kts 文件中：

Groovy

dependencies {
    // ... other dependencies
    compileOnly "com.android.extensions.xr:extensions-xr:1.1.0"
}

Kotlin

dependencies {
    // ... other dependencies
    compileOnly("com.android.extensions.xr:extensions-xr:1.1.0")
}

为增强现实体验（AI 眼镜）添加库依赖项

首先，请参阅以下参考指南，了解每个必需库的必要依赖项和兼容性问题：

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

Groovy

dependencies {
    implementation "androidx.xr.runtime:runtime:1.0.0-alpha10"
    implementation "androidx.xr.glimmer:glimmer:1.0.0-alpha05"
    implementation "androidx.xr.projected:projected:1.0.0-alpha04"
    implementation "androidx.xr.arcore:arcore:1.0.0-alpha10"
}

Kotlin

dependencies {
    implementation("androidx.xr.runtime:runtime:1.0.0-alpha10")
    implementation("androidx.xr.glimmer:glimmer:1.0.0-alpha05")
    implementation("androidx.xr.projected:projected:1.0.0-alpha04")
    implementation("androidx.xr.arcore:arcore:1.0.0-alpha10")
}
上一页
创建 Android XR 项目