Compartilhar via


Referência do MSBuild para o Sistema de Projetos JavaScript

Este artigo fornece informações de referência para as propriedades e itens do MSBuild que você pode usar para configurar projetos com base no JSPS (JavaScript Project System), que usa o formato .esproj.

Nota

As propriedades descritas neste artigo estendem as propriedades que o MSBuild fornece por padrão. Para obter uma lista de propriedades comuns do MSBuild, consulte propriedades comuns do MSBuild.

Propriedades ShouldRun

As seguintes propriedades do MSBuild estão documentadas nesta seção:

  • ShouldRunNpmInstall
  • ShouldRunBuildScript

ShouldRunNpmInstall

A propriedade ShouldRunNpmInstall especifica se a execução ou não deve ser executada npm install nos comandos Build e Restore. O valor padrão da propriedade é true se não estiver definido.

<PropertyGroup>
  <ShouldRunNpmInstall>false</ShouldRunNpmInstall>
</PropertyGroup>

Dois cenários comuns em que não executar npm install é desejável são:

  1. Quando um gerenciador de pacotes não npm (como yarn ou pnpm) é usado. Nesse cenário, a melhor solução é criar um destino que seja executado antes de BeforeRestore executar manualmente a instalação.
  2. Quando existe um mecanismo de instalação de pacote global na solução que torna a execução de instalações individuais desnecessária.

ShouldRunBuildScript

A propriedade ShouldRunBuildScript especifica se deve ou não executar npm run build em comandos build. O valor padrão da propriedade é true se não estiver definido.

<PropertyGroup>
  <ShouldRunBuildScript>false</ShouldRunBuildScript>
</PropertyGroup>

Para projetos que contêm apenas JavaScript que não exigem compilação, defina essa propriedade como false. Os projetos React, Vue e Angular recém-criados geralmente se enquadram nessa categoria. Nesse cenário, o build é usado para produção e não para depuração. Observe que os comandos Build e Publish são separados em projetos JSPS e Publish ainda são executados mesmo se essa propriedade estiver definida.

Propriedades de comando

As propriedades de comando são propriedades destinadas a mapear scripts comuns de package.json para destinos do MSBuild. Há suporte para valores padrão para todas essas propriedades, conforme descrito nesta seção.

Defina essas propriedades ao usar gerenciadores de pacotes diferentes de npm ou mecanismos de script, como gulp.

As seguintes propriedades do MSBuild são descritas nesta seção:

BuildCommand

A propriedade BuildCommand especifica o comportamento do destino build. Se o package.json associado contiver um script build ou compile, o valor de BuildCommand padrão já estará definido para executá-los.

Para modificar o comando, inclua npm run ao usar npm.

<PropertyGroup>
  <BuildCommand>npm run build</BuildCommand>
</PropertyGroup>

StartupCommand

A propriedade StartupCommand especifica o comportamento do destino dotnet run. Se o package.json associado contiver um script start, serverou dev, o valor de StartupCommand padrão já estará definido para executar esses scripts.

Se você modificar o comando, inclua npm run ao usar npm.

<PropertyGroup>
  <StartupCommand>npm run serve</StartupCommand>
</PropertyGroup>

TestCommand

A propriedade TestCommand especifica o comportamento do destino test. Se o package.json associado contiver um script de test, o valor de TestCommand padrão já está definido para executar esse script.

Se você modificar o comando, inclua npm run ao usar npm.

<PropertyGroup>
  <TestCommand>ng test</TestCommand>
</PropertyGroup>

CleanCommand

A propriedade CleanCommand especifica o comportamento do destino clean. Se o package.json associado contiver um script de clean, o valor de CleanCommand padrão já está definido para executar esse script.

Se você modificar o comando, inclua npm run ao usar npm.

<PropertyGroup>
  <CleanCommand>npm run clean</CleanCommand>
</PropertyGroup>

PublishCommand

A propriedade PublishCommand especifica o comportamento do destino publish. Se o package.json associado contiver um script de publish, o valor de PublishCommand padrão já está definido para executar esse script. No npm, é comum ter scripts pré e pós-publicação, que também serão executados.

Se você modificar o comando, inclua npm run ao usar npm.

<PropertyGroup>
  <PublishCommand>npm run publish</PublishCommand>
</PropertyGroup>

Consulte também