Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Run tests with Maestro Studio

Build and run mobile tests visually with Maestro Studio. Install the app, create tests via screen inspection, and automate without writing code from scratch.

Maestro Studio is a visual desktop app that simplifies mobile test automation. This guide covers how to install the application and use its interactive tools to build a contact creation test without writing any code.

Prerequisites

Before building your test, ensure you have a running Android emulator. Access the QuickStart for further guidance on setting up your virtual environment.

1

Installation

Get started by downloading the installer for your specific operating system:

  • Windows: Download MaestroStudio.exe and follow the setup wizard.

  • macOS: Download MaestroStudio.dmg and drag the icon into your Applications folder.

  • Linux: Download MaestroStudio.AppImage, make it executable with chmod +x, and run it.

2

Initial setup

  1. Launch Maestro Studio.

  2. Click New workspace to select a folder on your machine where your test files will be saved.

  1. Click on Select device at the top left and select your active virtual device from the list.

3

Create the test file

  1. Click New File.

  2. Enter a name for your test file, for example my_test.yaml.

  3. Select your app from the dropdown menu.

  4. Click Create Test.

Tags are used to control which tests run. For more information, access the following pages:

4

Test the app initialization

Before you begin building the test, run the app initialization. Click Run Test and observe the app initializing with a clear state.

5

Build your test

The fastest way to build a test is to right-click directly on any element in your app. A menu appears with the available Maestro commands for that element. Click the one you want, and it gets added to your test automatically.

You can also type a hyphen in the editor to see all available Maestro commands.

Autocomplete suggests commands, arguments, and real selectors from your connected device's screen, so you spend less time looking up syntax.

6

Review and run the test

Once your first test is ready, click Run Test to watch Maestro Studio execute these steps automatically on your device.

After a successful run, the recording file will be available in the .maestro directory.

Next steps

Now that you have created a test using the interactive features of Maestro Studio, you can explore more advanced capabilities:

To learn more about test structure and advanced logic, visit the Maestro Flows documentation.

PreviousMaestro Studio overview
NextEnvironments and variables

Last updated