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 começará a instalar o SDK do Android padrão e o Android Emulator.

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

   

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

   

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

    

11. Na janela de Aceitação da licença, clique em Aceitar:

    

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

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

    

    O Visual Studio começará a criar um emulador Android padrão.

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

    

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

    

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

15. Feche a janela Gerenciador de Dispositivos Android:

    

16. Na barra de ferramentas do Visual Studio, pressione o botão Pixel 5 – API 34 (Android 14.0 – API 33) para compilar 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).

17. 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, use a lista suspensa Destino de Depuração para selecionar Framework e, em seguida, a entrada net8.0-windows:

   

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

   

   Se você não tiver habilitado o Modo de Desenvolvedor, o Visual Studio solicitará que você o habilite. Na caixa de diálogo Habilitar Modo de Desenvolvedor para Windows, clique em configurações para desenvolvedores abrir o aplicativo de Configurações:

   

   No aplicativo de Configurações, ative Modo de Desenvolvedor e aceite o aviso de isenção de responsabilidade:

   

   Feche o aplicativo Configurações e feche a caixa de diálogo Habilitar o Modo de Desenvolvedor para Windows.

8. 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 destinados ao Mac Catalyst só podem ser iniciados e depurados usando o Visual Studio 2022 para Mac.

Android de destino

Se você quiser usar emuladores Android, siga essas etapas para instalar e criar um emulador:

1. Em seu terminal, navegue para <YOUR_ANDROID_SDK_DIRECTORY>/cmdline-tools/11.0/bin/.

2. Use sdkmanager para instalar o emulador.

   No Windows, execute os seguintes comandos no terminal:

   sdkmanager --install emulator
   sdkmanager --install "system-images;android-33;google_apis;x86_64"
   

   No macOS, execute os seguintes comandos no terminal:

   ./sdkmanager --install emulator
   ./sdkmanager --install "system-images;android-33;google_apis;x86_64"
   

   Observação

   As aspas em torno dos argumentos de linha de comando sdkmanager são importantes.

3. Em seguida, você pode criar um emulador na linha de comando com o avdmanager do Android.

   No Windows, execute os seguintes comandos no terminal:

   avdmanager create avd -n MyAndroidVirtualDevice-API33 -k "system-images;android-33;google_apis;x86_64"
   

   No macOS, execute os seguintes comandos no terminal:

   ./avdmanager create avd -n MyAndroidVirtualDevice-API33 -k "system-images;android-33;google_apis;x86_64"
   

   Observação

   As aspas em torno dos argumentos de linha de comando avdmanager são importantes.

Você também pode depurar em dispositivos físicos Android.

Destino iOS

Simuladores iOS são integrados ao Xcode. Para baixar os simuladores, certifique-se de que a opção esteja selecionada para instalá-los quando o Xcode> for iniciado pela primeira vez ou navegue até >Plataformas de configurações do Xcode e escolha um tempo de execução do simulador para instalar.

Para depurar com um dispositivo iOS, siga essas etapas antes de tentar depurar:

1. Especifique seu ID Apple em Xcode> Configurações >Conta.
2. Registre o dispositivo com sua equipe se você pertencer ao Programa para Desenvolvedor Apple.
3. Habilite o modo de Desenvolvedor em seu dispositivo, conforme descrito em Habilitando o modo de desenvolvedor em um dispositivo. Na primeira vez que você executar seu aplicativo, você poderá receber um pop-up no dispositivo - certifique-se de selecionar Permitir.