icon

Maestro Test

Runs Maestro flows on an Android emulator or iOS simulator and exports the results to Test Reports.

Runs your Maestro flows locally on the build machine and exports the results.

The Step installs the Maestro CLI, installs your app on the device, runs maestro test, and exports:

  • the results to the Test Reports page, with each flow's screenshots, startRecording videos and logs attached to its test case
  • the Maestro test output folder as a zip artifact

Add Deploy to Bitrise.io after this Step to upload the results.

Device

The Step runs the flows on a device that is already running. Start one before this Step with AVD Manager (Android) or Xcode Start Simulator (iOS).

Only one device of the app's platform may run: the Step fails before installing the app if it finds none or several. To run the flows on several devices, use parallel Pipeline Workflows, see the examples below.

Flow variables

Maestro passes every environment variable with the MAESTRO_ prefix to the flows, so an Env Var or Secret named MAESTRO_USERNAME is available as ${MAESTRO_USERNAME}.

Useful links

Similar steps

This Step is used to search for test results and export them for the Deploy to Bitrise.io Step which can export the results to the Test Reports.

Runs Instrumented tests on an existing APK

This step runs your Android project's unit tests.

Run App Center launch test for android