Referenční informace k nástroji MSBuild pro projektový systém JavaScriptu

  • Článek

Tento článek obsahuje referenční informace o vlastnostech a položkách nástroje MSBuild, které můžete použít ke konfiguraci projektů na základě javascriptového projektového systému (JSPS), který používá formát .esproj .

Poznámka:

Vlastnosti popsané v tomto článku rozšiřují vlastnosti, které nástroj MSBuild poskytuje ve výchozím nastavení. Seznam běžných vlastností nástroje MSBuild naleznete v části Společné vlastnosti nástroje MSBuild.

Vlastnosti ShouldRun

Následující vlastnosti nástroje MSBuild jsou popsány v této části:

ShouldRunNpmInstall

Vlastnost ShouldRunNpmInstall určuje, jestli se má spustit nebo nespouštět npm install příkazy sestavení a obnovení. Výchozí hodnota vlastnosti je true , pokud není nastavena.

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

Mezi dva běžné scénáře, kdy není spuštěno npm install , je žádoucí:

  1. Pokud se použije správce balíčků jiného typu než npm (například yarn nebo pnpm). V tomto scénáři je nejlepším řešením vytvořit cíl, který se spustí před BeforeRestore ručním spuštěním instalace.
  2. Pokud v řešení existuje globální instalační mechanismus balíčku, který znetřebňuje spouštění jednotlivých instalací.

ShouldRunBuildScript

Vlastnost ShouldRunBuildScript určuje, zda se má spustit npm run build v příkazech sestavení. Výchozí hodnota vlastnosti je true , pokud není nastavena.

<PropertyGroup>
  <ShouldRunNpmBuildScript>false</ShouldRunNpmBuildScript>
</PropertyGroup>

U projektů obsahujících pouze JavaScript, které nevyžadují sestavení, nastavte tuto vlastnost na false. Nově vytvořené projekty React, Vue a Angular obvykle spadají do této kategorie. V tomto scénáři se sestavení používá pro produkční prostředí, nikoli pro ladění. Všimněte si, že příkazy BuildPublish jsou v projektech JSPS oddělené a Publish stále běží i v případě, že je tato vlastnost nastavena.

Vlastnosti příkazu

Vlastnosti příkazů jsou vlastnosti určené k mapování běžných skriptů package.json na cíle NÁSTROJE MSBuild. Výchozí hodnoty jsou podporovány pro všechny tyto vlastnosti, jak je popsáno v této části.

Tyto vlastnosti nastavte při použití jiných správců balíčků než npm nebo skriptovacích modulů, jako gulpje .

Následující vlastnosti nástroje MSBuild jsou popsány v této části:

BuildCommand

Vlastnost BuildCommand určuje chování cíle build . Pokud přidružený soubor package.json obsahuje build nebo compile skript, výchozí BuildCommand hodnota je už nastavená tak, aby je spustila.

Chcete-li upravit příkaz, zahrňte npm run při použití npm.

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

StartupCommand

Vlastnost StartupCommand určuje chování cíle dotnet run . Pokud přidružená package.json obsahuje hodnotu start, servernebo dev skript, výchozí StartupCommand hodnota je již nastavena pro spuštění těchto skriptů.

Pokud příkaz upravíte, zahrňte npm run při použití npm.

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

TestCommand

Vlastnost TestCommand určuje chování cíle test . Pokud přidružený package.json skript obsahuje test , výchozí TestCommand hodnota je již nastavena na spuštění tohoto skriptu.

Pokud příkaz upravíte, zahrňte npm run při použití npm.

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

CleanCommand

Vlastnost CleanCommand určuje chování cíle clean . Pokud přidružený package.json skript obsahuje clean , výchozí CleanCommand hodnota je již nastavena na spuštění tohoto skriptu.

Pokud příkaz upravíte, zahrňte npm run při použití npm.

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

PublishCommand

Vlastnost PublishCommand určuje chování cíle publish . Pokud přidružený package.json skript obsahuje publish , výchozí PublishCommand hodnota je již nastavena na spuštění tohoto skriptu. V npm je běžné mít skripty před publikováním a po publikování, které se také spustí.

Pokud příkaz upravíte, zahrňte npm run při použití npm.

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

Viz také