Criar seu primeiro aplicativo

Neste tutorial, você criará seu primeiro aplicativo .NET MAUI no Visual Studio 2022 e o executará em um emulador Android:

O desenvolvimento de aplicativos MAUI do .NET para iOS no Windows requer um host de build do Mac. Se você não precisar direcionar especificamente para o iOS e não tiver um Mac, considere começar a usar o Android ou o Windows.

Neste tutorial, você criará seu primeiro aplicativo .NET MAUI no Visual Studio e o executará em um simulador do iOS:

Neste tutorial, você criará seu primeiro aplicativo .NET MAUI no Visual Studio 2022 e o executará no Windows:

1. Inicie o Visual Studio 2022. Na janela inicial, clique em Criar um novo projeto para criar um projeto:

   

2. Na janela Criar um novo projeto, selecione MAUI no menu suspenso Todos os tipos de projeto, selecione o modelo Aplicativo .NET MAUI e clique no botão Próximo:

   

3. Na janela Configurar seu novo projeto, nomeie seu projeto, escolha um local adequado para ele e clique no botão Próximo:

   

4. Na janela Informações adicionais, escolha a versão do .NET à qual você deseja direcionar e clique no botão Criar:

   

5. Aguarde até que o projeto seja criado e as dependências dele sejam restauradas:

   

6. Na barra de ferramentas do Visual Studio, use a lista suspensa Destino de Depuração para selecionar Emuladores Android e, em seguida, a entrada Android Emulator:

   

7. Na barra de ferramentas do Visual Studio, pressione o botão Android Emulator:

   

   O Visual Studio iniciará o processo de instalação do SDK do Android padrão e do Android Emulator.

8. Na janela SDK do Android – Contrato de Licença, pressione o botão Aceitar:

   

9. Na caixa de diálogo Controle de Conta de Usuário, pressione o botão Sim:

   

   Aguarde até que o Visual Studio baixe o SDK do Android padrão e o Android Emulator.

10. Na caixa de diálogo Controle de Conta de Usuário, pressione o botão Sim:

    

11. Na caixa de diálogo A plataforma Android SDK está ausente , pressione o botão Instalar :

    

12. Na janela SDK do Android – Contrato de Licença, pressione o botão Aceitar:

    

    Aguarde até que o Visual Studio instale os componentes do SDK do Android.

13. Na janela Novo Dispositivo, pressione o botão Criar:

    

    Aguarde até que o Visual Studio baixe, descompacte e crie um emulador Android.

14. Feche a janela Gerenciador de Dispositivos Android:

    

15. Na barra de ferramentas do Visual Studio, pressione o botão Pixel 7 - API 35 (Android 15.0 - API 35):

    

16. Na janela SDK do Android – Contrato de Licença, pressione o botão Aceitar:

    

17. Na caixa de diálogo Controle de Conta de Usuário, pressione o botão Sim:

    

    Aguarde a instalação do Visual Studio para baixar o SDK do Android.

18. Na barra de ferramentas do Visual Studio, pressione o botão Pixel 7 – API 35 (Android 15.0 – API 35) para criar e executar o aplicativo:

    

    O Visual Studio iniciará o emulador Android, compilará o aplicativo e implantará o aplicativo no emulador.

    Aviso

    A aceleração de hardware precisa ser habilitada para maximizar o desempenho do emulador Android. Falha em fazer isso resultará em uma execução muito lenta do emulador. Para obter mais informações, consulte Como habilitar a aceleração de hardware com emuladores Android (Hyper-V & AEHD).

19. No aplicativo em execução no emulador Android, pressione o botão Clique em mim várias vezes e observe que a contagem do número de cliques no botão é incrementada.

    

Solução de problemas

Se o aplicativo não for compilado, examine Solucionar problemas conhecidos, que pode ter uma solução para o problema. Se o problema estiver relacionado ao emulador Android, consulte Solução de problemas do emulador Android.

6. Na barra de ferramentas do Visual Studio, pressione o botão Computador Windows para compilar e executar o aplicativo:

   

7. No aplicativo em execução, pressione o botão Clique em mim várias vezes e observe que a contagem do número de cliques no botão é incrementada:

   

Solução de problemas

Se o aplicativo não for compilado, examine Solucionar problemas conhecidos, que pode ter uma solução para o problema.

6. No Visual Studio, emparelhe o IDE com um host do Mac Build. Para obter mais informações, consulte Emparelhar com Mac para desenvolvimento para iOS.

7. Na barra de ferramentas do Visual Studio, use a lista suspensa Destino de Depuração para selecionar Simuladores iOS e, em seguida, um simulador iOS específico:

   

8. Na barra de ferramentas do Visual Studio, pressione o botão Iniciar do simulador iOS escolhido para compilar e executar seu aplicativo:

   

   O Visual Studio compilará o aplicativo, iniciará o simulador remoto do iOS para Windows e implantará o aplicativo no simulador remoto. Para obter mais informações sobre o simulador remoto do iOS para Windows, consulte Simulador remoto do iOS para Windows.

9. No aplicativo em execução, pressione o botão Clique em mim várias vezes e observe que a contagem do número de cliques no botão é incrementada.

   

Solução de problemas

Se o aplicativo não for compilado, examine Solucionar problemas conhecidos, que pode ter uma solução para o problema.

Os aplicativos .NET MAUI direcionados ao Mac Catalyst só podem ser iniciados e depurados usando o Visual Studio Code.

