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

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

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

Jetpack XR SDK ต้องมี minSdk 24 และต้องคอมไพล์เป็น SDK 34 หรือสูงกว่า

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

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

จากนั้นเพิ่มการอ้างอิงที่จำเป็นลงในไฟล์ build.gradle.kts ของแอป

Groovy

dependencies {
    
    // Required for Java
    implementation "com.google.guava:listenablefuture:1.0"
    // Required for Kotlin
    implementation "org.jetbrains.kotlinx:kotlinx-coroutines-guava:1.9.0"

    implementation "androidx.xr.runtime:runtime:1.0.0-alpha05"
    implementation "androidx.xr.scenecore:scenecore:1.0.0-alpha05"
    implementation "androidx.xr.compose:compose:1.0.0-alpha05"
    implementation "androidx.xr.compose.material3:material3:1.0.0-alpha10"
    implementation "androidx.xr.arcore:arcore:1.0.0-alpha05"
}

Kotlin

dependencies {
    
    // Required for Java
    implementation("com.google.guava:listenablefuture:1.0")
    // Required for Kotlin
    implementation("org.jetbrains.kotlinx:kotlinx-coroutines-guava:1.9.0")

    implementation("androidx.xr.runtime:runtime:1.0.0-alpha05")
    implementation("androidx.xr.scenecore:scenecore:1.0.0-alpha05")
    implementation("androidx.xr.compose:compose:1.0.0-alpha05")
    implementation("androidx.xr.compose.material3:material3:1.0.0-alpha10")
    implementation("androidx.xr.arcore:arcore:1.0.0-alpha05")
}

ดูตัวอย่าง 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