Sdílet prostřednictvím

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ů založených na javascriptovém projektovém systému (JSPS), které používají 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 tématu common MSBuild vlastnosti.

Vlastnosti ShouldRun

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

ShouldRunNpmInstall

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

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

Existují dva běžné scénáře, kdy není spuštěn npm install žá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 pro ruční spuštění 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 mají spustit npm run build v příkazech sestavení. Výchozí hodnota vlastnosti je true, pokud není nastavena.

<PropertyGroup>
  <ShouldRunBuildScript>false</ShouldRunBuildScript>
</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 Build a Publish jsou v projektech JSPS oddělené a Publish stále běží, i když je tato vlastnost nastavená.

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 je gulp.

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á package.json obsahuje build nebo compile skript, výchozí hodnota BuildCommand je už nastavená tak, aby je spouštěla.

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

<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 start, servernebo dev skript, výchozí hodnota StartupCommand je již nastavena pro spuštění těchto skriptů.

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

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

TestCommand

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

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

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

CleanCommand

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

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

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

PublishCommand

Vlastnost PublishCommand určuje chování cíle publish. Pokud přidružená package.json obsahuje skript publish, výchozí hodnota PublishCommand je již nastavená 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, při použití npmzahrnout npm run .

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

Viz také