Criar seu primeiro aplicativo

Nesse tutorial, você aprenderá como criar e executar seu primeiro aplicativo .NET Multi-platform App UI (.NET MAUI) no Visual Studio 2022 no Windows ou no Visual Studio Code no Windows, macOS ou Linux. Isso ajudará a garantir que seu ambiente de desenvolvimento esteja configurado corretamente.

Visual Studio

Pré-requisitos

• Visual Studio 2022 17.8 ou superior, com a carga de trabalho da interface do usuário do aplicativo multiplataforma .NET instalada. Para obter mais informações, confira Instalação.

Criar um 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.

Visual Studio Code

Pré-requisitos

• Visual Studio Code, com a extensão .NET MAUI instalada. Para obter mais informações, confira Instalação.

Criar um aplicativo

Para criar um aplicativo .NET MAUI:

1. Inicie o Visual Studio Code. No Explorer, clique em Criar projeto .NET no Explorer. Como alternativa, selecione CTRL/CMD+SHIFT+P.NET: Novo Projeto....
2. Selecione Aplicativo .NET MAUI ou Aplicativo .NET MAUI Blazor.
3. Selecione uma pasta vazia. Se o explorador de arquivos abrir novamente, sua pasta não estará vazia.
4. Nomeie o projeto.
5. Verifique se o projeto é carregado com êxito no Gerenciador de Soluções e abra um arquivo C# ou XAML.

Observação

Você também pode abrir um projeto .NET MAUI existente no Visual Studio Code por meio do menu Arquivo> Abrir....

Agora você deve ver seu aplicativo no Gerenciador de Soluções do Kit de Desenvolvimento do C# no Visual Studio Code. Como a extensão do .NET MAUI depende do Kit de Desenvolvimento do C#, você pode usar todos os recursos dele junto com a extensão .NET MAUI.

Escolher o seu dispositivo de destino

Para escolher seu dispositivo de destino, clique no símbolo de colchetes { } no canto inferior direito do Visual Studio Code. Você pode usar esse símbolo para alterar seu projeto de inicialização, alterar seu destino de depuração para qualquer coisa válida em sua máquina de desenvolvimento e fixar qualquer configuração na barra de status do Visual Studio Code:

Você também pode definir o projeto de inicialização e o destino de depuração na paleta de comandos, usando CTRL/CMD+SHIFT+P e procurando por ".NET MAUI".

Você pode implantar em sua máquina de desenvolvimento local (desktop Windows ou macOS com Xcode) sem nenhuma etapa adicional.

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.

Depurar seu aplicativo

Para depurar seu aplicativo, navegue até o menu Executar e Depurar do Visual Studio Code e selecione o botão Executar e Depurar. Alternativamente, você pode usar F5 para iniciar uma sessão de depuração. Se o Visual Studio Code solicitar que você selecione um depurador, certifique-se de selecionar C#.

Observação

Nas versões de visualização da extensão, o depurador foi listado como .NET MAUI. Na versão estável, essa configuração foi substituída por C#.

O depurador escolherá automaticamente o destino de depuração e o projeto de inicialização que você definiu no menu de chaves { }. Se você não selecionou nada, será solicitado que você escolha um destino de depuração.

Depois que o aplicativo iniciar a depuração, você poderá usar as ferramentas internas de depuração do Visual Studio Code para definir pontos de interrupção, percorrer o código e mais.

Saiba mais

Se você enfrentar algum problema com a extensão, poderá seguir as etapas de solução de problemas, ver os problemas conhecidos ou fornecer comentários.

Próximas etapas

Neste tutorial, você aprendeu a criar e executar seu primeiro aplicativo .NET Multi-Platform App UI (.NET MAUI).

Para saber os conceitos básicos da criação de um aplicativo com o .NET MAUI, confira Criar um aplicativo .NET MAUI. Como alternativa, para obter um curso completo de treinamento do .NET MAUI, consulte Criar aplicativos móveis e de área de trabalho com o .NET MAUI.