Para começar a desenvolver aplicativos .NET MAUI nativos multiplataforma no Windows, instale o Visual Studio 2022 17.8 ou superior seguindo as etapas de instalação.
Pré-requisitos
- Visual Studio 2022 17.8 ou superior. Para obter informações sobre sistemas operacionais com suporte, hardware, linguagens com suporte e requisitos e diretrizes adicionais, confira Requisitos do Sistema do Visual Studio 2022.
Para compilar, assinar e implantar aplicativos .NET MAUI para iOS, você também precisará de:
Como alternativa, para implantar compilações de depuração do seu aplicativo diretamente do Windows para o seu dispositivo iOS com a reinicialização dinâmica, você precisará de:
Instalação
Para criar aplicativos .NET MAUI, você precisará da versão mais recente do Visual Studio 2022:
Instale o Visual Studio ou modifique a instalação existente e instale a carga de trabalho de desenvolvimento do .NET Multi-platform App UI com suas opções de instalação opcionais padrão:
Para começar a desenvolver aplicativos .NET MAUI nativos multiplataforma no macOS, instale o Visual Studio 2022 para Mac 17.6 seguindo as etapas de instalação.
Pré-requisitos
Para compilar, assinar e implantar aplicativos .NET MAUI para iOS ou macOS, você também precisará de:
Instalação
Para criar aplicativos .NET MAUI, você precisará do Visual Studio para Mac mais recente:
Instale o Visual Studio 2022 para Mac ou modifique a instalação existente e verifique se as seguintes cargas de trabalho estejam instaladas:
- .NET
- .NET MAUI
- Android
- iOS
Importante
Para novas instalações do Visual Studio 2022 para Mac, a seleção da carga de trabalho do .NET MAUI selecionará automaticamente as cargas de trabalho do Android e iOS, que são atualmente necessárias para o desenvolvimento do .NET MAUI.
Instale o .NET 8 por meio do instalador autônomo.
Após a instalação do .NET 8, execute dotnet workload install maui
em um terminal.
Importante
Para usar o Visual Studio para Mac com o .NET 8, habilite a caixa de seleção Visual Studio > Preferências > Outros > Versões Prévias de Recurso > Usar o SDK do .NET 8 se instalado (requer reinicialização).
Se você tiver problemas de rede durante a instalação em um ambiente corporativo, examine as instruções em instalação por trás de um firewall ou proxy.
Instalação atrás de um firewall ou servidor proxy
Para instalar o Visual Studio 2022 para Mac atrás de um firewall, determinados pontos de extremidade devem estar acessíveis para permitir downloads das ferramentas e atualizações necessárias para o seu software. Para obter mais informações sobre como configurar sua rede para permitir acesso aos pontos de extremidade necessários, confira Instalar e usar o Visual Studio para Mac atrás de um firewall ou servidor proxy.
Instalar o Visual Studio Code e a extensão do .NET MAUI
Instalar o Visual Studio Code.
Na guia Extensões, pesquise ".NET MAUI" e instale a extensão do .NET MAUI. 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.
Observação
A extensão do .NET MAUI requer o Kit de Desenvolvimento do C# e as extensões C# de pré-lançamento. Você deve entrar no Kit de Desenvolvimento do C# para usar a funcionalidade da extensão do .NET MAUI. Confira esta postagem no blog para obter mais informações sobre o Kit de Desenvolvimento do C# e sua família de extensões.
Instalar cargas de trabalho do .NET e .NET MAUI
Instale o .NET 8.
No Windows, é recomendável usar o instalador do Visual Studio para gerenciar as instalações de carga de trabalho do .NET e .NET MAUI. As instruções sobre como usar o instalador do Visual Studio podem ser encontradas aqui.
Instale a carga de trabalho do .NET MAUI.
No Windows e no macOS, execute o seguinte comando em um terminal:
dotnet workload install maui
No Linux, execute o seguinte comando em um terminal:
dotnet workload install maui-android
Para depurar um aplicativo .NET MAUI no Visual Studio Code, você precisa ter uma plataforma de destino válida para o sistema operacional do computador de desenvolvimento:
Seu sistema operacional |
Plataformas de destino com suporte |
Windows |
Windows, Android |
macOS |
Android, iOS, macOS |
Linux |
Android |
iOS e macOS
Para depurar para um destino iOS ou macOS no 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 versão estável mais recente do Xcode pode ser baixada na Mac App Store.
- Execute
xcode-select --install
em um terminal para adquirir as ferramentas de linha de comando do Xcode.
Android
Para depurar para um destino do Android no Visual Studio Code:
- Instale o Microsoft OpenJDK 17.
- Instale o SDK do Android por meio de uma das seguintes abordagens:
- (Recomendado) Crie um novo projeto do .NET MAUI (
dotnet new maui
) e use o destino InstallAndroidDependencies.
- Instale por meio do Visual Studio (somente Windows).
- Instale por meio do Android Studio.
- Instale por meio do gerenciador de pacotes preferido no Linux.
Solução de problemas
Você pode enfrentar problemas ao configurar a extensão do .NET MAUI para o Visual Studio Code. Se você ainda estiver enfrentando problemas depois de seguir as etapas de solução de problemas abaixo, relate o problema.
Criação do projeto
Se você tentar criar um novo projeto e o explorador de arquivos continuar aparecendo em um loop infinito, talvez você não esteja selecionando uma pasta vazia. Verifique se não há arquivos ou pastas ocultos, crie uma nova pasta ou crie seu aplicativo .NET MAUI a partir da linha de comando usando dotnet new maui
.
Usando o destino InstallAndroidDependencies
O .NET 8 tem um destino de compilação que ajuda a configurar seu ambiente Android para você. Execute o seguinte comando em um terminal para configurar seu computador e configurar seu ambiente Android:
dotnet build -t:InstallAndroidDependencies -f:net8.0-android -p:AndroidSdkDirectory="<AndroidSdkPath>" -p:JavaSdkDirectory="<JavaSdkPath>" -p:AcceptAndroidSDKLicenses=True
No comando acima:
AndroidSdkDirectory="<AndroidSdkPath>"
: instala ou atualiza as dependências do Android para o caminho absoluto especificado.
- Windows: o AndroidSdkPath sugerido é
%LOCALAPPDATA%/Android/Sdk
.
- MacOS: o AndroidSdkPath sugerido é
$HOME/Library/Android/sdk
.
JavaSdkDirectory="<JavaSdkPath>"
: instala o Java no caminho absoluto especificado.
AcceptAndroidSDKLicenses=True
: aceita as licenças necessárias do Android para desenvolvimento.
Há um erro indicando que o SDK do Android ou o SDK do Java não foi encontrado.
- Abra a paleta de comandos (Ctrl/Cmd + Shift + P) e pesquise o comando
.NET MAUI: Configure Android
. Selecione "Definir caminho do SDK do Android" e "Definir caminho do JDK do Android" e valide se eles apontam para as instalações de cada um.
- A pasta SDK do Android deve ter subpastas, como
build-tools
, cmdline-tools
e platform-tools
.
- A pasta Java OpenJDK deve ter subpasta, como
bin
, lib
e muito mais.
- No Windows, se você instalar por meio do Visual Studio, o SDK do Java estará em
C:\Program Files\Microsoft\
e o SDK do Android estará em C:\Program Files (x86)\Android\android-sdk
.
- Defina a variável de ambiente
JAVA_HOME
para um caminho válido do Java OpenJDK.
- Defina a variável de ambiente
ANDROID_HOME
para o caminho do SDK do Android.
- Verifique suas versões mínimas das dependências instaladas do Android:
- build-tools >= 34.0.0
- cmdline-tools == 11.0
- platforms;android-34*
- .NET 7: platform-tools = 33.0.2
- .NET 8: platform-tools = 34.0.5
Há um erro indicando que as licenças do Android não estão sendo aceitas
Em um prompt de comando ou terminal elevado, navegue até a pasta do SDK do Android cmdline-tools/latest/bin/
, execute sdkmanager --licenses
e siga os prompts da CLI.
Minhas dependências do Android não estão carregando no Gerenciador de Soluções, mas meu aplicativo é compilado corretamente
Este é um problema conhecido se você instalar para %APPDATA%
no Windows e será corrigido em uma versão futura.
Instalação do iOS/Xcode
- Se você receber um erro indicando que o Xcode não foi encontrado, execute
xcode-select --install
em um terminal e verifique se xcode-select -p
aponta para a instalação do Xcode.
- Se você ainda estiver enfrentando problemas, abra o próprio Xcode para garantir que ele seja carregado corretamente. Assim que o Xcode estiver aberto, navegue até Xcode > Configurações > Locais e verifique se o campo Ferramentas de linha de comando está apontando para o Xcode correto.
- Há um problema conhecido: às vezes você precisa compilar seu aplicativo iOS/macOS duas vezes para que ele seja implantado. Isso será corrigido em uma versão futura.
Problemas de depuração
- A depuração pode falhar ao iniciar por vários motivos. Se não houver um erro claro na janela Saída, primeiro verifique se você está usando a configuração de execução ".NET MAUI" no Visual Studio Code.
- Você pode tentar um build de linha de comando do terminal para ver se o erro está no seu código ou na extensão do .NET MAUI. Por exemplo, você pode executar
dotnet build -f:net8.0-android
para ver se a compilação do Android é bem-sucedida fora do Visual Studio Code. Se essa compilação for bem-sucedida, Reporte um problema
Limitações conhecidas
Essa extensão ainda está em versão prévia, portanto, há uma série de limitações conhecidas. Envie-nos seus comentários sobre outros recursos que você gostaria de ver à medida que continuamos criando essa nova experiência.
- Os recursos de edição XAML são muito leves – você obtém realce de sintaxe básica e preenchimento automático. Estamos explorando como melhorar a experiência XAML em uma versão futura.
- Atualmente, você não pode alternar a estrutura de destino do IntelliSense (ele mostrará realce de sintaxe apenas na primeira estrutura de destino listada em seu arquivo .csproj). Essa capacidade está em andamento.
- Atualmente, não há suporte para Recarga Dinâmica do .NET e XAML.
- Esta extensão ainda não foi totalmente testada com os betas mais recentes do iOS e Xcode.
Envie-nos seus comentários sobre outros recursos que você gostaria de ver à medida que continuamos criando essa nova experiência!
Fornecer Comentários
Leia as Perguntas frequentes sobre o Kit de Desenvolvimento do C# e verifique os Problemas conhecidos existentes antes de registrar um novo problema ou sugestão. Você pode enviar sugestões e problemas de dentro do Visual Studio Code por meio da caixa de diálogo Ajuda > Problema de Relatório . Certifique-se de selecionar "Uma extensão" e, em seguida, a extensão do .NET MAUI no menu suspenso.