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

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

التوافق

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

إضافة حِزم تابعة

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

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

Groovy

dependencies {
    implementation "androidx.xr.runtime:runtime:1.0.0-alpha08"
    implementation "androidx.xr.scenecore:scenecore:1.0.0-alpha09"
    implementation "androidx.xr.compose:compose:1.0.0-alpha08"
    implementation "androidx.xr.compose.material3:material3:1.0.0-alpha12"
    implementation "androidx.xr.arcore:arcore:1.0.0-alpha08"

    // For compatibility with guava, use these dependencies:
    implementation "androidx.xr.arcore:arcore-guava:1.0.0-alpha08"
    implementation "androidx.xr.runtime:runtime-guava:1.0.0-alpha08"
    implementation "androidx.xr.scenecore:scenecore-guava:1.0.0-alpha09"

    // For compatibility with rxjava3, use these dependencies:
    implementation "androidx.xr.arcore:arcore-rxjava3:1.0.0-alpha08"
    implementation "androidx.xr.runtime:runtime-rxjava3:1.0.0-alpha08"
}

Kotlin

dependencies {
    implementation("androidx.xr.runtime:runtime:1.0.0-alpha08")
    implementation("androidx.xr.scenecore:scenecore:1.0.0-alpha09")
    implementation("androidx.xr.compose:compose:1.0.0-alpha08")
    implementation("androidx.xr.compose.material3:material3:1.0.0-alpha12")
    implementation("androidx.xr.arcore:arcore:1.0.0-alpha08")

    // For compatibility with guava, use these dependencies:
    implementation("androidx.xr.arcore:arcore-guava:1.0.0-alpha08")
    implementation("androidx.xr.runtime:runtime-guava:1.0.0-alpha08")
    implementation("androidx.xr.scenecore:scenecore-guava:1.0.0-alpha09")

    // For compatibility with rxjava3, use these dependencies:
    implementation("androidx.xr.arcore:arcore-rxjava3:1.0.0-alpha08")
    implementation("androidx.xr.runtime:runtime-rxjava3:1.0.0-alpha08")
}

اطّلِع على مثال 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 for XR، اتّبِع الخطوات التالية:

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