Skip to main content

TFS2010: Publishing solution projects to their own directories

When looking to automate a TFS2010 build one of the first issues that most people seem to encounter is that all the binaries of each project in a solution end up in the same "bin" directory. The forum post TFS 2010 BUILD SERVER: Can not keep folder tree in the drop location ? details the solution; which is changes to both the CSPROJ file and the workflow template that is called by your build. Note: each CSPROJ file in your project needs to be updated as the workflow loops through the solution finding all the referenced projects.. The answer in the forum post has everything about what is needed but not why, which can be a bit confusing if you're just starting out with TFS / workflow.

The image to the left is the section of the workflow that is changed. The workflow variable "OutputDirectory" is defined within the scope of "Compile and Test for configuration" (highlighted in green). The value of "outputDirectory" is assigned (highlighted in red) and typically just includes the the build name + the build version (so Trunk_20120220.1 would be the first time the trunk build has run on 20th Feb 2012). For the default template the value of "outputDirectory" is assigned to the input argument "OutDir" of the "Run MSBuild for project" step (highlighted in blue). In the default template it is for this reason why all the binaries of all the projects end up in a single directory. The first documented change is to modify the properties of "Run MSBuild for project", the value of "outputDirectory" is no longer passed in the input argument "OutDir" but is assigned to the input argument of "CommandLineArguments" instead.

The code below duplicates the change to the "CommmandLineArguments" input argument referred to in the forum post but highlights the interaction of "OutputDirectory". The value of which is passed as the value of a variable whose name is not important - as long as it matches the reference you add to your CSPROJ file.

String.Format(
"/p:SkipInvalidConfigurations=true {0} /p:TfsProjectPublishDir=""{1}""",
MSBuildArguments, outputDirectory)

The code below shows the corresponding change made to the CSPROJ file. Similar to the previous section the important interaction with the workflow changes are highlighted. The name you use can be any unique variable name that you like that does not clash with existing workflow / environment variables. The change does need to be made to all CSPROJ files and for all configurations that you need to build. In this instances we can build both debug and/or release and we will end up with separate binary directories for each. For each CSPROJ file change the projectname value to a value unique to the project in question.

<PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Debug|AnyCPU' ">
...
<OutputPath Condition=" '$(TfsProjectPublishDir)'=='' ">bin\debug\</OutputPath>
<OutputPath Condition=" '$(TfsProjectPublishDir)'!='' ">$(TfsProjectPublishDir)\projectname\</OutputPath>
...
</PropertyGroup>
<PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Release|AnyCPU' ">
...
<OutputPath Condition=" '$(TfsProjectPublishDir)'=='' ">bin\release\</OutputPath>
<OutputPath Condition=" '$(TfsProjectPublishDir)'!='' ">$(TfsProjectPublishDir)\projectname\</OutputPath>
...
</PropertyGroup>

If you're not familiar with CSPROJ files, they are just XML based files that MSBuild uses to build the referenced project. The "Condition" attribute determines whether that XML element (and any children) are passed to MSBuild. So the first "PropertyGroup" is only present if configuration and platform equal Debug and AnyCPU (respectively), the second if it is equal to Release and AnyCPU. As should be apparent this conditional logic implies that only one of these PropertyGroups should ever be presented to MsBuild and they contain the configuration/platform specific values needed for the build. This conditional logic is how MsBuild behaviour changes between the IDE and TFS. If TfsProjectPublishDir is defined then that "OutputPath" node is included, otherwise the default more familiar "OutputPath" node is presented to MsBuild.

Comments

Popular posts from this blog

Mocking HttpCookieCollection in HttpRequestBase

When unit testing ASP.NET MVC2 projects the issue of injecting HttpContext is quickly encountered.  There seem to be many different ways / recommendations for mocking HttpContextBase to improve the testability of controllers and their actions.  My investigations into that will probably be a separate blog post in the near future but for now I want to cover something that had me stuck for longer than it probably should have.  That is how to mock non abstract/interfaced classes within HttpRequestBase and HttpResponseBase – namely the HttpCookieCollection class.   The code sample below illustrates how it can be used within a mocked instance of HttpRequestBase.  Cookies can be added / modified within the unit test code prior to being passed into the code being tested.   After it’s been called, using a combination of MOQ’s Verify and NUnit’s Assert it is possible to check how many times the collection is accessed (but you have to include the set up calls) and that the relevant cookies have …

Injecting HttpContextBase into an MVC Controller

It is a shame that when the ASP.NET MVC framework was released they did not think to build IoC support into the infrastructure. All the major components of the MVC engine appear to magically inherit instances of HttpContext and it’s related objects – which can cause no end of problems if you are trying to utilise Unit Testing and IoC. Reading around various articles on the subject just to get around this one problem requires the implementation of several different concepts and you are still left with a work around. The code below, along with the other links referenced in this article is my stab at resolving the issue. There’s probably nothing new here, but it does attempt to relate all the information needed to do this for Castle Windsor. The overview is that all controllers will need to inherit from a base controller, which takes an instance of HttpContext into it’s constructor. It then overrides the property HttpContext in the main controller class, supplying it’s own version…

Problem installing AWS CLI

It never feels like a good start when you're trying to start out with something and the install fails with an obscure error! I was just trying to install the Amazon CLI following the instructions at https://aws.amazon.com/cli/ and ran into the following error when running 'pip install awscli': Collecting awscli Could not find a version that satisfies the requirement awscli (from versions: ) No matching distribution found for awscli I appeared to have a correct version of Python installed (v2.7) and checking "PIP -v" indicated that 9.0.1 was installed. That all seemed to tick the required boxes but digging around a little more I did see that some people had had issues with various versions of PIP so I found / ran the following to upgrade to the latest vesion: curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py python get-pip.py This installed v9.0.3 of PIP which burst into life when I re-ran 'pip install awscli' and everything seems to be ok. Like…