CreateItem vs ItemGroup

Question

Qual è la differenza tra la creazione di un oggetto all'interno di un obiettivo come questo:

<Target Name="DoStuff"> 
    <CreateItem Include="@(IntermediateAssembly)" > 
     <Output TaskParameter="Include" ItemName="FileWrites"/> 
    </CreateItem> 
</Target> 

e in questo modo:

<Target Name="DoStuff"> 
    <ItemGroup> 
     <FileWrites Include="@(IntermediateAssembly)" /> 
    </ItemGroup> 
</Target> 

cui si deve utilizzare uno o l'altro e perché?

Answer 1

Nelle versioni di MSBuild precedenti alla 3.5 non è possibile definire proprietà o elementi all'interno di destinazioni (come nel secondo esempio). È stato quindi utilizzato un task (CreateItem e CreateProperty)

Se si utilizza ToolsVersion 3.5, non è più necessario utilizzare CreateItem (anche se è ancora possibile se si preferisce).

Alla fine entrambi creano l'articolo allo stesso modo, con lo stesso scopo. L'utilizzo della seconda sintassi è più leggibile e l'impostazione di metadati personalizzati è molto più semplice (secondo me).

NOTA: la versione 3.5 di MSBuild è installata con .NET 3.5. Sebbene sia necessario definire ToolsVersion="3.5" nel tag Project del file MSBuild per utilizzare le funzionalità 3.5.

Nel caso ve lo stiate chiedendo, ho ottenuto la maggior parte di queste informazioni dal libro Inside the Microsoft® Build Engine: Using MSBuild and Team Foundation Build che mi è piaciuto molto (ma non sono affiliato in alcun modo).

Answer 2

Non penso che la risposta accettata abbia definito la differenza.

La differenza è:

• ItemGroup viene valutata quando lo script MSBuild viene caricato.
• CreateItem viene valutata quando il target viene eseguito

Questo può portare a differenti valori della voce all'interno dello script.

Prendi l'esempio di un'attività che fa qualcosa con tutti i file che corrispondono a "* .txt" in una directory. Se il tuo script MSBuild è caricato in Visual Studio, solo i file esistenti all'avvio di VS saranno nell'articolo se usi ItemGroup.

Se si utilizza CreateItem, eseguirà una ricerca per tutti i file * .txt quando viene eseguito il target.

Answer 3

CreateItem e CreateProperty sono obsolete in MSBuild 3.5 (sebbene continueranno sempre a funzionare, ovviamente). Era abbastanza ovvio che avevamo bisogno della stessa sintassi familiare per ItemGroup e PropertyGroup per funzionare all'interno delle destinazioni.

Ma Gruppo Oggetti all'interno di un bersaglio ha alcuni poteri speciali extra. Può modificare gli elementi: ad esempio, questo aggiungerà true a tutti gli elementi nell'elenco Risorse che hanno un metadato denominato Primario con valore di true; solo se non è già Copia metadati:

<ItemGroup> 
    <Resources Condition=" '%(Primary)' == 'true' "> 
    <Copy Condition=" '%(Copy)' == '' ">true</Copy> 
    </Resources> 
</ItemGroup> 

Un altro potere magico: ora è possibile rimuovere gli elementi da un elenco.Questo esempio rimuoverà tutte le voci dalla lista delle risorse che hanno i metadati Tipo con il valore di bitmap:

<ItemGroup> 
    <Resources Condition=" '%(Type)'=='Bitmap' " Remove="@(Resources)"/> 
</ItemGroup> 

Questi poteri magici funzionano solo dentro al momento, non al di fuori.

Per i dettagli completi di questa roba, consiglio vivamente il libro di Sayed Hashimi su MSBuild. Si trova facilmente su Amazon.

Dan - team msbuild.

Answer 4

Come informazioni aggiuntive per gli altri che passano qui: Il Build-Engine che contiene un'API per costruire progetti MSBuild non supporta l'aggiunta di ItemGroup alla nuova modalità di destinazione. Qui dovrai usare la vecchia maniera.