Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Configura Android Game Development Extension en una computadora con Windows y ejecuta un proyecto de muestra de Visual Studio C++ en un dispositivo o emulador de Android.
Requisitos previos
Sigue los pasos que se indican en esta sección a fin de preparar tu computadora con Windows para instalar la extensión:
Descarga e instala una de las versiones compatibles de Visual Studio:
Descarga e instala JDK 17 para AGDE 23.1.82 o versiones posteriores, o JDK 11 para AGDE 22.2.71 como máximo, y configura tu variable de entorno JAVA_HOME.
Cómo instalar la extensión
Sigue los pasos que se indican en esta sección para descargar e instalar Android Game Development Extension:
Cierra todas las instancias de Visual Studio.
Descarga el instalador de extensión más reciente y los ejemplos de la página Descargas.
Desde la ubicación de la descarga, haz doble clic en el instalador. La instalación tarda varios minutos en completarse.
Si tienes más de una versión instalada de Visual Studio, selecciona las versiones para las que quieras instalar la extensión.
Haz clic en Finalizar para completar la instalación.
Cómo instalar el SDK y NDK de Android
Puedes instalar el SDK de Android y el kit de desarrollo nativo (NDK) de Android con Android Studio o Android Game Development Extension. Para instalar el SDK y NDK desde la extensión, usa SDK Manager, que se encuentra en la barra de herramientas de extensiones de Visual Studio.
Cuando instales el NDK, asegúrate de usar la casilla de verificación NDK (Side by side) para que la extensión pueda ubicarla. Debes instalar una versión del NDK que sea compatible con la extensión (consulta el historial de revisión del NDK).
Para instalar el SDK en una ubicación diferente de la predeterminada, configura la variable de entorno ANDROID_SDK_ROOT en la computadora.
Asegúrate de que Visual Studio esté cerrado.
En la búsqueda de Windows, busca Environment Variables.
Selecciona Editar las variables de entorno del sistema.
Haz clic en Variables de entorno.
En Variables de usuario, haz clic en Nueva.
En el cuadro Nombre de variable, escribe ANDROID_SDK_ROOT.
En el cuadro Valor de variable, ingresa la ruta de acceso al SDK de Android.
Reinicia tu computadora.
No se puede modificar la ubicación del SDK usando la ventana de SDK Manager, ya que esta variable de entorno es la única fuente de información respecto de la ubicación del SDK.
Cómo ejecutar el ejemplo
Sigue los pasos que se indican en esta sección para ejecutar un ejemplo proporcionado en un emulador y luego en un dispositivo Android físico.
Cómo configurar la plataforma
Descomprime el archivo ZIP de ejemplos en el directorio que desees. Se incluyen los siguientes ejemplos:
endless-tunnel
HelloJNI
Tetera
Inicia Visual Studio si aún no se está ejecutando.
Abre el directorio de ejemplos. Selecciona Archivo > Abrir > Proyecto/Solución y navega hasta el archivo .sln.
Selecciona una plataforma de Android:
Selecciona Compilar > Administrador de configuración.
En Plataforma de soluciones activas, selecciona Android-x86_64.
Asegúrate de que el proyecto de ejemplo cuente con las propiedades del SDK de Android y del NDK configuradas:
Figura 1: Propiedades de la plataforma de Android
En el Explorador de soluciones, haz clic con el botón derecho en el proyecto y selecciona Propiedades.
Selecciona la pestaña de propiedades General y busca las propiedades de Plataforma para Android.
Selecciona la pestaña de propiedades Empaquetado de Android.
Figura 2: Propiedades del empaquetado de Android
Puedes cambiar el nombre y el directorio del APK de salida desde esta pestaña. Ten en cuenta que algunas de las propiedades de configuración de Android se definen en las páginas de propiedades y se pasan a Gradle. Por ejemplo, la propiedad MSBUILD_ANDROID_OUTPUT_APK_NAME del nombre de APK pasa este nombre al archivo build.gradle de la app.
Configura el emulador
Inicia el Administrador de AVD desde la barra de herramientas de extensiones en Visual Studio.
Configura un dispositivo virtual y ejecútalo en Android Emulator.
En el Administrador del dispositivo virtual de Android, haz clic en Create Virtual Device.
Elige una definición de dispositivo (por ejemplo, Pixel 2).
Selecciona una imagen del sistema. Deberías seleccionar una ABI de x86_64 porque esta arquitectura se ejecuta más rápido en el emulador.
Verifica la configuración y haz clic en Finish.
Haz clic en el botón Run en el Administrador del dispositivo virtual de Android para iniciar el dispositivo virtual.
En Visual Studio, el dispositivo virtual debería aparecer junto al botón Iniciar depuración de la barra de herramientas. Haz clic en Iniciar depuración para iniciar la app del ejemplo en el dispositivo. Es posible que el depurador tarde unos minutos en conectarse a la app. Si estás ejecutando el ejemplo de Teapot, puedes arrastrar el cursor del mouse sobre la tetera para girarla.
Figura 3: Ejemplo de la tetera que se ejecuta en un emulador de Android
Cómo configurar el dispositivo
Para ejecutar el ejemplo en un dispositivo Android físico, es probable que debas crear una nueva plataforma de Android en el proyecto. Esta plataforma debe coincidir con la arquitectura del dispositivo. Para crear una plataforma nueva, haz lo siguiente en Visual Studio:
Selecciona Compilar > Administrador de configuración.
En Plataforma de soluciones activas, selecciona <New>.
Escribe una de las siguientes opciones para la plataforma nueva:
Android-armeabi-v7a
Android-arm64-v8a
Android-x86
Android-x86_64
En el cuadro Copiar configuración desde, selecciona otra plataforma de Android existente (o Ninguna si aún no tienes ninguna plataforma de Android).
Asegúrate de habilitar Crear nuevas plataformas de proyecto.
Conecta un dispositivo Android a tu computadora con un cable USB. El tipo de dispositivo debería aparecer junto al botón Iniciar depuración de la barra de herramientas.
Figura 4: Dispositivo Android conectado que se muestra junto al botón Iniciar depuración de la barra de herramientas
Si el dispositivo no aparece, verifica lo siguiente:
Si la selección de la plataforma coincide con la ABI de tu dispositivo.
Si el cable USB está conectado del dispositivo a la computadora.
Si el cable USB admite una conexión de datos (y no solo de energía).
Haz clic en el botón Iniciar depuración de la barra de herramientas para iniciar la app de ejemplo en el dispositivo. Es posible que el depurador tarde unos minutos en conectarse a la app. Una vez que se haya conectado, podrás interactuar con la app en tu dispositivo.
Preguntas frecuentes
Las siguientes son preguntas frecuentes sobre Android Game Development Extension.
¿Dónde se encuentran los registros para el complemento?
Puedes abrir el archivo de registro del complemento usando el ícono Open Logs en la barra de herramientas de Android Game Development Extension.
¿Qué variables de entorno usa el complemento?
El complemento usa las siguientes variables de entorno:
ANDROID_SDK_ROOT
ANDROID_SDK_HOME
TEMP
GOOGLE_ANDROID_LOG_DIR
Siguiente paso
Para usar tu propio proyecto con la extensión, debes configurarlo de acuerdo con la guía de configuración de proyectos.
El contenido y las muestras de código que aparecen en esta página están sujetas a las licencias que se describen en la Licencia de Contenido. Java y OpenJDK son marcas registradas de Oracle o sus afiliados.
Última actualización: 2025-07-27 (UTC)
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 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."]]
en el Administrador del dispositivo virtual de Android para iniciar el dispositivo virtual.
