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

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

التوافق

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

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

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

مثال

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

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.