OCLint

Using OCLint with Jenkins CI

This document shows how to integrate OCLint into Jenkins CI, and render the graphic report by the cooperation between Jenkins’ PMD Plugin and OCLint’s PMD reporter.

Prerequisite

Background

From the very beginning of OCLint project, we have always taken continuous integration into serious consideration. OCLint facilitates this process a lot. It generates the certain type of report as artifact, and it fails your build if any level of violations exceeds the threshold.

In order to utilize the Jenkins CI, we have introduced the PMD reporter that converts the analysis results into the format very close to PMD reports, so that the PMD plugin inside Jenkins can easily picks up this output, categorizes and renders graphic reports for us.

The idea was originally developed by Stephan Esch in his blog post along with his contribution of writing PMDReporter for us.

Setting up Project

  • Create a new free-style project
../_images/jenkins_1.png
  • Set up adequate steps for continuously building the project
../_images/jenkins_2.png

Configuring OCLint and PMD Plugin

  • Add a new build step as an execute shell
../_images/jenkins_3.png
  • Set up command used for OCLint analysis
    • In addition to the script shown in the following screenshot, we may also need to write the compile_commands.json generation commands in advance.
    • In some cases, oclint binary suits better than oclint-json-compilation-database
    • We need to set the report type to pmd
    • Give a name to the output artifact, we will need this file in the following step
../_images/jenkins_4.png
  • Add a new post-build action, and choose Publish PMD analysis results
../_images/jenkins_5.png
  • Enter the output artifact name that matches previous step
../_images/jenkins_6.png

Running Analysis

Same as running regular Jenkins build, it might be triggered by time, by pinging the source control management, and manually. you can see the build history and current build progress.

../_images/jenkins_7.png

Monitoring Results

When the build finishes successfully, we now can go into that build. On the left sidebar, click PMD Warnings to see the report. Following is a screenshot of sorting the results by the type of the rules.

../_images/jenkins_8.png