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

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

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

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

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

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

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

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

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

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

أنيق

dependencies {
    implementation "androidx.xr.runtime:runtime:1.1.0-alpha02"
    implementation "androidx.xr.scenecore:scenecore:1.1.0-alpha01"
    implementation "androidx.xr.compose:compose:1.0.0-beta02"
    implementation "androidx.xr.compose.material3:material3:1.0.0-alpha17"
    implementation "androidx.xr.arcore:arcore:1.1.0-alpha01"
}

Kotlin

dependencies {
    implementation("androidx.xr.runtime:runtime:1.1.0-alpha02")
    implementation("androidx.xr.scenecore:scenecore:1.1.0-alpha01")
    implementation("androidx.xr.compose:compose:1.0.0-beta02")
    implementation("androidx.xr.compose.material3:material3:1.0.0-alpha17")
    implementation("androidx.xr.arcore:arcore:1.1.0-alpha01")
}

تفعيل ميزة إزالة البيانات غير الضرورية من الرمز (اختياري)

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

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

أنيق

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

Kotlin

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

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

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

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

أنيق

dependencies {
    implementation "androidx.xr.runtime:runtime:1.1.0-alpha02"
    implementation "androidx.xr.glimmer:glimmer:1.0.0-alpha22"
    implementation "androidx.xr.glimmer:glimmer-google-fonts:1.0.0-alpha22"
    implementation "androidx.xr.projected:projected:1.0.0-alpha14"
    implementation "androidx.xr.arcore:arcore:1.1.0-alpha01"
}

Kotlin

dependencies {
    implementation("androidx.xr.runtime:runtime:1.1.0-alpha02")
    implementation("androidx.xr.glimmer:glimmer:1.0.0-alpha22")
    implementation("androidx.xr.glimmer:glimmer-google-fonts:1.0.0-alpha22")
    implementation("androidx.xr.projected:projected:1.0.0-alpha14")
    implementation("androidx.xr.arcore:arcore:1.1.0-alpha01")
}
السابق
إنشاء مشروع Android XR