Waldo fastlane plugin

fastlane Plugin Badge

Getting Started

This project is a fastlane plugin. To get started with fastlane-plugin-waldo, add it to your project by running:

fastlane add_plugin waldo

About Waldo

Waldo provides fast, reliable, and maintainable tests for the most critical flows in your app. This plugin provides a waldo action which allows you to upload an iOS or Android build to Waldo for processing.


To get started, first obtain a CI token from Waldo for your app. These are used to authenticate with the Waldo backend on each call.

Uploading an iOS Simulator Build

Create a new simulator build for your app.

You can use gym (aka build_ios_app) to build your app provided that you supply several parameters in order to convince Xcode to both build for the simulator and not attempt to generate an IPA:

gym(configuration: 'Release',
    derived_data_path: '/path/to/derivedData',
    skip_package_ipa: true,
    skip_archive: true,
    destination: 'generic/platform=iOS Simulator')

You can then find your app relative to the derived data path:

app_path = File.join(derived_data_path,

Regardless of how you create the actual simulator build for your app, the upload itself is very simple:

waldo(upload_token: '0123456789abcdef0123456789abcdef',
      app_path: '/path/to/YourApp.app')

Note: You must specify both the Waldo CI token and the path of the .app.

Uploading an Android Build

Build a new APK for your app. If you use gradle to build your APK, waldo will automatically find and upload the generated APK.

gradle(task: 'assemble',
       build_type: 'Release')

waldo(upload_token: '0123456789abcdef0123456789abcdef')

Note: You must specify the Waldo CI token.

If you do not use gradle to build your APK, you will need to explicitly specify the APK path to waldo:

waldo(upload_token: '0123456789abcdef0123456789abcdef',
      apk_path: '/path/to/YourApp.apk')

Issues and Feedback

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.

Using fastlane Plugins

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

About fastlane

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