131 lines
7.2 KiB
HTML
Executable File
131 lines
7.2 KiB
HTML
Executable File
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
|
<html>
|
|
<head>
|
|
<title>CruiseControl.NET : Visual Studio Task</title>
|
|
<link rel="stylesheet" href="styles/site.css" type="text/css" />
|
|
<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
|
|
</head>
|
|
|
|
<body>
|
|
<table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff">
|
|
<tr>
|
|
<td valign="top" class="pagebody">
|
|
<div class="pageheader">
|
|
<span class="pagetitle">
|
|
CruiseControl.NET : Visual Studio Task
|
|
</span>
|
|
</div>
|
|
<div class="pagesubheading">
|
|
This page last changed on Mar 14, 2009 by <font color="#0050B2">dcameron</font>.
|
|
</div>
|
|
|
|
<p>Most complex build processes use <a href="http://nant.sourceforge.net">NAnt </a> or <a href="http://msdn2.microsoft.com/en-us/library/ms171452.aspx">MSBuild </a> to script the build. However, for simple projects that just need to build a Visual Studio.NET solution, the Visual Studio task <tt><devenv></tt> provides an easier method.</p>
|
|
|
|
<h4><a name="VisualStudioTask-Examples"></a>Examples</h4>
|
|
|
|
<p>Minimalist example:</p>
|
|
<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
|
|
<pre class="code-xml"><span class="code-tag"><devenv></span>
|
|
<span class="code-tag"><solutionfile></span>src\MyProject.sln<span class="code-tag"></solutionfile></span>
|
|
<span class="code-tag"><configuration></span>Debug<span class="code-tag"></configuration></span>
|
|
<span class="code-tag"></devenv></span></pre>
|
|
</div></div>
|
|
<p>Full example:</p>
|
|
<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
|
|
<pre class="code-xml"><span class="code-tag"><devenv></span>
|
|
<span class="code-tag"><solutionfile></span>src\MyProject.sln<span class="code-tag"></solutionfile></span>
|
|
<span class="code-tag"><configuration></span>Debug<span class="code-tag"></configuration></span>
|
|
<span class="code-tag"><buildtype></span>Build<span class="code-tag"></buildtype></span>
|
|
<span class="code-tag"><project></span>MyProject<span class="code-tag"></project></span>
|
|
<span class="code-tag"><executable></span>c:\program files\Microsoft Visual Studio .NET\Common7\IDE\devenv.com<span class="code-tag"></executable></span>
|
|
<span class="code-tag"><buildTimeoutSeconds></span>600<span class="code-tag"></buildTimeoutSeconds></span>
|
|
<span class="code-tag"><version></span>VS2002<span class="code-tag"></version></span>
|
|
<span class="code-tag"></devenv></span></pre>
|
|
</div></div>
|
|
|
|
<h4><a name="VisualStudioTask-ConfigurationElements%3A"></a>Configuration Elements:</h4>
|
|
|
|
<table class='confluenceTable'><tbody>
|
|
<tr>
|
|
<th class='confluenceTh'> Node </th>
|
|
<th class='confluenceTh'> Description </th>
|
|
<th class='confluenceTh'> Type </th>
|
|
<th class='confluenceTh'> Required </th>
|
|
<th class='confluenceTh'> Default </th>
|
|
</tr>
|
|
<tr>
|
|
<td class='confluenceTd'> solutionfile </td>
|
|
<td class='confluenceTd'> The path of the solution file to build. If relative, it is relative to the <a href="Project Configuration Block.html#ProjectConfigurationBlock-workingDirectory">Project Working Directory</a>. </td>
|
|
<td class='confluenceTd'> string </td>
|
|
<td class='confluenceTd'> true </td>
|
|
<td class='confluenceTd'> n/a </td>
|
|
</tr>
|
|
<tr>
|
|
<td class='confluenceTd'> configuration </td>
|
|
<td class='confluenceTd'> The solution configuration to use (not case sensitive). </td>
|
|
<td class='confluenceTd'> string </td>
|
|
<td class='confluenceTd'> true </td>
|
|
<td class='confluenceTd'> n/a </td>
|
|
</tr>
|
|
<tr>
|
|
<td class='confluenceTd'> buildtype </td>
|
|
<td class='confluenceTd'> The type of build. Valid values are <b>Rebuild</b>, <b>Build</b> or <b>Clean</b> (not case sensitive). </td>
|
|
<td class='confluenceTd'> string </td>
|
|
<td class='confluenceTd'> false </td>
|
|
<td class='confluenceTd'> rebuild </td>
|
|
</tr>
|
|
<tr>
|
|
<td class='confluenceTd'> project </td>
|
|
<td class='confluenceTd'> A specific project in the solution, if you only want to build one project (not case sensitive). </td>
|
|
<td class='confluenceTd'> string </td>
|
|
<td class='confluenceTd'> false </td>
|
|
<td class='confluenceTd'> The default is to build all projects selected by the configuration. </td>
|
|
</tr>
|
|
<tr>
|
|
<td class='confluenceTd'> executable </td>
|
|
<td class='confluenceTd'> The path to <tt>devenv.com</tt>. </td>
|
|
<td class='confluenceTd'> string </td>
|
|
<td class='confluenceTd'> false </td>
|
|
<td class='confluenceTd'> (see below) </td>
|
|
</tr>
|
|
<tr>
|
|
<td class='confluenceTd'> buildTimeoutSeconds </td>
|
|
<td class='confluenceTd'> Number of seconds to wait before assuming that the process has hung and should be killed. </td>
|
|
<td class='confluenceTd'> int </td>
|
|
<td class='confluenceTd'> false </td>
|
|
<td class='confluenceTd'> 600 (10 minutes) </td>
|
|
</tr>
|
|
<tr>
|
|
<td class='confluenceTd'> version </td>
|
|
<td class='confluenceTd'> The version of Visual Studio. </td>
|
|
<td class='confluenceTd'> One of VS2002, VS2003, VS2005, VS2008, 7.0, 7.1, 8.0, or 9.0 </td>
|
|
<td class='confluenceTd'> false </td>
|
|
<td class='confluenceTd'> (see below) </td>
|
|
</tr>
|
|
<tr>
|
|
<td class='confluenceTd'> description </td>
|
|
<td class='confluenceTd'> If filled in, this will be shown in the buildstage as the process name<br clear="all" /> </td>
|
|
<td class='confluenceTd'> string <br clear="all" /> </td>
|
|
<td class='confluenceTd'> false <br clear="all" /> </td>
|
|
<td class='confluenceTd'> n/a </td>
|
|
</tr>
|
|
</tbody></table>
|
|
<p>If executable and version are not specified, CC.NET will search the registry for VS.NET 2008, 2005, 2003, and 2002 in that order. If you need to use a specific version when a newer version is installed, you should specify the version property to identify it, or specify the executable property to point to the location of correct version of <tt>devenv.com</tt>.</p>
|
|
|
|
<p><img class="emoticon" src="images/icons/emoticons/warning.gif" height="16" width="16" align="absmiddle" alt="" border="0"/> Note: this task requires you to have Visual Studio .NET installed on your integration server.</p>
|
|
<div class='panelMacro'><table class='infoMacro'><colgroup><col width='24'><col></colgroup><tr><td valign='top'><img src="images/icons/emoticons/information.gif" width="16" height="16" align="absmiddle" alt="" border="0"></td><td>Often programmers like to use a centralised project to build an entire software system. They define specific dependencies and the build order on that specific project to reproduce the behaviours of an nmake build.</td></tr></table></div>
|
|
|
|
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
<table border="0" cellpadding="0" cellspacing="0" width="100%">
|
|
<tr>
|
|
<td height="12" background="http://confluence.public.thoughtworks.org//images/border/border_bottom.gif"><img src="images/border/spacer.gif" width="1" height="1" border="0"/></td>
|
|
</tr>
|
|
<tr>
|
|
<td align="center"><font color="grey">Document generated by Confluence on Mar 14, 2009 02:55</font></td>
|
|
</tr>
|
|
</table>
|
|
</body>
|
|
</html> |