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 có màn hình
và âm thanh
Tìm hiểu về các loại thiết bị XR →

Trước khi có thể bắt đầu xây dựng, bạn cần thiết lập SDK Jetpack XR. Làm theo các bước trong mỗi 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

Jetpack XR SDK yêu cầu ứng dụng của bạn phải sử dụng minSdk Android là 24 và compileSdk là 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 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 phần phụ thuộc cho ứng dụng.

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 đây để nắm được 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.1.0-alpha02"
    implementation "androidx.xr.scenecore:scenecore:1.1.0-alpha01"
    implementation "androidx.xr.compose:compose:1.0.0-beta02"
    implementation "androidx.xr.compose.material3:material3:1.0.0-alpha17"
    implementation "androidx.xr.arcore:arcore:1.1.0-alpha01"
}

Kotlin

dependencies {
    implementation("androidx.xr.runtime:runtime:1.1.0-alpha02")
    implementation("androidx.xr.scenecore:scenecore:1.1.0-alpha01")
    implementation("androidx.xr.compose:compose:1.0.0-beta02")
    implementation("androidx.xr.compose.material3:material3:1.0.0-alpha17")
    implementation("androidx.xr.arcore:arcore:1.1.0-alpha01")
}

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ã nguồn 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 Android Extensions for 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.4.0"
}

Kotlin

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

Thêm phần phụ thuộc thư viện cho trải nghiệm thực tế tăng cường (âm thanh và kính có màn hình)

Trước tiên, hãy xem các hướng dẫn tham khảo sau đây để nắm được 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.1.0-alpha02"
    implementation "androidx.xr.glimmer:glimmer:1.0.0-alpha22"
    implementation "androidx.xr.glimmer:glimmer-google-fonts:1.0.0-alpha22"
    implementation "androidx.xr.projected:projected:1.0.0-alpha14"
    implementation "androidx.xr.arcore:arcore:1.1.0-alpha01"
}

Kotlin

dependencies {
    implementation("androidx.xr.runtime:runtime:1.1.0-alpha02")
    implementation("androidx.xr.glimmer:glimmer:1.0.0-alpha22")
    implementation("androidx.xr.glimmer:glimmer-google-fonts:1.0.0-alpha22")
    implementation("androidx.xr.projected:projected:1.0.0-alpha14")
    implementation("androidx.xr.arcore:arcore:1.1.0-alpha01")
}
Trước
Tạo dự án Android XR