Delen via

MSBuild-verwijzing voor het JavaScript-projectsysteem

  • Artikel

Dit artikel bevat naslaginformatie over de MSBuild-eigenschappen en -items die u kunt gebruiken om projecten te configureren op basis van het JavaScript Project System (JSPS), die gebruikmaken van de indeling .esproj.

Notitie

De eigenschappen die in dit artikel worden beschreven, breiden de eigenschappen van MSBuild standaard uit. Zie Algemene MSBuild-eigenschappenvoor een lijst met algemene MSBuild-eigenschappen.

ShouldRun-eigenschappen

De volgende MSBuild-eigenschappen worden beschreven in deze sectie:

ShouldRunNpmInstall

De eigenschap ShouldRunNpmInstall geeft aan of npm install moet worden uitgevoerd op opdrachten voor bouwen en herstellen. De standaardwaarde voor de eigenschap wordt true als deze niet is ingesteld.

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

Twee veelvoorkomende scenario's waarbij het niet uitvoeren van npm install wenselijk is, zijn:

  1. Wanneer een niet-npm-pakketbeheer (zoals yarn of pnpm) wordt gebruikt. In dit scenario is de beste oplossing om een doel te maken dat wordt uitgevoerd voordat BeforeRestore om de installatie handmatig uit te voeren.
  2. Wanneer er een globaal installatiemechanisme voor pakketten bestaat in de oplossing die het uitvoeren van afzonderlijke installaties onnodig maakt.

ShouldRunBuildScript

De eigenschap ShouldRunBuildScript geeft aan of npm run build moet worden uitgevoerd op build-opdrachten. De standaardwaarde voor de eigenschap wordt true als deze niet is ingesteld.

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

Stel deze eigenschap in op falsevoor projecten die alleen JavaScript bevatten waarvoor geen gebouw is vereist. Nieuw gemaakte React-, Vue- en Angular-projecten vallen meestal in deze categorie. In dit scenario wordt build gebruikt voor productie en niet voor foutopsporing. De opdrachten Build en Publish zijn gescheiden in JSPS-projecten en Publish nog steeds worden uitgevoerd, zelfs als deze eigenschap is ingesteld.

Opdrachteigenschappen

Opdrachteigenschappen zijn eigenschappen die zijn bedoeld om algemene package.json scripts toe te wijzen aan MSBuild-doelen. Standaardwaarden worden ondersteund voor al deze eigenschappen, zoals beschreven in deze sectie.

Stel deze eigenschappen in wanneer u andere pakketbeheerders dan npm gebruikt of scriptengines zoals gulp.

De volgende MSBuild-eigenschappen worden beschreven in deze sectie:

BuildCommand

De eigenschap BuildCommand geeft het gedrag op voor het build doel. Als de gekoppelde package.json een build of compile script bevat, is de standaardwaarde BuildCommand al ingesteld om deze uit te voeren.

Als u de opdracht wilt wijzigen, neemt u npm run op wanneer u npmgebruikt.

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

StartupCommand

De eigenschap StartupCommand geeft het gedrag op voor het dotnet run doel. Als de gekoppelde package.json een start, serverof dev script bevat, is de standaardwaarde StartupCommand al ingesteld om deze scripts uit te voeren.

Als u de opdracht wijzigt, neemt u npm run op wanneer u npmgebruikt.

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

TestOpdracht

De eigenschap TestCommand geeft het gedrag op voor het test doel. Als de gekoppelde package.json een test script bevat, is de standaardwaarde TestCommand al ingesteld om dit script uit te voeren.

Als u de opdracht wijzigt, neemt u npm run op wanneer u npmgebruikt.

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

CleanCommand

De eigenschap CleanCommand geeft het gedrag op voor het clean doel. Als de gekoppelde package.json een clean script bevat, is de standaardwaarde CleanCommand al ingesteld om dit script uit te voeren.

Als u de opdracht wijzigt, neemt u npm run op wanneer u npmgebruikt.

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

PublishCommand

De eigenschap PublishCommand geeft het gedrag op voor het publish doel. Als de gekoppelde package.json een publish script bevat, is de standaardwaarde PublishCommand al ingesteld om dit script uit te voeren. In npm is het gebruikelijk om scripts vooraf en na te publiceren, die ook worden uitgevoerd.

Als u de opdracht wijzigt, neemt u npm run op wanneer u npmgebruikt.

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

Zie ook