This project is a fastlane plugin. To
get started with
fastlane-plugin-waldo, add it to your project by running:
fastlane add_plugin waldo
Waldo provides fast, reliable, and maintainable tests
for the most critical flows in your app. This plugin provides a
which allows you to upload an iOS or Android build to Waldo for processing.
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 Simulator Build
Create a new simulator build for your app.
You can use
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 (and associated symbols) relative to the derived data path:
app_path = File.join(derived_data_path, 'Build', 'Products', 'ReleaseSim-iphonesimulator', 'YourApp.app')
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', include_symbols: true)
Note: You must specify both the Waldo upload token and the path of the
include_symbolsparameter is optional but we highly recommend supplying it.
Uploading an iOS Device Build
Build a new IPA for your app. If you use
build_ios_app) to build
waldo will automatically find and upload the generated IPA.
gym(export_method: 'ad-hoc') # or 'development' waldo(upload_token: '0123456789abcdef0123456789abcdef', dsym_path: lane_context[SharedValues::DSYM_OUTPUT_PATH])
Note: You must specify the Waldo upload token. The
dsym_pathparameter is optional but we highly recommend supplying it.
If you do not use
gym to build your IPA, you will need to explicitly
specify the IPA path to
waldo(upload_token: '0123456789abcdef0123456789abcdef', ipa_path: '/path/to/YourApp.ipa', dsym_path: '/path/to/YourApp.app.dSYM.zip')
Uploading an Android Build
Build a new APK for your app. If you use
gradle to build your APK,
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(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.
fastlane is the easiest way to automate beta deployments and releases for your iOS and Android apps. To learn more, check out fastlane.tools.