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

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

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

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

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

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

التحقّق من توافق حزمة Android SDK

تتطلّب حزمة Jetpack XR SDK أن يستخدم تطبيقك minSdk بقيمة 24 و compileSdk بقيمة 34 أو أعلى.

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

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

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

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

• وقت تشغيل XR
• ‫Jetpack SceneCore
• ‫Jetpack Compose for XR
• ‫التصميم المتعدد الأبعاد للواقع الممتد
• ‫ARCore for Jetpack XR

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

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

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

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

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

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

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

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

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

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

• وقت تشغيل XR
• ‫ARCore for Jetpack XR
• ‫Jetpack Compose Glimmer
• حزمة Jetpack Projected

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

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

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