Partilhar via

Referência do MSBuild para o sistema de projeto JavaScript

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

Observação

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.

ShouldRun propriedades

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

ShouldRunNpmInstall

A propriedade ShouldRunNpmInstall especifica se o npm install deve ou não ser executado nos comandos Build and Restore. O valor padrão para a propriedade é true se unset.

<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 BeforeRestore executar manualmente a instalação.
  2. Quando existe um mecanismo de instalação de pacote global na solução que torna desnecessária a execução de instalações individuais.

ShouldRunBuildScript

A propriedade ShouldRunBuildScript especifica se deve ou não ser executado npm run build comandos Build. O valor padrão para a propriedade é true se unset.

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

Para projetos contendo apenas JavaScript que não exigem compilação, defina esta propriedade como false. Os projetos React, Vue e Angular recém-criados geralmente se enquadram nessa categoria. Nesse cenário, a compilação é usada 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 que essa propriedade esteja definida.

Propriedades do comando

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

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

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

  • BuildCommand
  • StartupCommand
  • TestCommand
  • CleanCommand
  • PublishCommand

BuildCommand

A propriedade BuildCommand especifica o comportamento para o destino build. Se o package.json associado contiver um script build ou compile, o valor de BuildCommand padrão já está 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 para o destino dotnet run. Se o package.json associado contiver um script start, serverou dev, o valor StartupCommand padrão já está 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 para o destino test. Se o package.json associado contiver um script test, o valor 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 para o destino clean. Se o package.json associado contiver um script clean, o valor 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 para o destino publish. Se o package.json associado contiver um script publish, o valor 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>

Ver também