An Overview of Team Build in VSTS
Many developers think of build as compilation process which happens when you click F5 in the visual studio. These developers are thinking about the compilation of code which they have created. But in a team environment, there are many other developers who are writing code and one has to compile code created by all. One of the reasons such a compilation or “The build” is required, is to check the effects of code written in one module on the other modules. For example, if a class library contains a class which has a method, which returns an integer whereas the client module of that class library may have a method call for the same method which assumes string as the return type will be incompatible to each other. To find that all the created code integrates and works with each other, we need to build it together.
In Visual Studio Team System, Microsoft has provided a wizard to create such a build. In this article we will study Team Build which is the way to create and execute such a build. We will also study the engine behind Team Build called MSBuild.
With team build we can create a team build type which encapsulate a script to be executed during the build. Team build also provides certain configuration properties which will be used during execution. We start with creating a new team build type through the team explorer. It starts a wizard in which we provide following information
When we complete the wizard, it creates a TfsBuild.proj file which is an XML file of configuration. That file is used by MSBuild to execute the build. We can now execute the build any time.
If we need to customize the build, we can open the script file (TfsBuild.proj) and edit the parameter to be passed to MSBuild.
Team Build does not have any in-built scheduler and so it does not provide scheduled builds out of the box. However, it does have a command line tool to start team-builds. Any scheduler like the Windows Task Scheduler can be easily setup to use this command line Team Build utility to start builds at predetermined time. The Task Scheduler can be setup using a simple batch file or manually using the Add Scheduled task wizard that comes with Windows.
Since the scheduler will use the command line TfsBuild.exe utility, you'll need to start the scheduler on either any one of the TFS clients or on a Build Machine.
To open Scheduled Tasks on Windows XP or Windows 2003, click Start > All Programs, > Accessories > System Tools > Scheduled Tasks and then Add Scheduled Task. Then choose the TfsBuild.exe (ProgramFiles\Microsoft Visual Studio 8\Common7\IDE\TfsBuild.exe) as the executable and set the schedule and the account information under which you want to run the TfsBuild. At the last page ensure that the "Open advanced properties..." is checked before you hit finish...
In the dialog that opens enter the arguments in the Run text box so that it’s like...
"d:\Program Files\Microsoft Visual Studio 8\Common7\IDE\TfsBuild.exe" start <TfsServer> <Team Project> <Build Type name>
We can also do it by creating a batch file and running the batch file through a scheduler.
Let us now see the structure of the MSBuild script. It is a hierarchy of XML sections and tags.
The MSBuild Project File is an XML file that tells MSBuild what needs to be built, as well as how to build it. The file is divided into four main sections:
Items define what you want to compile. They are grouped into collections, which can then be used by Tasks. These collections are called ItemGroup. For example Listing 1 shows the collection which enumerates files to be included in the build.
<FilesToCompile Include=”\sub\**\*.cs” />
<FilesToCompile Include=”*util.cs” Exclude=”hiddenutil.cs”/>
Properties are scalar values that help configure the build. Properties are also grouped into PropertyGroup collections.
MSBuild defines some reserved properties and they are listed in the table below:
Table 1: Reserved properties
Folder in which the project is stored
Filename of the project file
File extension of the project file
Full pathname of the project file
Name of the project file without extension
List of targets specified in project’s DefaultTargets attribute
Folder in which msbuild.exe is stored
Listing 2 shows the definition and use of the property in a PropertyGroup.
In this listing, to create output path of the assembly, we are internally using a property defined earlier that is “OutputDir” as well as a standard property “MSBuildProjectName”. The way to use a property has a special syntax of $(Property Name).
Tasks are executable code that MSBuild uses to perform the build. Tasks are written in managed code, and can be shared and used across different projects. MSBuild ships with several tasks, and you can also create your own custom tasks.
A task is just a class that implements a particular interface (ITask) with task attributes corresponding to public properties on the task class. The file that maps these built-in tasks to the assemblies they are contained in is Microsoft.Common.Tasks in the .NET framework directory. An excerpt from this file is shown in Listing 3.
<UsingTask TaskName=”Csc” AssemblyName=”Microsoft.Build.Tasks,
<UsingTask TaskName=”MakeDir” AssemblyName=”Microsoft.Build.Tasks,
Targets are used to group tasks together in a certain order and expose sections of the project file as entry points into the build process. Targets are somewhat similar to functions of programming languages. Similar to functions they are declared at one place and contain executable lines. They are called by the script as needed. As in the case of functions, one target can invoke other targets. It is possible to create a separate .target file to contain individual or grouped targets to improve reusability.
The following code example shows a Target element that executes the Csc task.
<Target Name="Compile" DependsOnTarget="Resources" >
The following example shows a project file that compiles a Visual C# application and logs a message containing the output file name.
<Project DefaultTargets = "Compile"
<!-- Set the application name as a property -->
<!-- Specify the inputs by type and file name -->
<CSFile Include = "consolehwcs1.cs"/>
<Target Name = "Compile">
<!-- Run the Visual C# compilation using input files of type CSFile -->
Sources = "@(CSFile)"
OutputAssembly = "$(appname).exe">
<!-- Set the OutputAssembly attribute of the CSC task
to the name of the executable file that is created -->
TaskParameter = "OutputAssembly"
ItemName = "EXEFile" />
<!-- Log the file name of the output file -->
<Message Text="The output file is @(EXEFile)"/>
In this example, we have defined a target named “Compile”. This target encapsulates a task “CSC” which is one of the built in tasks. It also uses another built in task named “Message”. These tasks in turn use a property named appname and an item named CSFile. The “Compile” target is called by msbuild as it is given as the default target of the project.
Team build is a GUI tools in VSTS to create a compiled version of the application. It uses msbuild technology to execute certain tasks in a specific order. Configuration of build is provided through a .proj file which is an XML file having certain schema. In this article we studied the team build wizard as well as the structure of the msbuild configuration file.
I hope this article was useful and I thank you for viewing it. If you liked the article, please subscribe to my RSS feed over here.
This article has been editorially reviewed by Suprotim Agarwal.
C# and .NET have been around for a very long time, but their constant growth means there’s always more to learn.
We at DotNetCurry are very excited to announce the The Absolutely Awesome Book on C# and .NET. This is a 500 pages concise technical eBook available in PDF, ePub (iPad), and Mobi (Kindle).
Organized around concepts, this eBook aims to provide a concise, yet solid foundation in C# and .NET, covering C# 6.0, C# 7.0 and .NET Core, with chapters on .NET Standard and the upcoming C# 8.0 too. Use these concepts to deepen your existing knowledge of C# and .NET, to have a solid grasp of the latest in C# and .NET OR to crack your next .NET Interview.
Click here to Explore the Table of Contents or Download Sample Chapters!