Configure seu ambiente de desenvolvimento e crie seu primeiro aplicativo de interface do usuário de aplicativo multiplataforma (.NET MAUI) do .NET.
Verifique os requisitos do sistema para o Visual Studio 2022.
Verifique os requisitos do sistema para Visual Studio para Mac 2022 e os requisitos mínimos para a última versão do Xcode.
10 minutos + tempo de download/instalação
Um aplicativo móvel e desktop que funciona no Windows e Android que exibe uma mensagem Hello, World!
.
Um aplicativo móvel e da área de trabalho executado no Mac e no Android que exibe uma mensagem Hello, World!
.
Baixe e instale o Visual Studio 2022.
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:
Se você já possui o Visual Studio 2022, pode atualizar sua instalação para adicionar suporte a .NET MAUI:
Baixe e instale o Visual Studio 2022 para Mac.
Baixar o Visual Studio 2022 para Mac
Durante a instalação, verifique se as seguintes cargas de trabalho estão selecionadas:
As duas últimas cargas de trabalho (Android e iOS) devem ser selecionadas automaticamente assim que você selecionar .NET MAUI.
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:
Para criar aplicativos .NET MAUI, você também precisará de:
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.
Depois de instalar o Xcode, você deve abrir o Xcode, concordar com os termos de serviço e instalar componentes opcionais, se solicitado.
Criar um novo aplicativo .NET MAUI:
Na janela Criar um novo projeto, digite MAUI App na barra de pesquisa. Selecione o modelo .NET MAUI App e clique no botão Next.
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 8.0 (Suporte a Longo Prazo) na lista suspensa Framework se ainda não estiver selecionado e clique no botão Create.
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.
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.
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.
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:
Dependendo da sua versão do Windows, essa configuração pode parecer um pouco diferente. Ative o botão de alternância em ou ao lado de 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.
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:
<Label
Text="Hello, World!"
Style="{StaticResource Headline}"
SemanticProperties.HeadingLevel="Level1" />
Atualizar o texto para ler Hello, .NET MAUI!
:
<Label
Text="Hello, .NET MAUI!"
Style="{StaticResource Headline}"
SemanticProperties.HeadingLevel="Level1" />
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:
private void OnCounterClicked(object sender, EventArgs e)
{
count++;
if (count == 1)
CounterBtn.Text = $"Clicked {count} time";
else
CounterBtn.Text = $"Clicked {count} times";
SemanticScreenReader.Announce(CounterBtn.Text);
}
Atualizar o count++;
para incrementar em 10 alterando-o para count += 10;
.
private void OnCounterClicked(object sender, EventArgs e)
{
count += 10;
if (count == 1)
CounterBtn.Text = $"Clicked {count} time";
else
CounterBtn.Text = $"Clicked {count} times";
SemanticScreenReader.Announce(CounterBtn.Text);
}
Para aplicar suas alterações de código, salve o arquivo e 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.
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.
Na sua Barra do Windows Search, digite Recursos do Windows e selecione Ativar ou desativar recursos do Windows.
Verifique se a caixa Hypter-V está marcada e selecione Ok.
Você precisará reinicializar seu computador nesse momento para que a alteração entre em vigor.
Abra o Visual Studio e sua solução MyFirstMauiApp. No menu suspenso de destino de depuração, selecione net8.0-android no Framework.
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.
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.
Não se preocupe se o Nível da API que você vê for diferente das imagens. Deve ser 33 ou superior.
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). Selecione Executar Mesmo Assim.
O emulador do Android será iniciado e será totalmente concluído quando você vir a capacidade de Stop no Gerenciador de Dispositivos Android. Isso pode levar algum tempo.
Quando estiver totalmente concluído, você o verá exibido no menu de depuração do Visual Studio.
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.
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
Verificar o status de depuração de USB
Dispositivo de confiança
Seu dispositivo está configurado agora e será exibido no Visual Studio como um destino de implantação.
Está tendo problemas? Verifique a documentação.
Seu emulador ou dispositivo agora deve ser configurado para implantação!
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.
Parabéns, você criou e executou seu primeiro aplicativo .NET MAUI!
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.
Roteiro de Aprendizagem do .NET MAUI
Permita que James o oriente na criação de um aplicativo .NET MAUI completo do início ao fim:
Você também pode estar interessado em...