Ajouter les dépendances nécessaires

Ce guide explique comment 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 compiler le SDK 34 ou une 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.

Exemple

L'extrait suivant de l'exemple Hello Android XR montre un exemple de fichier build.gradle qui inclut toutes les dépendances du SDK Jetpack XR:

dependencies {
    val composeBom = platform(libs.androidx.compose.bom)
    implementation(composeBom)
    implementation(libs.impress)
    implementation(libs.androidx.arcore)
    implementation(libs.androidx.scenecore)
    implementation(libs.androidx.compose)
    implementation(libs.kotlinx.coroutines.guava)

    implementation(libs.material)
    implementation(libs.androidx.compose.material3)
    implementation(libs.androidx.adaptive.android)
    implementation(libs.androidx.concurrent.futures)
    implementation(libs.androidx.compose.runtime)
    implementation(libs.androidx.activity.compose)

    debugImplementation(libs.androidx.compose.ui.tooling)

    screenshotTestImplementation(libs.androidx.compose.ui.tooling)
}

Voici un exemple de fichier libs.toml correspondant:

[versions]
androidx-runtime = "1.8.0-alpha06"
agp = "8.6.1"
arcore = "1.0.0-alpha01"
compose = "1.0.0-alpha01"
impress = "0.0.1"
kotlinxCoroutinesGuava = "1.9.0"
scenecore = "1.0.0-alpha01"
kotlin = "2.0.21"
concurrentFuturesKtx = "1.2.0"
activityCompose = "1.10.0-beta01"
composeBom = "2024.11.00"
material = "1.12.0"
screenshot = "0.0.1-alpha08"
adaptiveAndroid = "1.0.0"

[libraries]
androidx-arcore = { module = "androidx.xr.arcore:arcore", version.ref = "arcore" }
androidx-compose = { module = "androidx.xr.compose:compose", version.ref = "compose" }
androidx-scenecore = { module = "androidx.xr.scenecore:scenecore", version.ref = "scenecore" }
impress = { module = "com.google.ar:impress", version.ref = "impress" }
kotlinx-coroutines-guava = { module = "org.jetbrains.kotlinx:kotlinx-coroutines-guava", version.ref = "kotlinxCoroutinesGuava" }
androidx-compose-material3 = { module = "androidx.compose.material3:material3" }
material = { module = "com.google.android.material:material", version.ref = "material" }
androidx-compose-ui-tooling = { module = "androidx.compose.ui:ui-tooling" }
androidx-concurrent-futures = { module = "androidx.concurrent:concurrent-futures-ktx", version.ref = "concurrentFuturesKtx" }
androidx-activity-compose = { group = "androidx.activity", name = "activity-compose", version.ref = "activityCompose" }
androidx-compose-runtime = { module = "androidx.compose.runtime:runtime", version.ref = "androidx-runtime" }
androidx-compose-bom = { group = "androidx.compose", name = "compose-bom", version.ref = "composeBom" }

Consultez l'exemple Hello Android XR.

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

Pour créer un projet qui inclut Jetpack Compose pour XR, 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 Template (Modèle), puis Basic Headset Activity (Activité de base avec le 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.