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

أجهزة XR المشمولة

تساعدك هذه الإرشادات في إنشاء تجارب لهذه الأنواع من أجهزة XR.

مزيد من المعلومات حول أنواع أجهزة XR →

مزيد من المعلومات حول أنواع أجهزة XR →

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

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

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

إضافة تبعيات المكتبة

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

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

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

• XR Runtime
• ‫Jetpack SceneCore
• ‫Jetpack Compose للواقع الموسّع
• التصميم المتعدد الأبعاد للواقع المُمتد
• ‫ARCore for Jetpack XR

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

dependencies {
    implementation "androidx.xr.runtime:runtime:1.0.0-alpha13"
    implementation "androidx.xr.scenecore:scenecore:1.0.0-alpha14"
    implementation "androidx.xr.compose:compose:1.0.0-alpha13"
    implementation "androidx.xr.compose.material3:material3:1.0.0-alpha16"
    implementation "androidx.xr.arcore:arcore:1.0.0-alpha13"
}

dependencies {
    implementation("androidx.xr.runtime:runtime:1.0.0-alpha13")
    implementation("androidx.xr.scenecore:scenecore:1.0.0-alpha14")
    implementation("androidx.xr.compose:compose:1.0.0-alpha13")
    implementation("androidx.xr.compose.material3:material3:1.0.0-alpha16")
    implementation("androidx.xr.arcore:arcore:1.0.0-alpha13")
}

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

إذا أردت تفعيل تصغير الرموز البرمجية وتشويشها باستخدام ProGuard في إصداراتك، عليك أيضًا إضافة تبعية إلى مكتبة Android Extensions for XR. هذه السمة مطلوبة للمشاريع التي تستخدم Jetpack XR alpha05 أو إصدارًا أحدث.

أضِف تبعية compileOnly التالية إلى ملف build.gradle.kts في الوحدة:

dependencies {
    // ... other dependencies
    compileOnly "com.android.extensions.xr:extensions-xr:1.1.0"
}

dependencies {
    // ... other dependencies
    compileOnly("com.android.extensions.xr:extensions-xr:1.1.0")
}

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

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

• XR Runtime
• ‫ARCore for Jetpack XR
• ‫Jetpack Compose Glimmer
• Jetpack Projected

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

dependencies {
    implementation "androidx.xr.runtime:runtime:1.0.0-alpha13"
    implementation "androidx.xr.glimmer:glimmer:1.0.0-alpha11"
    implementation "androidx.xr.glimmer:glimmer-google-fonts:1.0.0-alpha11"
    implementation "androidx.xr.projected:projected:1.0.0-alpha06"
    implementation "androidx.xr.arcore:arcore:1.0.0-alpha12"
}

dependencies {
    implementation("androidx.xr.runtime:runtime:1.0.0-alpha13")
    implementation("androidx.xr.glimmer:glimmer:1.0.0-alpha11")
    implementation("androidx.xr.glimmer:glimmer-google-fonts:1.0.0-alpha11")
    implementation("androidx.xr.projected:projected:1.0.0-alpha06")
    implementation("androidx.xr.arcore:arcore:1.0.0-alpha12")
}