Jetpack XR SDK का इस्तेमाल शुरू करना

इस गाइड में, Jetpack XR SDK का इस्तेमाल करके Android XR ऐप्लिकेशन बनाने के निर्देश दिए गए हैं. इसमें इमर्सिव एक्सआर अनुभव बनाने के लिए, Android Studio में ज़रूरी डिपेंडेंसी और प्रोजेक्ट सेटअप करने के बारे में बताया गया है.

साथ काम करने की सुविधा

Jetpack XR SDK के लिए, minSdk 24 होना ज़रूरी है. साथ ही, इसे SDK 34 या इसके बाद के वर्शन पर कंपाइल किया जाना चाहिए.

डिपेंडेंसी जोड़ें

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-alpha06"
    implementation "androidx.xr.compose:compose:1.0.0-alpha06"
    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-alpha06")
    implementation("androidx.xr.compose:compose:1.0.0-alpha06")
    implementation("androidx.xr.compose.material3:material3:1.0.0-alpha10")
    implementation("androidx.xr.arcore:arcore:1.0.0-alpha05")
}

Hello Android XR का सैंपल देखें.

कोड छोटा करने की सुविधा चालू करें (ज़रूरी नहीं)

अगर आपको अपने बिल्ड के लिए ProGuard का इस्तेमाल करके, कोड को छोटा और अस्पष्ट करना है, तो आपको Android Extensions for XR लाइब्रेरी पर निर्भरता जोड़नी होगी. Jetpack XR alpha05 या इसके बाद के वर्शन का इस्तेमाल करने वाले प्रोजेक्ट के लिए, यह ज़रूरी है.

अपने मॉड्यूल की build.gradle.kts फ़ाइल में, यह compileOnly डिपेंडेंसी जोड़ें:

Groovy

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

Basic Headset Activity टेंप्लेट का इस्तेमाल करके, Android Studio में नया ऐप्लिकेशन बनाएं

Jetpack Compose for XR की सुविधा वाला नया प्रोजेक्ट बनाने के लिए, यह तरीका अपनाएं:

  1. अगर आप Android Studio में आपका स्वागत है विंडो में हैं, तो नया Android Studio प्रोजेक्ट शुरू करें पर क्लिक करें. अगर आपने पहले से ही कोई Android Studio प्रोजेक्ट खोला हुआ है, तो मेन्यू बार में जाकर File > New चुनें.
  2. टेंप्लेट विकल्पों में जाकर, XR चुनें. इसके बाद, बेसिक हेडसेट ऐक्टिविटी चुनें.
  3. अपने प्रोजेक्ट को कॉन्फ़िगर करें विंडो में जाकर, यह तरीका अपनाएं:
    1. ऐप्लिकेशन का नाम सेट करें.
    2. अपने सैंपल के लिए प्रोजेक्ट की जगह चुनें.
  4. पूरा करें पर क्लिक करें.
  5. पुष्टि करें कि प्रोजेक्ट की build.gradle फ़ाइल को सही तरीके से कॉन्फ़िगर किया गया हो. इसके बारे में Gradle प्रॉपर्टी फ़ाइलें में बताया गया है.