CreateItem vs ItemGroup

Question

¿Cuál es la diferencia entre la creación de un elemento dentro de un objetivo como éste:

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

y como este:

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

¿Cuándo utilizar uno o el otro y por qué?

Answer 1

En versiones de MSBuild anteriores a 3.5 no se podían definir propiedades o elementos dentro de los destinos (como en el segundo ejemplo). Por lo tanto, se utilizó una tarea en su lugar (CreateItem y CreateProperty)

Si está utilizando ToolsVersion 3.5, entonces ya no necesita usar CreateItem (aunque puede hacerlo si lo prefiere).

Al final ambos crean el elemento de la misma manera, con el mismo alcance. Usar la segunda sintaxis es más legible y configurar metadatos personalizados es mucho más fácil (en mi opinión).

NOTA: La versión 3.5 de MSBuild está instalada con .NET 3.5. Aunque necesita definir ToolsVersion="3.5" en la etiqueta Project de su archivo MSBuild para usar las características 3.5.

En caso de que se lo pregunte, obtuve la mayor parte de esta información del libro Inside the Microsoft® Build Engine: Using MSBuild and Team Foundation Build que realmente me gustó (pero no estoy afiliado de ninguna manera).

Answer 2

No creo que la respuesta aceptada haya definido la diferencia.

La diferencia es:

• ItemGroup se evalúa cuando se carga el script MSBuild.
• CreateItem se evalúa cuando el objetivo es ejecutado

Esto puede dar lugar a diferentes valores del artículo dentro del guión.

Tome el ejemplo de una Tarea que hace algo con todos los archivos que coinciden con "* .txt" en un directorio. Si su script MSBuild se carga en Visual Studio, solo los archivos que existían cuando se inició VS estarán en el Item si usa ItemGroup.

Si usa CreateItem, buscará todos los archivos * .txt cuando se ejecute el destino.

Answer 3

CreateItem y CreateProperty están obsoletos en MSBuild 3.5 (aunque siempre seguirán funcionando, por supuesto). Era bastante obvio que necesitábamos la misma sintaxis familiar para ItemGroup y PropertyGroup para trabajar dentro de los objetivos.

Pero ItemGroup dentro de un objetivo tiene algunos poderes especiales adicionales. Puede modificar elementos: por ejemplo, se agregará verdadero a todos los elementos en la lista de Recursos que tienen un metadato llamado Primario con valor de verdadero; solo si no existe ya Copiar metadatos:

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

Otro poder mágico: ahora puede eliminar elementos de una lista.En este ejemplo se va a eliminar todos los elementos de la lista de recursos que han Tipo de metadatos con un valor de mapa de bits:

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

Estos poderes mágicos sólo funcionan en el interior en la actualidad, no afuera.

Para obtener todos los detalles de estas cosas, recomiendo encarecidamente el libro de Sayed Hashimi en MSBuild. Se encuentra fácilmente en Amazon.

Dan - equipo de msbuild.

Answer 4

Como información adicional para otros que pasan aquí: Build-Engine que contiene una API para construir proyectos de MSBuild no admite agregar ItemGroups de la nueva manera a un objetivo. Aquí tendrá que usar la forma antigua.