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

Executar em um dispositivo móvel

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.

Ativar Hyper-V

Na sua Barra do Windows Search, digite Recursos do Windows e selecione Ativar ou desativar recursos do Windows.

Ativar ou desativar os recursos do Windows

Verifique se a caixa Hypter-V está marcada e selecione Ok.

Recursos do Windows com a caixa Hyper-v marcada

Você precisará reinicializar seu computador nesse momento para que a alteração entre em vigor.

Instalação do SDK do Android

Abra o Visual Studio e sua solução MyFirstMauiApp. No menu suspenso de destino de depuração, selecione net8.0-android no Framework.

Selecionar Android como implantação de destino

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.

Mensagem de erro na janela Lista de Erros mostrando que a licença SDK do Android não foi aceita.

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.

Prompt SDK do Android solicitando que o usuário instale uma versão SDK do Android específica para compilar o projeto.

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.

O menu da barra de ferramentas do Visual Studio 2022 mostrando “Android Emulator” como destino de depuração.

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.

Caixa de diálogo para criar um novo Android Emulator com as configurações padrão preenchidas.

Após a criação do emulador, você verá um botão que indica Iniciar. Clique nele.

Gerenciador do emulador do Android mostrando que o emulador foi criado e está pronto para ser executado.

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.

Solicitação para habilitar a Plataforma do Hipervisor do Windows

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.

Menu da barra de ferramentas do Visual Studio 2022 mostrando o emulador do Android recém-criado como um destino de depuração.

Quando estiver totalmente concluído, você o verá exibido no menu de depuração do Visual Studio.

Menu da barra de ferramentas do Visual Studio 2022 mostrando o emulador do Android recém-criado como um destino de depuração.

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

  1. Vá para a tela Configurações.
  2. Localize número de build usando Pesquisar na parte superior da tela de configurações ou localize-o em Sobre telefone.
  3. Toque em Número da compilação 7-10 vezes até aparecer "Agora você é um desenvolvedor!".

Tela de configurações do dispositivo Android na tela sobre telefone exibindo o número da versão.

Verificar o status de depuração de USB

  1. Vá para a tela Configurações.
  2. Localize depuração de USB usando o Pesquisar na parte superior da tela de configurações ou nas Opções do desenvolvedor.
  3. Habilitar Depuração de USB se ainda não estiver habilitada.

Tela de configurações do dispositivo Android na tela sobre configurações do desenvolvedor exibindo a opção de depuração de USB ativada.

Dispositivo de confiança

  1. Conecte seu dispositivo ao computador.
  2. Você será solicitado a Permitir depuração USB.
  3. Marque a caixa Sempre permitir deste computador.
  4. Clique em Permitir.

Prompt do dispositivo Android para permitir a depuração USB no dispositivo do computador.

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!

Executar no Android

Verifique se o dispositivo ou o emulador está selecionado como um destino de depuração.

Android Emulator Pixel 5 definido como 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.

Seu aplicativo será compilado, implantado no dispositivo/emulador Android selecionado e executado.

Emulador do Android executando o aplicativo .NET MAUI. Uma mensagem 'Hello, World!' é exibida.

Você pode implementar em uma ou mais plataformas com base em seu ambiente de desenvolvimento. Você acabou de executar e implantar seu aplicativo no macOS. Agora, vamos implantar no iOS.

Feche o aplicativo .NET MAUI que você estava executando e retorne ao VS Code.

Clique nas chaves no canto inferior direito da janela do VS Code na barra de status e selecione Depurar Destino.

Meu Mac selecionado como implantação de destino por padrão

Role a tela para baixo e selecione iPhone 15.

Lista de destinos de depuração com o iPhone 15 realçado

Agora você deve ver iOS: iPhone 15 como o novo destino de depuração.

Destino de depuração atualizado para mostrar o iPhone 15

Para executar o aplicativo, clique no ícone Executar e depurar na barra de atividades do VS Code. Em seguida, clique em Executar e Depurar.

Painel de execução e depuração do VS Code

Seu aplicativo será criado e implantado no simulador do iPhone. Observe que isso pode demorar um pouco, pois é praticamente como ligar um iPhone!

Aplicativo .NET MAUI em execução no simulador de iOS

Continuar