راه‌اندازی Jetpack XR SDK

دستگاه‌های XR واجدشرایط
این راهنمایی به شما کمک می‌کند برای این نوع دستگاه‌های واقعیت گسترده تجربه بسازید.
آشنایی با انواع دستگاه‌های XR →
هدست‌های واقعیت گسترده
عینک واقعیت گسترده سیمی
عینک
نمایشگردار و صوتی
آشنایی با انواع دستگاه‌های XR →

قبل‌از اینکه بتوانید ساختن را شروع کنید، باید Jetpack XR SDK را راه‌اندازی کنید. مراحل هر بخش را دنبال کنید تا محیط توسعه نرم‌افزار خود را با SDK راه‌اندازی کنید.

بررسی سازگاری کیت توسعه نرم‌افزار Android

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

افزودن وابستگی‌های کتابخانه

وابستگی‌هایی که برنامه‌تان نیاز دارد به انواع تجربه‌ها و دستگاه‌های XR که برای آن‌ها می‌سازید بستگی دارد. برای اطلاعات بیشتر درباره افزودن وابستگی‌ها برای برنامه‌تان، بخش‌های زیر را ببینید.

افزودن وابستگی‌های کتابخانه برای تجربه‌های فراگیر (هدست‌های واقعیت گسترده و عینک‌های واقعیت گسترده)

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

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

شیک

dependencies {
    implementation "androidx.xr.runtime:runtime:1.1.0-alpha02"
    implementation "androidx.xr.scenecore:scenecore:1.1.0-alpha01"
    implementation "androidx.xr.compose:compose:1.0.0-beta02"
    implementation "androidx.xr.compose.material3:material3:1.0.0-alpha17"
    implementation "androidx.xr.arcore:arcore:1.1.0-alpha01"
}

کاتلین

dependencies {
    implementation("androidx.xr.runtime:runtime:1.1.0-alpha02")
    implementation("androidx.xr.scenecore:scenecore:1.1.0-alpha01")
    implementation("androidx.xr.compose:compose:1.0.0-beta02")
    implementation("androidx.xr.compose.material3:material3:1.0.0-alpha17")
    implementation("androidx.xr.arcore:arcore:1.1.0-alpha01")
}

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

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

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

شیک

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

کاتلین

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

افزودن وابستگی‌های کتابخانه برای تجربه‌های افزوده (عینک‌های صوتی و نمایشگر)

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

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

شیک

dependencies {
    implementation "androidx.xr.runtime:runtime:1.1.0-alpha02"
    implementation "androidx.xr.glimmer:glimmer:1.0.0-alpha22"
    implementation "androidx.xr.glimmer:glimmer-google-fonts:1.0.0-alpha22"
    implementation "androidx.xr.projected:projected:1.0.0-alpha14"
    implementation "androidx.xr.arcore:arcore:1.1.0-alpha01"
}

کاتلین

dependencies {
    implementation("androidx.xr.runtime:runtime:1.1.0-alpha02")
    implementation("androidx.xr.glimmer:glimmer:1.0.0-alpha22")
    implementation("androidx.xr.glimmer:glimmer-google-fonts:1.0.0-alpha22")
    implementation("androidx.xr.projected:projected:1.0.0-alpha14")
    implementation("androidx.xr.arcore:arcore:1.1.0-alpha01")
}
قبلی
ایجاد پروژه Android XR