Waldo fastlane plugin

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.

Usage

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

Uploading an iOS Device Build

Build a new IPA for your app. If you use gym (aka build_ios_app) to build your IPA, waldo will automatically find and upload the generated IPA.

gym(export_method: 'development')                       # or 'ad-hoc'
waldo(upload_token: '0123456789abcdef0123456789abcdef')

Note: You must specify the Waldo upload token.

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

waldo(ipa_path: '/path/to/YourApp.ipa',
      upload_token: '0123456789abcdef0123456789abcdef')

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 in the ./Build/Products/Release-iphonesimulator directory.

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

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

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

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 upload token.

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

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

Issues and Feedback

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

Troubleshooting

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.