Crie 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 .NET MAUI para iOS no Windows requer um host de compilação do Mac. Se você não precisar segmentar especificamente 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 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 Iniciar, clique em Criar um novo projeto para criar um novo projeto:

   

2. Na janela Criar um novo projeto, selecione MAUI na lista suspensa Todos os tipos de projeto, selecione o modelo Aplicativo .NET MAUI e clique no botão Avançar:

   

3. Na janela Configurar seu novo projeto, nomeie seu projeto, escolha um local adequado para ele e clique no botão Avançar:

   

4. Na janela Informações adicionais, escolha a versão do .NET que deseja alvejar e clique no botão Criar:

   

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

   

6. Na barra de ferramentas do Visual Studio, use a lista suspensa Debug Target para selecionar Emuladores Android e, em seguida, a entrada Android Emulator:

   

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

   

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

8. Na janela Android SDK - License Agreement, 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 e o emulador Android padrão.

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

    

11. Na caixa de diálogo Android SDK Platform estiver ausente, pressione o botão Install:

    

12. Na janela Android SDK - License Agreement, 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 Gestor 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 Android SDK - License Agreement, 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.

    Advertência

    A aceleração de hardware deve ser habilitada para maximizar o desempenho do emulador Android. Se isso não for feito, o emulador será executado muito lentamente. Para obter mais informações, consulte Como habilitar a aceleração de hardware com emuladores Android (Hyper-V & AEHD).

19. No aplicativo a ser executado no emulador Android, clique no botão Click me várias vezes e observe que o número de cliques no botão é incrementado.

    

Solução de problemas

Se a sua aplicação não conseguir compilar, consulte Resolução de problemas conhecidos, que poderá ter uma solução para o seu 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 Windows Machine para criar 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 a sua aplicação não conseguir compilar, consulte Resolução de problemas conhecidos, que poderá ter uma solução para o seu problema.

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

7. Na barra de ferramentas do Visual Studio, use a lista suspensa Debug Target para selecionar iOS Simulators e depois escolha um simulador iOS específico:

   

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

   

   O Visual Studio criará 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 Remote iOS Simulator for Windows.

9. No aplicativo em execução, pressione o botão Click me várias vezes e observe que a contagem de cliques no botão é incrementada.

   

Solução de problemas

Se a sua aplicação não conseguir compilar, consulte Resolução de problemas conhecidos, que poderá ter uma solução para o seu problema.

Os aplicativos .NET MAUI destinados 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 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: Configure Android, seguido por Refresh Android environment. Quaisquer erros detetados devem ser corrigidos.

8. Na barra de estado na parte inferior do Visual Studio Code, pressione o símbolo de chavetas { } e verifique se o alvo 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: Pick Android Device na paleta de comandos.

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

   

   Se lhe for solicitado para selecionar um depurador na paleta de comandos, selecione C# e depois a configuração de lançamento para o seu projeto.

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

    

Depurar o aplicativo em um dispositivo Android

Para depurar o aplicativo em um dispositivo Android:

1. Certifique-se de que o dispositivo está configurado para implementação. Para obter mais informações, consulte Configurar um dispositivo para implantação.
2. Conecte seu dispositivo à sua máquina e selecione-o como um destino de depuração no Visual Studio Code.
3. Execute o aplicativo.

7. No Visual Studio Code, verifique se seu ambiente Apple está configurado corretamente pressionando Cmd+Shift+P e selecionando .NET MAUI: Configure Apple, seguido por Refresh Apple environment. Quaisquer erros detetados devem ser corrigidos.

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

   

   Você também pode definir o destino de depuração pressionando Cmd+Shift+P e selecionando .NET MAUI: Escolher 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 lhe for solicitado para selecionar um depurador na paleta de comandos, selecione C# e depois a configuração de lançamento para o seu projeto.

10. No aplicativo em execução no simulador iOS escolhido, pressione o botão Click me 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. Certifique-se de que adicionou o seu ID Apple ao Xcode nas Preferências > de Xcode > Contas.
2. Certifique-se de que o seu dispositivo foi registado com a sua equipa, se pertencer ao Apple Developer Program.
3. Habilite o Modo de Desenvolvedor no seu dispositivo. Na primeira vez que executar a sua aplicação, poderá receber um pop-up no dispositivo - certifique-se de que seleciona Permitir. Para obter mais informações sobre o Modo de Desenvolvedor, consulte Ativando o Modo de Desenvolvedor em um dispositivo no developer.apple.com.
4. Conecte seu dispositivo à sua máquina e selecione-o como um destino de depuração no Visual Studio Code.
5. Execute o aplicativo.

7. No Visual Studio Code, verifique se seu ambiente Apple está configurado corretamente pressionando Cmd+Shift+P e selecionando .NET MAUI: Configure Apple, seguido por Refresh Apple environment. Quaisquer erros detetados devem ser corrigidos.

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

   

   Você também pode definir o destino de depuração pressionando Cmd+Shift+P e selecionando .NET MAUI: Pick macOS Device 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 lhe for solicitado para selecionar um depurador na paleta de comandos, selecione C# e depois a configuração de lançamento para o seu 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 chavetas { } e verifique se o 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: Pick Windows Device 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 lhe for solicitado para selecionar um depurador na paleta de comandos, selecione C# e depois a configuração de lançamento para o seu 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: