Megosztás a következőn keresztül:


MSBuild-referencia a JavaScript-projektrendszerhez

Ez a cikk az MSBuild tulajdonságokra és elemekre vonatkozó referenciainformációkat tartalmaz, amelyeket a projektek JavaScript-projektrendszeren (JSPS) alapuló konfigurálásához használhat, amelyek az .esproj formátumot használják.

Jegyzet

A cikkben ismertetett tulajdonságok alapértelmezés szerint kiterjesztik az MSBuild által biztosított tulajdonságokat. Az MSBuild gyakori tulajdonságainak listáját a Common MSBuild propertiescímű témakörben találja.

A ShouldRun tulajdonságai

Ebben a szakaszban a következő MSBuild tulajdonságokat dokumentáljuk:

ShouldRunNpmInstall

A ShouldRunNpmInstall tulajdonság azt határozza meg, hogy a buildelési és visszaállítási parancsokon futtassa-e a npm install. A tulajdonság alapértelmezett értéke true, ha nincs megadva.

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

Két gyakori forgatókönyv, amelyekben a npm install futtatása nem kívánatos:

  1. Ha nem npm csomagkezelőt használ (például yarn vagy pnpm). Ebben a forgatókönyvben a legjobb megoldás egy olyan cél létrehozása, amely a telepítés manuális futtatásához BeforeRestore előtt fut.
  2. Ha egy globális csomagtelepítési mechanizmus létezik a megoldásban, amely szükségtelensé teszi az egyes telepítések futtatását.

ShouldRunBuildScript

A ShouldRunBuildScript tulajdonság azt határozza meg, hogy npm run build futtasson-e buildparancsokon. A tulajdonság alapértelmezett értéke true, ha nincs megadva.

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

Olyan projektek esetén, amelyek csak olyan JavaScriptet tartalmaznak, amelyekhez nem szükséges az építkezés, állítsa ezt a tulajdonságot false. Az újonnan létrehozott React-, Vue- és Angular-projektek általában ebbe a kategóriába tartoznak. Ebben a forgatókönyvben a buildet éles környezetben használják, és nem hibakeresésre. Vegye figyelembe, hogy a Build és a Publish parancsok JSPS-projektekben különállóak, és Publish akkor is futnak, ha ez a tulajdonság be van állítva.

Parancs tulajdonságai

A parancstulajdonságok olyan tulajdonságok, amelyek a gyakori package.json szkriptek MSBuild-célokra való leképezésére szolgálnak. Az alapértelmezett értékek az összes ilyen tulajdonság esetében támogatottak, az ebben a szakaszban leírtak szerint.

Ezeket a tulajdonságokat az npm-től eltérő csomagkezelők vagy szkriptmotorok, például gulphasználatakor állíthatja be.

A következő MSBuild tulajdonságokat ebben a szakaszban ismertetjük:

BuildCommand

A BuildCommand tulajdonság határozza meg a build cél viselkedését. Ha a társított package.jsonbuild vagy compile szkriptet tartalmaz, az alapértelmezett BuildCommand érték már be van állítva a futtatásra.

A parancs módosításához a npmhasználatakor adja meg a npm run.

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

StartupCommand

A StartupCommand tulajdonság határozza meg a dotnet run cél viselkedését. Ha a társított package.jsonstart, servervagy dev szkriptet tartalmaz, az alapértelmezett StartupCommand érték már be van állítva a szkriptek futtatására.

Ha módosítja a parancsot, a npmhasználatakor adja meg a npm run.

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

TestCommand

A TestCommand tulajdonság határozza meg a test cél viselkedését. Ha a társított package.jsontest szkriptet tartalmaz, az alapértelmezett TestCommand érték már be van állítva a szkript futtatására.

Ha módosítja a parancsot, a npmhasználatakor adja meg a npm run.

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

CleanCommand

A CleanCommand tulajdonság határozza meg a clean cél viselkedését. Ha a társított package.jsonclean szkriptet tartalmaz, az alapértelmezett CleanCommand érték már be van állítva a szkript futtatására.

Ha módosítja a parancsot, a npmhasználatakor adja meg a npm run.

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

PublishCommand

A PublishCommand tulajdonság határozza meg a publish cél viselkedését. Ha a társított package.jsonpublish szkriptet tartalmaz, az alapértelmezett PublishCommand érték már be van állítva a szkript futtatására. Az npm-ben gyakori, hogy előzetes és utólagos közzétételi szkriptek is futnak, amelyek szintén futni fognak.

Ha módosítja a parancsot, a npmhasználatakor adja meg a npm run.

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

Lásd még: