Thêm các phần phụ thuộc cần thiết

Hướng dẫn này cung cấp hướng dẫn tạo ứng dụng Android XR bằng SDK Jetpack XR. Tài liệu này trình bày các phần phụ thuộc thiết yếu và cách thiết lập dự án trong Android Studio để tạo trải nghiệm XR sống động.

Khả năng tương thích

SDK Jetpack XR yêu cầu minSdk là 24 và phải biên dịch thành SDK 34 trở lên

Thêm phần phụ thuộc

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 trong SDK Jetpack XR

Ví dụ

Đoạn mã sau đây trong mẫu Hello Android XR cho thấy một tệp build.gradle mẫu bao gồm tất cả các phần phụ thuộc SDK Jetpack XR:

dependencies {
    val composeBom = platform(libs.androidx.compose.bom)
    implementation(composeBom)
    implementation(libs.impress)
    implementation(libs.androidx.arcore)
    implementation(libs.androidx.scenecore)
    implementation(libs.androidx.compose)
    implementation(libs.kotlinx.coroutines.guava)

    implementation(libs.material)
    implementation(libs.androidx.compose.material3)
    implementation(libs.androidx.adaptive.android)
    implementation(libs.androidx.concurrent.futures)
    implementation(libs.androidx.compose.runtime)
    implementation(libs.androidx.activity.compose)

    debugImplementation(libs.androidx.compose.ui.tooling)

    screenshotTestImplementation(libs.androidx.compose.ui.tooling)
}

Sau đây là ví dụ về tệp libs.toml tương ứng:

[versions]
androidx-runtime = "1.8.0-alpha06"
agp = "8.6.1"
arcore = "1.0.0-alpha01"
compose = "1.0.0-alpha01"
impress = "0.0.1"
kotlinxCoroutinesGuava = "1.9.0"
scenecore = "1.0.0-alpha01"
kotlin = "2.0.21"
concurrentFuturesKtx = "1.2.0"
activityCompose = "1.10.0-beta01"
composeBom = "2024.11.00"
material = "1.12.0"
screenshot = "0.0.1-alpha08"
adaptiveAndroid = "1.0.0"

[libraries]
androidx-arcore = { module = "androidx.xr.arcore:arcore", version.ref = "arcore" }
androidx-compose = { module = "androidx.xr.compose:compose", version.ref = "compose" }
androidx-scenecore = { module = "androidx.xr.scenecore:scenecore", version.ref = "scenecore" }
impress = { module = "com.google.ar:impress", version.ref = "impress" }
kotlinx-coroutines-guava = { module = "org.jetbrains.kotlinx:kotlinx-coroutines-guava", version.ref = "kotlinxCoroutinesGuava" }
androidx-compose-material3 = { module = "androidx.compose.material3:material3" }
material = { module = "com.google.android.material:material", version.ref = "material" }
androidx-compose-ui-tooling = { module = "androidx.compose.ui:ui-tooling" }
androidx-concurrent-futures = { module = "androidx.concurrent:concurrent-futures-ktx", version.ref = "concurrentFuturesKtx" }
androidx-activity-compose = { group = "androidx.activity", name = "activity-compose", version.ref = "activityCompose" }
androidx-compose-runtime = { module = "androidx.compose.runtime:runtime", version.ref = "androidx-runtime" }
androidx-compose-bom = { group = "androidx.compose", name = "compose-bom", version.ref = "composeBom" }

Xem mẫu Hello Android XR.

Tạo ứng dụng mới trong Android Studio bằng Mẫu hoạt động cơ bản trên tai nghe

Để tạo một dự án mới có chứa Jetpack Compose cho XR, hãy tiến hành như sau:

  1. Nếu bạn đang ở cửa sổ Chào mừng bạn đến với Android Studio (Welcome to Android Studio), vui lòng nhấp vào nút Bắt đầu dự án Android Studio mới (Start a new Android Studio project). Nếu bạn đã mở một dự án Android Studio, hãy chọn File > New (Tệp > Mới) trên thanh trình đơn.
  2. Chọn XR trong các tuỳ chọn Mẫu, sau đó chọn Hoạt động cơ bản trên tai nghe.
  3. Trong cửa sổ Configure your project (Định cấu hình dự án), hãy làm như sau:
    1. Đặt Tên ứng dụng.
    2. Chọn Vị trí dự án cho mẫu của bạn.
  4. Nhấp vào Hoàn tất.
  5. Xác minh rằng tệp build.gradle của dự án được định cấu hình chính xác, như mô tả trong các tệp thuộc tính Gradle.