Instalação

Para começar a desenvolver aplicativos .NET MAUI nativos multiplataforma no Windows, instale o Visual Studio 2022 17.12 ou superior seguindo as etapas de instalação.

Pré-requisitos

• Visual Studio 2022 17.12 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 criar, assinar e implantar aplicativos MAUI do .NET para iOS e Mac Catalyst, você também precisará:

• Um Mac compatível com o Xcode. Para obter mais informações, consulte a documentação de requisitos mínimos da Apple.
• Uma versão específica do Xcode, que depende da versão do MAUI do .NET que você está usando. Para obter informações, consulte Versões de lançamento.
• Uma ID da Apple e uma inscrição paga no Programa de Desenvolvedores da Apple. É necessário uma ID da Apple para implantar aplicativos em dispositivos e enviar aplicativos para a Apple Store.

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:

• Uma conta de Desenvolvedor da Apple e inscrição paga no Programa de Desenvolvedores da Apple.

Instalação

1. Para criar aplicativos MAUI do .NET, você precisará baixar a versão mais recente do Visual Studio 2022:

   • Baixar o Visual Studio 2022 Community

   • Baixar o Visual Studio 2022 Profissional

   • Baixar o Visual Studio 2022 Enterprise

2. Instale o Visual Studio ou modifique sua instalação existente por meio do instalador do Visual Studio e instale a carga de trabalho de desenvolvimento de interface do usuário de aplicativo multiplataforma do .NET com suas opções de instalação opcionais padrão:

   

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á:

• Um Mac compatível com o Xcode. Para obter mais informações, consulte a documentação de requisitos mínimos da Apple.
• Uma versão específica do Xcode, que depende da versão do MAUI do .NET que você está usando. Para obter informações, consulte Versões de lançamento.
• Uma ID da Apple e uma inscrição paga no Programa de Desenvolvedores da Apple. É necessário uma ID da Apple para implantar aplicativos em dispositivos e enviar aplicativos para a Apple Store.

Instalar o Visual Studio Code

1. Para criar aplicativos MAUI do .NET, você precisará baixar a versão mais recente do Visual Studio Code:

   • Baixar o Visual Studio Code

2. 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:

1. Inicie o Visual Studio Code.

2. 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:

1. Na guia 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, confira Instalação.

Como alternativa, para instalar manualmente o SDK do .NET:

1. Baixe o instalador do .NET.

2. 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:

1. Abra um terminal.

2. 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, confira Instalação.

Como alternativa, para instalar manualmente o SDK do MAUI do .NET:

1. Abra um terminal.

2. 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:

1. Abra um terminal.

2. 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.

Configurar plataformas de destino

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:

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 é:

• Baixe e instale o SDK do Java Para obter mais informações, consulte Baixar e instalar o JDK do Java.
• Baixe e instale o SDK do Android. Para obter mais informações, consulte Baixe e instale o SDK do Android.
• Baixe e instale um emulador do Android. Para obter mais informações, consulte Fazer o download e instalar um emulador Android.

Baixar e instalar o SDK do Java

Para baixar e instalar o SDK do Java e configurar o Visual Studio Code para usá-lo:

1. 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 Usar o destino InstallAndroidDependencies.

   Importante

   Observe o local no qual o OpenJDK está instalado, pois isso é necessário na próxima etapa.

2. Verifique se você configurou o caminho para o OpenJDK por meio de uma das seguintes abordagens:

   1. 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 instalar o OpenJDK no Windows via MSI, você poderá optar por ativar a configuração que define a variável ambiental JAVA_HOME.

   2. No Visual Studio Code, pressione Ctrl+Shift+P no Windows ou Cmd+Shift+P no macOS e, em seguida, selecione .NET MAUI: Configurar o Android, seguido por Selecionar o local do SDK do Java para definir o caminho do SDK do Java no nível do usuário/workspace.

   3. 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:

1. Baixe e instale o SDK do Android por meio de uma das seguintes abordagens:

   1. 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 Usar o destino InstallAndroidDependencies.
   2. 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.
   3. 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.
   4. Baixe e instale o SDK do Android por meio do gerenciador de pacotes preferido no Linux.

2. Verifique se você configurou o caminho para o SDK do Android por meio de uma das seguintes abordagens:

   1. 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.
   2. No Visual Studio Code, pressione Ctrl+Shift+P no Windows ou Cmd+Shift+P no macOS e, em seguida, 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.
   3. 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.

3. 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 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

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:

1. Em um terminal, navegue até o {YOUR_ANDROID_SDK_FOLDER}/cmdline-tools/{version}/bin/.

2. 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.

3. 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.

   Importante

   Dispositivos Windows ARM: o emulador android requer arquitetura x64 e não tem suporte em dispositivos Windows ARM (como o Surface Pro X). Se você estiver usando um dispositivo Windows ARM, considere usar um dispositivo Android físico para teste. Para obter mais informações, confira Configurar o dispositivo Android para depuração.

iOS e macOS

Para configurar seu Mac para o desenvolvimento de .NET MAUI no iOS e Mac Catalyst com o Visual Studio Code:

1. 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.

2. Em um terminal, execute o seguinte comando para adquirir as ferramentas de linha de comando do Xcode:

   xcode-select --install
   

3. Inicie o Xcode e aceite quaisquer contratos de licença. Se os simuladores não começarem a ser instalados, navegue até Xcode > Configurações > Componentes e instale os runtimes de simulador escolhidos.

