Thiết lập Jetpack XR SDK

Các thiết bị XR được hỗ trợ
Hướng dẫn này giúp bạn xây dựng các trải nghiệm cho những loại thiết bị XR sau.
Tìm hiểu về các loại thiết bị XR →
Thiết bị đeo đầu XR
Kính thông minh XR có dây
Kính thông minh AI
Tìm hiểu về các loại thiết bị XR →

Trước khi bắt đầu xây dựng, bạn cần thiết lập SDK Jetpack XR. Hãy 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 Android minSdk 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ị XR mà bạn đang xây dựng. 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 thư viện cho trải nghiệm sống động (thiết bị đeo đầu XR và kính thông minh XR)

Trước tiên, hãy xem các hướng dẫn tham khảo sau để hiểu 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-alpha12"
    implementation "androidx.xr.scenecore:scenecore:1.0.0-alpha13"
    implementation "androidx.xr.compose:compose:1.0.0-alpha12"
    implementation "androidx.xr.compose.material3:material3:1.0.0-alpha16"
    implementation "androidx.xr.arcore:arcore:1.0.0-alpha12"

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

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

Kotlin

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

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

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

Bật tính năng rút gọn mã (không bắt buộc)

Nếu muốn bật tính năng rút gọn và làm rối mã bằng ProGuard cho các bản dựng, bạn cũng phải thêm phần phụ thuộc vào thư viện Tiện ích Android cho XR. Điều này là 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 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 thư viện cho trải nghiệm tăng cường (kính thông minh AI)

Trước tiên, hãy xem các hướng dẫn tham khảo sau để hiểu 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-alpha12"
    implementation "androidx.xr.glimmer:glimmer:1.0.0-alpha08"
    implementation "androidx.xr.projected:projected:1.0.0-alpha05"
    implementation "androidx.xr.arcore:arcore:1.0.0-alpha11"
}

Kotlin

dependencies {
    implementation("androidx.xr.runtime:runtime:1.0.0-alpha12")
    implementation("androidx.xr.glimmer:glimmer:1.0.0-alpha08")
    implementation("androidx.xr.projected:projected:1.0.0-alpha05")
    implementation("androidx.xr.arcore:arcore:1.0.0-alpha11")
}
Trước
Tạo dự án Android XR