Crie seu primeiro aplicativo

Neste tutorial, você aprenderá como criar e executar seu primeiro aplicativo .NET Multi-platform App UI (.NET MAUI) no Visual Studio 2022 no Windows ou 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.12 ou superior, com o pacote de trabalho da UI de Aplicação Multiplataforma .NET instalado. Para obter mais informações, consulte Installation.

Criar uma aplicação

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.

Pré-requisitos

• Visual Studio Code, com a extensão .NET MAUI instalada e configurada:
  • Sua conta da Microsoft conectada ao C# Dev Kit.
  • O SDK do .NET está instalado.
  • O SDK do .NET MAUI está instalado.
  • Xcode instalado no seu Mac, incluindo os tempos de execução do simulador e as ferramentas de linha de comandos do Xcode, se o objetivo forem as plataformas Apple.
  • Microsoft OpenJDK, o Android SDK e um emulador Android instalados na sua máquina, se estiver a direcionar para Android.

Para obter mais informações, consulte Installation.

Criar uma aplicação

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:

1. Inicie o Visual Studio Code. No Explorer, pressione Criar Projeto .NET:

   

   Como alternativa, pressione CTRL+SHIFT+P no Windows ou CMD+SHIFT+P no macOS e, em seguida, o comando .NET: New Project....

2. Na paleta de comandos, selecione o modelo de App .NET MAUI .

   

3. Na caixa de diálogo Local do Projeto, selecione o local onde deseja que o novo projeto seja criado.

   Importante

   Os projetos devem ser criados em uma pasta vazia.

4. Na paleta de comandos, insira um nome para seu novo projeto e pressione ENTER:

   

5. Na paleta de comandos, pressione Criar projeto:

   

   Aguarde até que o projeto seja criado, aceitando a pasta como um local confiável, se necessário.

6. No Explorer, expanda o nó raiz do seu projeto e, em seguida, abra um arquivo C# como MainPage.xaml.cs:

   

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: Pick iOS Device 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: Escolher 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 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:

   

Solução de problemas

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

Próximos passos

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

Para aprender os fundamentos da criação de um aplicativo com o .NET MAUI, consulte Criar um aplicativo .NET MAUI. Como alternativa, para obter um curso de treinamento completo do .NET MAUI, consulte Criar aplicativos móveis e de desktop com o .NET MAUI.