بدء استخدام Jetpack XR SDK

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

التوافق

تتطلّب حزمة تطوير البرامج (SDK) لمنصة XR من Jetpack مستوى واجهة برمجة تطبيقات يبلغ minSdk ويجب أن يتم تجميعها باستخدام حزمة تطوير البرامج (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 أو إصدارًا أحدث.

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

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

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