Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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
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:
- 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. - 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
- StartupCommand
- TestCommand
- CleanCommand
- PublishCommand
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
, server
ou 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>