Clover for Jenkins Developer Guide

Preconditions

• You have GitHub account with SSH keys configured and the local SSH key is not protected by password (otherwise release:prepare will hang)

• Configure maven.jenkins-ci.org in settings.xml:

  settings.xml

  <!-- user/password of your Jenkins account! http://jenkins-ci.org/account -->
  <server>
      <id>maven.jenkins-ci.org</id>
      <username>xxx</username> 
      <password>yyy</password>
  </server>

• Clone the repository from GitHub using SSH:

  git clone git@github.com:jenkinsci/clover-plugin.git jenkins-clover-plugin

• JDK1.6+
• Maven 3.0+

Build and Test

1. If you have already cloned jenkinsci/clover-plugin then ensure you git pull upstream

2. Create a JIRA on https://issues.jenkins-ci.org/ for the issue you are fixing.
3. Make changes necessary.
4. Bump the dependency version on Clover Core if necessary (in pom.xml)
5. Test by running Jenkins with the Clover plugin installed and setting up a Clovered project for CI. This can be achieved via:
   mvn clean hpi:run
   
   1. it will start Jenkins on localhost:8080 by default, open it in web browser
   2. open "Manage Jenkins" > "Manage plugins" > "Installed" and check if new "Jenkins Clover Plugin" is listed
   3. configure new project (you can use MoneyBags as a test case) and a build job (e.g. "freestyle project" with "ant task")
   4. configure "Post-build actions" > "Publish Clover Coverage Report" in the build job
   5. run "Build now" and check if Clover summary report is available
6. Commit changes and push to GitHub. Include your JIRA issue from above.

Release and Publish

Run

mvn release:prepare
mvn release:perform

Verify that the plugin has been deployed:

• visit http://maven.jenkins-ci.org/content/repositories/releases/org/jenkins-ci/plugins/clover/
• visit http://repo.jenkins-ci.org/releases/org/jenkins-ci/plugins/
• check http://updates.jenkins-ci.org/update-center.json (file is updated every 6 hours)
• run your local Jenkins and open Administration page, check if you see the latest version number

Documentation

Edit the  http://wiki.jenkins-ci.org/display/JENKINS/Clover+Plugin page.