Get access to Build Changelog in Jenkins

Tag: svn , jenkins , testflight Author: helloguys Date: 2012-07-21

I've been pulling my hair out trying to find a way to include the list of changes generated by Jenkins (from the SVN pull) into our Testflight notes. I'm using the Testflight Plugin, which has a field for notes - but there doesn't seem to be any paramater/token that jenkins creates to embed that information.

Has anyone had any luck accomplishing something like this?

I needed the exact same thing. Thank you for asking this question, and I'm even more grateful for the answer.

Best Answer

It looks like the TestFlight Plugin expands variables placed into the "Build Notes" field, so the question is: how can we get the changes for the current build into an environment variable?

As far as I'm aware, the Subversion plugin doesn't provide this information via an environment variable. However, all Jenkins SCM plugins integrate changelog information, as you can see via the "Changes" link in the web UI for each build.

This information is also available via the Jenkins API, even while a build is in progress.

For example, if you add an "Execute shell" build step where you run this command:

curl -s "http://jenkins/job/my-job/$BUILD_NUMBER/api/xml?wrapper=changes&xpath=//changeSet//comment"

You'll get an XML document similar to this:

  <comment>First commit.</comment>
  <comment>Second commit.</comment>

You can then format this information however you like and place it into an environment variable which can then be referenced in the TestFlight "Build Notes" section.

However, setting an environment variable in a build step isn't persistent by default — to do so requires using the EnvInject Plugin.

In this case, you could write your changelog text to a temporary file with contents like:

CHANGELOG="New in this build:\n- First commit.\n- Second commit."

Then, by using a build step with the Environment Properties File Path option to load this file, the $CHANGELOG variable would exist in your environment and persist until the end of the build, allowing you to use it in the "Build Notes" field.

Note: I haven't used the TestFlight plugin myself (though I took a quick look at the code), and I only tested the changes API with a Git repository. Similarly, I didn't test how newlines should be encoded with the EnvInject plugin, so that could cause issues.


Thank you so much, Christopher!
BTW, "you can then format this information however you like" -- I used: sed -e "s/<\/*comment>//g" | sed '/^$/d;G' to strip out the XML <comment> tags and clean up the newlines.
To get a clean output of multiple change messages, I used this variation on @makdad's: sed -e "s/<\/comment>//g; s/<comment>/\t* /g; s/<\/*changes>//g" | sed '/^$/d;G'

Other Answer1

I am using this one found here:

${CHANGES, showPaths=true}

Stupid simple and it works for SVN.

Other Answer2

The Testflight Plugin has an option for this. Here's the commit:

I didn't see it in the most recent testflight-plugin release so I built the plugin from git and it has this option.

enter image description here


This won't help you if the testflight runs as a downstream project.