Screen recording your UI tests with Appium

Japanese translation unavailable

This page has not been translated into Japanese yet - we apologise for the inconvenience! If you’re interested in helping us out, feel free to translate any article in the jp folder of the DevCenter repository and open a PR!

このページは日本語への翻訳がまだ完了しておりません。ご不便をおかけして申し訳ございません! もしお手伝いできる方がいらっしゃれば、ご自由にjpフォルダの記事を日本語に訳していただき、PRを開いてください

Appium is a popular testing framework to catch defects in native, hybrid, and web apps. You can easily integrate your Appium UI tests into your own Bitrise workflow using our Script Step. This way you can have the whole testing screen recorded and can visually verify if your app is doing what it’s supposed to do.

In this guide we’ll show how to kickstart Appium and run your UI test specified in the test.js file, then retrieve the test results and view them on

ADB workaround for Javascript

Javascript does not support the in-built screen recording and screen capturing commands so we’re using ADB shell commands as a workaround. For all the other languages, check out Appium’s Start Recording Screen guide.

We will use our Script and Deploy to Steps. Here is why:

Let’s put this all together!

  1. Insert the Script Step as the first Step in your workflow.
  2. Click the Step.
  3. Insert the following command to the Script content input field.

    appium &> $BITRISE_DEPLOY_DIR/logs.txt & 
    npm test

    You will find the above mentioned logs.txt file in the Bitrise deploy directory (BITRISE_DEPLOY_DIR). This logs.txt file contains the outputs of the Appium server. With the help of the Deploy to Step you will be able to download this file from the APPS & ARTIFACTS tab.

  4. Since screen recoding is not supported through Javascript, we advise you to add the screen recording / screen capturing and the file retrieving shell commands to your own test.js file.
  5. Once you have pulled the test results (which in this case can be videos and screenshots) from the emulator, make sure you move them to the Bitrise deploy directory (BITRISE_DEPLOY_DIR).
  6. Insert the Deploy to - Apps, Logs, Artifacts Step to your workflow so that it can export your test results to the APPS & ARTIFACTS tab on your Build’s page.
  7. Start a build!

If all went well, you should be able to view the generated test results on the APPS & ARTIFACTS tab of your Build’s page.