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 exige que votre application utilise un minSdk Android 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 de réalité étendue pour lesquels vous développez. Pour en savoir plus sur l'ajout des dépendances pour votre application, consultez les sections suivantes.

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

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

Ajoutez ensuite les dépendances nécessaires au fichier build.gradle.kts de votre application :

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

Activer la minification du code (facultatif)

Si vous souhaitez activer la minification et l'obscurcissement du code à l'aide de ProGuard pour vos compilations, vous devez également ajouter une dépendance à la bibliothèque Android Extensions for XR. Cette étape est obligatoire pour les projets utilisant Jetpack XR alpha05 ou 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 d'IA)

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

Ajoutez ensuite les dépendances nécessaires au fichier build.gradle.kts de votre application :

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")
}
Précédent
Créer un projet Android XR