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

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

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

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

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

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

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

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

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

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

أنيق

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

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

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

Kotlin

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

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

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

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

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

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

أنيق

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 الخاص بتطبيقك:

أنيق

dependencies {
    implementation "androidx.xr.runtime:runtime:1.0.0-alpha12"
    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"
}

Kotlin

dependencies {
    implementation("androidx.xr.runtime:runtime:1.0.0-alpha12")
    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")
}
السابق
إنشاء مشروع Android XR