= MsxBuild =

Microsoft .NET comes with a build tool called "msbuild" which Novell Mono calls "xbuild". This document will use the name "msbuild" henceforth, but will be referring to both of them as they take the same input files and produce the same results.

== Example ==

{{{
#!xml
<Project DefaultTargets="Build"
    xmlns="http://schemas.microsoft.com/developer/msbuild/2003">

	<PropertyGroup>
		<ProjectName>Company.Project</ProjectName>
        <OutputDir>build</OutputDir>
		<BuildPartsDir>parts</BuildPartsDir>
	</PropertyGroup>

	<ItemGroup>

		<CobraFlags Include="-d"/>
		<CobraFlags Include="-correct-source"/>

		<CobraFiles Include="source\A.cobra"/>
		<CobraFiles Include="source\B.cobra"/>
		<CobraFiles Include="source\C.cobra"/>

		<References Include="System"/>
		<References Include="System.Web"/>

	</ItemGroup>

	<Target Name="Clean">
		<RemoveDir Directories="$(OutputDir)"/>
	</Target>

	<Target Name="Build">
		<CallTarget Targets="Reset"/>
		<Exec Command="cobra -c -t:lib @(CobraFlags, ' ') -out:$(OutputDir)/$(ProjectName).dll @(References -> '-ref:%(Identity)', ' ') @(CobraFiles, ' ')"/>
	</Target>

	<Target Name="Test">
		<CallTarget Targets="Reset"/>
		<Exec Command="cobra -test @(CobraFlags, ' ') -out:$(OutputDir)/$(ProjectName).dll @(References -> '-ref:%(Identity)', ' ') @(CobraFiles, ' ')"/>
	</Target>

	<Target Name="Reset">
		<CallTarget Targets="Clean"/>
		<MakeDir Condition="!Exists('$(OutputDir)')" Directories="$(OutputDir)"/>
	</Target>

</Project>
}}}

Then at the command line, a simple "msbuild" (or "xbuild" on Mono) will pick the lone *.proj file and build its default target:
{{{
msbuild
}}}

If there is more than one .proj file, you can pass it on the command line:
{{{
msbuild foo.proj
}}}

To build a specific target:
{{{
msbuild /t:test
}}}
Targets are case insensitive.


== Notes ==

You don't need to use a build tool for single files or very small projects.

You can embed library references in your Cobra source code with the RefDirective (@ref) and thereby skip passing them on the command line.

Alternatives to msbuild/xbuild include Nant, Make and scripts (such as bash or .bat).


== External Links ==

 * [http://msdn.microsoft.com/en-us/library/wea2sca5(v=vs.90).aspx MSBuild] and [http://msdn.microsoft.com/en-us/library/0k6kkbsd.aspx MSBuild Reference] pages at MSDN
 * [http://www.mono-project.com/Microsoft.Build Novell Mono page on msbuild/xbuild]
 * [http://mono-project.com/Porting_MSBuild_Projects_To_XBuild Porting MSBuild Projects to XBuild]
 * [http://rhysc.blogspot.com/2010/05/msbuild-101.html MSBuild 101 Tutorial]
 * [http://www.sedodream.com/PermaLink,guid,ed3a0c98-fdac-4467-9116-5b3bf6755abc.aspx How to Build Several Projects]
 * [http://stackoverflow.com/questions/3008927/ How to separate items with a space rather than semicolon]

== See Also ==

 * CommandLine
 * BuildTools
 * RelatedProjects