Share via

Informazioni di riferimento su MSBuild per il sistema di progetti JavaScript

  • Articolo

Questo articolo fornisce informazioni di riferimento per le proprietà e gli elementi di MSBuild che è possibile usare per configurare progetti basati su JavaScript Project System (JSPS), che usano il formato .esproj .

Nota

Le proprietà descritte in questo articolo estendono le proprietà fornite da MSBuild per impostazione predefinita. Per un elenco delle proprietà comuni di MSBuild, vedere Proprietà comuni di MSBuild.

Proprietà ShouldRun

Le proprietà MSBuild seguenti sono documentate in questa sezione:

ShouldRunNpmInstall

La ShouldRunNpmInstall proprietà specifica se eseguire o meno npm install i comandi di compilazione e ripristino. Il valore predefinito per la proprietà è true se non impostato.

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

Due scenari comuni in cui non è in esecuzione npm install è consigliabile:

  1. Quando si usa una gestione pacchetti non npm (ad esempio yarn o pnpm). In questo scenario, la soluzione migliore consiste nel creare una destinazione eseguita prima BeforeRestore di eseguire manualmente l'installazione.
  2. Quando esiste un meccanismo di installazione globale dei pacchetti nella soluzione che rende superflua l'esecuzione di singole installazioni.

ShouldRunBuildScript

La ShouldRunBuildScript proprietà specifica se eseguire npm run build o meno i comandi di compilazione. Il valore predefinito per la proprietà è true se non impostato.

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

Per i progetti contenenti solo JavaScript che non richiedono la compilazione, impostare questa proprietà su false. I progetti React, Vue e Angular appena creati rientrano in genere in questa categoria. In questo scenario, la compilazione viene usata per la produzione e non per il debug. Si noti che i Build comandi e Publish sono separati nei progetti JSPS e Publish vengono comunque eseguiti anche se questa proprietà è impostata.

Proprietà comando

Le proprietà dei comandi sono proprietà destinate al mapping degli script package.json comuni alle destinazioni MSBuild. I valori predefiniti sono supportati per tutte queste proprietà, come descritto in questa sezione.

Impostare queste proprietà quando si usano gestori pacchetti diversi da npm o motori di scripting, ad gulpesempio .

Le proprietà MSBuild seguenti sono descritte in questa sezione:

BuildCommand

La BuildCommand proprietà specifica il comportamento per la build destinazione. Se il file package.json associato contiene uno build script o compile , il valore predefinito BuildCommand è già impostato per eseguirli.

Per modificare il comando, includere npm run quando si usa npm.

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

StartupCommand

La StartupCommand proprietà specifica il comportamento per la dotnet run destinazione. Se l'oggetto associato package.json contiene uno startscript , servero dev , il valore predefinito StartupCommand è già impostato per eseguire questi script.

Se si modifica il comando , includere npm run quando si usa npm.

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

TestCommand

La TestCommand proprietà specifica il comportamento per la test destinazione. Se l'oggetto associato package.json contiene uno test script, il valore predefinito TestCommand è già impostato per eseguire questo script.

Se si modifica il comando , includere npm run quando si usa npm.

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

CleanCommand

La CleanCommand proprietà specifica il comportamento per la clean destinazione. Se l'oggetto associato package.json contiene uno clean script, il valore predefinito CleanCommand è già impostato per eseguire questo script.

Se si modifica il comando , includere npm run quando si usa npm.

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

PublishCommand

La PublishCommand proprietà specifica il comportamento per la publish destinazione. Se l'oggetto associato package.json contiene uno publish script, il valore predefinito PublishCommand è già impostato per eseguire questo script. In npm è comune avere script di pre-pubblicazione e post-pubblicazione, che verranno eseguiti anche.

Se si modifica il comando , includere npm run quando si usa npm.

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

Vedi anche