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

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

سازگاری

کیت توسعه نرم‌افزار Jetpack XR به minSdk برابر با ۲۴ نیاز دارد و باید به SDK ۳۴ یا بالاتر کامپایل شود.

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

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

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

گرووی

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

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

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

کاتلین

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

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

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

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

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

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

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

گرووی

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

کاتلین

dependencies {
    // ... other dependencies
    compileOnly("com.android.extensions.xr:extensions-xr:1.1.0")
}

با استفاده از الگوی فعالیت هدست پایه، یک برنامه جدید در اندروید استودیو ایجاد کنید

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

  1. اگر در پنجره «به اندروید استودیو خوش آمدید» هستید، روی «شروع یک پروژه جدید اندروید استودیو» کلیک کنید. اگر از قبل یک پروژه اندروید استودیو باز دارید، از نوار منو، «فایل» > «جدید» را انتخاب کنید.
  2. از گزینه‌های قالب، XR و سپس Basic Headset Activity را انتخاب کنید.
  3. در پنجره پیکربندی پروژه ، موارد زیر را انجام دهید:
    1. نام برنامه را تنظیم کنید.
    2. محل پروژه را برای نمونه خود انتخاب کنید.
  4. روی پایان کلیک کنید.
  5. تأیید کنید که فایل build.gradle پروژه به درستی پیکربندی شده است، همانطور که در Gradle properties files توضیح داده شده است.