Tutorial .NET MAUI – Crie seu primeiro aplicativo multiplataforma em C#

Baixar e instalar

Baixe e instale o Visual Studio 2022.

Baixar o Visual Studio 2022

Durante a instalação, a carga de trabalho de desenvolvimento do .NET Multi-Platform App UI deve ser selecionada. O uso do link acima deve pré-selecionar todos os pré-requisitos corretamente, conforme mostrado na imagem a seguir:

Instalador do Visual Studio com o desenvolvimento móvel com a carga de trabalho do .NET selecionada

Já tem o Visual Studio 2022?

Se você já tiver o Visual Studio 2022, certifique-se de que ele esteja atualizado e de que a carga de trabalho necessária esteja instalada:

  • Selecione a tecla Windows, digite Instalador do Visual Studio e pressione Enter.
  • Se solicitado, permita que o instalador se atualize.
  • Se uma atualização para o Visual Studio 2022 estiver disponível, um botão de Atualizar será exibido. Selecione-o para atualizar antes de modificar a instalação. Este tutorial só funciona com Visual Studio 2022 17.12 e versões posteriores.
  • Localize sua instalação do Visual Studio 2022 e selecione Modificar.
  • Selecione Desenvolvimento do .NET Multi-Platform App UI.
  • Selecione o botão Modificar.
  1. Baixe e instale o SDK do .NET. Após a conclusão do download, inicie o download para iniciar a instalação.

    Baixar o SDK do .NET 9 x64 (Intel)
    Baixar o SDK do .NET 9 Arm64 (Apple Silicon)

    Se você estiver em um Mac com um chip Apple M1 ou M2, precisará instalar a versão Arm64 do SDK.

  2. Baixe e instale o VS Code:

    Baixar o VS Code

  3. Abra o VS Code e selecione o botão Extensões na Barra de Atividades do VS Code à esquerda. Digite MAUI na barra de pesquisa, selecione .NET MAUI e, em seguida, selecione o botão Instalar na página da extensão .NET MAUI.

    Extensão MAUI do VS Code

    Essa extensão vem com o Kit de Desenvolvimento do C# e as extensões C#, que são necessárias para a execução da extensão .NET MAUI.

    Dependências da Extensão MAUI do VS Code

  4. Abra um novo terminal e instale a carga de trabalho .NET MAUI executando o seguinte comando:

    Terminal
    sudo dotnet workload install maui

    Se a instalação for bem-sucedida, você deverá ver uma saída semelhante à seguinte:

    Terminal
    Successfully installed workload maui

Verifique se tudo foi instalado corretamente

Depois de configurar seu ambiente, abra um novo terminal do VS Code. Na barra de ferramentas, selecione Terminal e, em seguida, Novo Terminal.

Novo Terminal do VS Code

No terminal, execute o comando a seguir para verificar sua instalação.

Terminal
dotnet workload list

Executar o comando da lista de cargas de trabalho dotnet no VS Code Terminal

Se a instalação for bem-sucedida, você deverá ver uma saída semelhante à seguinte:

Terminal
Installed Workload Id      Manifest Version      Installation Source
--------------------------------------------------------------------
maui                       8.0.82/8.0.100        SDK 8.0.400

Use `dotnet workload search` to find additional workloads to install.

Encontrou um erro?

Se você receber um erro do tipo O 'dotnet' não é reconhecido como um comando interno ou externo, verifique se você abriu um novo terminal do VS Code. Se reiniciar o VS Code ou reiniciar seu computador não resolver o problema, use o botão Encontrei um problema na parte inferior da página para obter ajuda para corrigir o problema.

Instalar o Xcode

Para criar aplicativos .NET MAUI, você também precisará de:

  1. Última versão do Xcode

    Para localizar a versão mais recente do Xcode que é compatível com o .NET MAUI, verifique esta referência de versão de lançamento. Vá para a coluna Ferramentas da Apple para encontrar a versão mais recente compatível do Xcode.

  2. Uma ID da Apple

    Se você ainda não tiver uma ID da Apple, poderá criar uma nova em https://appleid.apple.com. Uma ID da Apple é necessária para instalar e entrar no Xcode.

  3. Depois de instalar o Xcode, você deve abrir o Xcode e concordar com os contratos de licença e instalar componentes opcionais, se solicitado.

  4. Quando perguntado para quais plataformas você gostaria de desenvolver, selecione as plataformas macOS e iOS e, em seguida, selecione Baixar e Instalar.

    Prompt do Xcode para instalar as plataformas macOS e iOS

  5. Abra um novo terminal e instale as ferramentas de desenvolvedor de linha de comando do Xcode executando o seguinte comando:

    Terminal
    xcode-select --install

    Quando solicitado a instalar as ferramentas de desenvolvedor de linha de comando do Xcode, selecione Instalar. Por fim, concorde com o contrato de licença.

    O prompt do Xcode para instalar ferramentas de desenvolvedor de linha de comando

Se tudo estiver certo, selecione o botão Continuar abaixo para ir para a próxima etapa.

Continuar