Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Observação
Esta não é a versão mais recente deste artigo. Para a versão atual, consulte a versão .NET 10 deste artigo.
Advertência
Esta versão do ASP.NET Core não é mais suportada. Para obter mais informações, consulte a Política de suporte do .NET e .NET Core. Para a versão atual, consulte a versão .NET 10 deste artigo.
Este tutorial mostra como criar e executar um aplicativo .NET MAUIBlazor Hybrid. Você aprende a:
- Criar um projeto de aplicativo .NET MAUIBlazor Hybrid no Visual Studio
- Executar a aplicação no Windows
- Execute o aplicativo em um dispositivo móvel emulado no emulador Android
Pré-requisitos
- Plataformas suportadas (.NET MAUI documentação)
- Visual Studio com o desenvolvimento .NET Multi-platform App UI carga de trabalho.
- Microsoft Edge WebView2: WebView2 é necessário no Windows ao executar um aplicativo nativo. Ao desenvolver aplicativos .NET MAUIBlazor Hybrid e executá-los apenas nos emuladores do Visual Studio, WebView2 não é necessário.
- Habilite a aceleração de hardware para melhorar o desempenho do emulador Android.
Para obter mais informações sobre pré-requisitos e instalação de software para este tutorial, consulte os seguintes recursos na documentação do .NET MAUI:
Criar um aplicativo .NET MAUIBlazor Hybrid
Inicie o Visual Studio. Na Janela de Início, selecione Criar um novo projeto:
Na janela Criar um novo projeto, use a lista suspensa Tipo de projeto para filtrar as molduras MAUI:
Selecione o modelo .NET MAUIBlazor Hybrid App e, em seguida, selecione o botão Próxima:
Observação
No .NET 7 ou anterior, o modelo é chamado .NET MAUIBlazor App.
Na caixa de diálogo Configurar o seu novo projeto:
- Defina o nome do projeto como MauiBlazor.
- Escolha um local adequado para o projeto.
- Selecione o botão Avançar.
Na caixa de diálogo Informações adicionais , selecione a versão da estrutura com a lista suspensa Framework. Selecione o botão Criar:
Aguarde o Visual Studio criar o projeto e, em seguida, restaurar as dependências do projeto. Monitore o progresso no Explorador de Soluções abrindo a entrada Dependências.
Restauração de dependências:
Dependências restauradas:
Executar a aplicação no Windows
Na barra de ferramentas do Visual Studio, selecione o botão do Windows Machine para criar e iniciar o projeto:
Se o Modo de Programador não estiver ativado, ser-lhe-á pedido para ativá-lo em Definições>Para programadores>Modo de Programador (Windows 10) ou Definições>Privacy & segurança>Para programadores>Modo de Programador (Windows 11). Coloque o interruptor em On.
A aplicação em execução como uma aplicação de ambiente de trabalho do Windows:
Execute o aplicativo no emulador Android
Se tiver seguido as orientações na secção Executar a aplicação no Windows, selecione o botão Parar Depuração na barra de ferramentas para interromper a execução da aplicação do Windows:
Na barra de ferramentas do Visual Studio, selecione o botão de lista suspensa das configurações de início. Selecione emuladores Android>emulador Android:
SDKs Android são necessários para criar aplicativos para Android. No painel Lista de Erros
A janela Android SDK License Acceptance é exibida, selecione o botão Aceitar para cada licença exibida. Uma janela adicional é exibida para as licenças Android Emulator e SDK Patch Applier. Selecione o botão Aceitar.
Aguarde até que o Visual Studio baixe o SDK do Android e o emulador do Android. Você pode acompanhar o progresso selecionando o indicador de tarefas em segundo plano no canto inferior esquerdo da interface do usuário do Visual Studio:
O indicador mostra uma marca de verificação quando as tarefas em segundo plano são concluídas.
Na barra de ferramentas, selecione o botão emulador Android:
Na janela Criar um dispositivo Android padrão , selecione o botão Criar :
Aguarde até que o Visual Studio baixe, descompacte e crie um emulador Android. Quando o emulador de telefone Android estiver pronto, selecione o botão Iniciar.
Observação
Habilite a aceleração de hardware para melhorar o desempenho do emulador Android.
Feche a janela Gestor de Dispositivos Android. Aguarde até que a janela do telefone emulado apareça, o sistema operacional Android carregue e a tela inicial apareça.
Importante
O telefone emulado deve ser ligado com o sistema operacional Android carregado para carregar e executar o aplicativo no depurador. Se o telefone emulado não estiver em execução, ligue-o usando o atalho de teclado Ctrl+P ou selecionando o botão Power na interface do usuário:
Na barra de ferramentas do Visual Studio, selecione o botão Pixel 5 - {VERSION} para criar e executar o projeto, onde o espaço reservado {VERSION} é a versão do Android. No exemplo a seguir, a versão do Android é API 30 (Android 11.0 - API 30)e uma versão posterior aparece dependendo do SDK do Android instalado:
O Visual Studio cria o projeto e implanta o aplicativo no emulador.
Iniciar o emulador, carregar o telefone emulado e o sistema operativo, e implantar e executar a aplicação pode levar vários minutos, dependendo da velocidade do sistema e se a aceleração de hardware está ativada ou não. Você pode monitorar o progresso da implantação inspecionando a barra de status do Visual Studio na parte inferior da interface do usuário. O indicador Ready recebe uma marca de seleção e os indicadores de implantação e carregamento do aplicativo do emulador desaparecem quando o aplicativo está em execução:
Durante a implantação:
Durante a inicialização do aplicativo:
O aplicativo em execução no emulador Android:
Próximos passos
Neste tutorial, você aprendeu como:
- Criar um projeto de aplicativo .NET MAUIBlazor Hybrid no Visual Studio
- Executar a aplicação no Windows
- Execute o aplicativo em um dispositivo móvel emulado no emulador Android
Saiba mais sobre Blazor Hybrid aplicações:
Colabore connosco no GitHub
A fonte deste conteúdo pode ser encontrada no GitHub, onde também pode criar e rever issues e pull requests. Para mais informações, consulte o nosso guia para colaboradores.
