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 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,
'Build',
'Products',
'Release-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')
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.
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.