Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Configure a Android Game Development Extension em um computador Windows e execute um projeto de exemplo do Visual
Studio C++ em um dispositivo ou emulador Android.
Pré-requisitos
Siga as etapas nesta seção para preparar o computador Windows para a instalação
da extensão:
Faça o download de uma das versões compatíveis do Visual Studio e instale-a:
Faça o download e instale o JDK 17 para AGDE
23.1.82 ou mais recente, ou o JDK 11 para até AGDE
22.2.71, e defina a variável de ambiente JAVA_HOME.
Instalar a extensão
Siga as etapas desta seção para fazer o download da
Android Game Development Extension e instalá-la:
Feche todas as instâncias do Visual Studio.
Faça o download do instalador e dos exemplos mais recentes da extensão na página
Downloads.
No local de download, clique duas vezes no instalador, que pode levar
vários minutos para ser concluído.
Se você tiver mais de uma versão do Visual Studio instalada, selecione as
versões em que quer que a extensão seja instalada.
Clique em Concluir para concluir a instalação.
Instalar o NDK e o SDK do Android
É possível instalar o SDK do Android e o Android
Native Development Kit (NDK)
com o Android Studio ou a Android Game Development Extension. Para instalar o SDK e o NDK pela
extensão, use o SDK Manager, localizado na
barra de ferramentas de extensão do Visual Studio.
Ao instalar o NDK, use a caixa de seleção NDK (Side by side) para
que a extensão possa localizá-lo. É necessário instalar uma versão
do NDK que seja compatível com a extensão
(consulte o Histórico de revisões do NDK):
Para instalar o SDK em um local diferente do padrão, defina a variável de ambiente ANDROID_SDK_ROOT no computador:
Verifique se o Visual Studio está fechado.
Na Pesquisa do Windows, pesquise por Environment Variables.
Selecione Editar as variáveis de ambiente do sistema.
Clique em Variáveis de ambiente.
Em Variáveis de usuário, clique em Nova.
Na caixa Nome da variável, digite ANDROID_SDK_ROOT.
Na caixa Valor da variável, insira o caminho do SDK do Android.
Reinicialize o computador.
Não é possível modificar o local do SDK usando a janela do SDK Manager, porque essa
variável de ambiente é a única fonte de verdade para o local do SDK.
Executar o exemplo
Siga as etapas desta seção para executar um exemplo fornecido em um
emulador e, em seguida, em um dispositivo Android físico.
Configurar a plataforma
Descompacte o arquivo ZIP de exemplo em um diretório da sua escolha. Os exemplos
a seguir estão incluídos:
endless-tunnel
HelloJNI
Teapot
Inicie o Visual Studio se ainda não tiver feito isso.
Abra o diretório de exemplos. Selecione Arquivo > Abrir > Projeto/Solução e navegue até o arquivo .sln.
Selecione uma Plataforma Android:
Selecione Compilação > Configuration Manager.
Em Plataforma de solução ativa, selecione Android-x86_64.
Verifique se as propriedades do NDK e do SDK do Android do projeto de exemplo estão
configuradas:
Figura
1. Propriedades da Plataforma Android.
No Explorador de Soluções, clique com o botão direito do mouse no projeto e selecione
Propriedades.
Selecione a guia de propriedades Geral e localize as propriedades da Plataforma
para Android.
Selecione a guia de propriedades Empacotamento do Android.
Figura
2. Propriedades de empacotamento do Android.
É possível alterar a saída do nome e do diretório do APK nessa guia. Algumas
das propriedades de configuração do Android são definidas nas páginas
de propriedades e transmitidas ao Gradle. Por exemplo, a propriedade de nome do APK
MSBUILD_ANDROID_OUTPUT_APK_NAME transmite esse nome para o arquivo build.gradle
do app.
Configurar o emulador
Inicie o AVD Manager na barra de ferramentas da extensão no Visual Studio.
Configure um dispositivo virtual e
execute-o no emulador do Android.
Na janela Android Virtual Device Manager, clique em Create Virtual Device.
Escolha uma definição de dispositivo (por exemplo, Pixel 2).
Selecione uma imagem do sistema. Selecione uma ABI x86_64 porque essa
arquitetura é executada com mais rapidez no emulador.
Verifique a configuração e clique em Finish.
Inicie o dispositivo virtual clicando no botão Run na ferramenta Android
Virtual Device Manager.
No Visual Studio, o dispositivo virtual vai aparecer ao lado do botão
Iniciar depuração da barra de ferramentas. Clique em Iniciar depuração para iniciar o
app de exemplo no dispositivo. Pode levar alguns instantes para que o depurador seja conectado ao app. Se você estiver executando a amostra do bule, arraste o cursor do mouse sobre ele para girar.
Figura
3. Exemplo do Teapot em execução no Android Emulator.
Configurar o dispositivo
Para executar o exemplo em um dispositivo Android físico, talvez seja necessário criar uma
nova Plataforma Android no projeto. Essa plataforma precisa usar a mesma arquitetura
do dispositivo. Para criar uma nova plataforma, faça o seguinte no Visual Studio:
Selecione Compilação > Configuration Manager.
Em Plataforma de solução ativa, selecione <Nova>.
Digite uma das seguintes opções para a nova plataforma:
Android-armeabi-v7a
Android-arm64-v8a
Android-x86
Android-x86_64
Na caixa Copiar configurações de, selecione outra plataforma Android (ou Nenhuma se você ainda não tiver nenhuma plataforma Android).
Verifique se você ativou a opção Criar novas plataformas de projeto.
Conecte um dispositivo Android ao computador usando um cabo USB. O tipo de
dispositivo precisa ser exibido ao lado do botão Iniciar depuração.
Figura
4. Dispositivo Android conectado mostrado ao lado do botão Iniciar depuração da barra de ferramentas.
Se o dispositivo não aparecer, verifique o seguinte:
a plataforma selecionada corresponde à ABI do dispositivo.
o dispositivo está conectado ao computador com o cabo USB;
o cabo USB é compatível com uma conexão de dados e não apenas de energia;
Clique no botão Iniciar depuração na barra de ferramentas para iniciar o app de exemplo no
dispositivo. Pode levar alguns instantes para que o depurador seja conectado ao app.
Depois disso, você pode interagir com o app no seu dispositivo.
Perguntas frequentes
Veja a seguir algumas perguntas frequentes sobre a Android Game Development Extension.
Em que local os registros do plug-in são armazenados?
Abra o arquivo de registros do plug-in usando o ícone Open Logs na barra de ferramentas
Android Game Development Extension.
Quais variáveis de ambiente são usadas pelo plug-in?
O plug-in usa as seguintes variáveis de ambiente:
ANDROID_SDK_ROOT
ANDROID_SDK_HOME
TEMP
GOOGLE_ANDROID_LOG_DIR
Próxima etapa
Para usar seu próprio projeto com a extensão, é preciso configurá-lo de acordo com
o guia de configuração de projeto.
O conteúdo e os exemplos de código nesta página estão sujeitos às licenças descritas na Licença de conteúdo. Java e OpenJDK são marcas registradas da Oracle e/ou suas afiliadas.
Última atualização 2025-07-27 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 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."]]