Résumé
Utilisez Unity si votre application professionnelle nécessite du contenu 3D interactif, ou Android Studio si elle nécessite une interface Android native. La configuration est terminée lorsque les outils requis sont installés, que le projet réussit les contrôles de configuration et que votre appareil de test ou votre émulateur est disponible.
Les instructions suivent la documentation officielle d'Android XR. Les ports de développement, les menus du firmware et les autorisations propres à Aura doivent être vérifiés à l'aide des instructions de prise en main fournies avec votre appareil. Ce guide ne prétend pas avoir été testé physiquement sur un Aura.
Choisissez votre parcours de développement
Choisissez Unity si votre projet utilisera des modèles 3D, de la formation ou de la simulation interactives, ou si vos développeurs travaillent déjà avec Unity et C#. Unity vous offre un espace de travail visuel pour organiser le contenu et configurer les fonctionnalités XR. Vous pouvez configurer l'environnement sans écrire de code ni créer de prototype.
Choisissez Android Studio si vous étendez une application professionnelle Android ou si vous créez des interfaces natives comme des instructions de travail, des formulaires ou des panneaux de tâches. Il utilise Kotlin et les bibliothèques Jetpack XR de Google. Les deux parcours peuvent ensuite se connecter aux systèmes de l'entreprise via une API, c'est-à-dire un moyen défini permettant à des logiciels d'échanger des informations ; choisissez le parcours en fonction de l'interface de l'application et des compétences de votre équipe.
Éditeur de développement principal :
- Parcours Unity : Unity Editor, installé via Unity Hub
- Parcours Android Studio : Android Studio
Langage pour le développement ultérieur :
- Parcours Unity : C#
- Parcours Android Studio : Kotlin
Outils de build Android :
- Parcours Unity : Android Build Support, y compris le SDK, le NDK et OpenJDK
- Parcours Android Studio : outils du SDK Android, installés via SDK Manager
Prise en charge XR de base :
- Parcours Unity : OpenXR Plugin, installé via Unity Package Manager
- Parcours Android Studio : bibliothèques du SDK Jetpack XR, téléchargées via Gradle
Prise en charge XR spécifique à la plateforme :
- Parcours Unity : package Unity OpenXR: Android XR
- Parcours Android Studio : modèle de projet XR et bibliothèques Jetpack XR requises
Signification des outils XR :
- Parcours Unity : OpenXR est une interface commune entre une application XR et le runtime de l'appareil, c'est-à-dire le logiciel système qui exécute les fonctionnalités XR
- Parcours Android Studio : le SDK Jetpack XR est l'ensemble de bibliothèques de Google destiné aux interfaces spatiales natives et aux fonctionnalités XR
Connexion et diagnostic :
- Parcours Unity : ADB, l'outil Android Debug Bridge
- Parcours Android Studio : ADB et Logcat d'Android Studio, qui affiche les messages de diagnostic
Préparez votre poste de travail et votre accès de développement
Prévoyez un ordinateur de développement pris en charge, une connexion internet fiable pour les dépendances, un dossier de projet approuvé par l'entreprise et un câble USB de données. Les exigences de l'émulateur diffèrent de celles de l'éditeur ; consultez la page de Google consacrée au matériel requis pour l'émulateur XR avant de vous fier à un appareil virtuel. Un appareil virtuel est une simulation logicielle d'un appareil Android. [4]
Utilisez un Aura disposant d'un accès développeur autorisé, de la connexion aux lunettes fournie et de la connexion de développement documentée par XREAL. Vérifiez la disponibilité dans votre région et la prise en main du kit avant de fixer la date d'un atelier. Les pages actuelles de XREAL et les pages régionales peuvent différer quant à la disponibilité ; une fiche produit ne suffit pas à établir un délai de livraison. [1]
Pour un usage professionnel, vérifiez l'éligibilité de votre organisation à une licence Unity et les éventuelles conditions Industry applicables avant d'utiliser Unity à des fins commerciales. Utilisez un système de gestion de versions contrôlé par l'entreprise, des sources de packages approuvées et des données de test. Android Studio et Unity sont des outils de développement pour applications professionnelles ; leur installation n'implique pas la prise en charge de la gestion d'entreprise sur Aura.
Parcours A : configurer l'environnement de développement Unity
Ce parcours installe Unity et ses outils Android, crée un projet vide et active la prise en charge d'Android XR. Il prépare l'espace de travail pour le développement ultérieur.
Étape 1 | Installer l'éditeur Unity
Unity Hub gère les installations de vos éditeurs ; Unity Editor est l'espace de travail dans lequel vous configurez vos projets et développerez ensuite votre application.
Installez Unity Hub depuis le site officiel de Unity et ouvrez-le. Allez dans Installs, puis Install Editor. Choisissez une version prise en charge de Unity 6.5 (ou plus récente), compatible avec le package Android XR que vous utiliserez, afin de bénéficier d'une prise en charge complète de la saisie via le pavé tactile du puck et d'autres fonctionnalités. La page de configuration de Google indique actuellement la version 6000.0.58f2 ou supérieure ; les exigences des packages plus récents s'appliquent également. [5]
Étape 2 | Ajouter les outils de build Android
Ces modules permettent à Unity de transformer votre projet en application Android.
XREAL Aura fonctionne sous Android XR ; il lui faut donc une application Android que son système d'exploitation peut installer et exécuter. Votre projet Unity contient des fichiers modifiables destinés au développement ; les outils de build Android empaquettent et compilent ces fichiers en une application installable, généralement un APK pour les tests sur l'appareil.
Dans les modules d'installation, sélectionnez Android Build Support et ses sous-éléments, puis cliquez sur Continue et suivez les invites d'installation. Les outils nécessaires sont :
· Android SDK (Software Development Kit, kit de développement logiciel)
· Android NDK (Native Development Kit) : il transforme le code de bas niveau en une forme que le processeur de l'appareil peut exécuter.
· JDK (Java Development Kit)
Pour un éditeur existant, retournez dans Unity Hub > Installs, ouvrez le menu de l'éditeur, choisissez Add modules, sélectionnez les mêmes éléments puis cliquez sur Installs.
Étape 3 | Créer un projet
Un projet vide vous offre un espace pour configurer l'environnement de développement Android XR.
Dans Unity Hub, ouvrez Projects > New project. Sélectionnez l'éditeur installé et choisissez Universal 3D. Nommez le projet AuraDevelopmentSetup, choisissez un dossier et sélectionnez Create project. Universal 3D utilise URP, l'Universal Render Pipeline, qui dessine les graphismes de votre application.
Étape 4 | Vérifier les chemins des outils
Unity doit savoir où sont installés ses outils de build Android compatibles.
Dans Unity Editor, ouvrez Edit > Preferences > External Tools (Unity > Settings ou Preferences sous macOS). Laissez sélectionnés le SDK (outils de la plateforme Android), le NDK (outils de compilation du code natif) et le JDK (outils de build Java) fournis par Unity. Ces versions correspondent à votre éditeur Unity, ce qui aide à éviter les erreurs de build. Ne les remplacez pas par des versions d'outils Android Studio sans rapport simplement parce que les deux sont installés.
Configurer votre environnement de développement XREAL Aura dans Unity
OpenXR est une norme ouverte qui aide les applications XR à communiquer avec les runtimes compatibles des appareils. Dans Unity, installez le package OpenXR Plugin pour la connexion de base et Unity OpenXR: Android XR pour la prise en charge d'Android XR via le Package Manager. AR Foundation est l'interface commune de Unity pour les fonctionnalités AR prises en charge, comme la compréhension de l'environnement.
Étape 1 | Sélectionner la cible de build Android XR
La cible de build indique à Unity sur quelle plateforme l'application doit s'exécuter.
Ouvrez File > Build Profiles. Dans Unity 6.1 ou version ultérieure, ajoutez ou sélectionnez le profil de plateforme Android XR et basculez vers celui-ci. Selon la documentation de Unity, cela peut installer automatiquement le package Android XR compatible. Si votre éditeur pris en charge utilise plutôt la plateforme Android, sélectionnez Android et configurez OpenXR manuellement. [7]
Étape 2 | Installer les packages OpenXR
Les packages ajoutent les composants logiciels qui relient votre scène Unity à Android XR.
Ouvrez Window > Package Management > Package Manager, ou Window > Package Manager dans les éditeurs dotés de l'ancienne disposition des menus. Vérifiez que OpenXR Plugin et Unity OpenXR: Android XR sont installés. Si le package Android XR est absent, utilisez le menu plus > Add package by name et saisissez com.unity.xr.androidxr-openxr. L'identifiant du package OpenXR de base est com.unity.xr.openxr. Laissez le Package Manager résoudre les dépendances compatibles. [6]
Étape 3 | Activer le fournisseur XR
L'installation d'un package le rend disponible ; l'activation du fournisseur permet à l'application de l'utiliser.
Ouvrez Edit > Project Settings > XR Plug-in Management. Dans l'onglet Android, activez OpenXR. Ouvrez la section OpenXR située en dessous et activez le groupe de fonctionnalités Android XR. Activez Android XR: Session lorsque vous utilisez des fonctionnalités AR Foundation. Activez Android XR: AR Session pour la version 1.0. Évitez d'activer des fournisseurs sans rapport pour ce build. [8]
Étape 4 | Valider le projet
La validation repère les paramètres qui empêcheraient un build XR pris en charge.
Ouvrez XR Plug-in Management > Project Validation et sélectionnez Android. Examinez et corrigez les problèmes requis, puis relancez la vérification. Les exigences de validation propres à chaque package priment sur les paramètres copiés d'un ancien tutoriel.
Étape 5 | Limiter les exigences de saisie au strict nécessaire
N'activez que les fonctionnalités requises par l'application prévue et prises en charge par l'appareil cible.
Réservez les fonctionnalités de saisie facultatives à la phase de développement de l'application, sauf si votre projet ou votre modèle les exige. Activer un profil de suivi du regard ou de manette n'ajoute pas ce matériel à Aura. Examinez les éventuels paramètres d'interaction requis dans Project Validation avant de poursuivre.
Android XR Extensions for Unity de Google est un package supplémentaire qui offre des fonctionnalités en plus. Il est distinct de Unity OpenXR: Android XR. Inutile de l'ajouter simplement parce que les noms se ressemblent ; ajoutez-le lorsque votre application a besoin d'une fonctionnalité qu'il fournit. [9]
Vérifier le rendu et les paramètres de build Android
Vulkan est l'interface graphique utilisée pour envoyer le travail de rendu au GPU. Dans Edit > Project Settings > Player, sélectionnez Android > Other Settings. Si Auto Graphics API est activé, désactivez-le et placez Vulkan en premier. Pour une base URP simple, désactivez le HDR dans l'asset URP et le post-traitement dans son asset de renderer. Google recommande ces paramètres pour Android XR. [5]
Dans ces mêmes paramètres Player, définissez un identifiant de package unique, par exemple com.yourcompany.aurapilot. Sous Configuration, sélectionnez IL2CPP et ARM64 pour le build destiné à l'appareil physique. IL2CPP convertit le code C# en code natif ; ARM64 est l'architecture de processeur ciblée par le build. Vérifiez la validation des packages installés et les exigences de l'appareil pour toute contrainte supplémentaire.
Google indique l'API 24 comme minimum pour le loader OpenXR, et non comme version du système d'exploitation d'Aura. Utilisez un niveau d'API minimal qui satisfait aussi chaque package installé, ainsi qu'un SDK cible installé pris en charge par votre éditeur et conforme à vos exigences de distribution. Configurez GameActivity comme point d'entrée de l'application, décochez Activity et activez Resizable Activity sous Resolution and Presentation, comme l'indique Google. [5]
Parcours B : configurer l'environnement de développement Android Studio
Ce parcours installe Android Studio, télécharge les outils de développement Android et crée un projet XR à partir du modèle de Google. Il prépare l'espace de travail Android natif pour le développement ultérieur de l'application. Vous pouvez également créer un émulateur pour vérifier que le projet se compile et se lance.
Aperçu de la configuration : installer Android Studio → télécharger les outils Android → créer un projet XR → vérifier les dépendances → préparer une cible de test.Android Studio est l'environnement de développement de Google pour les applications Android. Kotlin est le langage de programmation utilisé ici. Le SDK Jetpack XR fournit des bibliothèques d'interface spatiale native et XR, tandis que Jetpack Compose décrit les interfaces en code Kotlin.
Étape 1 | Installer l'éditeur compatible XR
La version recommandée d'Android Studio comprend les outils et modèles XR utilisés dans ce parcours.
Téléchargez le build d'Android Studio recommandé par la page de configuration XR de Google. Les recommandations actuelles préconisent le dernier build Canary ; installez-le si nécessaire à côté de votre version stable habituelle. Canary désigne une version de développement précoce : notez donc la version exacte utilisée par votre équipe. [10]
Étape 2 | Télécharger les outils de développement Android
SDK Manager installe les composants nécessaires pour compiler, exécuter et inspecter votre application.
Sur l'écran d'accueil, ouvrez More Actions > SDK Manager. Sous SDK Tools, installez ou mettez à jour Android SDK Build-Tools, Android Emulator et Android SDK Platform-Tools, ainsi que la version de Layout Inspector indiquée dans les instructions actuelles de Google. Cliquez sur Apply et acceptez les licences. [10]
Étape 3 | Créer le projet XR
Un modèle XR fournit une application de départ dont la structure spatiale est déjà en place.
Ouvrez New Project. Sélectionnez XR dans la liste des modèles, puis le modèle immersif pour casques XR ou lunettes XR filaires. Ne sélectionnez pas de modèle pour lunettes audio ou lunettes d'affichage. Cliquez sur Next, nommez le projet AuraBusinessPanel, définissez un nom de package d'entreprise si l'option est proposée, choisissez un dossier d'enregistrement et cliquez sur Finish. [11]
Étape 4 | Laisser le projet télécharger les dépendances
Gradle sync prépare les bibliothèques et la configuration de build avant que vous ne modifiiez l'application.
Attendez que Gradle sync se termine. Gradle est le système de build qui télécharge les dépendances et compile l'application. Ouvrez le panneau Project et repérez app/build.gradle.kts, ou le fichier Gradle du module app. Conservez les versions mutuellement compatibles du modèle ; ne mettez pas à niveau une bibliothèque XR au hasard.
Étape 5 | Vérifier les exigences d'API Android
Les paramètres d'API doivent satisfaire aux exigences du modèle et de chaque bibliothèque que vous utilisez.
Comparez la page de configuration du SDK Jetpack XR avec votre modèle. La base publiée est minSdk 24 et compileSdk 34 ou supérieur ; utilisez des valeurs plus élevées lorsque les bibliothèques ou le modèle choisis l'exigent. compileSdk est l'API Android utilisée lors de la compilation, tandis que minSdk définit l'API Android la plus ancienne prise en charge. [12]
La page de configuration du SDK répertorie les dépendances Runtime, SceneCore, Compose for XR, Material Design for XR et ARCore for Jetpack XR. N'ajoutez que ce que l'application utilise. SceneCore gère le contenu spatial ; ARCore for Jetpack XR fournit les capacités de perception prises en charge. Les versions preview peuvent changer : utilisez donc conjointement le modèle et les notes de version plutôt que de coller un ancien bloc de dépendances.
Si votre modèle n'inclut pas automatiquement les bibliothèques XR de base, assurez-vous que votre app/build.gradle.kts reprend les dépendances de base suivantes :
android {
compileSdk = 34 // ou la valeur supérieure définie par votre modèle
defaultConfig {
minSdk = 24
}
}
dependencies {
// Dépendances principales du SDK Jetpack XR
implementation("androidx.xr.runtime:runtime:1.1.0-alpha02")
implementation("androidx.xr.scenecore:scenecore:1.1.0-alpha01")
implementation("androidx.xr.compose:compose:1.0.0-beta02")
implementation("androidx.xr.compose.material3:material3:1.0.0-alpha17")
}
À la date de la recherche, Compose for XR 1.0.0-beta02 (21-10-2026) nécessite Kotlin 2.2, et ses notes de version indiquent qu'il dépend de SceneCore 1.0.0-rc01, qui présente une fuite de mémoire connue ; la solution de contournement consiste à déclarer vous-même SceneCore 1.0.0 ou une version plus récente, ce que fait déjà le bloc de dépendances ci-dessus. C'est l'une des raisons pour lesquelles il faut consigner l'ensemble complet des dépendances plutôt que de présenter une installation « la plus récente » comme prête pour la production. [13]
Exécuter sur un émulateur XR avant que le matériel soit disponible
Étape 1 | Créer un appareil XR virtuel
L'émulateur vous permet de vérifier le logiciel avant qu'un Aura physique soit disponible.
Ouvrez Tools > Device Manager, puis Add a new device > Create Virtual Device. Sélectionnez XR comme facteur de forme et choisissez XR Glasses pour le flux de travail des lunettes filaires. [4]
Étape 2 | Installer l'image système requise
L'image système fournit l'environnement d'exploitation Android XR de l'appareil virtuel.
Choisissez l'image système preview requise pour XR Glasses selon le guide de Google, téléchargez-la si vous y êtes invité et terminez la création de l'appareil virtuel. Démarrez-le depuis Device Manager.
Étape 3 | Exécuter l'application
Android Studio compile le projet et l'installe sur l'appareil virtuel sélectionné.
Dans la barre d'outils supérieure d'Android Studio, choisissez la configuration d'exécution app et l'appareil virtuel XR en cours d'exécution. Cliquez sur Run. Laissez Android Studio compiler et installer le modèle non modifié. Il n'est pas nécessaire de personnaliser son interface pour cette vérification de l'environnement.
Étape 4 | Vérifier le résultat
Un build et un lancement réussis confirment que les outils installés peuvent traiter le modèle.
Vérifiez que le modèle s'ouvre sans erreur de build ni de lancement. Cela valide la configuration logicielle de base, et non l'optique d'Aura, le suivi physique, les performances ou la préparation à la production.
Connecter XREAL Aura à l'ordinateur de développement
ADB, abréviation d'Android Debug Bridge, permet à un ordinateur de développement d'installer des applications et de lire les journaux de diagnostic d'un appareil Android. Unity et Android Studio peuvent tous deux l'utiliser.
Selon la FAQ Aura de XREAL, les deux ports USB-C du compute puck prennent en charge le débogage ADB standard avec Android Studio, mais son tableau de spécifications n'indique une prise en charge ADB complète que pour le Glasses Port ; privilégiez donc ce port si possible. Laissez les lunettes connectées conformément aux instructions. La recopie d'écran DisplayPort et une connexion ADB autorisée sont des fonctions différentes : voir l'écran d'un ordinateur portable dans les lunettes ne prouve donc pas que la connexion de développement fonctionne.
Étape 1 | Activer le débogage autorisé
Le débogage permet à votre ordinateur de développement d'installer et d'inspecter des applications de test.
Sur le système Android XR, ouvrez Settings et activez Developer options et USB debugging en suivant les instructions propres à votre firmware. Sur Android standard, les Developer options s'affichent généralement en sélectionnant plusieurs fois Build number, mais le chemin exact dans le menu d'Aura n'a pas pu être établi dans les sources publiques consultées. Suivez le chemin indiqué dans la documentation de prise en main fournie s'il diffère. [14]
Étape 2 | Connecter et autoriser l'ordinateur
Une connexion USB de données et l'approbation de l'appareil sont nécessaires pour ce flux de débogage filaire.
Connectez l'hôte à l'aide d'un câble USB de données et du port de développement documenté. Sur l'appareil, acceptez la demande d'autorisation de débogage de l'ordinateur. Sous Windows, installez le pilote ADB du fabricant si le système en exige un. [14]
Étape 3 | Vérifier qu'ADB détecte l'appareil
La liste des appareils confirme que la connexion est prête avant que vous ne tentiez un build et une exécution.
Dans Android Studio, ouvrez SDK Manager et notez l'emplacement indiqué sous Android SDK Location. Dans votre terminal, ouvrez le dossier platform-tools de ce SDK et exécutez la commande appropriée ci-dessous.
# Windows PowerShell, dans platform-tools
.\adb.exe devices -l
# macOS ou Linux, dans platform-tools
./adb devices -l
Résultat attendu : le numéro de série de votre appareil est suivi de device. S'il indique unauthorized, acceptez la demande. Si la liste est vide, vérifiez le câble, le port de l'hôte, le paramètre de débogage et le pilote. Si plusieurs appareils ou émulateurs sont connectés, sélectionnez explicitement la cible voulue.
Vérifier que votre environnement de développement est prêt
Contrôles de préparation pour Unity
Étape 1 | Vérifier le profil de build
Vérifiez la configuration avant de commencer le développement de l'application.
Ouvrez File > Build Profiles et vérifiez qu'Android XR, ou le profil Android configuré pour la XR, est actif. Vérifiez que les modules de build Android requis sont disponibles pour cet éditeur.
Étape 2 | Vérifier les packages et la validation
Les packages XR requis doivent être installés et activés dans le projet.
Dans le Package Manager, vérifiez OpenXR Plugin et Unity OpenXR: Android XR. Dans Project Settings > XR Plug-in Management, vérifiez le fournisseur OpenXR Android et le groupe de fonctionnalités Android XR. Corrigez les problèmes requis sous Project Validation.
Étape 3 | Vérifier l'appareil cible
Un appareil reconnu achève la partie connexion de la configuration.
Dans Build Profiles, actualisez Run Device et vérifiez que votre Aura autorisé apparaît. Si ce n'est pas le cas, vérifiez la connexion ADB et les chemins définis dans les External Tools de Unity. Vous pouvez configurer le projet avant que le matériel soit disponible, mais la validation du déploiement physique doit attendre un appareil.
Contrôles de préparation pour Android Studio
Vérifiez que la Gradle sync se termine sans erreur, que les outils requis sont installés dans le SDK Manager et que l'émulateur XR ou l'appareil Aura autorisé apparaît dans le sélecteur de cible. Exécutez le modèle XR non modifié si une cible de test est disponible. Ouvrez View > Tool Windows > Logcat pour examiner les erreurs de lancement. Logcat affiche les messages de diagnostic d'Android.
Comment Unity et Android Studio fonctionnent ensemble
Unity peut compiler des applications Android à l'aide de ses propres outils pris en charge ; Android Studio n'est donc pas nécessaire pour configurer un projet Unity. Android Studio peut toutefois être utile pour gérer les émulateurs et pour les diagnostics Android tels que Logcat. Il convient de souligner que l'émulateur Android XR ne prend pas en charge la simulation d'applications créées avec Unity, Godot, Unreal Engine ou OpenXR ; les builds Unity nécessitent donc un Aura physique. Pour une application Kotlin native, Android Studio est votre espace de travail principal et Unity est inutile.
Pour personnaliser ultérieurement le build Android, Unity peut exporter un projet Gradle pour Android Studio. Cette étape n'est pas nécessaire pour la configuration initiale. Laissez sélectionnés les outils de build pris en charge propres à Unity, sauf si votre intégration exige spécifiquement un flux d'exportation.
Dépannage de la première configuration
- La cible de build Android est indisponible : ajoutez Android Build Support à l'installation exacte de l'éditeur Unity concernée
- Le groupe Android XR est absent : vérifiez l'identifiant du package, la compatibilité et l'onglet de la cible Android
- La Gradle sync échoue : lisez la première erreur de build ; vérifiez l'installation du SDK et la correspondance des versions des dépendances
- Des packages ou fonctionnalités requis sont absents : vérifiez le Package Manager, la cible Android active et le groupe de fonctionnalités Android XR
- Project Validation affiche des erreurs : examinez chaque problème requis et appliquez la correction adaptée à la version du package installée
- L'appareil n'est pas autorisé : acceptez la demande de débogage sur l'appareil
- L'installation échoue sur l'émulateur : vérifiez que l'architecture de l'APK correspond à l'image système de l'émulateur
Conclusion
Configurer un environnement de développement XREAL Aura consiste à installer des outils compatibles, à préparer un projet Android XR, à activer la bonne prise en charge de la plateforme et à vérifier la connexion de l'appareil. Unity convient aux projets qui utiliseront du contenu 3D interactif, tandis qu'Android Studio convient aux interfaces Android natives. Une configuration claire et reproductible aide les entreprises à réduire les problèmes de configuration et offre aux développeurs une base fiable pour créer et tester des applications.
Vous prévoyez un développement pour XREAL Aura ? Discutez de l'accès au matériel, des exigences logicielles et de l'accompagnement au déploiement avec VR Expert.
Découvrez le matériel XR professionnel et l'accompagnement proposés sur : https://ai.vr-expert.com/

























