Tutorial: Criar um aplicativo ASP.NET Core com o React no Visual Studio

Artigo
12/08/2023

Neste artigo, você aprenderá a criar um projeto ASP.NET Core para atuar como um back-end de API e um projeto de React para atuar como interface do usuário.

Atualmente, o Visual Studio inclui modelos ASP.NET Core SPA (aplicativo de página única) que dão suporte a Angular e React. Os modelos fornecem uma pasta interna do aplicativo cliente no projetos ASP.NET Core, que contém os arquivos e as pastas base de cada estrutura.

Você pode usar o método descrito neste artigo para criar aplicativos de página única ASP.NET Core que:

Coloca o aplicativo cliente em um projeto separado, fora do projeto ASP.NET Core
Cria o projeto cliente com base na CLI da estrutura instalada em seu computador

Observação

Este artigo descreve o processo de criação do projeto usando o modelo atualizado no Visual Studio 2022 versão 17.8, que usa a CLI do Vite.

Pré-requisitos

Visual Studio 2022 versão 17.8 ou posterior com a carga de trabalho ASP.NET e desenvolvimento Web instalada. Acesse a página de downloads do Visual Studio para instalar gratuitamente. Caso precise instalar a carga de trabalho e já tiver o Visual Studio, acesse Ferramentas>Obter Ferramentas e Recursos..., que abre o Instalador do Visual Studio. Escolha a carga de trabalho ASP.NET e desenvolvimento para a Web e, em seguida, selecione Modificar.
npm (https://www.npmjs.com/), que está incluído com o Node.js
npx (https://www.npmjs.com/package/npx)

Criar o aplicativo de front-end

Na janela Iniciar, selecione Criar projeto.
Pesquise o React na barra de pesquisa na parte superior e selecione React e ASP.NET Core (versão prévia). Este modelo é um modelo JavaScript.
Nomeie o projeto ReactWithASP e, em seguida, escolha Criar.

O Gerenciador de Soluções mostra as seguintes informações do projeto:

Em comparação com o modelo React autônomo, você verá alguns arquivos novos e modificados para integração com o ASP.NET Core:
- vite.config.js
- App.js (modificado)
- App.test.js (modificado)
Selecione um navegador instalado na barra de ferramentas Depurar, como Chrome ou Microsoft Edge.

Se o navegador desejado ainda não estiver instalado, instale o navegador primeiro e selecione-o.

Definir as propriedades do projeto

No Gerenciador de Soluções, clique com o botão direito do mouse no projeto ReactWithASP.Server e escolha Propriedades.
Na página Propriedades, abra a guia Depurar e selecione a opção Abrir interface do usuário dos perfis de inicialização de depuração. Desmarque a opção Iniciar navegador para o perfil com o nome do projeto do ASP.NET Core (ou https, se presente).

Esse valor impede a abertura da página da Web com os dados meteorológicos de origem.

Observação

No Visual Studio, launch.json armazena as configurações de inicialização associadas ao botão Iniciar na barra de ferramentas Depurar. No momento, launch.json deve estar na pasta .vscode.

Iniciar o projeto

Pressione F5 ou selecione o botão Iniciar na parte superior da janela para iniciar o aplicativo. Dois prompts de comando são exibidos:

O projeto de API do ASP.NET Core em execução
A CLI do Vite mostrando uma mensagem como VITE v4.4.9 ready in 780 ms

Observação

Verifique a saída do console em busca de mensagens. Por exemplo, pode haver uma mensagem para atualizar o Node.js.

O aplicativo React é exibido e populado por meio da API. Se você não visualizar o aplicativo, consulte Solução de problemas.

Publicar o projeto

No Gerenciador de Soluções, clique com o botão direito do mouse no projeto ReactWithASP.Server e selecione Adicionar>Referência de projeto.

Verifique se o projeto reactwithasp.client está selecionado.
Selecione OK.
Clique com o botão direito do mouse no projeto ASP.NET Core novamente e selecione Editar arquivo de projeto.

Ele abre o arquivo .csproj do projeto.
No arquivo .csproj, verifique se a referência do projeto inclui um elemento <ReferenceOutputAssembly> com o valor definido como false.

Essa referência deve ser semelhante à seguinte.
```
 <ProjectReference Include="..\reactwithasp.client\reactwithasp.client.esproj">
   <ReferenceOutputAssembly>false</ReferenceOutputAssembly>
 </ProjectReference>
```
Clique com o botão direito do mouse no projeto ASP.NET Core e escolha Recarregar Projeto se essa opção estiver disponível.

Em Program.cs, verifique se o código a seguir está presente.

app.UseDefaultFiles();
app.UseStaticFiles();

// Configure the HTTP request pipeline.
if (app.Environment.IsDevelopment())
{
   app.UseSwagger();
   app.UseSwaggerUI();
}

Para publicar, clique com o botão direito do mouse no projeto do ASP.NET Core, escolha Publicar e selecione opções para corresponder ao cenário de publicação desejado, como Azure, publicar em uma pasta, etc.

O processo de publicação leva mais tempo do que para apenas um projeto ASP.NET Core, já que o comando npm run build é invocado durante a publicação. O BuildCommand executa npm run build por padrão.

Solução de problemas

Erro de proxy

Você poderá ver o seguinte erro:

[HPM] Error occurred while trying to proxy request /weatherforecast from localhost:4200 to https://localhost:7183 (ECONNREFUSED) (https://nodejs.org/api/errors.html#errors_common_system_errors)

Se conseguir visualizar esse problema, provavelmente o front-end foi iniciado antes do back-end. Depois de ver o prompt de comando de back-end em execução, basta atualizar o aplicativo React no navegador.

Verificar portas

Se os dados meteorológicos não forem carregados corretamente, talvez você também precise verificar se as portas estão corretas.

Verifique se os números da porta correspondem. Vá para o arquivo launchSettings.json no projeto do ASP.NET Core ReactWithASP.Server (na pasta Propriedades). Obtenha o número da porta da propriedade applicationUrl.

Se houver várias propriedades applicationUrl, procure uma usando um ponto de extremidade https. Será semelhante a https://localhost:7183.
Em seguida, vá para o arquivo vite.config.js do projeto React. Atualize a propriedade target para corresponder à propriedade applicationUrl em launchSettings.json. O valor atualizado é semelhante ao seguinte:
```
target: 'https://localhost:7183/',
```

Erro de privacidade

Você pode ver o seguinte erro de certificado:

Your connection isn't private

Tente excluir os certificados React de %appdata%\local\asp.net\https ou %appdata%\roaming\asp.net\https e tente novamente.

Próximas etapas

Para obter mais informações sobre aplicativos SPA no ASP.NET Core, confira a seção React em Desenvolver aplicativos de página única. O artigo vinculado fornece contexto adicional para arquivos de projeto, como aspnetcore-https.js, embora os detalhes da implementação sejam diferentes com base nas diferenças de modelo. Por exemplo, em vez de uma pasta ClientApp, os arquivos React estão contidos em um projeto separado.

Para obter informações específicas sobre o MSBuild do projeto do cliente, consulte Propriedades do MSBuild para JSPS.