Juan Pablo Garcia Blog

English Version

Johnny and Ezequiel han publicado en sus Blogs acerca de las Southworks SDC Tasks que hemos publicado dos semanas atrás en Google Code. Este projecto es un set de tasks para MSBuild tasks que construimos mientras madurabamos nuestro proceso de build.

Durante este tiempo voy a intentar darles una guía sobre estas tasks que hemos desarrollado por medio de un ejemplo de cada una de ellas.

En este post van a encontrar de que forma se pueden actualizar los archivos AssemblyInfo con información de la empresa utilizando la task UpdateAssemblyinfo facilmente.

Esta task es basntate simple, entonces, vamos a crear un simple projecto de MSBuild (.proj) para demostrar como funciona.

Referenciando el assembly SDC en el proyecto de MSBuild

El primer paso es añadir la referencia para esta task en particular configurando los nodos AssemblyFile y TaskName con los siguientes valores:

<Project DefaultTargets="UpdateAssemblyInfos" 

         xmlns="http://schemas.microsoft.com/developer/msbuild/2003">

  <UsingTask AssemblyFile="d:\test\Southworks.Sdc.Tasks.dll"

             TaskName="UpdateAssemblyInfo"/> 

</Project>

Hay que tener en cuenta que el nodo DefaultTargets indica cual va a ser el target que va a ejecutarse primero, más adelante voy a incluir este target.

Definiendo que files van a ser actualizados

El siguiente paso es indentificar y configurar cuáles van a ser los archivos que modificará nuestra task y donde se encuentran. Para esto vamos a crear un ItemGroup. Si querés conocer más acerca de incluir y/o excluir items mira este link http://msdn.microsoft.com/en-us/library/646dk05y.aspx.

<Project DefaultTargets="UpdateAssemblyInfos"

         xmlns="http://schemas.microsoft.com/developer/msbuild/2003">

  <UsingTask AssemblyFile="d:\test\Southworks.Sdc.Tasks.dll"

             TaskName="UpdateAssemblyInfo"/>  

  <ItemGroup>

    <AssemblyInfos Include="d:\test\**\AssemblyInfo.cs"/>

  </ItemGroup>

</Project>

Configurando el target UpdateAssemblyinfo

Por último debemos crear y configurar el nuevo target especificando la información que va a ser reemplazada en los archivos que hemos configurado en el paso anterior.

<Project DefaultTargets="UpdateAssemblyInfos" 

         xmlns="http://schemas.microsoft.com/developer/msbuild/2003">

  <UsingTask AssemblyFile="d:\test\Southworks.Sdc.Tasks.dll"

             TaskName="UpdateAssemblyInfo"/>

  <ItemGroup>

    <AssemblyInfos Include="d:\test\**\AssemblyInfo.cs"/>

  </ItemGroup>

  <Target Name="UpdateAssemblyInfos">

    <UpdateAssemblyinfo Include="@(AssemblyInfos)"

                      AssemblyCopyright="Southworks (r) copyright"

                      AssemblyCompany="Southworks"

                      AssemblyProduct="Sample product " />

  </Target>

</Project>

Verificación

Para comprobar que todo esta funcionando, podemos ejecutar el projecto con MSBuild como se muestra en la siguiente imagen:

Por último, abriendo alguno de los  AssemblyInfo.cs incluidos y veremos como se ha actualizado:

Gracias, y sigan atentos!

English Version

Esta última semana estuvimos trabajando en nuestro Build Server utilizando CruiseControl.Net para permitir la posibilidad de ejecutar múltiples Test / Code Coverage tasks para dos o más soluciones.

Una vez que tenemos configurado el MSBuild Project para ejecutar, por ejemplo, un set de dos o más RunTests / RunCoverage tasks, necesitamos fusionar estos resultados al log de MSBuild luego de su ejecución.

Entonces, nuestro primer intento fue modificar el archivo ccnet.config para poder fusionar los archivos generados por estas tasks usando el mismo patrón utilizado por MSBuild, quiero decir, usando /**/, algo como esto:

<merge>

    <files>

        <file>D:\srv\ccnet\logs\project\**\*.trx</file>

        <file>D:\srv\ccnet\logs\project\**\*.cvg</file>

    </files>

</merge>

En ese momento nos dimos cuenta, que CruiseControl.Net no posee esta funcionalidad, únicamente nos permite la utilización de Wildcards de la forma convencional, por ejemplo D:\srv\ccnet\logs\project\theProject\*.trx, y como el código fuente de CruiseControl.Net está disponible, me puse a escribir algunas líneas de código para modificar el assembly ThoughtWorks.CruiseControl.Core para que nos permita utilizar /**/ como lo hace MSBuild.

En este post van a encontrar el código fuente de un Spike que escribí con una serie de test para implementar esta funcionalidad y el código fuente del archivo WildCardPath.cs actualizado que forma parte del Core de proyecto CruiseControl.Net.

• Solucion Spike con unit tests [Download]
• El archivo donde se encuentra la clase WildCardPath del assembly Core de CruiseControl.Net [Download]

Una vez actualizado el proyecto Core con esta nueva implementación, tendrían que seguir los siguientes pasos para dejarlo con esta nueva funcionalidad

1. Compliar el Core Project
2. Parar el servicio de CruiseControl.Net (ccservice)
3. Reemplazar el assembly ThoughtWorks.CruiseControl.Core por el Nuevo
4. Levantar nuevamente el servicio

Y eso es todo, a usar wildcards como en MSBuild :)

English Version

Microsoft ha publicado una gran herramienta llamada Microsoft Source Analysis for C#, conocida también como StyleCop.

Esta herramienta nos permite controlar y mejorar la calidad del código que escribimos. Esta totalmente integrada con Visual Studio, lo que quiere decir que con un simple click derecho en nuestra solución, proyecto o file, podemos comprobar nuestro código teniendo en cuenta las mejores prácticas definidas en una serie de reglas como se muestra a continuación.

Pueden encontrar una descripción mas detallada (inglés) en el siguiente post: Announcing the release of Microsoft Source Analysis for C# y descargarse el instalador desde aquí.

Otra de las opciones que nos brinda esta herramienta, es la posibilidad de personalizar qué reglas van a ser ejecutadas, utilizando la configuración que viene integrada en la UI.

Por último, otra punto importante, es que nos permite integrar este chequeo en nuestro proceso de build por medio de MSBuild. Les recomiendo este blog post (inglés) de Jason Allor’s en la página de Source Analysis donde él explica cómo hacerlo.

Y otro post intereando del MSBuild Team Blog , donde anuncian este release.

Disfrutenlo y diganle adios a los documentos con estándares de código :)