Neste tutorial, você criará seu primeiro aplicativo .NET MAUI no Visual Studio Code e o executará em um emulador android:

Neste tutorial, você criará seu primeiro aplicativo .NET MAUI no Visual Studio Code em um Mac e o executará em um simulador do iOS:

Neste tutorial, você criará seu primeiro aplicativo .NET MAUI no Visual Studio Code em um Mac e o executará no macOS:

Neste tutorial, você criará seu primeiro aplicativo .NET MAUI no Visual Studio Code no Windows e o executará no Windows:

7. 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 o Android, seguido por Atualizar ambiente android. Todos os erros detectados devem ser resolvidos.

8. Na barra de status na parte inferior do Visual Studio Code, pressione o símbolo de colchetes { } e verifique se o de destino de depuração está definido como um emulador android específico:

   

   Você também pode definir o destino de depuração pressionando CTRL+SHIFT+P no Windows ou CMD+SHIFT+P no macOS e selecionando .NET MAUI: Escolha o dispositivo Android na paleta de comandos.

9. Compile e execute o aplicativo no Android pressionando F5 ou pressionando o botão Executar no canto superior direito do Visual Studio Code:

   

   Se for solicitado que você selecione um depurador na paleta de comandos, selecione C# e, em seguida, a configuração de inicialização do projeto.

10. No aplicativo em execução no emulador do Android escolhido, pressione o botão Clique em mim várias vezes e observe que a contagem de cliques no botão é incrementada.

    

Depurar o aplicativo em um dispositivo Android

Para depurar o aplicativo em um dispositivo Android:

1. Verifique se o dispositivo está configurado para implantação. Para obter mais informações, consulte Configurar um dispositivo para implantação.
2. Conecte seu dispositivo ao computador e selecione-o como um destino de depuração no Visual Studio Code.
3. Execute o aplicativo.

7. No Visual Studio Code, verifique se o ambiente da Apple está configurado corretamente pressionando CMD+SHIFT+P e, em seguida, selecionando .NET MAUI: Configurar o Apple, seguido por Atualizar ambiente da Apple. Todos os erros detectados devem ser resolvidos.

8. Na barra de status na parte inferior do Visual Studio Code, pressione o símbolo de chaves { } e verifique se o Alvo de Depuração está configurado para um simulador específico do iOS.

   

   Você também pode definir o destino de depuração pressionando CMD+SHIFT+P e selecionando .NET MAUI: escolha o dispositivo iOS na paleta de comandos.

9. Crie e execute o aplicativo no iOS pressionando F5 ou pressionando o botão Executar no canto superior direito do Visual Studio Code:

   

   Se for solicitado que você selecione um depurador na paleta de comandos, selecione C# e, em seguida, a configuração de inicialização do projeto.

10. No aplicativo em execução no simulador do iOS de sua escolha, pressione o botão Clique em mim várias vezes e observe que a contagem do número de cliques no botão é incrementada.

    

Depurar o aplicativo em um dispositivo iOS

Para depurar o aplicativo em um dispositivo iOS:

1. Verifique se você adicionou sua ID Apple ao Xcode em Ajustes do > Xcode > Contas.
2. Verifique se o dispositivo foi registrado com sua equipe, se você pertencer ao Programa de Desenvolvedores da Apple.
3. Habilite o Modo de Desenvolvedor em seu dispositivo. Na primeira vez que você executar seu aplicativo, você poderá receber um pop-up no dispositivo - certifique-se de selecionar Permitir. Para obter mais informações sobre o Modo de Desenvolvedor, consulte Habilitando o Modo de Desenvolvedor em um dispositivo no developer.apple.com.
4. Conecte seu dispositivo ao computador e selecione-o como um destino de depuração no Visual Studio Code.
5. Execute o aplicativo.

7. No Visual Studio Code, verifique se o ambiente da Apple está configurado corretamente pressionando CMD+SHIFT+P e, em seguida, selecionando .NET MAUI: Configurar o Apple, seguido por Atualizar ambiente da Apple. Todos os erros detectados devem ser resolvidos.

8. Na barra de status na parte inferior do Visual Studio Code, pressione o símbolo de colchetes { } e verifique se o de destino de depuração do está definido para seu Mac:

   

   Você também pode definir o destino de depuração pressionando CMD+SHIFT+P e selecionando .NET MAUI: Selecionar dispositivo macOS na paleta de comandos.

9. Crie e execute o aplicativo no macOS pressionando F5 ou pressionando o botão Executar no canto superior direito do Visual Studio Code:

   

   Se for solicitado que você selecione um depurador na paleta de comandos, selecione C# e, em seguida, a configuração de inicialização do projeto.

10. No aplicativo em execução, pressione o botão Clique em mim várias vezes e observe que a contagem do número de cliques no botão é incrementada:

    

7. Na barra de status na parte inferior do Visual Studio Code, pressione o símbolo de colchetes { } e verifique se o de destino de depuração está definido como Windows:

   

   Você também pode definir o destino de depuração pressionando CTRL+SHIFT+P e selecionando .NET MAUI: Escolher Dispositivo Windows na paleta de comandos.

8. Crie e execute o aplicativo no Windows pressionando F5 ou pressionando o botão Executar no canto superior direito do Visual Studio Code:

   

   Se for solicitado que você selecione um depurador na paleta de comandos, selecione C# e, em seguida, a configuração de inicialização do projeto.

9. No aplicativo em execução, pressione o botão Clique em mim várias vezes e observe que a contagem do número de cliques no botão é incrementada: