Durante a instalação, a carga de trabalho de desenvolvimento de interface do usuário de aplicativo de várias plataformas .NET deve ser selecionada. O uso do link acima deve pré-selecionar todos os pré-requisitos corretamente, conforme mostrado na imagem a seguir:
Já tem o Visual Studio 2022?
Se você já possui o Visual Studio 2022, pode atualizar sua instalação para adicionar suporte a .NET MAUI:
Selecione a tecla Windows, digite Instalador do Visual Studio e pressione Enter.
Se solicitado, permita que o instalador se atualize.
Se uma atualização do Visual Studio 2022 estiver disponível, um botão Atualizar será mostrado. Selecione-o para atualizar antes de modificar a instalação.
Localize sua instalação do Visual Studio 2022 e selecione Modificar.
Selecione Desenvolvimento de interface do usuário de aplicativo de várias plataformas do .NET.
Durante a instalação, verifique se as seguintes cargas de trabalho estão selecionadas:
.NET
.NET MAUI
Android
iOS
As duas últimas cargas de trabalho (Android e iOS) devem ser selecionadas automaticamente assim que você selecionar .NET MAUI.
Verifique se há atualizações do Visual Studio
Este tutorial é otimizado para a última versão do Visual Studio para Mac. Se você já tem o Visual Studio 2022 para Mac, poderá verificar se há atualizações:
Abra Visual Studio para Mac.
Na barra de menus, clique em Visual Studio > Verificar se há atualizações.
As atualizações disponíveis serão exibidas e selecione Atualizar.
Instalar o Xcode
Para criar aplicativos .NET MAUI, você também precisará de:
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.
Depois de instalar o Xcode, você deve abrir o Xcode, concordar com os termos de serviço e instalar componentes opcionais, se solicitado.
Criar seu aplicativo
Criar um novo aplicativo .NET MAUI:
Abra o Visual Studio 2022.
Selecione o botão Criar um novo projeto.
Na janela Criar um novo projeto selecione MAUI na lista suspensa Todos os tipos de projeto selecione o modelo Aplicativo .NET MAUI e, em seguida, clique no botão Avançar.
Na janela Configurar seu novo projeto, insira MyFirstMauiApp como o nome do projeto e clique no botão Avançar.
Na janela Informações adicionais, selecione .NET 7.0 (Standard Term Support) no menu suspenso Estrutura, se ainda não estiver selecionado, e clique no botão Criar.
Visual Studio cria o novo projeto. Se você receber um aviso de Alerta de Segurança do Windows sobre o firewall bloqueando alguns recursos, selecione o botão Permitir acesso.
Aguardar o processo de restauração de pacotes NuGet
O NuGet é um gerenciador de pacotes que trará as dependências de seu novo aplicativo.
O processo de restauração do pacote será iniciado automaticamente. Aguarde até a mensagem de Restaurada ou Pronta exibida na barra de status na parte inferior esquerda da tela.
Abra o Visual Studio 2022 para Mac.
Na janela inicial, clique em Novo para criar um novo projeto.
Na janela Escolher um modelo para seu novo projeto, selecione Multiplataforma > Aplicativo, selecione o modelo Aplicativo .NET MAUI e clique no botão Continuar.
Na janela Configurar seu novo aplicativo .NET MAUI, selecione .NET 7.0 no menu suspenso Estrutura de destino se ainda não estiver selecionado e clique no botão Continuar:
Insira MyFirstMauiApp como o nome do projeto e clique no botão Criar.
Executar seu aplicativo
Este tutorial se concentrará na implantação de um aplicativo .NET MAUI em seu computador Windows local primeiro. Posteriormente, você terá a opção de configurar um dispositivo ou emulador Android.
Na barra de ferramentas do Visual Studio, você deve ver Windows Machine como o destino de depuração por padrão. Pressione o botão Windows Machine para compilar e executar o aplicativo:
Se você ainda não habilitou o modo de desenvolvedor, o Visual Studio solicitará que você o habilite. Na caixa de diálogo Ativar modo de Desenvolvedor para Windows, clique no link configurações para desenvolvedores para abrir o aplicativo Configurações:
Ative a alternância em Modo de Desenvolvedor.
A caixa de diálogo Usar recursos de desenvolvedor é exibida. Selecione Sim para confirmar que você deseja habilitar o modo de desenvolvedor.
Feche o aplicativo Configurações e, em seguida, feche a caixa de diálogo Ativar modo de Desenvolvedor para Windows. O aplicativo deve começar a ser executado.
No aplicativo em execução, selecione o botão Clique em mim algumas vezes e observe que a contagem do número de cliques no botão é incrementada:
Este tutorial se concentrará na implantação de um aplicativo .NET MAUI em seu computador Mac local primeiro. Posteriormente, você terá a opção de configurar um dispositivo ou emulador Android.
Na barra de ferramentas do Visual Studio, você verá Meu Mac como o destino de depuração por padrão. Pressione o ícone de reprodução (▶) para compilar e executar o aplicativo:
No aplicativo em execução, selecione o botão Clique em mim algumas vezes e observe que a contagem do número de cliques no botão é incrementada:
Parabéns, você criou e executou seu primeiro aplicativo .NET MAUI! Mantenha o aplicativo em execução e continue o tutorial.
Editar seu código
Ao desenvolver aplicativos com .NET MAUI, Recarga Dinâmica de XAML está disponível quando você está depurando seu aplicativo. Isso significa que você pode alterar a interface do usuário XAML enquanto o aplicativo está em execução e a interface do usuário será atualizada automaticamente.
Volte para o Visual Studio e deixe o aplicativo em execução. No Solution Explorer, clique duas vezes no arquivo MainPage.xaml no projeto MyFirstMauiApp. Se você não vir o painel Gerenciador de Soluções, selecione Exibir > Solution Explorer no menu principal (ou pressione CTRL+ALT+L).
Volte para o Visual Studio e deixe o aplicativo em execução. Na janela Solução, clique duas vezes no arquivo MainPage.xaml no projeto MyFirstMauiApp. Se você não vir a janela Solução, selecione Exibir > Solução no menu principal.
Atualmente, o Text do primeiro Label está definido para dizer Hello, World! conforme mostrado no código a seguir:
A interface do usuário do aplicativo é atualizada automaticamente à medida que você faz alterações.
Ao desenvolver aplicativos com o .NET MAUI, você também pode usar o .NET Recarga Dinâmica para recarregar seu código C#. Vamos modificar a lógica no aplicativo para incrementar a contagem em 10 em vez de 1 quando você clicar no botão.
Abrir MainPage.xaml.cs (esse arquivo está aninhado em MainPage.xaml ou você pode clicar com o botão direito do mouse e selecionar Exibir Código no menu).
O método OnCounterClicked nesse arquivo atualmente tem o seguinte código:
Para aplicar as alterações de código, selecione o botão Recarga Dinâmica no Visual Studio ou selecione ALT+F10.
Selecione o botão Clique em mim e veja-o aumentar em 10. Muito bem! Você pode fechar o aplicativo em execução agora.
Configurar dispositivo Android
Você pode decidir implantar em uma ou mais plataformas com base em seu ambiente de desenvolvimento. Você acabou de executar e implantar seu aplicativo no Windows. Agora, vamos configurar um dispositivo ou emulador Android.
Instalação do SDK do Android
No menu suspenso do destino de depuração, selecione net7.0-android em Estrutura.
Versões específicas do SDK do Android são necessárias para compilar projetos. Se você não aceitou a licença SDK do Android, verá a seguinte mensagem de erro na janela Lista de Erros.
Clique duas vezes na mensagem para iniciar o processo de aceitação da licença. Clique em Aceitar para cada uma das licenças presentes e a instalação automática será iniciada.
Configurar o emulador do Android
Se você não tiver um dispositivo Android para implantar, siga estas etapas para configurar um emulador do Android. Se você já fez isso ou deseja usar seu próprio dispositivo Android, pode pular esta etapa.
Se esta for a primeira vez que você cria um .NET MAUI aplicativo, você verá Android Emulator selecionado no menu suspenso de destino de depuração. Clique nele para iniciar o processo de criação. Se uma caixa de diálogo de aceitação de licença aparecer, selecione Aceitar.
Isso abre a janela Novo dispositivo. Selecione o botão Criar para criar um emulador com as configurações padrão. Isso baixará as imagens do emulador e finalizará a criação do emulador para uso no Visual Studio. Esta etapa pode demorar um pouco.
Após a criação do emulador, você verá um botão que indica Iniciar. Clique nele.
Você pode receber uma solicitação para habilitar a plataforma de hipervisor do Windows. Siga a documentação para habilitar a aceleração para melhorar o desempenho (necessário para colocar o emulador em funcionamento).
O emulador do Android será iniciado. Aguarde a conclusão completa da inicialização e você o verá exibido no menu de depuração do Visual Studio. Isso pode levar algum tempo.
Seu Android Emulator foi agora criado e está pronto para ser usado. Da próxima vez que você executar o Visual Studio, o emulador aparecerá diretamente na janela de destino de depuração e será iniciado quando você selecioná-lo. Se você tiver qualquer problema ou tiver problemas de desempenho com o emulador, leia a documentação de instalação completa.
Decida se quer implantar em uma ou mais plataformas com base em seu ambiente de desenvolvimento. Você acabou de executar e implantar seu aplicativo no Mac. Agora, vamos configurar um dispositivo ou emulador Android.
Se esta for a primeira vez que cria um aplicativo .NET MAUI, será necessário criar um novo Android Emulator. Você verá Android Emulator no menu de depuração. Pressione o ícone de reprodução (▶) para iniciar o processo de criação.
As opções são preenchidas automaticamente para um emulador base. Se necessário, altere as opções e, em seguida, clique em Criar.
Neste ponto, você poderá ser solicitado a concordar com o contrato de licença do emulador do Android. Leia e clique em Aceitar para continuar o processo. Isso baixará as imagens do emulador e finalizará a criação do emulador para uso no Visual Studio.
Após a criação do emulador, você verá um botão que indica Executar. Clique nele.
O emulador do Android será iniciado. Aguarde a conclusão completa da inicialização e você o verá exibido no menu de depuração do Visual Studio. Isso pode levar algum tempo se você não estiver usando a aceleração de hardware.
Seu Android Emulator foi agora criado e está pronto para ser usado. Da próxima vez que você executar o Visual Studio, o emulador aparecerá diretamente na janela de destino de depuração e será iniciado quando você selecioná-lo. Se você tiver qualquer problema ou tiver problemas de desempenho com o emulador, leia a documentação de instalação completa.
Configurar dispositivo Android
Para desenvolver com seu dispositivo Android, a depuração USB precisa ser habilitada. Siga estas etapas no dispositivo para conectá-lo ao Visual Studio. Se você não tiver um dispositivo Android, poderá ignorar esta seção.
Habilitar o modo de desenvolvedor
Vá para a tela Configurações.
Localize número de build usando Pesquisar na parte superior da tela de configurações ou localize-o em Sobre telefone.
Toque em Número da compilação 7-10 vezes até aparecer "Agora você é um desenvolvedor!".
Verificar o status de depuração de USB
Vá para a tela Configurações.
Localize depuração de USB usando o Pesquisar na parte superior da tela de configurações ou nas Opções do desenvolvedor.
Habilitar Depuração de USB se ainda não estiver habilitada.
Dispositivo de confiança
Conecte seu dispositivo ao computador.
Você será solicitado a Permitir depuração USB.
Marque a caixa Sempre permitir deste computador.
Clique em Permitir.
Seu dispositivo está configurado agora e será exibido no Visual Studio como um destino de implantação.
Seu emulador ou dispositivo agora deve ser configurado para implantação!
Executar no Android
Verifique se o dispositivo ou o emulador está selecionado como um destino de depuração.
No menu, selecione Depurar > Iniciar Depuração (ou pressione F5). Se essa opção estiver desabilitada, verifique se um emulador ou dispositivo está selecionado.
No menu, selecione Depurar > Iniciar Depuração. Se essa opção estiver desabilitada, verifique se um emulador ou dispositivo está selecionado.
Seu aplicativo será compilado, implantado no dispositivo/emulador Android selecionado e executado.
Próximas etapas
Parabéns, você criou e executou seu primeiro aplicativo .NET MAUI!
Continuar aprendendo
Agora que você tem as noções básicas, continue aprendendo a criar aplicativos .NET MAUI com o roteiro de aprendizagem autoguiado no Microsoft Learn.