Delen via

Geef op welk MSBuild-doel als eerste moet worden gebouwd

  • Artikel

MSBuild-projectbestanden kunnen een of meer doelen bevatten die bepalen hoe het project wordt gebouwd. MSBuild bouwt het eerste doel dat wordt gevonden, en eventuele afhankelijkheden, tenzij:

  • Het element Project bevat een InitialTargets kenmerk.
  • Het element Project bevat een DefaultTargets kenmerk.
  • De MSBuild-opdracht heeft een -target switch die een doel aangeeft.

Het kenmerk InitialTargets gebruiken

Het InitialTargets kenmerk van het Project-element geeft het eerste doel aan dat als eerste wordt uitgevoerd. Het overschrijft alle opgegeven targets die u met MSBuild op de opdrachtregel of in het DefaultTargets-kenmerk van het Project-element specificeert.

Eén eerste doel opgeven

Geef het standaarddoel op in het kenmerk InitialTargets van het Project-element. Bijvoorbeeld:

<Project InitialTargets="Clean">

Meerdere initiële doelen opgeven

U kunt meer dan één eerste doel opgeven in het kenmerk InitialTargets van het Project-element. Geef de doelen op volgorde weer en gebruik een puntkomma om elk doel te scheiden. De doelen in de lijst worden opeenvolgend uitgevoerd.

Als u bijvoorbeeld het Clean doel wilt uitvoeren en vervolgens het Compile doel, voert u het volgende in:

<Project InitialTargets="Clean;Compile">

Het kenmerk DefaultTargets gebruiken

Het DefaultTargets kenmerk van het Project-element geeft aan welk doel of welke doelen worden gebouwd als een doel niet expliciet op de opdrachtregel is opgegeven.

Als doelen zijn gespecificeerd in zowel het kenmerk InitialTargets als DefaultTargets van het element Project, en er geen doel is opgegeven op de opdrachtregel, voert MSBuild eerst de doelen uit die zijn opgegeven in het kenmerk InitialTargets, gevolgd door de doelen in het kenmerk DefaultTargets.

Eén standaarddoel opgeven

Geef het standaarddoel op in het kenmerk DefaultTargets van het Project-element. Bijvoorbeeld:

<Project DefaultTargets="Compile">`

Meerdere standaarddoelen opgeven

U kunt meer dan één standaarddoel opgeven in het kenmerk DefaultTargets van het Project-element. Geef de standaarddoelen op volgorde weer en gebruik een puntkomma om elk doel te scheiden. De doelen in de lijst worden opeenvolgend uitgevoerd.

Als u bijvoorbeeld het Clean doel wilt uitvoeren en vervolgens het Compile doel, voert u het volgende in:

<Project DefaultTargets="Clean;Compile">

De -target-switch gebruiken om het standaarddoel te overschrijven

Als een standaarddoel niet is gedefinieerd in het projectbestand of als u het gedefinieerde standaarddoel niet wilt gebruiken, kunt u de opdrachtregelswitch -target gebruiken om een ander doel op te geven. Het doel of de doelen die zijn opgegeven met de -target-switch, worden uitgevoerd in plaats van de doelen die zijn opgegeven door het kenmerk DefaultTargets van het Project-element. Doelen die zijn opgegeven in het kenmerk InitialTargets worden altijd eerst uitgevoerd.

Het standaarddoel overschrijven met één doel

Geef het doel op dat moet worden gebruikt als het eerste doel met behulp van de -target opdrachtregelschakelaar met een dubbele punt (:) en de naam van het doel. Bijvoorbeeld:

msbuild file.proj -target:Clean

Het standaarddoel overschrijven met meerdere doelen

Geef een lijst met doelen op die moeten worden gebruikt als de eerste doelen en scheidt deze door puntkomma's met de -target opdrachtregelswitch. Bijvoorbeeld:

msbuild <file name>.proj -t:Clean;Compile

Verwante inhoud