เพิ่มการพึ่งพาที่จำเป็น

คู่มือนี้จะแสดงวิธีการสร้างแอปพลิเคชัน Android XR โดยใช้ Jetpack XR SDK ซึ่งครอบคลุมถึงไลบรารีและการตั้งค่าโปรเจ็กต์ที่จำเป็นใน Android Studio เพื่อสร้างประสบการณ์ XR ที่สมจริง

ความเข้ากันได้

Jetpack XR SDK กำหนดให้ minSdk เป็น 24 และต้องคอมไพล์เป็น SDK 34 ขึ้นไป

เพิ่มทรัพยากร Dependency

ดูคู่มืออ้างอิงต่อไปนี้เพื่อทำความเข้าใจการพึ่งพาที่จำเป็นและปัญหาความเข้ากันได้ของไลบรารีแต่ละรายการใน Jetpack XR SDK

ตัวอย่าง

ข้อมูลโค้ดต่อไปนี้จากตัวอย่าง Hello Android XR แสดงตัวอย่างไฟล์ build.gradle ที่มีทรัพยากร Dependency ทั้งหมดของ 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)
}

และนี่คือตัวอย่างไฟล์ libs.toml ที่เกี่ยวข้อง

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

ดูตัวอย่าง Hello Android XR

สร้างแอปใหม่ใน Android Studio โดยใช้เทมเพลตกิจกรรมชุดหูฟังพื้นฐาน

หากต้องการสร้างโปรเจ็กต์ใหม่ที่มี Jetpack Compose สำหรับ XR ให้ทำดังนี้

  1. หากคุณอยู่ในหน้าต่างยินดีต้อนรับสู่ Android Studio ให้คลิกเริ่มโปรเจ็กต์ Android Studio ใหม่ หากมีโปรเจ็กต์ Android Studio ที่เปิดอยู่ ให้ไปที่ไฟล์ > ใหม่จากแถบเมนู
  2. เลือก XR จากตัวเลือกเทมเพลต แล้วเลือกกิจกรรมพื้นฐานของชุดหูฟัง
  3. ในหน้าต่างกําหนดค่าโปรเจ็กต์ ให้ทําดังนี้
    1. ตั้งค่าชื่อแอปพลิเคชัน
    2. เลือกตำแหน่งโปรเจ็กต์สำหรับตัวอย่าง
  4. คลิกเสร็จสิ้น
  5. ตรวจสอบว่าไฟล์ build.gradle ของโปรเจ็กต์ได้รับการกําหนดค่าอย่างถูกต้องตามที่อธิบายไว้ในไฟล์พร็อพเพอร์ตี้ Gradle