إعداد حزمة تطوير البرامج (SDK) لتقنية XR في Jetpack

أجهزة XR المعنيّة
تساعدك هذه الإرشادات في إنشاء تجارب لهذه الأنواع من أجهزة الواقع الممتد.
مزيد من المعلومات حول أنواع أجهزة XR →
سماعات رأس بنظام الواقع الممتد
نظارات الواقع الممتد السلكية
نظارات AI Glasses
مزيد من المعلومات حول أنواع أجهزة XR →

قبل البدء في إنشاء التطبيق، عليك إعداد حزمة Jetpack XR SDK. اتّبِع الخطوات الواردة في كل قسم لإعداد بيئة التطوير باستخدام حزمة SDK.

التحقّق من توافق حزمة تطوير البرامج (SDK) لنظام التشغيل Android

تتطلّب حزمة تطوير البرامج (SDK) الخاصة بتجربة الواقع الممتد (XR) من Jetpack أن يستخدم تطبيقك الإصدار minSdk من نظام التشغيل Android‏ (24) والإصدار compileSdk‏ (34) أو إصدارًا أحدث.

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

تعتمد العناصر التابعة التي يتطلّبها تطبيقك على أنواع التجارب وأجهزة الواقع الممتد التي تصمّمها. راجِع الأقسام التالية للحصول على مزيد من المعلومات حول إضافة التبعيات لتطبيقك.

إضافة موارد تابعة للمكتبة لتجارب غامرة (سماعات رأس ونظارات بنظام الواقع الممتد)

في البداية، راجِع أدلة المراجع التالية للتعرّف على التبعيات الضرورية ومشاكل التوافق لكل مكتبة من المكتبات المطلوبة:

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

Groovy

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

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

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

Kotlin

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

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

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

تفعيل تصغير الرموز (اختياري)

إذا أردت تفعيل تصغير الرموز البرمجية وتشويشها باستخدام 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")
}

إضافة تبعيات المكتبة للتجارب المعزّزة (نظارات الذكاء الاصطناعي)

في البداية، راجِع أدلة المراجع التالية للتعرّف على التبعيات الضرورية ومشاكل التوافق لكل مكتبة من المكتبات المطلوبة:

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

Groovy

dependencies {
    implementation "androidx.xr.runtime:runtime:1.0.0-alpha09"
    implementation "androidx.xr.glimmer:glimmer:1.0.0-alpha02"
    implementation "androidx.xr.projected:projected:1.0.0-alpha03"
    implementation "androidx.xr.arcore:arcore:1.0.0-alpha09"
}

Kotlin

dependencies {
    implementation("androidx.xr.runtime:runtime:1.0.0-alpha09")
    implementation("androidx.xr.glimmer:glimmer:1.0.0-alpha02")
    implementation("androidx.xr.proejcted:projected:1.0.0-alpha03")
    implementation("androidx.xr.arcore:arcore:1.0.0-alpha09")
}
السابق
إنشاء مشروع Android XR