[New for Release 1.3.0.0]

The SPDisposeCheck activity can be used to run the SPDisposeCheck.exe tool to check for coding best practices in SharePoint assemblies. For more details on this tool see the SharePoint Dispose Checker site. In this example we aim to show the basic steps that are required to get the activity integrated into a build.

Note: That SPDisposeChecker, like any other command line tools, can be integrated with TFS build using the InvokeMethod activity. This activity custom provides no new features over a direct call using InvokeMethod. However, it does wrapper the command in a hopefully easier to use way.

Before you can make use of any of the TFS 2010 community build activities you have to make sure they are available for the build system and on your development PC. Instructions for this process can be found in the ALM Rangers build guide or in the StyleCop page of this wiki. This page assumes the SPDisposeCheck activity is available in the developers build process workflow toolbox.

Installing SPDisposeChecker

The current version of the SPDisposeCheker can be downloaded from the SharePoint Dispose Checker site. This needs to be installed on the build agent PC.

Add the activity to the workflow

The SPDisposeChecker activity should added to the workflow. As the tool works with compiled assemblies it is probably best to place it just after the build workflows Compile and Tests block.

image_thumb1

Setting the Properties

The following properties need to be set (as a minimum)

image

AssemblyDirectory
(Required) – this folder to check for assemblies to scan. You don’t have to worry about selecting only SharePoint assemblies. If you try to scan a non SharePoint assemblies the tool will just find no issues. So a good starting option is to just use outputDirectory.
LogFile
This is folder to dump the analysis results in.  A good default is BuildDetail.DropLocation as this places the report file in the build drop location which can be accessed by all
SPDisposePath
The activity will try to look for the command line exe in it’s default location. If this fails a hard coded path can be entered in this property e.g. "C:\Program Files (x86)\Microsoft\SharePoint Dispose Check\SPDisposeCheck.exe"

 

Running the Build

When the build is run, and if a SPDispose violation is found, then the build will fail and the number of issues will be listed in the build report summary. The details of the issues will be found in the report file in the drops location (if using the setting above)

The activity also returns an out bool parameter AnalysisFailed to indicated if any issues were found, which can be used in the build workflow.

image

Last edited Mar 20, 2012 at 3:58 PM by rfennell, version 3

Comments

No comments yet.