הגדרת Jetpack XR SDK

מכשירי XR רלוונטיים

ההנחיות האלה יעזרו לכם ליצור חוויות למכשירי XR מהסוגים הבאים.

מידע ולמידה על סוגי מכשירי XR ←

מידע ולמידה על סוגי מכשירי XR ←

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

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

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

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

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

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

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

• סביבת זמן ריצה של XR
• Jetpack SceneCore
• ‫Jetpack Compose ל-XR
• ‫Material Design ל-XR
• ARCore for Jetpack 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 בגרסאות ה-build, אתם צריכים גם להוסיף תלות בספריית Android Extensions for 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")
}

הוספת תלות של הפרויקט בספריות לחוויות משופרות (משקפיים עם תצוגה פנימית ואודיו)

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

• סביבת זמן ריצה של XR
• ARCore for Jetpack XR
• Jetpack Compose Glimmer
• Jetpack Projected

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

dependencies {
    implementation "androidx.xr.runtime:runtime:1.1.0-alpha02"
    implementation "androidx.xr.glimmer:glimmer:1.0.0-alpha18"
    implementation "androidx.xr.glimmer:glimmer-google-fonts:1.0.0-alpha18"
    implementation "androidx.xr.projected:projected:1.0.0-alpha13"
    implementation "androidx.xr.arcore:arcore:1.0.0-beta02"
}

dependencies {
    implementation("androidx.xr.runtime:runtime:1.1.0-alpha02")
    implementation("androidx.xr.glimmer:glimmer:1.0.0-alpha18")
    implementation("androidx.xr.glimmer:glimmer-google-fonts:1.0.0-alpha18")
    implementation("androidx.xr.projected:projected:1.0.0-alpha13")
    implementation("androidx.xr.arcore:arcore:1.0.0-beta02")
}