Menambahkan dependensi yang diperlukan

Panduan ini memberikan petunjuk untuk membuat aplikasi Android XR menggunakan Jetpack XR SDK. Panduan ini mencakup dependensi penting dan penyiapan project di Android Studio untuk membuat pengalaman XR yang imersif.

Kompatibilitas

Jetpack XR SDK memerlukan minSdk 24 dan harus dikompilasi ke SDK 34 atau yang lebih tinggi

Menambahkan dependensi

Lihat panduan referensi berikut untuk memahami dependensi yang diperlukan dan masalah kompatibilitas untuk setiap library di Jetpack XR SDK

Contoh

Cuplikan berikut dari contoh Hello Android XR menunjukkan contoh file build.gradle yang menyertakan semua dependensi Jetpack XR SDK:

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

Berikut adalah contoh file libs.toml yang sesuai:

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

Lihat contoh Hello Android XR.

Membuat aplikasi baru di Android Studio menggunakan Template Aktivitas Headset Dasar

Untuk membuat project baru yang menyertakan Jetpack Compose untuk XR, lakukan langkah berikut:

  1. Jika baru memulai di jendela Welcome to Android Studio, klik Start a new Android Studio project. Jika sudah membuka project Android Studio, pilih File > New dari panel menu.
  2. Pilih XR dari opsi Template, lalu Basic Headset Activity.
  3. Di jendela Configure your project, lakukan langkah berikut:
    1. Setel Application name.
    2. Pilih Project location untuk contoh.
  4. Klik Finish.
  5. Pastikan file build.gradle project sudah dikonfigurasi dengan benar, seperti yang dijelaskan dalam file properti Gradle.