Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Configurez l'extension Android Game Development sur un ordinateur Windows et exécutez un exemple de projet Visual Studio C++ sur un appareil ou un émulateur Android.
Conditions préalables
Suivez la procédure décrite dans cette section pour préparer votre ordinateur Windows à l'installation de l'extension :
Téléchargez et installez une des versions compatibles de Visual Studio :
Téléchargez et installez JDK 17 pour AGDE 23.1.82 ou version ultérieure, ou JDK 11 jusqu'à AGDE 22.2.71, et définissez votre variable d'environnement JAVA_HOME.
Installer l'extension
Suivez la procédure décrite dans cette section pour télécharger et installer l'extension Android Game Development :
Fermez toutes les instances de Visual Studio.
Téléchargez le programme d'installation de l'extension et les exemples les plus récents à partir de la page Téléchargements.
Accédez à l'emplacement où vous avez téléchargé le programme d'installation et double-cliquez dessus. Patientez quelques minutes jusqu'à la fin de l'installation.
Si plusieurs versions de Visual Studio sont installées, sélectionnez celles pour lesquelles vous souhaitez installer l'extension.
Cliquez sur Terminer pour finaliser l'installation.
Installer le SDK et le NDK Android
Vous pouvez installer le SDK Android et le kit de développement natif (NDK) Android à l'aide d'Android Studio ou de l'extension Android Game Development. Pour installer le SDK et le NDK à l'aide de l'extension, utilisez SDK Manager, situé dans la barre d'outils de l'extension dans Visual Studio.
Lors de l'installation du NDK, veillez à cocher la case NDK (Side by side) [NDK (Côte à côte)] afin que l'extension puisse le localiser. Vous devez installer une version du NDK compatible avec l'extension (consultez l'Historique des révisions du NDK).
Pour installer le SDK à un emplacement autre que l'emplacement par défaut, définissez la variable d'environnement ANDROID_SDK_ROOT sur votre ordinateur :
Assurez-vous que Visual Studio est fermé.
Dans Windows Search, recherchez Environment Variables.
Sélectionnez Modifier les variables d'environnement système.
Cliquez sur Variables d'environnement.
Sous User Variables (Variables utilisateur), cliquez sur New (Nouvelle).
Dans le champ Nom de la variable, saisissez ANDROID_SDK_ROOT.
Dans le champ Valeur de la variable, saisissez le chemin d'accès au SDK Android.
Redémarrez l'ordinateur.
L'emplacement du SDK ne peut pas être modifié à l'aide de la fenêtre SDK Manager, car cette variable d'environnement est la seule référence pour l'emplacement du SDK.
Exécuter l'exemple
Suivez la procédure décrite dans cette section pour exécuter un exemple fourni dans un émulateur, puis sur un appareil Android physique.
Configurer la plate-forme
Décompressez le fichier ZIP des exemples dans le répertoire de votre choix. Ce fichier contient les exemples suivants :
endless-tunnel
HelloJNI
Teapot
Si ce n'est déjà fait, démarrez Visual Studio.
Ouvrez le répertoire des exemples. Sélectionnez File > Open > Project/Solution (Fichier > Ouvrir > Projet/Solution) et accédez au fichier .sln.
Sélectionnez une plate-forme Android :
Sélectionnez Build > Configuration Manager (Compiler > Gestionnaire de configurations).
Sous Active solution platform (Plate-forme de solution active), sélectionnez Android x86_64.
Assurez-vous que les propriétés du SDK et du NDK Android sont configurées dans l'exemple de projet :
Figure
1. Propriétés de la plate-forme Android.
Dans l'explorateur de solutions, effectuez un clic droit sur le projet et sélectionnez Properties (Propriétés).
Sélectionnez l'onglet General (Général) et recherchez les propriétés de la plate-forme Android.
Sélectionnez l'onglet de propriétés Package Android.
Figure
2. Propriétés d'un package Android.
Vous pouvez modifier le nom et le répertoire de l'APK de sortie à partir de cet onglet. Notez que certaines propriétés de configuration d'Android sont définies sur les pages de propriétés et transmises à Gradle. Par exemple, la propriété de nom de l'APK MSBUILD_ANDROID_OUTPUT_APK_NAME transmet ce nom au fichier build.gradle de l'application.
Configurer l'émulateur
Lancez AVD Manager à partir de la barre d'outils de l'extension dans Visual Studio.
Configurez un appareil virtuel, puis exécutez-le dans Android Emulator.
Dans le gestionnaire d'appareils virtuels Android, cliquez sur Create Virtual Device (Créer un appareil virtuel).
Choisissez une définition d'appareil (par exemple, Pixel 2).
Sélectionnez une image système. Vous devez sélectionner une ABI x86_64, car cette architecture est plus rapide dans l'émulateur.
Vérifiez la configuration, puis cliquez sur Finish (Terminer).
Démarrez l'appareil virtuel en cliquant sur le bouton Run (Exécuter) dans le gestionnaire d'appareils virtuels Android.
Dans Visual Studio, l'appareil virtuel doit apparaître à côté du bouton Start Debugging (Démarrer le débogage) de la barre d'outils. Cliquez sur Start Debugging (Démarrer le débogage) pour lancer l'application exemple sur l'appareil. L'association du débogueur avec l'application peut prendre quelques instants. Si vous exécutez l'exemple Teapot, vous pouvez faire pivoter la théière en faisant glisser le curseur de la souris dessus.
Figure
3. Exemple Teapot exécuté sur un émulateur Android.
Configurer l'appareil
Pour exécuter l'exemple sur un appareil Android physique, il se peut que vous deviez créer une plate-forme Android dans le projet. Cette plate-forme doit correspondre à l'architecture de l'appareil. Pour créer une plate-forme, procédez comme suit dans Visual Studio :
Sélectionnez Build > Configuration Manager (Compiler > Gestionnaire de configurations).
Sous Active solution platform, sélectionnez New (Plate-forme de solution active > Nouvelle).
Saisissez l'une des architectures suivantes pour la nouvelle plate-forme :
Android-armeabi-v7a
Android-arm64-v8a
Android-x86
Android-x86_64
Dans le champ Copy settings from (Copier les paramètres de), sélectionnez une autre plate-forme Android ou None (Aucune) si vous n'avez pas encore de plate-forme Android.
Assurez-vous d'avoir activé l'option Create new project platforms (Créer des plates-formes de projet).
Connectez un appareil Android à votre ordinateur à l'aide d'un câble USB. Le type d'appareil doit s'afficher à côté du bouton Démarrer le débogage de la barre d'outils.
Figure
4. Appareil Android connecté affiché à côté du bouton Démarrer le débogage de la barre d'outils.
Si le type d'appareil n'est pas affiché, vérifiez les points suivants :
La plate-forme sélectionnée correspond à l'ABI de votre appareil.
Le câble USB est branché entre l'appareil et l'ordinateur.
Le câble USB accepte la connexion de données (et pas seulement l'alimentation).
Cliquez sur le bouton Start Debugging (Démarrer le débogage) de la barre d'outils pour lancer l'application exemple sur l'appareil. L'association du débogueur à l'application peut prendre quelques instants. Une fois l'association effectuée, vous pouvez interagir avec l'application sur votre appareil.
Questions fréquentes
Vous trouverez ci-dessous les réponses à quelques questions fréquentes sur l'extension Android Game Development.
Où se trouvent les journaux du plug-in ?
Vous pouvez ouvrir le fichier journal du plug-in à l'aide de l'icône Open Logs (Ouvrir les journaux) de la barre d'outils de l'extension Android Game Development.
Quelles variables d'environnement le plug-in utilise-t-il ?
Le plug-in utilise les variables d'environnement suivantes :
ANDROID_SDK_ROOT
ANDROID_SDK_HOME
TEMP
GOOGLE_ANDROID_LOG_DIR
Étapes suivantes
Pour utiliser votre propre projet avec l'extension, vous devez le configurer comme mentionné dans le guide de configuration de projet.
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/07/27 (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/07/27 (UTC)."],[],[],null,["# Quickstart\n\nSet up the Android Game Development Extension on a Windows computer and run a sample Visual\nStudio C++ project on an Android device or emulator.\n\nPrerequisites\n-------------\n\nFollow the steps in this section to prepare your Windows computer for\ninstallation of the extension:\n\n1. Download and install one of the supported versions of Visual Studio:\n\n - [Visual Studio 2017 Version 15.4.0 (October 9th, 2017) or higher](https://docs.microsoft.com/en-us/visualstudio/install/update-visual-studio?view=vs-2017).\n - [Visual Studio 2019 Version 16.0.0 or higher](https://docs.microsoft.com/en-us/visualstudio/install/update-visual-studio?view=vs-2019).\n - [Visual Studio 2022 Version 17.0.0 or higher](https://docs.microsoft.com/en-us/visualstudio/install/update-visual-studio?view=vs-2022).\n2. [Download and install .NET Core SDK 2.2](https://dotnet.microsoft.com/download/thank-you/dotnet-sdk-2.2.107-windows-x64-installer).\n\n3. [Android Studio 3.5 or higher](/studio) is optional, but can be used\n instead of the Android Game Development Extension to install the\n [Android SDK and NDK](#install-sdk-ndk).\n\n4. Download and install [JDK 17](https://jdk.java.net/archive/) for AGDE\n 23.1.82 or newer, or [JDK 11](https://jdk.java.net/archive/) for up to AGDE\n 22.2.71, and set your `JAVA_HOME` environment variable.\n\nInstall the extension\n---------------------\n\nFollow the steps in this section to download and install the\nAndroid Game Development Extension:\n\n1. Close all instances of Visual Studio.\n\n2. Download the latest extension installer and samples from the\n [Downloads](/games/agde#downloads) page.\n\n3. From your download location, double-click the installer. The installer takes\n several minutes to complete.\n\n4. If you have more than one version of Visual Studio installed, select the\n versions that you would like the extension to be installed for.\n\n5. Click **Finish** to complete the installation.\n\nInstall the Android SDK and NDK\n-------------------------------\n\nYou can install the Android SDK and the Android\n[Native Development Kit (NDK)](/studio/projects/install-ndk#specific-version)\nwith Android Studio or the Android Game Development Extension. To install the SDK and NDK from\nthe extension, use the **SDK Manager**, which is located in the\nextension toolbar of Visual Studio.\n\nWhen installing the NDK, make sure to use the **NDK (Side by side)** checkbox so\nthat the extension can locate it. You must install an NDK version\nthat is supported by the extension\n(see [NDK revision history](/ndk/downloads/revision_history)).\n\nTo install the SDK to a different location than the default, set the\n`ANDROID_SDK_ROOT` environment variable on your computer:\n\n1. Ensure that Visual Studio is closed.\n2. In Windows Search, search for `Environment Variables`.\n3. Select **Edit the system environment variables**.\n4. Click **Environment Variables**.\n5. Under **User Variables** , click **New**.\n6. In the **Variable Name** box, type `ANDROID_SDK_ROOT`.\n7. In the **Variable Value** box, enter the path to the Android SDK.\n8. Reboot your computer.\n\nThe location of the SDK cannot be modified using the SDK Manager window as this\nenvironment variable is the only source-of-truth for the SDK location.\n\nRun the sample\n--------------\n\nFollow the steps in this section to run a provided sample on an\nemulator and then on a physical Android device.\n\n### Configure the platform\n\n1. Unzip the samples zip file into a directory of your choice. The following\n samples are included:\n\n - endless-tunnel\n - HelloJNI\n - Teapot\n2. Start Visual Studio if it is not already running.\n\n3. Open the samples directory. Select **File \\\u003e Open \\\u003e Project/Solution** and\n navigate to the `.sln` file.\n\n4. Select an Android platform:\n\n 1. Select **Build \\\u003e Configuration Manager**.\n 2. Under **Active solution platform** , select **Android-x86_64**.\n\n Android platforms are already configured in the samples (see [add\n more Android platforms](#add-platform) for adding platforms).\n | **Note:** Typical emulator images use x86 or x86_64 ABIs.\n5. Make sure the sample project has the Android SDK and NDK properties\n configured:\n\n **Figure\n 1.** Android platform properties\n - In the **Solution Explorer** , right-click the project and select\n **Properties**.\n\n - Select the **General** properties tab and find the **Platform**\n properties for Android.\n\n | **Note:** Make sure you select an NDK that is installed.\n6. Select the **Android Packaging** properties tab.\n\n **Figure\n 2.** Android packaging properties\n\n You can change the output APK name and directory from this tab. Note that\n some of the Android configuration properties are defined in the property\n pages and are passed to Gradle. For example, the APK name property\n `MSBUILD_ANDROID_OUTPUT_APK_NAME` passes this name to the app `build.gradle`\n file.\n\n### Set up the emulator\n\n1. Start AVD Manager from the extension toolbar in Visual Studio.\n Configure a virtual device and then\n [run it in the Android emulator](/studio/run/emulator).\n\n 1. In the Android Virtual Device Manager, click **Create Virtual Device**.\n 2. Choose a device definition (for example, Pixel 2).\n 3. Select a system image. You should select an x86_64 ABI because this architecture performs faster in the emulator.\n 4. Verify the configuration and click **Finish**.\n2. Start the virtual device by clicking the **Run**\n button in the Android\n Virtual Device Manager.\n\n3. In Visual Studio, the virtual device should appear next to the\n **Start Debugging** toolbar button. Click **Start Debugging** to launch the\n sample app on the device. It may take a few moments for the debugger\n to attach to the app. If you are running the Teapot sample, you can rotate\n the teapot by dragging your mouse cursor across it.\n\n \u003cbr /\u003e\n\n\n **Figure\n 3**. Teapot sample running on an Android emulator\n\n### Set up the device\n\n1. To run the sample on a physical Android device, you may need to create a\n new Android platform in the project. This platform must match the architecture\n of the device. To create a new platform, do the following in Visual Studio:\n\n 1. Select **Build \\\u003e Configuration Manager**.\n 2. Under **Active solution platform** , select **\\\u003cNew\\\u003e**.\n 3. Type one of the following for the new platform:\n\n - **Android-armeabi-v7a**\n - **Android-arm64-v8a**\n - **Android-x86**\n - **Android-x86_64**\n 4. In the **Copy settings from** box, select another existing Android\n platform (or **None** if you do not have any Android platforms yet).\n Make sure you enabled **Create new project platforms**.\n\n2. Connect an Android device to your computer using a USB cable. The device\n type should be shown next to the **Start Debugging** toolbar button.\n\n \u003cbr /\u003e\n\n\n **Figure\n 4** . Connected Android device shown next to the **Start Debugging** toolbar button\n\n If the device is not shown, check the following:\n - The platform selection matches the ABI of your device.\n - [Developer options and USB debugging](/studio/debug/dev-options) are enabled on the device.\n - The USB cable is connected from the device to the computer.\n - The USB cable supports a data connection (and not just power).\n3. Click the **Start Debugging** toolbar button to launch the sample app on the\n device. It may take a few moments for the debugger to attach to the app.\n Once it is attached, you can interact with the app on your device.\n\nFAQ\n---\n\nThe following are some frequently asked questions about the Android Game Development Extension.\n\n### Where are the logs for the plugin located?\n\nYou can open the log file for the plugin using the **Open Logs** icon in the\n**Android Game Development Extension** toolbar.\n\n### What environment variables does the plugin use?\n\nThe plugin uses the following environment variables:\n\n- `ANDROID_SDK_ROOT`\n- `ANDROID_SDK_HOME`\n- `TEMP`\n- `GOOGLE_ANDROID_LOG_DIR`\n\nWhat's next\n-----------\n\nTo use your own project with the extension, you must configure it according to\nthe [project configuration](/games/agde/adapt-existing-project) guide."]]
dans le gestionnaire d'appareils virtuels Android.
