HeadSpin provides a plugin to Jenkins that does a deep integration of the HeadSpin session with the Jenkins concept of build. Using the HeadSpin plugin, each session is tagged with the build_id. This allows viewing all devices in use during a build, as well as end of build statistics based on the HeadSpin performance data. This document will explain how to configure and use the plugin.
Usage of this plugin requires a HeadSpin API token. You must have a HeadSpin account to generate an API token. You can sign up for a new account at https://ui.headspin.io/register?referral=jenkins. Further configration of the plugin can be found under https://ui.headspin.io/mysettings.
Installation
The HeadSpin plugin is hosted at https://plugins.jenkins.io/headspin as well as the Jenkins Maven reposity under io.jenkins.plugins:headspin
.
- Go to
Manage Jenkins
>Manage Plugins
. - Search for
HeadSpin
onAvailable
tab. - Check the
Install
box and click theInstall without restart
orDownload now and install after restart
button.
Set up
-
Create a Freestyle project.
-
Add
Archive the artifacts
onPost-Build Actions
-
Enter the file path. (The base directory is the workspace).
For example:
**/my-app.apk
-
Add
HeadSpin Jenkins Plugin
onPost-Build Actions
. -
Add HeadSpin API Token.
-
Enter Package Name for Android app or App Id for IOS app.
-
Enter Activity Name of the app where automation tests will start from.
-
Add HeadSpin Tests with selectors that choose a device and commands that run automation scripts.
-
Save.
Post-Build
Summary
Summary page shows device views of running tests.
Analysis
Analysis page ("HeadSpin Report") gives useful information about performance of your app.
Changelog
1.0 (August 2019)
Initial release
Credits
jenkins-headspin-plugin
is maintained by HeadSpin. HeadSpin is the next generation global platform for mobile app testing and monitoring.