Ce guide décrit comment installer et configurer Android Studio et tous les outils essentiels que vous utiliserez pour construire des applications de VR, notamment :

EDI Android Studio (environnement de développement intégré recommandé)

Plateformes Android

Outils Android SDK

Android NDK

Premiers pas

Si vous prévoyez d’utiliser un Mac pour le développement, installez d’abord Xcode⁠. Si vous utilisez une autre plateforme, vous pouvez ignorer cette installation.

Pour commencer, téléchargez Android Studio⁠. Pour connaître les étapes détaillées de l’installation, consultez le guide Installer Android Studio⁠.

Installer des packages et outils supplémentaires

Après l’installation d’Android Studio, vous pouvez installer les packages suivants :

Android SDK Platform, API level 26

Android SDK Build Tools, version 28.0.3 ou ultérieure

Android NDK

Ces packages sont installés via Android SDK Manager. Pour y accéder :

Ouvrez Android Studio.

Cliquez sur l’icône en forme de trois points verticaux dans le coin supérieur droit.

Cliquez sur l’icône du SDK Manager ( SDK Manager

Sinon, chargez un projet existant et naviguez vers Tools > SDK Manager ou cliquez sur l’icône SDK Manager dans le coin supérieur droit.

Vérifier que les packages et versions installés sont les plus récents

À ce stade, vous devez vérifier que vous avez bien installé tous les packages et versions les plus récents.

Dans la fenêtre Settings qui s’ouvre, sous Android SDK Manager, sélectionnez l’onglet SDK Platforms.

Si vous construisez pour Meta Quest, vérifiez que Android 8.0 (Oreo) est installé, car c’est la version minimale requise par le SDK Oculus.

Si Android 8.0 (Oreo) n’est pas installé, cochez la case située à côté de son nom et cliquez sur Apply pour l’installer.

Sélectionnez l’onglet SDK Tools.

Vérifiez que l’ensemble d’outils NDK (Side by side), CMake et Android SDK Build Tools 28.0.3 (ou version ultérieure) sont tous installés.

S’ils sont manquants, sélectionnez-les et cliquez sur Apply pour les installer.

Pour plus d’informations sur Android NDK, consultez les pages Télécharger le NDK et les outils de compilation⁠ et Installer le NDK et CMake⁠.

Configurer Android Studio

Une fois que vous avez installé les packages requis, vous pouvez configurer votre environnement de développement.

Structure des projets Android Studio

Pour vérifier vos paramètres dans Android Studio, ouvrez un projet existant ou créez-en un et naviguez vers File > Settings > Project Structure > SDK Location (Fichier > Paramètres > Structure du projet > Emplacement du SDK).

S’il y a lieu, vérifiez que les propriétés suivantes sont définies sur les valeurs appropriées :

Android SDK Location

Android NDK Location

Notez bien ces emplacements, car vous les utiliserez pour définir vos variables d’environnement dans la section suivante. Si l’emplacement d’Android NDK est manquant, localisez le dossier ndk et sa dernière version, généralement sous C:\Users\[username]\AppData\Local\Android\Sdk\ndk\[versionnumber] car vous utiliserez ce chemin également.

Variables de l’environnement et chemin d’accès

Avec les emplacements enregistrés à l’étape précédente, définissez les variables d’environnement suivantes :

Définissez la variable d’environnement JAVA_HOME à l’emplacement de JDK, généralement C:\Program Files\Android\Android Studio\jre.

Définissez la variable d’environnement ANDROID_HOME à l’emplacement d’Android SDK, généralement C:\Users\[username]\AppData\Local\Android\Sdk.

Définissez la variable d’environnement ANDROID_NDK_HOME à l’emplacement d’Android NDK, généralement C:\Users\[username]\AppData\Local\Android\Sdk\ndk\[versionnumber].

Ajoutez le répertoire d’outils JDK à votre PATH, généralement C:\Program Files\Android\Android Studio\jre\bin.

Ajoutez le répertoire d’outils de plateforme Android SDK à votre PATH, généralement C:\Users\[username]\AppData\Local\Android\Sdk\platform-tools.

Ajoutez le répertoire d’outils Android SDK à votre PATH, généralement C:\Users\<username>\AppData\Local\Android\Sdk\tools.

Configuration de votre système pour détecter votre appareil Android (Windows uniquement)

Vous devez configurer votre système pour détecter votre appareil Android sur USB afin de pouvoir lancer, débuguer et tester votre application sur un appareil Android.

Vous devrez peut-être installer un pilote USB pour ADB après avoir installé Android SDK. Le pilote et les instructions d’installation sont disponibles sur la page Téléchargements

Windows peut détecter automatiquement le bon appareil et installer le pilote approprié lorsque vous connectez votre appareil à un port USB de votre ordinateur.

Accédez au Gestionnaire de périphériques via le Panneau de configuration Windows. Si l’appareil a été détecté automatiquement, il apparaîtra sous Périphériques portables dans le Gestionnaire de périphériques. Sinon, regardez sous Autres périphériques dans le Gestionnaire de périphériques et sélectionnez l’appareil afin de mettre à jour le pilote manuellement.

Pour voir la liste des appareils attachés détectés, entrez ce qui suit dans une invite de commande :