Run-in-Cloud Using the UI

This guide contains instructions for using the Bitbar Run-in-Cloud plugin from the UI. For instructions on Pipeline, click here.

Configure

Open Jenkins main configuration page (Manage Jenkins -> Configure System) in the ‘Bitbar Run-in-Cloud’ section and fill necessary Bitbar Testing account information. Click Authorize & Save button to validate account details.

image0

Run-in-Cloud - Build Step

Open existing Jenkins job or create a new one. From job configuration add a new build step.

To run tests in Bitbar Cloud select a target project, upload a new application or/and instrumentation package to that project and define file name in corresponding field. If you need to customize projects settings click “Edit project on Bitbar Testing website” button and it will open Cloud.

image1

Annotations can be configured in the following section. Here is more information on how to use annotations to execute subsets of tests.

image2

The following fields are only for Android Instrumentation runs:

  • Device group
  • Device language
  • Screenshots configuration
  • Custom test runner
  • Tests with annotation
  • Tests without annotation
  • Use test cases from

Note

Calabash on Android and iOS:

Application
This field defines the path to .apk or .ipa file (this is relative to job workspace)
Test
This field defines the path to .zip file which contains the feature files. See http://docs.bitbar.com/calabash/creating-calabash-tests/ for more details how to create calabash test zip

There are two ways for Jenkins plugin to get notification from Bitbar Testing about finished test runs.

API CALL

Jenkins is polling Bitbar Testing for results. Test results are copied to Jenkins workspace after the tests are finished.

image3

HOOK URL

Bitbar Testing sends post message to defined URL when test run is finished. RiC listens the message in default location and downloads results when post message arrives. The listened URL can be changed.

POST message body:

testRunId=%s&projectId=%s&status=FINISHED

Note! This requires HOOK URL to be reachable from Internet ie. Jenkins instance can be reached from Bitbar Testing.

image4

Using Annotations