Aller au contenu principal

Premiers pas pour les développeurs

Préparez XREAL AURA pour le développement.

Prérequis​

Avant de commencer, préparez :

  • XREAL AURA (lunettes + Compute Puck)
  • Un ordinateur de développement Windows, macOS ou Linux
  • Android Studio installé, dans sa dernière version stable
  • Un câble USB-C de qualité prenant en charge les données
  • Un compte Google pour le Play Store et les services

Étape 1 : configurer Android Studio​

Installer le SDK Android XR​

  1. Ouvrez Android Studio.
  2. Ouvrez SDK Manager depuis Tools > SDK Manager.
  3. Sélectionnez l’onglet SDK Platforms.
  4. Cochez Android 15 (API 35) ou une version ultérieure.
  5. Sélectionnez l’onglet SDK Tools.
  6. Installez les éléments suivants :
    • Android SDK Build-Tools
    • Android Emulator
    • Extensions Android XR, lorsqu’elles sont disponibles

Installer le profil de l’émulateur XR​

Pour tester sans matériel :

  1. Ouvrez Device Manager dans Android Studio.
  2. Créez un appareil virtuel.
  3. Sélectionnez un profil d’appareil XR.
  4. Choisissez une image système Android XR.
  5. Configurez les paramètres OST pour simuler XREAL.

Étape 2 : activer le mode développeur​

Sur XREAL AURA :

  1. Ouvrez Paramètres depuis le lanceur d’applications.
  2. Accédez à À propos de l’appareil.
  3. Touchez 7 fois le numéro de build.
  4. Le message « Mode développeur activé » apparaît.
  5. Revenez aux paramètres.
  6. Ouvrez le nouveau menu Options pour les développeurs.
  7. Activez le débogage USB.

Étape 3 : connecter l’appareil à l’ordinateur​

  1. Gardez les lunettes connectées au port des lunettes, à droite du Compute Puck.
  2. Reliez l’ordinateur au port de charge, à gauche du Compute Puck, avec un câble USB-C.
important

Le port des lunettes et le port de charge prennent tous deux en charge toutes les fonctions de débogage ADB. Utiliser le port de charge permet de déboguer par câble tout en regardant l’affichage dans les lunettes.

Étape 4 : compiler et déployer votre première application​

Créer un projet​

  1. Dans Android Studio, sélectionnez New Project
  2. Choisissez le modèle XR Activity, s’il est disponible, ou Empty Activity
  3. Définissez le SDK minimal sur API 35
  4. Choisissez Kotlin comme langage

Configurer les dépendances XR​

Dans le fichier build.gradle.kts :

android {
    defaultConfig {
        minSdk = 35
        targetSdk = 35
    }
}

dependencies {
    // Add XR dependencies
    implementation("androidx.xr:xr-compose:1.0.0")
    // ... other dependencies
}

Déployer sur l’appareil​

  1. Sélectionnez l’appareil connecté dans la liste des appareils
  2. Cliquez sur Run, le bouton de lecture vert
  3. Attendez la fin de la compilation et de l’installation
  4. Mettez les lunettes pour voir l’application en cours d’exécution

Étapes suivantes​

Dépannage​

ProblèmeSolution
Appareil non reconnuVérifiez le câble et essayez un autre port USB
État « Unauthorized »Touchez « Autoriser » dans la demande de débogage USB sur l’appareil
Échec de compilationMettez à jour Android Studio et les outils de plateforme SDK
Application fermée au lancementConsultez logcat pour les erreurs et traces de pile
Affichage des lunettes invisibleReconnectez les lunettes après la fin de la session ADB

Besoin d’aide ? Consultez le Discord développeurs XREAL.