設定 Jetpack XR SDK

適用 XR 裝置
這份指南可協助您為這類 XR 裝置打造體驗。
瞭解 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 檔案中新增必要依附元件： <0x0

Groovy

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

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

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

Kotlin

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

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

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

啟用程式碼縮減功能 (選用)

如要為建構作業啟用程式碼縮減和混淆功能 (使用 ProGuard)，您也必須新增 Android Extensions for XR 程式庫的依附元件。使用 Jetpack XR alpha05 以上版本的專案必須執行這項操作。

在模組的 build.gradle.kts 檔案中新增下列 compileOnly 依附元件：

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-alpha09"
    implementation "androidx.xr.glimmer:glimmer:1.0.0-alpha02"
    implementation "androidx.xr.projected:projected:1.0.0-alpha03"
    implementation "androidx.xr.arcore:arcore:1.0.0-alpha09"
}

Kotlin

dependencies {
    implementation("androidx.xr.runtime:runtime:1.0.0-alpha09")
    implementation("androidx.xr.glimmer:glimmer:1.0.0-alpha02")
    implementation("androidx.xr.proejcted:projected:1.0.0-alpha03")
    implementation("androidx.xr.arcore:arcore:1.0.0-alpha09")
}
上一頁
建立 Android XR 專案