Thiết lập Jetpack XR SDK

Các thiết bị XR áp dụng
Hướng dẫn này giúp bạn tạo trải nghiệm cho các loại thiết bị XR này.
Tìm hiểu về các loại thiết bị thực tế mở rộng (XR) →
Kính XR
Kính XR có dây
Kính AI
Tìm hiểu về các loại thiết bị thực tế mở rộng (XR) →

Trước khi có thể bắt đầu tạo, bạn cần thiết lập Jetpack XR SDK. Làm theo các bước trong từng phần để thiết lập môi trường phát triển bằng SDK.

Kiểm tra khả năng tương thích của SDK Android

SDK Jetpack XR yêu cầu ứng dụng của bạn sử dụng minSdk Android 24 và compileSdk 34 trở lên.

Thêm phần phụ thuộc thư viện

Các phần phụ thuộc mà ứng dụng của bạn yêu cầu phụ thuộc vào các loại trải nghiệm và thiết bị thực tế mở rộng mà bạn đang tạo. Hãy xem các phần sau để biết thêm thông tin về cách thêm các phần phụ thuộc cho ứng dụng của bạn.

Thêm phần phụ thuộc của thư viện cho trải nghiệm sống động (kính XR và kính thực tế mở rộng)

Trước tiên, hãy xem các hướng dẫn tham khảo sau đây để hiểu rõ các phần phụ thuộc cần thiết và vấn đề về khả năng tương thích cho từng thư viện bắt buộc:

Sau đó, hãy thêm các phần phụ thuộc cần thiết vào tệp build.gradle.kts của ứng dụng:

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")
}

Bật tính năng giảm thiểu mã (không bắt buộc)

Nếu muốn bật tính năng giảm thiểu và làm rối mã bằng ProGuard cho các bản dựng, bạn cũng phải thêm một phần phụ thuộc vào Thư viện Tiện ích Android cho XR. Đây là yêu cầu bắt buộc đối với các dự án sử dụng Jetpack XR alpha05 trở lên.

Thêm phần phụ thuộc compileOnly sau đây vào tệp build.gradle.kts của mô-đun:

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")
}

Thêm phần phụ thuộc của thư viện cho trải nghiệm tăng cường (kính AI)

Trước tiên, hãy xem các hướng dẫn tham khảo sau đây để hiểu rõ các phần phụ thuộc cần thiết và vấn đề về khả năng tương thích cho từng thư viện bắt buộc:

Sau đó, hãy thêm các phần phụ thuộc cần thiết vào tệp build.gradle.kts của ứng dụng:

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")
}
Trước
Tạo dự án Android XR