เริ่มต้นใช้งาน Jetpack XR SDK

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

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

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

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

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

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

Groovy

dependencies {
    implementation "androidx.xr.runtime:runtime:1.0.0-alpha06"
    implementation "androidx.xr.scenecore:scenecore:1.0.0-alpha07"
    implementation "androidx.xr.compose:compose:1.0.0-alpha07"
    implementation "androidx.xr.compose.material3:material3:1.0.0-alpha11"
    implementation "androidx.xr.arcore:arcore:1.0.0-alpha06"

    // For compatibility with guava, use these dependencies:
    implementation "androidx.xr.arcore:arcore-guava:1.0.0-alpha06"
    implementation "androidx.xr.runtime:runtime-guava:1.0.0-alpha06"
    implementation "androidx.xr.scenecore:scenecore-guava:1.0.0-alpha07"

    // For compatibility with rxjava3, use these dependencies:
    implementation "androidx.xr.arcore:arcore-rxjava3:1.0.0-alpha06"
    implementation "androidx.xr.runtime:runtime-rxjava3:1.0.0-alpha06"
}

Kotlin

dependencies {
    implementation("androidx.xr.runtime:runtime:1.0.0-alpha06")
    implementation("androidx.xr.scenecore:scenecore:1.0.0-alpha07")
    implementation("androidx.xr.compose:compose:1.0.0-alpha07")
    implementation("androidx.xr.compose.material3:material3:1.0.0-alpha11")
    implementation("androidx.xr.arcore:arcore:1.0.0-alpha06")

    // For compatibility with guava, use these dependencies:
    implementation("androidx.xr.arcore:arcore-guava:1.0.0-alpha06")
    implementation("androidx.xr.runtime:runtime-guava:1.0.0-alpha06")
    implementation("androidx.xr.scenecore:scenecore-guava:1.0.0-alpha07")

    // For compatibility with rxjava3, use these dependencies:
    implementation("androidx.xr.arcore:arcore-rxjava3:1.0.0-alpha06")
    implementation("androidx.xr.runtime:runtime-rxjava3:1.0.0-alpha06")
}

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

เปิดใช้การลดขนาดโค้ด (ไม่บังคับ)

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

เพิ่มทรัพยากร Dependency compileOnly ต่อไปนี้ลงในไฟล์ build.gradle.kts ของโมดูล

Groovy

dependencies {
    // ... other dependencies
    compileOnly "com.android.extensions.xr:extensions-xr:1.1.0"
}

Kotlin

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

สร้างแอปใหม่ใน Android Studio โดยใช้เทมเพลต Basic Headset Activity

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

  1. หากอยู่ในหน้าต่าง Welcome to Android Studio ให้คลิก Start a new Android Studio project หากมีโปรเจ็กต์ Android Studio เปิดอยู่แล้ว ให้เลือก File > New จากแถบเมนู
  2. เลือก XR จากตัวเลือก Template แล้วเลือกBasic Headset Activity
  3. ในหน้าต่าง Configure your project ให้ทำดังนี้
    1. ตั้งค่า Application name
    2. เลือก Project location สำหรับไฟล์ตัวอย่างของคุณ
  4. คลิก Finish
  5. ตรวจสอบว่าไฟล์ build.gradle ของโปรเจ็กต์ได้รับการกำหนดค่าอย่างถูกต้องตามที่อธิบายไว้ในไฟล์พร็อพเพอร์ตี้ Gradle