इस गाइड में, Jetpack XR SDK टूल का इस्तेमाल करके Android XR ऐप्लिकेशन बनाने के निर्देश दिए गए हैं. इसमें, बेहतरीन XR अनुभव देने के लिए, Android Studio में ज़रूरी डिपेंडेंसी और प्रोजेक्ट सेटअप के बारे में बताया गया है.
इनके साथ काम करता है
Jetpack XR SDK टूल के लिए, minSdk
24 की ज़रूरत होती है. साथ ही, इसे SDK टूल 34 या इसके बाद के वर्शन के लिए कॉम्पाइल करना ज़रूरी है
डिपेंडेंसी जोड़ें
Jetpack XR SDK में मौजूद हर लाइब्रेरी के लिए, ज़रूरी डिपेंडेंसी और काम करने से जुड़ी समस्याओं को समझने के लिए, यहां दी गई रेफ़रंस गाइड देखें
- Jetpack XR के लिए ARCore
- एक्सआर के लिए Jetpack Compose
- एक्सआर के लिए मटीरियल डिज़ाइन
- XR रनटाइम
- Jetpack SceneCore
उदाहरण
Hello Android XR के सैंपल का यह स्निपेट, build.gradle फ़ाइल का एक उदाहरण दिखाता है. इसमें 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 में नया ऐप्लिकेशन बनाना
XR के लिए Jetpack Compose का इस्तेमाल करने वाला नया प्रोजेक्ट बनाने के लिए, यह तरीका अपनाएं:
- अगर आप Android Studio में आपका स्वागत है विंडो में हैं, तो Android Studio में नया प्रोजेक्ट शुरू करें पर क्लिक करें. अगर आपके पास पहले से ही Android Studio प्रोजेक्ट खुला है, तो मेन्यू बार से फ़ाइल > नया चुनें.
- टेंप्लेट के विकल्पों में जाकर, XR चुनें. इसके बाद, हेडसेट की बुनियादी गतिविधि चुनें.
- अपना प्रोजेक्ट कॉन्फ़िगर करें विंडो में, ये काम करें:
- ऐप्लिकेशन का नाम सेट करें.
- अपने सैंपल के लिए प्रोजेक्ट की जगह चुनें.
- पूरा करें पर क्लिक करें.
- पुष्टि करें कि प्रोजेक्ट की build.gradle फ़ाइल को सही तरीके से कॉन्फ़िगर किया गया है, जैसा कि Gradle प्रॉपर्टी फ़ाइलों में बताया गया है.