4. No Visual Studio Code, verifique se o ambiente da Apple está configurado corretamente pressionando Cmd+Shift+P e, em seguida, selecionando .NET MAUI: Configurar a Apple, seguido por Atualizar o 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 MAUI do .NET no Visual Studio Code, mais informações sobre os problemas poderão ser encontradas navegando até a janela Saída (Ctrl+Shift+U no Windows ou Cmd+Shift+U no macOS) e selecionando o .NET MAUI na lista suspensa.

Enviar 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.

Pré-requisitos

Para criar, assinar e implantar aplicativos MAUI do .NET para iOS e Mac Catalyst, você precisará:

• Um Mac compatível com o Xcode. Para obter mais informações, consulte a documentação de requisitos mínimos da Apple.
• Uma versão específica do Xcode, que depende da versão do MAUI do .NET que você está usando. Para obter informações, consulte Versões de lançamento.
• Uma ID da Apple e uma inscrição paga no Programa de Desenvolvedores da Apple. É necessário uma ID da Apple para implantar aplicativos em dispositivos e enviar aplicativos para a Apple Store.

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 .

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:

Instalar o Visual Studio Code

1. Para criar aplicativos MAUI do .NET, você precisará baixar a versão mais recente do Visual Studio Code:

   • Baixar o Visual Studio Code

2. 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:

1. Inicie o Visual Studio Code.

2. 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.

Siga as instruções no passo a passo

Depois de instalar a extensão do .NET MAUI, você será recebido pelo passo a passo do MAUI do .NET, "Introdução ao MAUI do .NET".

Clique e siga os prompts em cada etapa para configurar totalmente o ambiente do .NET MAUI e as plataformas de destino:

1. Conectar sua conta à extensão do Kit de Desenvolvimento em C#
2. Configurar seu ambiente do .NET
3. Configurar seu ambiente do .NET MAUI
4. Configurar seu ambiente iOS e macOS
5. Configurar seu ambiente Android

A etapa Configurar seu ambiente Android configurará tudo o que você precisa para ter êxito com o Android como uma plataforma de destino e a etapa Configurar seu ambiente iOS e macOS configurará tudo o que você precisa para ter êxito com o iOS e o Mac como plataformas de destino.

Este passo a passo também pode ser acessado na paleta de comandos. Selecione Bem-vindo: Abra o Passo a passo... seguido por Introdução ao MAUI do .NET.

Acessar a experiência de instalação aprimorada

1. No Visual Studio Code, pressione Ctrl+Shift+P no Windows ou Cmd+Shift+P no macOS, selecione Preferências: Abrir Configurações (interface do usuário).

   

2. Navegue até Extensões >.NET MAUI e verifique a configuração Maui > Configuração: Experiência de Configuração Aprimorada.

   

3. Retorne ao passo a passo Começando com o .NET MAUI. Verifique se você pode ver Configurar seu ambiente Android entre outras etapas no passo a passo.

   

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:

1. Na guia 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, confira Instalação.

Como alternativa, para instalar manualmente o SDK do .NET:

1. Baixe o instalador do .NET.

2. 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:

1. Abra um terminal.

2. 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, confira Instalação.

Como alternativa, para instalar manualmente o SDK do MAUI do .NET:

1. Abra um terminal.

2. 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:

1. Abra um terminal.

2. 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.

Configurar seu ambiente Android

Para configurar o ambiente de desenvolvimento do Android, basta clicar no botão Configurar Ambiente Android na etapa passo a passo Configurar seu Ambiente Android para inserir o fluxo completo de aquisição do Android.

O fluxo de aquisição do Android analisará seu ambiente Android e oferecerá a instalação de todos os componentes ausentes:

• SDK do Android e SDK do Java: componentes do SDK do Android e do SDK do Java são necessários.

  • O fluxo de aquisição do Android solicitará que você instale esses componentes diretamente ou selecione uma instalação pré-existente que você já tenha.

    

  • Para configurar ainda mais as instalações do SDK e do JDK, confira instruções sobre como instalar e configurar o Android manualmente.

• Android emulator: a instalação de um emulador android é recomendada e necessária na ausência de um dispositivo físico.

  • O fluxo de aquisição do Android solicitará que você instale um emulador padrão diretamente.

    

  • Para configurar ainda mais os emuladores, siga as instruções para instalar um emulador android manualmente.

Quando seu ambiente Android tiver sido configurado corretamente, você será notificado: "Seu ambiente Android para .NET MAUI está pronto!"

Consulte o painel de saída para obter mais detalhes sobre o status do ambiente Android.

Configurar seu ambiente iOS e macOS

Para configurar seu Mac para o desenvolvimento de .NET MAUI no iOS e Mac Catalyst com o Visual Studio Code:

1. 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.

2. Em um terminal, execute o seguinte comando para adquirir as ferramentas de linha de comando do Xcode:

   xcode-select --install
   

3. Inicie o Xcode e aceite quaisquer contratos de licença. Se os simuladores não começarem a ser instalados, navegue até Xcode > Configurações > Componentes e instale os runtimes de simulador escolhidos.

4. No Visual Studio Code, verifique se o ambiente do Xcode está configurado simplesmente clicando em Configurar o ambiente iOS e macOS na etapa passo a passo Configurar o ambiente do iOS e do macOS .

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.

Quando o ambiente Xcode tiver sido configurado corretamente, você será notificado: "Seu ambiente iOS e macOS para .NET MAUI está tudo definido!"

Enviar 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.