This how-to is based on the SPCAF how-to written for TFS 2012.

If you are looking how to run SPCAF v4 during TeamBuild in TFS 2013, see this post.

SharePoint code analysis with SPCAF can also be executed during a TFS Team Build. This helps to ensure the correctness of the SharePoint code. During the Team Build all found errors and warnings are listed in the build result. Additionally the SPCAF reports can be generated and saved to the output directory.

SPCAF supports the Team Build with the following products:

• TFS 2010
• TFS 2012
• TFS 2013 (with this how-to)
• Visual Studio Online

To support TFS 2010 and TFS 2012/2013 and VSO, SPCAF comes with 2 different build activities which can be integrated into the workflow of a Team Build, depending on the version of TFS. The build activities can be found within the installation directory of SPCAF in subfolder “TeamBuildActivities”.

• SPCAF.BuildActivity.TFS2010.dll for TFS 2010
• SPCAF.BuildActivity.TFS2012.dll for TFS 2012/2013 and Visual Studio Online

Note: The build activities should not be copied directly into the installation folder of SPCAF because SPCAF searches during analysis within the installation folder for custom rules. As the activities depend on Team Build assemblies they cannot be loaded and SPCAF cannot execute.

Note: If you are not familiar with configuration of team builds in TFS please request somebody to help you.

The following steps provide the general instructions for the Team Build. Some standard TFS configuration steps are skipped.

Preparation

To run SPCAF on the build server the SPCAF assemblies must be available on the build server. You don’t need to install SPCAF on the server!

Note: You can download a preconfigured package of SPCAF Server from the Visual Studio Gallery and skip steps 2 to 4 of the following description.

1. Open Source Control of TFS and navigate to folder “BuildProcessTemplates” of your team project. It is possible that this folder does not exist in your TFS 2013 team project. You can create it manually.

2. Create a subfolder “CustomAssemblies” and check in

3. Within this folder create a subfolder “SPCAF”

4. Copy only the following assemblies from SPCAF installation directory to that folder:

   • ICSharpCode.Decompiler.dll
   • ICSharpCode.NRefactory.CSharp.dll
   • ICSharpCode.NRefactory.dll
   • Jurassic.dll
   • log4net.dll
   • Microsoft.Deployment.Compression.Cab.dll
   • Microsoft.Deployment.Compression.dll
   • Mono.Cecil.dll
   • Mono.Cecil.Pdb.dll
   • SPCAF.Dependencies.dll
   • SPCAF.exe
   • SPCAF.exe.config
   • SPCAF.Engine.dll
   • SPCAF.Engine.dll.config
   • SPCAF.Inventory.dll
   • SPCAF.Metrics.dll
   • SPCAF.Reports.dll
   • SPCAF.Reports.Engine.dll
   • SPCAF.Reports.MigrationAssessment.dll
   • SPCAF.Rules.Apps.dll
   • SPCAF.Rules.dll
   • SPCAF.Rules.JavaScript.dll
   • SPCAF.Rules.MigrationAssessment.dll
   • SPCAF.Integration.CSSLint.dll
   • SPCAF.Integration.CSSLintRunner.exe
   • SPCAF.Integration.JSHint.dll
   • SPCAF.Integration.JSHintRunner.exe
   • SPCAF.Sdk.dll
   • SPCAF.Sdk.XmlSerializers.dll
   • log4net.config
   • RazorEngine.dll
   • System.Web.Razor.dll

   Do not deploy the assemblies

   • SPCAF.VSPackage
   • SPCAF.VSPackage.Common

5. Also include the License.lic file with your license (can be found in users AppData directory)

6. Copy the assembly from folder “TeamBuildActivites” in the SPCAF installation directory to that folder in TFS

7. Copy the folder “RuleSets” to the folder in TFS

   You should end up as shown in the following screenshot:

   

Configure Build Controller to load the SPCAF Assemblies

Now we need to tell the Build Controller that during a build the SPCAF assemblies should be loaded.

Add SPCAF Build Activity to the Process Template

It is possible to manually edit the process template with a text editor. In this how-to you are going to use the designer in Visual Studio.

Add Build Activity with Designer in Visual Studio

If you don’t want to add the build activity to the process template in XML you can use a visual designer in Visual Studio.

1. Make a copy of an existing Process Template e.g. DefaultTemplate.xaml in TFS an name it for instance DefaultTemplateSPCAF.xaml

2. Create a new project of type Class library in Visual Studio and delete the default created Class.cs

3. Add the copied Process template ‘DefaultTemplateSPCAF.xaml’ to the project via “Add Existing Item” and navigate to the folder with DefaultTemplateSPCAF.xaml. Important: Select “Add As Link” in the dialog to add only a link to the file.

   

4. Add the necessary reference to the project:

   • Microsoft.TeamFoundation.Build.Workflow.dll
   • Microsoft.TeamFoundation.VersionControl.Client.dll
   • Microsoft.TeamFoundation.VersionControl.Common.dll

5. Add reference to SPCAF.BuildActivity.TFS2012 to the project from the previously created folder “CustomAssemblies”

   See below the Visual Studio project with all references, the linked DefaultTemplateSPCAF.xaml

   

6. Open the process template in designer.

7. Add the SPCAF build activity to the toolbox: Right click in toolbox and select “Choose items…”. In tab System.Activites Components select “Browse…” and select the assembly SPCAF.BuildActivity.TFS2012 from the folder “CustomAssemblies”. The Build Activity appear in the toolbox.

8. Because in TFS 2013 the default build process template is a little bit different we need to add a variable to store the path to the Binaries Directory. Open the tab “Variables”, add a variable named “BinariesDirectory” with the type “String”, you can leave the scope in its default setting.

   

9. In the process template navigate to Compile, Test and Publish and open the try block. Drag a GetEnvironmentVariable activity below the “Get Impacted Tests”-activity. Set the activity arguments according to the table below:

   Argument	Value
   Name	Microsoft.TeamFoundation.Build.Activities.Extensions.WellKnownEnvironmentVariables.BinariesDirectory
   DisplayName	Get Binaries Folder
   Result	BinariesDirectory

10. Drag the SPCAF build activity below the Get Binaries Folder activity.

    You should end up with the following setup:

    

11. Configure the SPCAF build activity to your needs (see parameters below).

    

12. Save the process template and check in.

Parameters of Build Activity

The following parameters can be configured for the build activity.

The build activity returns the following values after analysis.

Create a new Build Definition

Now we can use the new process template in a new Build Definiiton

1. Create a new Build Definition in TFS

2. In the build definition goto tab “Process” and select “New..” and “Select an existing XAML file” and choose the DefaultTemplateSPCAF.xaml

3. For building SharePoint projects a special setting is needed: Go in process tab to “3. Advanced” and change the parameter “MSBuild Arguments” to “/p:IsPackaging=true”. This ensure that during the build process the WSP files are created.

   

4. Run a build with the new Build Definition. To check if SPCAF was configured correctly check the log. There you can find the output of the analysis.

   

5. In case of found errors and warnings during analysis the result can be found in the Build Summary.

   

6. Navigate to the DropLocation. There you should find the created SPCAF reports.