إضافة العناصر التابعة اللازمة

يقدّم هذا الدليل تعليمات حول كيفية إنشاء تطبيق Android XR باستخدام حزمة تطوير البرامج (SDK) لمنصة Jetpack XR. ويشمل التبعيات الأساسية وإعداد المشاريع في Android Studio لإنشاء تجارب واقع مختلط غامرة.

التوافق

تتطلّب حزمة تطوير البرامج (SDK) لمنصة XR من Jetpack minSdk 24 ويجب أن يتم تجميعها باستخدام حزمة تطوير البرامج (SDK) 34 أو إصدار أحدث.

إضافة عناصر تابعة

راجِع أدلة المراجع التالية للتعرّف على التبعيات اللازمة ومشاكل التوافق لكل مكتبة من مكتبات Jetpack XR SDK:

• XR Runtime
• Jetpack SceneCore
• Jetpack Compose للواقع الموسّع
• Material Design للواقع الموسّع
• ARCore for Jetpack XR

بعد ذلك، أضِف التبعيات اللازمة إلى ملف build.gradle.kts في تطبيقك:

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

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" باستخدام نموذج "نشاط سماعة الرأس الأساسي"

لإنشاء مشروع جديد يتضمّن Jetpack Compose للواقع الممتد، اتّبِع الخطوات التالية:

1. إذا كنت في نافذة مرحبًا بك في "استوديو Android"، انقر على بدء مشروع جديد في "استوديو Android". إذا كان لديك مشروع مفتوح في "استوديو Android"، انقر على ملف (File) > جديد (New) من شريط القوائم.
2. اختَر XR من خيارات النموذج، ثم اختَر نشاط سماعة الرأس الأساسي (Basic Headset Activity).
3. في نافذة ضبط مشروعك، اتّبِع الخطوات التالية:
   1. اضبط اسم التطبيق.
   2. اختَر موقع المشروع للعيّنة.
4. انقر على إنهاء.
5. تأكَّد من ضبط ملف build.gradle الخاص بالمشروع بشكل صحيح، كما هو موضّح في ملفات خصائص Gradle.