Ajouter les dépendances nécessaires

Ce guide fournit des instructions pour créer une application Android XR à l'aide du SDK Jetpack XR. Il couvre les dépendances essentielles et la configuration du projet dans Android Studio pour créer des expériences XR immersives.

Compatibilité

Le SDK Jetpack XR nécessite un minSdk de 24 et doit être compilé avec le SDK 34 ou version ultérieure.

Ajouter des dépendances

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 du SDK Jetpack XR :

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

Groovy

dependencies {
    
    // Required for Java
    implementation "com.google.guava:listenablefuture:1.0"
    // Required for Kotlin
    implementation "org.jetbrains.kotlinx:kotlinx-coroutines-guava:1.9.0"

    implementation "androidx.xr.runtime:runtime:1.0.0-alpha05"
    implementation "androidx.xr.scenecore:scenecore:1.0.0-alpha05"
    implementation "androidx.xr.compose:compose:1.0.0-alpha05"
    implementation "androidx.xr.compose.material3:material3:1.0.0-alpha10"
    implementation "androidx.xr.arcore:arcore:1.0.0-alpha05"
}

Kotlin

dependencies {
    
    // Required for Java
    implementation("com.google.guava:listenablefuture:1.0")
    // Required for Kotlin
    implementation("org.jetbrains.kotlinx:kotlinx-coroutines-guava:1.9.0")

    implementation("androidx.xr.runtime:runtime:1.0.0-alpha05")
    implementation("androidx.xr.scenecore:scenecore:1.0.0-alpha05")
    implementation("androidx.xr.compose:compose:1.0.0-alpha05")
    implementation("androidx.xr.compose.material3:material3:1.0.0-alpha10")
    implementation("androidx.xr.arcore:arcore:1.0.0-alpha05")
}

Consultez l'exemple Hello Android XR.

Créer une application dans Android Studio à l'aide du modèle d'activité de base du casque

Pour inclure Jetpack Compose pour XR lors de la création de votre projet, procédez comme suit :

  1. Si vous vous trouvez dans la fenêtre Welcome to Android Studio (Bienvenue dans Android Studio), cliquez sur Start a new Android Studio project (Démarrer un nouveau projet Android Studio). Si vous avez déjà ouvert un projet Android Studio, sélectionnez File > New (Fichier > Nouveau) dans la barre de menu.
  2. Sélectionnez XR dans les options Modèle, puis Activité de base du casque.
  3. Dans la fenêtre Configure your project (Configurer votre projet), procédez comme suit :
    1. Définissez l'Application name (Nom de l'application).
    2. Choisissez le Project location (Emplacement du projet) pour votre exemple.
  4. Cliquez sur Terminer.
  5. Vérifiez que le fichier build.gradle du projet est correctement configuré, comme décrit dans la section Fichiers de propriétés Gradle.