Click here to Skip to main content
11,581,852 members (72,036 online)
Click here to Skip to main content

Solution Build Timer for VS2005/2013

, 8 Apr 2015 CPOL 32.6K 443 18
Rate this:
Please Sign up or sign in to vote.
Add-in for VS2005 or VS2013 that provides the time taken to build a complete solution.

Introduction

This add-in allows users of Visual Studio 2005 or Visual Studio 2013 to see the time taken to build a complete solution.

Background

I recently discovered a blog post that referred to an undocumented switch (/MP) in Visual Studio 2005 C++ solutions that would compile source files in multiple threads.

I wanted to determine the time saving I would get on our 30 project solution, so needed to time a solution build with and without the switch. Unfortunately, the VS2005 C++ project settings that allow you to switch on build timing will not time the entire solution, only the time to build each individual project. After suffering through two builds using a stopwatch to determine the total build times (for the record, 28m 26s without the switch, and 17m 42s with), I searched for a way to get the IDE to tell me the total build time.

Googling the problem led me to other blog and forum posts from people complaining of this missing feature (which was present back in the days of Visual Studio 6).

My solution was to use the IDE automation present in Visual Studio 2005 to add back a most welcome feature.

How the code works

The add-in was initially generated using the Visual Studio 2005 C# AddIn wizard. This created the framework on which the rest of the code could be hung.

The IDE automation model exposes two events, OnBuildBegin and OnBuildDone, which were perfect for use in the add-in as they are fired when a build is started and after it ends.

In the OnConnection event of the add-in, we get the window pane to which we intend to send output (in this case, the Build window) and add our own event handlers to the IDE:

public void OnConnection(object application, ext_ConnectMode connectMode,
                         object addInInst, ref Array custom)
{
  _applicationObject = (DTE2)application;
  _addInInstance = (AddIn)addInInst;
  // We want our output in the Build window
  OutputWindow outputWindow = 
   (OutputWindow)_applicationObject.Windows.Item(Constants.vsWindowKindOutput).Object;
  outputWindowPane = outputWindow.OutputWindowPanes.Item("Build");
  // Add ourselves as a OnBuildBegin/OnBuildDone handler
  EnvDTE.Events events = _applicationObject.Events;
  buildEvents = (EnvDTE.BuildEvents)events.BuildEvents;
  buildEvents.OnBuildBegin += 
   new _dispBuildEvents_OnBuildBeginEventHandler(this.OnBuildBegin);
  buildEvents.OnBuildDone += 
   new _dispBuildEvents_OnBuildDoneEventHandler(this.OnBuildDone);
}

In the OnDisconnection event of the add-in, we clean up after ourselves:

public void OnDisconnection(ext_DisconnectMode disconnectMode, ref Array custom)
{
  // Remove ourselves as a OnBuildBegin/OnBuildEnd handler
  if (buildEvents != null)
  {
    buildEvents.OnBuildBegin -=
     new _dispBuildEvents_OnBuildBeginEventHandler(this.OnBuildBegin);
    buildEvents.OnBuildDone -=
     new _dispBuildEvents_OnBuildDoneEventHandler(this.OnBuildDone);
  }
}

The meat of the add-in comes in the handlers that we added during the OnConnection event. Firstly, the OnBuildBegin event:

public void OnBuildBegin(EnvDTE.vsBuildScope Scope, EnvDTE.vsBuildAction Action)
{
  // Check for a solution build for Build or RebuildAll
  if (EnvDTE.vsBuildScope.vsBuildScopeSolution == Scope &&
      (EnvDTE.vsBuildAction.vsBuildActionBuild == Action ||
       EnvDTE.vsBuildAction.vsBuildActionRebuildAll == Action))
  {
    // Flag our build timer
    amTiming = true;
    dtStart = DateTime.Now;
    outputWindowPane.OutputString(String.Format(
         "Starting timed solution build on {0}\n", dtStart));
  }
}

The OnBuildBegin event first checks that we are building a solution (as opposed to a project), and further limits our timing to the Build or Rebuild All commands (we want to ignore Clean commands). If the checks are successful, we then set a flag to say we are timing the build, get the current date and time, and send that to the Build window.

Secondly, the OnBuildDone event:

public void OnBuildDone(EnvDTE.vsBuildScope Scope, EnvDTE.vsBuildAction Action)
{
  // Check if we are actually timing this build
  if (amTiming)
  {
    amTiming = false;
    dtEnd = DateTime.Now;
    outputWindowPane.OutputString(String.Format(
        "Ended timed solution build on {0}\n", dtEnd));
    TimeSpan tsElapsed = dtEnd - dtStart;
    outputWindowPane.OutputString(String.Format("Total build time: {0}\n", 
                                                tsElapsed));
   }
}

The OnBuildDone event first checks that we were actually timing the build. If that is correct, we then get the current date and time, send that to the Build window, calculate the elapsed time between the start and the end of the build and, finally, send that to the Build window.

Points of interest

I found it quite difficult to determine what was available in terms of automation in the IDE. The MSDN Help on the subject appears to be sorely lacking for someone just starting out in the world of add-ins (this is only my third).

I did find a very helpful resource in the VS2005 Automation samples (downloadable from the Microsoft website) which gave me all the entry points I needed once I could browse the source code.

Visual Studio 2013

When Visual Studio 2013 was introduced I noticed that there was now an option to enable build timings for C++ solutions (Tools > Options > Projects and Solutions > VC++ Project Settings > Build Timing).

I promptly enabled this option and discovered that the IDE developers had gone overboard with the detail they provide in the timing output. I still prefer the output from my original Solution Build Timer so wanted to enable it in VS2013.

Microsoft has introduced VSPackages in place of Add Ins so I created a new package in VS2013 and moved the original code across.

The result is downloadable as SolutionBuildTimer2013.zip. This contains the source code for the extension as well as a vsix package that you can install by simply double-clicking the file.

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)

Share

About the Author

Brett Rowbotham
Architect Knowledge Base Software
South Africa South Africa
No Biography provided

You may also be interested in...

Comments and Discussions

 
QuestionHow to install and does it work with VS 2008 Pin
bencbr22-Apr-09 9:49
memberbencbr22-Apr-09 9:49 
AnswerRe: How to install and does it work with VS 2008 [modified] Pin
Brett Rowbotham22-Apr-09 18:46
memberBrett Rowbotham22-Apr-09 18:46 
GeneralRe: How to install and does it work with VS 2008 Pin
bencbr23-Apr-09 4:24
memberbencbr23-Apr-09 4:24 
GeneralRe: How to install and does it work with VS 2008 Pin
Brett Rowbotham23-Apr-09 4:39
memberBrett Rowbotham23-Apr-09 4:39 
I set the addin to run only with the GUI. You could set it to run with the command line but that might require changing some of the event handlers and/or the events to which it reacts.

Cheers,
Brett
GeneralRe: How to install and does it work with VS 2008 Pin
Don Shrout5-May-09 11:20
memberDon Shrout5-May-09 11:20 
GeneralRe: How to install and does it work with VS 2008 Pin
Member 457912418-May-10 2:49
memberMember 457912418-May-10 2:49 
GeneralRe: How to install and does it work with VS 2008 Pin
Brett Rowbotham18-May-10 3:04
memberBrett Rowbotham18-May-10 3:04 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

| Advertise | Privacy | Terms of Use | Mobile
Web04 | 2.8.150603.1 | Last Updated 8 Apr 2015
Article Copyright 2008 by Brett Rowbotham
Everything else Copyright © CodeProject, 1999-2015
Layout: fixed | fluid