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

يوفّر هذا الدليل تعليمات لإنشاء تطبيق Android XR باستخدام حزمة تطوير البرامج (SDK) لمنصة Jetpack XR. ويتناول هذا الدليل التبعيات الأساسية وإعداد المشاريع في IDE Android Studio لإنشاء تجارب واقع معمّق غامرة.

التوافق

تتطلّب حزمة تطوير البرامج (SDK) لمنصة Jetpack XR minSdk 24، ويجب تجميعها باستخدام الإصدار 34 من حزمة تطوير البرامج (SDK) أو إصدار أحدث.

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

اطّلِع على الأدلة المرجعية التالية للتعرّف على التبعيات اللازمة و مشاكل التوافق لكل مكتبة من المكتبات في حزمة SDK لبرنامج Jetpack XR.

مثال

يعرض المقتطف التالي من نموذج Hello Android XR مثالاً على ملف build.gradle يتضمّن كل تبعيات حزمة تطوير البرامج (SDK) لـ Jetpack XR:

dependencies {
    val composeBom = platform(libs.androidx.compose.bom)
    implementation(composeBom)
    implementation(libs.impress)
    implementation(libs.androidx.arcore)
    implementation(libs.androidx.scenecore)
    implementation(libs.androidx.compose)
    implementation(libs.kotlinx.coroutines.guava)

    implementation(libs.material)
    implementation(libs.androidx.compose.material3)
    implementation(libs.androidx.adaptive.android)
    implementation(libs.androidx.concurrent.futures)
    implementation(libs.androidx.compose.runtime)
    implementation(libs.androidx.activity.compose)

    debugImplementation(libs.androidx.compose.ui.tooling)

    screenshotTestImplementation(libs.androidx.compose.ui.tooling)
}

في ما يلي مثال على ملف libs.toml المقابل:

[versions]
androidx-runtime = "1.8.0-alpha06"
agp = "8.6.1"
arcore = "1.0.0-alpha01"
compose = "1.0.0-alpha01"
impress = "0.0.1"
kotlinxCoroutinesGuava = "1.9.0"
scenecore = "1.0.0-alpha01"
kotlin = "2.0.21"
concurrentFuturesKtx = "1.2.0"
activityCompose = "1.10.0-beta01"
composeBom = "2024.11.00"
material = "1.12.0"
screenshot = "0.0.1-alpha08"
adaptiveAndroid = "1.0.0"

[libraries]
androidx-arcore = { module = "androidx.xr.arcore:arcore", version.ref = "arcore" }
androidx-compose = { module = "androidx.xr.compose:compose", version.ref = "compose" }
androidx-scenecore = { module = "androidx.xr.scenecore:scenecore", version.ref = "scenecore" }
impress = { module = "com.google.ar:impress", version.ref = "impress" }
kotlinx-coroutines-guava = { module = "org.jetbrains.kotlinx:kotlinx-coroutines-guava", version.ref = "kotlinxCoroutinesGuava" }
androidx-compose-material3 = { module = "androidx.compose.material3:material3" }
material = { module = "com.google.android.material:material", version.ref = "material" }
androidx-compose-ui-tooling = { module = "androidx.compose.ui:ui-tooling" }
androidx-concurrent-futures = { module = "androidx.concurrent:concurrent-futures-ktx", version.ref = "concurrentFuturesKtx" }
androidx-activity-compose = { group = "androidx.activity", name = "activity-compose", version.ref = "activityCompose" }
androidx-compose-runtime = { module = "androidx.compose.runtime:runtime", version.ref = "androidx-runtime" }
androidx-compose-bom = { group = "androidx.compose", name = "compose-bom", version.ref = "composeBom" }

اطّلِع على نموذج Hello Android XR.

إنشاء تطبيق جديد في "استوديو Android" باستخدام نموذج "نشاط سماعة الرأس الأساسي"

لإنشاء مشروع جديد يتضمّن Jetpack Compose لأجهزة الواقع المعزّز، اتّبِع الخطوات التالية:

  1. إذا كنت في نافذة مرحبًا بك في "استوديو Android"، انقر على بدء مشروع جديد في "استوديو Android". إذا كان لديك مشروع Android Studio مفتوح، اختَر ملف > جديد من شريط القوائم.
  2. اختَر XR من خيارات النموذج، ثم نشاط أساسي لسماعة الرأس .
  3. في نافذة Configure your project (إعداد المشروع)، اتّبِع الخطوات التالية:
    1. اضبط اسم التطبيق.
    2. اختَر موقع المشروع لعينة الاختبار.
  4. انقر على إنهاء.
  5. تأكَّد من ضبط ملف build.gradle للمشروع بشكلٍ صحيح، كما هو описан في ملفات خصائص Gradle.