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

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

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

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

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

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