Configurer le SDK Jetpack XR

Appareils XR concernés
Ces conseils vous aident à créer des expériences pour ces types d'appareils XR.
En savoir plus sur les types d'appareils XR →
Casques XR
Lunettes XR filaires
Lunettes IA
En savoir plus sur les types d'appareils XR →

Avant de commencer à créer, vous devez configurer le SDK Jetpack XR. Suivez les étapes de chaque section pour configurer votre environnement de développement avec le SDK.

Vérifier la compatibilité du SDK Android

Le SDK Jetpack XR nécessite que votre application utilise un Android minSdk de 24 et un compileSdk de 34 ou version ultérieure.

Ajouter des dépendances de bibliothèque

Les dépendances requises par votre application dépendent des types d'expériences et d'appareils XR pour lesquels vous créez des applications. Pour en savoir plus sur l'ajout de dépendances à votre application, consultez les sections suivantes.

Ajouter des dépendances de bibliothèque pour les expériences immersives (casques XR et lunettes XR)

Tout d'abord, consultez les guides de référence suivants pour comprendre les dépendances nécessaires et les problèmes de compatibilité pour chacune des bibliothèques requises :

Ensuite, ajoutez les dépendances nécessaires au fichier build.gradle.kts de votre application :

Groovy

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

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

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

Kotlin

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

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

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

Activer la minification du code (facultatif)

Si vous souhaitez activer la minification et l'obscurcissement du code à l'aide de ProGuard pour vos builds, vous devez également ajouter une dépendance à la bibliothèque Android Extensions for XR. Cette opération est obligatoire pour les projets utilisant Jetpack XR alpha05 ou une version ultérieure.

Ajoutez la dépendance compileOnly suivante au fichier build.gradle.kts de votre module :

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")
}

Ajouter des dépendances de bibliothèque pour les expériences augmentées (lunettes IA)

Tout d'abord, consultez les guides de référence suivants pour comprendre les dépendances nécessaires et les problèmes de compatibilité pour chacune des bibliothèques requises :

Ensuite, ajoutez les dépendances nécessaires au fichier build.gradle.kts de votre application :

Groovy

dependencies {
    implementation "androidx.xr.runtime:runtime:1.0.0-alpha12"
    implementation "androidx.xr.glimmer:glimmer:1.0.0-alpha08"
    implementation "androidx.xr.projected:projected:1.0.0-alpha05"
    implementation "androidx.xr.arcore:arcore:1.0.0-alpha11"
}

Kotlin

dependencies {
    implementation("androidx.xr.runtime:runtime:1.0.0-alpha12")
    implementation("androidx.xr.glimmer:glimmer:1.0.0-alpha08")
    implementation("androidx.xr.projected:projected:1.0.0-alpha05")
    implementation("androidx.xr.arcore:arcore:1.0.0-alpha11")
}
Précédent
Créer un projet Android XR