وابستگی های لازم را اضافه کنید

این راهنما دستورالعمل هایی را برای ایجاد یک برنامه Android XR با استفاده از Jetpack XR SDK ارائه می دهد. وابستگی‌های ضروری و راه‌اندازی پروژه در Android Studio را برای ایجاد تجربه‌های فراگیر XR پوشش می‌دهد.

سازگاری

Jetpack XR SDK به minSdk 24 نیاز دارد و باید در SDK 34 یا بالاتر کامپایل شود.

وابستگی ها را اضافه کنید

برای درک وابستگی‌ها و مسائل سازگاری لازم برای هر یک از کتابخانه‌های Jetpack XR SDK، به راهنمای مرجع زیر مراجعه کنید.

مثال

قطعه زیر از نمونه 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 را ببینید.

با استفاده از الگوی Basic Headset Activity یک برنامه جدید در Android Studio ایجاد کنید

برای ایجاد یک پروژه جدید که شامل Jetpack Compose برای XR است، به صورت زیر عمل کنید:

  1. اگر در پنجره خوش آمدید به Android Studio هستید، روی Start a new Android Studio کلیک کنید. اگر از قبل یک پروژه اندروید استودیو باز کرده اید، File > New را از نوار منو انتخاب کنید.
  2. XR را از گزینه های Template و سپس Basic Headset Activity انتخاب کنید.
  3. در پنجره Configure your project ، موارد زیر را انجام دهید:
    1. نام برنامه را تنظیم کنید.
    2. مکان پروژه را برای نمونه خود انتخاب کنید.
  4. روی Finish کلیک کنید.
  5. بررسی کنید که فایل build.gradle پروژه به درستی پیکربندی شده است، همانطور که در فایل های ویژگی های Gradle توضیح داده شده است.