با Jetpack XR SDK شروع کنید

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

سازگاری

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

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

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

سپس، وابستگی های لازم را به فایل build.gradle.kts برنامه خود اضافه کنید:

شیار 

dependencies {
    
    // Required for Java
    implementation "com.google.guava:listenablefuture:1.0"
    // Required for Kotlin
    implementation "org.jetbrains.kotlinx:kotlinx-coroutines-guava:1.9.0"

    implementation "androidx.xr.runtime:runtime:1.0.0-alpha05"
    implementation "androidx.xr.scenecore:scenecore:1.0.0-alpha06"
    implementation "androidx.xr.compose:compose:1.0.0-alpha06"
    implementation "androidx.xr.compose.material3:material3:1.0.0-alpha10"
    implementation "androidx.xr.arcore:arcore:1.0.0-alpha05"
}

کاتلین 

dependencies {
    
    // Required for Java
    implementation("com.google.guava:listenablefuture:1.0")
    // Required for Kotlin
    implementation("org.jetbrains.kotlinx:kotlinx-coroutines-guava:1.9.0")

    implementation("androidx.xr.runtime:runtime:1.0.0-alpha05")
    implementation("androidx.xr.scenecore:scenecore:1.0.0-alpha06")
    implementation("androidx.xr.compose:compose:1.0.0-alpha06")
    implementation("androidx.xr.compose.material3:material3:1.0.0-alpha10")
    implementation("androidx.xr.arcore:arcore:1.0.0-alpha05")
}

نمونه Hello Android XR را ببینید.

فعال کردن کوچک سازی کد (اختیاری)

اگر می‌خواهید کوچک‌سازی کد و مبهم‌سازی را با استفاده از ProGuard برای ساخت‌های خود فعال کنید، باید یک وابستگی به افزونه‌های Android برای کتابخانه XR اضافه کنید. این برای پروژه هایی با استفاده از Jetpack XR alpha05 یا جدیدتر مورد نیاز است.

وابستگی compileOnly زیر را به فایل build.gradle.kts ماژول خود اضافه کنید:

شیار 

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

با استفاده از الگوی 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 توضیح داده شده است.