תחילת העבודה עם Jetpack XR SDK

במדריך הזה מוסבר איך ליצור אפליקציית Android XR באמצעות Jetpack XR SDK. המאמר כולל מידע על תלות חיונית ועל הגדרת פרויקט ב-Android Studio ליצירת חוויות XR אימרסיביות.

תאימות

‫Jetpack XR SDK דורש minSdk בגרסה 24, וצריך לבצע קומפילציה ל-SDK בגרסה 34 ומעלה.

הוספת יחסי תלות

במדריכי ההפניה הבאים מוסבר על התלות הנדרשת ועל בעיות התאימות של כל אחת מהספריות ב-Jetpack XR SDK:

לאחר מכן, מוסיפים את יחסי התלות הדרושים לקובץ build.gradle.kts של האפליקציה:

Groovy

dependencies {
    implementation "androidx.xr.runtime:runtime:1.0.0-alpha06"
    implementation "androidx.xr.scenecore:scenecore:1.0.0-alpha07"
    implementation "androidx.xr.compose:compose:1.0.0-alpha07"
    implementation "androidx.xr.compose.material3:material3:1.0.0-alpha11"
    implementation "androidx.xr.arcore:arcore:1.0.0-alpha06"

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

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

Kotlin

dependencies {
    implementation("androidx.xr.runtime:runtime:1.0.0-alpha06")
    implementation("androidx.xr.scenecore:scenecore:1.0.0-alpha07")
    implementation("androidx.xr.compose:compose:1.0.0-alpha07")
    implementation("androidx.xr.compose.material3:material3:1.0.0-alpha11")
    implementation("androidx.xr.arcore:arcore:1.0.0-alpha06")

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

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

אפשר לעיין בדוגמה ל-Hello Android XR.

הפעלה של מזעור קוד (אופציונלי)

אם רוצים להפעיל מזעור והסתרה של קוד באמצעות ProGuard בגרסאות ה-build, צריך להוסיף תלות בספריית Android Extensions for XR. הפעולה הזו נדרשת לפרויקטים שמשתמשים ב-Jetpack XR alpha05 ומעלה.

מוסיפים את יחסי התלות הבאים compileOnly לקובץ build.gradle.kts של המודול:

Groovy

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

Kotlin

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

יצירת אפליקציה חדשה ב-Android Studio באמצעות תבנית הפעילות הבסיסית של אוזניות

כדי ליצור פרויקט חדש שכולל את Jetpack Compose for XR, פועלים לפי השלבים הבאים:

  1. אם אתם נמצאים בחלון Welcome to Android Studio (ברוכים הבאים ל-Android Studio), לוחצים על Start a new Android Studio project (התחלת פרויקט חדש ב-Android Studio). אם כבר פתוח פרויקט ב-Android Studio, בוחרים באפשרות File > New (קובץ > חדש) בסרגל התפריטים.
  2. בוחרים באפשרות XR מבין האפשרויות של תבנית ואז באפשרות פעילות בסיסית של אוזניות.
  3. בחלון Configure your project (הגדרת הפרויקט), מבצעים את הפעולות הבאות:
    1. מגדירים את שם האפליקציה.
    2. בוחרים את מיקום הפרויקט לדוגמה.
  4. לוחצים על סיום.
  5. מוודאים שקובץ build.gradle של הפרויקט מוגדר בצורה נכונה, כמו שמתואר במאמר קובצי מאפיינים של Gradle.