SOASTA CloudTest Plugin for Jenkins
The CloudTest Jenkins plugin provides the ability to:
- easily run the MakeAppTouchTestable utility on an iOS or Android project
- silently install an iOS app on a connected device
- play CloudTest compositions and include the output in the build's test results
The CloudTest plug-in requires Jenkins 1.447 or later.
Global Configuration Options
Before using the plug-in, you will need to provide the CloudTest server information, in the "Manage Jenkins" -> "Configure System" page. This includes the CloudTest URL and a set of credentials. We recommend creating a dedicated CloudTest account for Jenkins to use.
The CloudTest password is encrypted before saving it to disk. It is also masked (e.g. "****") in all output generated during builds.
The plug-in adds the following new build steps:
Make App TouchTestable
Adds the TouchTest Driver library to your app's source code or to your iOS ipa, app, or apk file. For adding the TouchTest Driver library to the source, typically this build step is inserted right before the build step that compiles the app's code (e.g. before the Xcode build step for iOS, or before the "Invoke Ant" build step for Android). If you are using an ipa or app file instead, an TouchTestable ipa will be created. If you are using an apk file, an apk file will be created and returned. You must provide the necessary provisioning profile and signing key so the resulting ipa can be properly installed onto an Apple device.
Install iOS App on Device
Silently installs an IPA file on one or more attached iOS devices. This ensures that your tests run against the latest version of your app. NOTE: there is no Android version of this build step, because the Android SDK already provides this functionality ("adb install").
Executes a CloudTest composition, and saves the output in the build's test results. You can include this build step multiple times if there are multiple compositions in your test suite.
Wake Up iOS Device
Wakes up one or more attached iOS devices, and opens Mobile Safari to the most recently-viewed page (e.g. TouchTest Agent). This can optionally be used at the beginning of a build, to "prep" the devices for testing. NOTE: there is no Android version of this build step, because the Android SDK already provides this functionality.
Reboot iOS Device
Reboots one or more attached iOS devices. This can optionally be used at the end of a build, to "reset" for the next one. NOTE: there is no Android version of this build step, because the Android SDK already provides this functionality ("adb reboot").