הגדרת Jetpack XR SDK

מכשירי XR רלוונטיים
ההנחיות האלה יעזרו לכם ליצור חוויות למכשירי XR מהסוגים האלה.
מידע על סוגי מכשירי XR →
משקפי XR
משקפי AR חוטיים
משקפי AI
מידע על סוגי מכשירי XR →

כדי להתחיל לפתח, צריך להגדיר את Jetpack XR SDK. כדי להגדיר את סביבת הפיתוח עם ה-SDK, פועלים לפי השלבים שמפורטים בכל קטע.

בדיקת התאימות של Android SDK

כדי להשתמש ב-Jetpack XR SDK, האפליקציה צריכה להשתמש ב-Android minSdk בגרסה 24 וב-compileSdk בגרסה 34 ואילך.

הוספת תלות של הפרויקט בספריות

התלות שהאפליקציה שלכם דורשת תלויה בסוגי החוויות ובמכשירי ה-XR שאתם מפתחים עבורם. בקטעים הבאים מפורט מידע נוסף על הוספת התלויות לאפליקציה.

הוספת תלות של הפרויקט בספריות לחוויות סוחפות (משקפי XR ומשקפי AR)

קודם כדאי לעיין במדריכים הבאים כדי להבין את התלות הנדרשת ואת בעיות התאימות של כל אחת מהספריות הנדרשות:

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

Groovy

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

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

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

Kotlin

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

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

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

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

אם רוצים להפעיל מזעור והסתרה של קוד באמצעות 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")
}

הוספת תלות של הפרויקט בספריות לחוויות מועשרות (משקפי AI)

קודם כדאי לעיין במדריכים הבאים כדי להבין את התלות הנדרשת ואת בעיות התאימות של כל אחת מהספריות הנדרשות:

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

Groovy

dependencies {
    implementation "androidx.xr.runtime:runtime:1.0.0-alpha09"
    implementation "androidx.xr.glimmer:glimmer:1.0.0-alpha02"
    implementation "androidx.xr.projected:projected:1.0.0-alpha03"
    implementation "androidx.xr.arcore:arcore:1.0.0-alpha09"
}

Kotlin

dependencies {
    implementation("androidx.xr.runtime:runtime:1.0.0-alpha09")
    implementation("androidx.xr.glimmer:glimmer:1.0.0-alpha02")
    implementation("androidx.xr.proejcted:projected:1.0.0-alpha03")
    implementation("androidx.xr.arcore:arcore:1.0.0-alpha09")
}
הקודם
יצירת פרויקט ל-Android XR