Le SDK Android XR est désormais disponible en version Preview développeur. Votre avis nous intéresse. Pour nous contacter, consultez notre page d'assistance.
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Pour commencer à développer pour Android XR, utilisez la dernière version Canary d'Android Studio, qui inclut de nouveaux outils et mises à jour optimisés pour Android XR.
Voici les nouvelles fonctionnalités incluses dans cette version d'Android Studio :
Émulateur Android XR
Ajout de la compatibilité avec la réalité étendue dans l'outil d'inspection de la mise en page
Modèle de projet XR
Configuration système requise pour l'émulateur Android XR
Pour macOS :
OS : macOS 13.3 ou version ultérieure.
Processeur/GPU : Apple Silicon (puce M1 ou version ultérieure)
RAM/VRAM : 16 Go ou plus
Pour Windows :
OS : Windows 11 ou version ultérieure.
Processeur : Intel de 9e génération ou ultérieur, ou AMD Ryzen série 1000 ou ultérieur.
RAM : 16 Go ou plus
GPU : NVIDIA GeForce série 10 ou ultérieure, ou AMD Radeon RX série 5000 ou ultérieure.
VRAM : 8 Go ou plus
Paramètres du BIOS : les extensions VMX du processeur doivent être activées dans le BIOS de votre ordinateur.
Installer et configurer Android Studio pour le développement XR
Pour télécharger Android Studio et configurer votre environnement de développement, procédez comme suit :
Veillez à fermer toutes les versions d'Android Studio que vous avez déjà installées.
Téléchargez la dernière version Canary d'Android Studio, extrayez-la à l'emplacement de votre choix, puis lancez l'application.
Suivez les instructions d'installation de l'assistant.
Dans la boîte de dialogue Welcome to Android Studio (Bienvenue dans Android Studio), cliquez sur More Actions (Autres actions), puis sélectionnez SDK Manager (SDK Manager).
Sur la page Android SDK, cliquez sur l'onglet SDK Tools, puis sélectionnez les outils suivants à installer :
Android SDK Build-Tools
Android Emulator
Android SDK Platform-Tools
Outil d'inspection de la mise en page pour les API 31 à 36
Dans l'onglet Plates-formes SDK, procédez comme suit :
Cochez la case Afficher les détails du package pour afficher toutes les options.
Sélectionnez l'image système Google Play XR ARM (macOS) ou Google Play XR Intel x86_64 (Windows).
Cliquez sur Appliquer pour effectuer les modifications, puis sur OK.
Laissez toutes les étapes de l'installation se terminer, puis cliquez sur Terminer.
Créer un projet Android XR
Suivez ces étapes pour créer un projet Android XR dans Android Studio ou étendre un projet existant à XR.
Dans la fenêtre Welcome to Android Studio (Bienvenue dans Android Studio), effectuez l'une des opérations suivantes :
Si vous créez une application XR, cliquez sur Nouveau projet et passez à l'étape suivante.
Si vous spatialisez une application existante, cliquez sur Open (Ouvrir) pour sélectionner votre projet, puis passez à l'étape suivante : "Créer un appareil virtuel Android pour l'émulateur Android". (Pour obtenir de l'aide concernant la spatialisation de votre application existante pour Android XR, consultez Intégrer votre application Android en 3D avec XR.)
Dans la catégorie XR, sélectionnez le modèle Basic Headset Activity (Activité de base du casque) et cliquez sur Next (Suivant).
Sur l'écran suivant, vous pouvez choisir un nom pour votre projet. Vous pouvez conserver les paramètres par défaut. Cliquez ensuite sur Terminer.
Créer un appareil virtuel Android pour l'émulateur Android
L'émulateur Android XR est une version spécialisée de l'émulateur Android conçue pour le développement d'applications XR. Il vous permet de tester et de déboguer vos applications de réalité étendue (XR) dans l'environnement familier d'Android Studio.
Pour utiliser l'émulateur Android XR, vous devez créer un appareil virtuel.
Pour ce faire, procédez comme suit :
Dans Android Studio, cliquez sur Tools > AVD Manager (Outils > AVD Manager), puis suivez les instructions pour créer un appareil virtuel Android (AVD).
Dans la fenêtre Add Device (Ajouter un appareil), sous Form Factor (Facteur de forme), sélectionnez l'option XR, puis XR Device (Appareil XR) dans la liste Name (Nom). Cliquez sur Suivant.
Dans l'onglet suivant (Configure Virtual Device, Configurer l'appareil virtuel), sous System Image (Image système), sélectionnez l'image système Android XR la plus récente compatible avec votre système.
Cliquez sur Terminer.
Pour démarrer l'émulateur, cliquez sur le bouton Run (Exécuter) dans le gestionnaire d'appareils.
L'émulateur s'ouvre dans une fenêtre distincte.
Pour lancer votre application dans l'émulateur, cliquez sur l'icône Run (Exécuter) dans Android Studio.
Pour en savoir plus sur l'utilisation de l'émulateur et d'autres nouveaux outils XR, consultez Outils Android Studio pour la XR.
Activer les statistiques d'utilisation pour améliorer Android Studio
Comme il s'agit d'une version Preview développeur d'Android Studio, la plupart de ces fonctionnalités sont encore en cours de développement. Envisagez d'activer les statistiques d'utilisation et d'envoyer des commentaires pour nous aider à améliorer ces outils.
Pour activer les statistiques d'utilisation :
Cliquez sur Settings > Appearance & Behavior > System Settings > Data Sharing (Paramètres > Apparence et comportement > Paramètres système > Partage de données).
Sélectionnez Envoyer des statistiques d'utilisation à Google.
Le contenu et les exemples de code de cette page sont soumis aux licences décrites dans la Licence de contenu. Java et OpenJDK sont des marques ou des marques déposées d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/01 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/08/01 (UTC)."],[],[],null,["# Set up your development environment\n\nTo get started developing for Android XR, use the latest Canary build of\n[Android Studio](/studio/preview), which includes new tools and updates optimized for Android\nXR.\n| **Note:** Ensure you are using the latest Canary build of Android Studio. Other versions might not include Android XR tools.\n\nNew features included in this version of Android Studio are:\n\n- Android XR Emulator\n- Addition of XR support in the Layout Inspector\n- XR Project template\n\nSystem Requirements for Android XR Emulator\n-------------------------------------------\n\n**For macOS:**\n\n- **OS**: macOS 13.3 or later.\n- **CPU/GPU**: Apple Silicon (M1 chip or newer)\n- **RAM/VRAM**: 16 GB or higher\n\n**For Windows:**\n\n- **OS**: Windows 11 or later.\n- **CPU**: Intel 9th generation or later, or AMD Ryzen 1000-series or later.\n- **RAM**: 16 GB or higher\n- **GPU**: NVIDIA GeForce 10 series or later, or AMD Radeon RX 5000 series or later.\n- **VRAM**: 8 GB or higher\n- **BIOS Settings**: VMX CPU extensions must be enabled in your computer's BIOS\n\n| **Note:** You can check if the VMX CPU extensions are already enabled by attempting to run the 2D Android Emulator. If it runs successfully, no BIOS changes are needed.\n\nInstall and configure Android Studio for XR development\n-------------------------------------------------------\n\nComplete the following steps to download Android Studio and set up your\ndevelopment environment:\n\n1. Make sure to close any versions of Android Studio you already have\n installed.\n\n2. Download the latest Canary build of [Android Studio](/studio/preview), extract it into\n your preferred location, and launch the application.\n\n3. Follow the installation instructions in the wizard.\n\n4. In the **Welcome to Android Studio** dialog, click **More Actions** , and\n select **SDK Manager**.\n\n5. In the **Android SDK** page, click the **SDK Tools** tab and select the\n following tools to install:\n\n - Android SDK Build-Tools\n - Android Emulator\n - Android SDK Platform-Tools\n - Layout Inspector for API 31 - 36\n\n | **Note:** If you had a previous version of Android Studio installed, you may need to recheck these boxes, and click **Apply** to download the latest updates.\n6. Under the **SDK Platforms** tab, do the following:\n\n 1. Select the **Show Package Details** checkbox to see all the options.\n 2. Select the **Google Play XR ARM** system image (macOS) or **Google Play\n XR Intel x86_64** (Windows).\n\n 1. Click **Apply** to make the updates, and then click **OK**.\n 2. Allow all the installation steps to complete, then click **Finish**.\n\nCreate an Android XR project\n----------------------------\n\nFollow these steps to create an Android XR project in Android Studio or extend\nan existing project to XR.\n\n1. In the **Welcome to Android Studio** window, do one of the following:\n\n 1. If you're creating a new XR app, click **New Project** and go to the next step.\n 2. If you're spatializing an existing app, click **Open** to select your project, then skip to the next step Create a new Android Virtual Device for the Android Emulator. (For help with spatializing your existing app for Android XR, read [Bring your Android app into 3D with XR](/develop/xr/jetpack-xr-sdk/add-xr-to-existing))\n\n2. In the **XR** category, select the **Basic Headset Activity** template and\n click **Next**.\n\n3. On the next screen you can choose a name for your project. You can leave the\n default settings in place. Then click **Finish**.\n\n4. Explore the code provided in the template. Check out our [development\n guide](/develop/xr/jetpack-xr-sdk/develop-ui) and [reference documentation](/jetpack/androidx/releases/xr-compose).\n\nCreate a new Android Virtual Device for the Android Emulator\n------------------------------------------------------------\n\nThe Android XR Emulator is a specialized version of the Android emulator\ndesigned for XR app development. It lets you test and debug your Extended\nReality (XR) applications within the familiar Android Studio environment.\n| **Caution:** In rare cases, using the emulator can result in system freezes or crashes on some Windows configurations. Please ensure all data is saved before running the emulator. As a workaround, [enable WHPX](/studio/run/emulator-acceleration#vm-windows-whpx). See [release notes](/studio/preview/features) for more known issues.\n\nTo use the Android XR Emulator, you'll have to create a new virtual device.\nFollow these steps to do so:\n\n1. In Android Studio, click **Tools \\\u003e AVD Manager**, and follow the\n instructions to create a new Android Virtual Device (AVD).\n\n2. In the **Add Device** window, under **Form Factor** , select the **XR**\n option, then select **XR Device** in the **Name** list. Click **Next**.\n\n3. In the next tab (**Configure Virtual Device** ), under **System Image**,\n select the most recent Android XR system image that is compatible with your\n system.\n\n4. Click **Finish**.\n\n5. To start the emulator, click the **Run** button in Device Manager.\n\n The emulator opens in a separate window.\n\n6. To launch your app in the emulator, click the **Run** icon in Android\n Studio.\n\nFor details on using the emulator and other new XR tools, read [Android\nStudio Tools for XR](/develop/xr/jetpack-xr-sdk/studio-tools).\n\nEnable Usage Statistics to help improve Android Studio\n------------------------------------------------------\n\nBecause this is a developer preview version of Android Studio, many of these\nfeatures are still under development. Consider enabling usage statistics and\nsending feedback to help us improve these tools.\n\nTo enable Usage Statistics:\n\n1. Click **Settings \\\u003e Appearance \\& Behavior \\\u003e System Settings \\\u003e Data Sharing**.\n2. Select **Send usage statistics to google**."]]
