Criar seu primeiro aplicativo

Neste tutorial, você aprenderá a criar e executar seu primeiro aplicativo .NET Multi-platform App UI (.NET MAUI) no Visual Studio 2022 no Windows ou Visual Studio 2022 para Mac. 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 para Mac

Observação

O Visual Studio para Mac está programado para ser desativado em 31 de agosto de 2024, de acordo com a Política de ciclo de vida moderna da Microsoft. O Visual Studio para Mac 17.6 continuará com suporte até 31 de agosto de 2024, com atualizações de manutenção para problemas de segurança e plataformas atualizadas da Apple. Para obter mais informações, incluindo opções alternativas para desenvolvimento em Mac, consulte O que está acontecendo com o Visual Studio para Mac?.

Pré-requisitos

• Visual Studio 2022 para Mac 17.6 com as cargas de trabalho do .NET, .NET MAUI, Android e iOS instaladas. Para obter mais informações, confira Instalação.

Importante

Para usar o Visual Studio para Mac com o .NET 8, habilite a caixa de seleção Visual Studio > Preferências > Outros > Versões Prévias de Recurso > Usar o SDK do .NET 8 se instalado (requer reinicialização).

Criar um aplicativo

Neste tutorial, você criará seu primeiro aplicativo .NET MAUI no Visual Studio 2022 para Mac e o executará na plataforma de sua escolha:

1. Inicie o Visual Studio 2022 para Mac. Na janela Iniciar, clique em Novo para criar um projeto:

   

2. Na janela Escolher um modelo para o novo projeto, selecione Multiplataforma > Aplicativo, selecione o modelo Aplicativo .NET MAUI e clique no botão Continuar:

   

3. Na janela Configurar seu novo aplicativo .NET MAUI , escolha a versão do .NET que você deseja direcionar e clique no botão Continuar:

   

4. Na janela Configurar seu novo Aplicativo .NET MAUI, insira MyMauiApp como o nome do projeto, selecione um local adequado para o projeto e clique no botão Criar:

   

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

   

6. O Visual Studio 2022 para Mac exibirá uma barra de informações se o Mac não tiver os componentes do SDK do Android. Clique no botão Instalar para instalar o SDK do Android:

   

7. Na janela SDK do Android, selecione a caixa de seleção Baixar e instalar dependências do Android automaticamente e clique no botão Baixar e Instalar:

   

8. Na janela de Aceitação da licença, clique no botão Aceitar:

   

   Aguarde até que o Visual Studio 2022 para Mac baixe o SDK do Android:

9. Na barra de ferramentas do Visual Studio 2022 para Mac, altere o destino de depuração para Android Emulator:

   

10. Na barra de ferramentas do Visual Studio 2022 para Mac, pressione o botão Reproduzir para compilar o aplicativo e tentar iniciá-lo:

    

    O Visual Studio 2022 para Mac compilará o aplicativo e criará um emulador Android padrão.

11. Na janela Novo Dispositivo, clique no botão Criar:

    

12. Na janela de Aceitação da licença, clique no botão Aceitar:

    

    Aguarde até que o Visual Studio 2022 para Mac baixe e instale um emulador Android.

13. Feche a janela Gerenciador de Dispositivos Android:

    

14. Na barra de ferramentas do Visual Studio 2022 para Mac, altere o destino de depuração para Pixel 5 – API 34 (API 34):

    

15. Na barra de ferramentas do Visual Studio 2022 para Mac, pressione o botão Reproduzir para iniciar o aplicativo no emulador Android:

    

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

16. 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:

    

6. Na barra de ferramentas do Visual Studio 2022 para Mac, verifique se o destino de depuração está definido como um simulador do iOS:

   

7. Na barra de ferramentas do Visual Studio 2022 para Mac, pressione o botão Reproduzir para iniciar o aplicativo no simulador do iOS escolhido:

   

   O Visual Studio 2022 para Mac iniciará o simulador do iOS, compilará o aplicativo e implantará o aplicativo no emulador.

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:

   

6. Na barra de ferramentas do Visual Studio 2022 para Mac, verifique se o destino de depuração está definido como Meu Mac (MacCatalyst):

   

7. No Visual Studio 2022 para Mac, clique com o botão direito do mouse no projeto MyMauiApp e selecione Editar Arquivo de Projeto. Em seguida, no editor de arquivos do projeto, insira o seguinte XML antes do primeiro <ItemGroup>:

   <PropertyGroup Condition="'$(Configuration)|$(TargetFramework)|$(Platform)'=='Debug|net8.0-maccatalyst|AnyCPU'">
       <RuntimeIdentifiers>maccatalyst-x64;maccatalyst-arm64</RuntimeIdentifiers>
   </PropertyGroup>
   

8. Na barra de ferramentas do Visual Studio 2022 para Mac, pressione o botão Reproduzir para iniciar o aplicativo no seu Mac:

   

   O Visual Studio 2022 para Mac compilará e implantará o aplicativo.

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:

   

Aplicativos MAUI do .NET destinados ao Windows só podem ser iniciados e depurados usando o Visual Studio 2022.

Visual Studio Code (versão prévia)

Observação

O suporte ao MAUI do .NET no Visual Studio Code ainda está em versão prévia. Experimente e compartilhe seus comentários.

Instalar a extensão

Siga as instruções para instalar a extensão do .NET MAUI para Visual Studio Code.

Criar o aplicativo

Para criar um aplicativo .NET MAUI:

1. Clique em Criar Projeto do .NET no Explorer ou 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, significará que sua pasta não está 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.

Você também pode abrir um projeto .NET MAUI existente no Visual Studio Code por meio do 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

Clique no símbolo de colchetes { } no canto inferior direito do Visual Studio Code. Aqui, você pode alterar seu Projeto de Inicialização, alterar o Destino de Depuração para qualquer coisa válida em seu computador 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 pesquisando por ".NET MAUI".

Por padrão, você pode implantar no seu computador de desenvolvimento do Windows ou macOS local. No macOS, você também pode implantar em simuladores do iOS.

Se você quiser usar emuladores Android, siga estas etapas:

1. Em seu terminal, navegue para <YOUR_ANDROID_SDK_DIRECTORY>/cmdline-tools/latest/bin/.
2. Execute sdkmanager --install emulator e sdkmanager --install system-images;android-33;google_apis;x86_64 no Windows, ou ./sdkmanager --install emulator e ./sdkmanager --install system-images;android-33;google_apis;x86_64 no macOS.
3. Em seguida, você pode criar um emulador na linha de comando com o avdmanager do Android. Por exemplo, você pode executar avdmanager create avd -n MyAndroidVirtualDevice-API33 -k "system-images;android-33;google_apis;x86_64" no Windows ou ./avdmanager create avd -n MyAndroidVirtualDevice-API33 -k "system-images;android-33;google_apis;x86_64" no macOS.

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

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". Como alternativa, você pode usar F5 para iniciar uma sessão de depuração. Se o Visual Studio Code solicitar que você selecione um depurador, selecione ".NET MAUI".

O depurador escolherá automaticamente o Destino de Depuração e o Projeto de Inicialização definidos no menu dos colchetes { }. Se você não tiver selecionado nada, ele solicitará 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 problemas com a extensão, poderá seguir as etapas de solução de problemas, ver nossos 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.