About Bitrise
Bitrise is a Continuous Integration and Delivery (CI/CD) Platform as a Service with a main focus on mobile app development with iOS, Android, React Native, Flutter, etc. Bitrise is a collection of tools and services to help you with the development and automation of your software projects.
A Bitrise Workflow is a collection of Steps. When a build of an app is running, the Steps will be executed so that they are defined in the Workflow.
To integrate with Bitrise - we’re introducing Kobiton Steps to help user upload app and run test on Kobiton from Bitrise.
What Kobiton Steps does & How to use it
1- Upload new build of application to Kobiton App repo
This Step will take your latest build and upload to Kobiton App Repo (it will either create new app or upload a new version of the existing app).
This step is already launched and available in Bitrise Step library (see Integrations)
To use it, go to Workflow editor, click 
and search for Kobiton: 
Click on the step to add it to your workflow - the added step will look like this: 
Review and input your app info as well as your Kobiton credentials (to get your Kobiton Username and API Key, login Kobiton portal and go to https://portal.kobiton.com/settings/keys).
Some additional notes:
-
Input “App ID” in case you want to upload a new version for an existing app.
-
You can choose App Privacy you want, can either set it to Public (available for all member users in an org to access) or Private (only available for you to access).
Once you’re done inputting variables for the step - save the workflow then start/schedule your build in Bitrise.
2- Execute automation test using Kobiton devices
This step will execute an automated test script on Kobiton service (see Integrations ).
You can search for this step in Workflow editor:
Once added, the step will look like this: 
To use this step, you will need these info:
A- Kobiton API Credentials
To get your Kobiton Username and API Key, login Kobiton portal and go to https://portal.kobiton.com/settings/keys
B- Kobiton Executor Server Credentials
We will provide you credentials to access our TestNG Execution Server. This will be used to execute your automation test script. Fill your info to these fields:
-
Executor Server URL
-
Kobiton Executor Username
-
Kobiton Executor Password
C- Git repository contains your TestNG automation test script + SSH Key
In order to execute your test script using this Bitrise Step, you will have to prepare your automation test project in a Git-based repository.
For your security, we highly recommend setting your Git repository to Private and prepare an SSH key for it.
If you do not know how to authenticate the key with Git, please follow the guide from Github create SSH key instruction and Github adding the key to account instruction.
Fill your Git repository info to these fields on the Bitrise Step:
-
Git repository URL: This is the URL to your Git repository that contains your TestNG test script.
-
Git repository branch: The branch of the repository to execute automation test script.
-
Git repository SSH Key: The SSH Key of the above repository.
D- Execution inputs
-
Root directory & Commands: Input the root directory of your Git repo and the command lines to install dependencies and execute your automation test script. These commands will run from the root directory of your Git repository.
-
Wait for execution: Set to “true” if you want the release pipeline to wait until your automation testing is either completed or failed, then print out the console log and test result. If it’s set to “false”, the release pipeline will continue to the next step. The execution job ID of this task will be printed, but not the console logs or TestNG report URL.
-
Log type: choose your desired log type to be shown.
E- Use a custom device to execute your script
If you haven’t set the device information in your script, use this section to choose a device to execute your test script. Set “Use Custom Device” to True and input below info:
-
Kobiton Cloud Device Name
-
Device Platform version
-
Device Platform (android/iOS)
Please ignore this part if you already set above information in your desiredCapabilities.
Once you’re done inputting all above info (from A to D/E) for the step - save the workflow then start/schedule your build in Bitrise.