Para começar a desenvolver aplicativos .NET MAUI nativos e multiplataforma no Windows, macOS ou Linux, instale o Visual Studio Code mais recente seguindo as etapas de instalação do .
Pré-requisitos
Para criar, assinar e implantar aplicativos MAUI do .NET para iOS e Mac Catalyst, você precisará:
Instalar o Visual Studio Code
Para criar aplicativos MAUI do .NET, você precisará baixar a versão mais recente do Visual Studio Code:
Instale o Visual Studio Code. Para obter instruções detalhadas sobre como instalar o Visual Studio Code, consulte Visual Studio Code no Windows, Visual Studio Code no macOSe Visual Studio Code no Linux.
Instalar a extensão .NET MAUI
Antes de criar aplicativos .NET MAUI no Visual Studio Code, você precisará instalar a Extensão .NET MAUI:
Inicie o Visual Studio Code.
No Visual Studio Code, navegue até a guia Extensões e pesquise por ".NET MAUI". Em seguida, selecione a extensão .NET MAUI e instale-a clicando no botão Instalar:
A extensão do .NET MAUI instala automaticamente o Kit de Desenvolvimento do C# e as extensões do C#, que são necessárias para a execução da extensão do .NET MAUI. Para obter mais informações sobre o Kit de Desenvolvimento em C#, consulte Kit de Desenvolvimento em C# para Visual Studio Code.
Conectar sua conta ao Kit de Desenvolvimento em C#
O uso do Kit de Desenvolvimento do C# exige que você entre com uma conta da Microsoft que tenha uma assinatura ativa do Visual Studio:
Na guia de Boas-vindas para começar a usar o .NET MAUI, pressione o botão Conectar:
Siga os prompts para entrar em sua conta da Microsoft. Para obter mais informações, consulte Entrar no Kit de Desenvolvimento do C#.
Para obter mais informações sobre o licenciamento do Kit de Desenvolvimento em C#, consulte perguntas frequentes sobre o Kit de Desenvolvimento em C#.
Configurar seu ambiente do .NET
Você precisará do SDK do .NET instalado em seu computador para desenvolver aplicativos MAUI do .NET. Se você não tiver o SDK do .NET instalado em seu computador, a abordagem preferencial para instalá-lo no Windows será por meio do Instalador do Visual Studio. Para obter mais informações, consulte Instalação .
Como alternativa, para instalar manualmente o SDK do .NET:
Baixe o instalador do .NET .
Instale o SDK do .NET executando o instalador do .NET. Para obter mais informações, consulte Instalar o .NET no Windows, Linux e macOS.
Dica
No Linux, você pode instalar o SDK do .NET usando as instruções de instalação com script .
Para verificar se o SDK do .NET está instalado:
Abra um terminal.
No terminal, execute o seguinte comando:
dotnet --version
Você deverá ver a versão do SDK do .NET que você instalou.
Observação
Talvez seja necessário reiniciar o computador antes de verificar se o SDK do .NET está instalado.
Configurar seu ambiente do .NET MAUI
Você precisará do SDK do MAUI do .NET instalado em seu computador para desenvolver aplicativos MAUI do .NET. Se você não tiver o SDK do MAUI do .NET instalado em seu computador, a abordagem preferencial para instalá-lo no Windows será por meio do Instalador do Visual Studio. Para obter mais informações, consulte Instalação .
Como alternativa, para instalar manualmente o SDK do MAUI do .NET:
Abra um terminal.
No terminal no Windows, execute o seguinte comando:
dotnet workload install maui
No terminal no macOS, execute o seguinte comando:
sudo dotnet workload install maui
No terminal no Linux, execute o seguinte comando:
dotnet workload install maui-android
Para verificar se o SDK do MAUI do .NET está instalado:
Abra um terminal.
No terminal, execute o seguinte comando:
dotnet workload list
No Windows e no macOS, você deverá ver a ID da carga de trabalho maui listada junto com a versão instalada. No entanto, se você o instalou por meio do Instalador do Visual Studio no Windows, as seguintes IDs de carga de trabalho serão listadas:
android
maui-windows
maccatalyst
ios
No Linux, você deverá ver a ID da carga de trabalho maui-android listada junto com a versão instalada.
Para criar e depurar um aplicativo MAUI do .NET, você precisará ter uma plataforma de destino válida compatível com o sistema operacional do computador de desenvolvimento. A tabela a seguir lista as plataformas de destino com suporte em cada sistema operacional:
| Seu sistema operacional |
Plataformas de destino com suporte |
| Windows |
Windows, Android |
| macOS |
Android, iOS, macOS |
| Linux |
Android |
A criação de um aplicativo MAUI do .NET para Android e para plataformas Apple exige que você execute configurações e configurações adicionais.
Android
O processo para configurar seu computador para o desenvolvimento do .NET MAUI no Android com o Visual Studio Code é:
Baixar e instalar o SDK do Java
Para baixar e instalar o SDK do Java e configurar o Visual Studio Code para usá-lo:
Baixe e instale Microsoft OpenJDK 17. Para obter informações sobre como instalar o OpenJDK, consulte Instalar o Microsoft Build do OpenJDK.
Como alternativa, em vez de baixar e instalar manualmente o SDK do Java, você pode usar o InstallAndroidDependencies destino de build para instalar o SDK do Java (e o SDK do Android). Para obter mais informações, consulte Usando o alvo InstallAndroidDependencies.
Importante
Observe o local no qual o OpenJDK está instalado, pois isso é necessário na próxima etapa.
Verifique se você configurou o caminho para o OpenJDK por meio de uma das seguintes abordagens:
Defina a variável de ambiente JAVA_HOME para definir o caminho do SDK do Java para seu computador. Essa é a abordagem recomendada, que define o caminho do SDK do Java no nível do computador.
Observação
Se você instalar o OpenJDK no Windows via MSI, poderá optar por ativar a configuração que define a variável ambiental JAVA_HOME.
No Visual Studio Code, pressione CTRL+SHIFT+P no Windows ou CMD+SHIFT+P no macOS e selecione .NET MAUI: Configurar o Android, em seguida Selecione o Local do SDK do Java para definir o caminho do SDK do Java no nível do usuário ou espaço de trabalho.
Configure o caminho do SDK do Java em seu arquivo .csproj definindo a propriedade $(JavaSdkDirectory) MSBuild para o caminho OpenJDK. Isso definirá o caminho do SDK do Java no nível do projeto.
Baixar e instalar o SDK do Android
Para baixar e instalar o SDK do Android e configurar o Visual Studio Code para usá-lo:
Baixe e instale o SDK do Android por meio de uma das seguintes abordagens:
- Baixe e instale o SDK do Android criando um novo projeto do .NET MAUI e, em seguida, utilize o alvo de build
InstallAndroidDependencies para ajudar a configurar seu ambiente Android. Essa é a abordagem recomendada. Para obter mais informações, consulte Usando o alvo InstallAndroidDependencies.
- Baixe e instale o SDK do Android no Windows instalando a carga de trabalho de desenvolvimento do .NET MAUI no Visual Studioe, em seguida, criando e executando um aplicativo .NET MAUI no Android. Esse processo garantirá que o SDK do Android e um emulador android estejam instalados.
- Baixe e instale o SDK do Android por meio do Android Studio. Para obter mais informações, consulte Instalar o Android Studio no developer.android.com.
- Baixe e instale o SDK do Android por meio do gerenciador de pacotes preferido no Linux.
Verifique se você configurou o caminho para o SDK do Android por meio de uma das seguintes abordagens:
- Defina a variável de ambiente
ANDROID_HOME para definir o caminho do SDK do Android para seu computador. Essa é a abordagem recomendada, que define o caminho do SDK do Android no nível do computador.
- No Visual Studio Code, pressione CTRL+SHIFT+P no Windows ou CMD+SHIFT+P no macOS e selecione .NET MAUI: Configurar o Android, seguido por selecionar o local do SDK do Android para definir o caminho do SDK do Android no nível do usuário/workspace.
- Configure o caminho do SDK do Android em seu arquivo .csproj definindo a propriedade
$(AndroidSdkDirectory) MSBuild para o caminho do SDK do Android. Isso definirá o caminho do SDK do Android no nível do projeto.
No Visual Studio Code, verifique se seu ambiente Android está configurado corretamente pressionando CTRL+SHIFT+P no Windows ou CMD+SHIFT+P no macOS e selecionando .NET MAUI: Configurar o Android, seguido por Atualizar ambiente android. Todos os erros detectados devem ser resolvidos:
- Na paleta de comandos, selecione .NET MAUI: Configure o Android, em seguida, escolha tanto quanto Selecione o local do SDK do Android e e verifique se eles apontam corretamente para as instalações de cada um. No Windows, se você instalar os SDKs por meio do Visual Studio, o OpenJDK estará localizado em C:\Arquivos de Programas\Microsoft e o SDK do Android estará localizado em C:\Arquivos de Programas (x86)\Android\android-sdk.
- Verifique se sua pasta do SDK do Android tem subpastas, como de ferramentas de build, cmdline-tools e de ferramentas de plataforma.
- Verifique se a pasta OpenJDK tem subpastas, como bin, libe muito mais.
- Verifique se a variável de ambiente
ANDROID_HOME está definida como o caminho do SDK do Android.
- Verifique se a variável de ambiente
JAVA_HOME está definida como o caminho do SDK do Java.
- Se as licenças do Android não tiverem sido aceitas, em um terminal com privilégios elevados, navegue até a pasta cmdline-tools/{version}/bin do SDK do Android e execute
sdkmanager --licenses e siga os prompts da CLI.
Usando o destino InstallAndroidDependencies
A abordagem recomendada para instalar as dependências necessárias para seu projeto .NET MAUI no Android é executar o InstallAndroidDependencies destino do MSBuild. Esse destino instalará o SDK do Android para você, se ele ainda não estiver instalado.
Em um terminal, crie um novo projeto .NET MAUI:
dotnet new maui -n "MyMauiApp"
Em um terminal, altere o diretório para myMauiAppe compile o aplicativo ao especificar o destino de build InstallAndroidDependencies:
cd MyMauiApp
dotnet build -t:InstallAndroidDependencies -f:net9.0-android -p:AndroidSdkDirectory="/path/to/sdk" -p:AcceptAndroidSDKLicenses=True
Observação
O destino InstallAndroidDependencies MSBuild também poderá instalar o SDK do Java se a propriedade JavaSdkDirectory MSBuild for fornecida.
No comando acima:
-
-p:AndroidSdkDirectory="/path/to/sdk" instala ou atualiza as dependências do Android para o caminho absoluto especificado. Os caminhos sugeridos são %LOCALAPPDATA%/Android/Sdk no Windows e $HOME/Library/Android/sdk no macOS.
-
-p:AcceptAndroidSDKLicenses=True aceita as licenças necessárias do Android para desenvolvimento.
- (opcional)
-p:JavaSdkDirectory="/path/to/sdk" instala o SDK do Java no caminho absoluto especificado.
Tente evitar o uso de caminhos que contenham espaços ou caracteres não ASCII.
Baixar e instalar um emulador do Android
Para baixar e instalar um emulador android no qual executar seus aplicativos:
Em um terminal, navegue até o {YOUR_ANDROID_SDK_FOLDER}/cmdline-tools/{version}/bin/.
Em um terminal, use o comando sdkmanager para baixar e instalar um emulador android:
No Windows, execute os seguintes comandos:
sdkmanager --install emulator
sdkmanager --install "system-images;android-35;google_apis;x86_64"
No macOS, execute os seguintes comandos:
./sdkmanager --install emulator
./sdkmanager --install "system-images;android-35;google_apis;arm64-v8a"
Observação
O comando acima pressupõe um Apple Silicon Mac. Para um Intel Mac, substitua arm64-v8a por x86_64.
Para obter mais informações sobre o comando sdkmanager, consulte sdkmanager no developer.android.com.
Em um terminal, use o comando avdmanager para criar um novo emulador android:
No Windows, execute os seguintes comandos:
avdmanager create avd -n MyAndroidVirtualDevice-API35 -k "system-images;android-35;google_apis;x86_64"
No macOS, execute os seguintes comandos:
./avdmanager create avd -n MyAndroidVirtualDevice-API35 -k "system-images;android-35;google_apis;arm64-v8a"
Observação
O comando acima pressupõe um Apple Silicon Mac. Para um Intel Mac, substitua arm64-v8a por x86_64.
Para obter mais informações sobre o comando avdmanager, consulte avdmanager no developer.android.com.
iOS e macOS
Para configurar seu Mac para o desenvolvimento de .NET MAUI no iOS e Mac Catalyst com o Visual Studio Code:
Instale a versão do Xcode exigida pela versão do MAUI do .NET que você está usando. Para obter informações, consulte Versões de lançamento. A última versão estável do Xcode pode ser baixada na Apple App Store.
Em um terminal, execute o seguinte comando para adquirir as ferramentas de linha de comando do Xcode:
xcode-select --install
Inicie o Xcode e aceite quaisquer contratos de licença. Se os simuladores não começarem a ser instalados, navegue até Configurações > do Xcode > Componentes e instale os runtimes de simulador escolhidos.
No Visual Studio Code, verifique se o ambiente da Apple está configurado corretamente pressionando CMD+SHIFT+P e, em seguida, selecionando .NET MAUI: Configurar o Apple, seguido por Atualizar ambiente da Apple. Todos os erros detectados devem ser resolvidos:
- Verifique se você executou
xcode-select --install em um terminal.
- Se você receber um erro que o Xcode não foi encontrado, execute
xcode-select -p em um terminal e verifique se ele retorna um caminho para a instalação do Xcode.
- Abra o Xcode para garantir que ele seja carregado corretamente e, em seguida, navegue até Configurações do Xcode Local e verifique se o campo ferramentas de linha de comando está apontando para a instalação correta do Xcode.
Solução de problemas
Se você encontrar problemas ao instalar a extensão do .NET MAUI no Visual Studio Code, mais informações sobre os problemas poderão ser encontradas navegando até a janela de Saída do (CTRL+SHIFT+U no Windows ou CMD+SHIFT+U no macOS) e selecionando do .NET MAUI na lista suspensa.
Fornecer comentários
Para fornecer comentários sobre a extensão do .NET MAUI de dentro do Visual Studio Code, navegue até a caixa de diálogo Ajuda > Relatar Problema. Em seguida, selecione "Relatório de Bug" como o valor da lista suspensa Esta é uma, "Uma extensão do VS Code" como o valor da lista suspensa Para, e ".NET MAUI" como o valor da lista suspensa Extensão.
