🧪 Maestro fastlane plugin

This project is a fastlane plugin. To get started with fastlane-plugin-maestro, add it to your project by adding the following line to your Pluginfile:

gem "fastlane-plugin-maestro", git: "https://github.com/inf2381/fastlane-plugin-maestro.git", branch: "main"

fastlane plugin for maestro. You can directly pass the options to maestro or provide them in the file fastlane/Maestrofile when using the action maestro_test

Additionally to the maestro action, this plugin provides an action to start an iOS simulator and install a given .app file to it.

Create a simulator, install a .app file on it and patch the device for testing

app = File.realpath(Dir["../**/*.app"].first)

device = launch_simulator(
  app_path: app,
  device_name: "iPhone 14",
  language: "en-US"
)

Run all flows defined in the folder .maestro/screenshot

maestro_test(
  device: "EMULATOR_42",
  tests: "test_dir",
  debug_output: "my_output_dir",
  env_vars: {
    "USERNAME" => "testuser",
    "PASSWORD" => "test123"
  }
)

Install maestro

maestro(
  command: 'install'
)

Download the samples

maestro(
  command: 'download_samples'
)

Generically call maestro

maestro(
  command: 'start-device',
  flags: '--device-locale "de_DE"'
)

For other examples, please have a look at the Fastfile of this repository

For any other issues and feedback about this plugin, please submit it to this repository.

If you have trouble using plugins, check out the Plugins Troubleshooting guide.

For more information about how the fastlane plugin system works, check out the Plugins documentation.

fastlane is the easiest way to automate beta deployments and releases for your iOS and Android apps. To learn more, check out fastlane.tools.