run_tests_firebase_testlab plugin
Please, read this blog post if you want to know better how to use this plugin.
Getting Started
This project is a fastlane plugin. To get started with fastlane-plugin-run_tests_firebase_testlab, add it to your project by running:
fastlane add_plugin run_tests_firebase_testlabAbout run_tests_firebase_testlab
-
Authenticates with Google Cloud.
-
Runs Android tests in Firebase Test Lab.
-
Fetches the results to a local directory.
-
Deletes the results from firebase bucket if wanted.
Example
Check out the example Fastfile to see how to use this plugin.
Simple usage
run_tests_firebase_testlab(
project_id: "your-firebase-project-id",
devices: [
{
model: "Nexus6P",
version: "27"
}
]);
Parameters
| Parameter | Description | Optional | Default |
|---|---|---|---|
| project_id | Your Firebase project id | No | - |
| devices | A list of devices to test the App on | No | - |
| device[model] | A device model on which the tests will run | No | - |
| device[version] | The Android api version of the device | No | - |
| device[locale] | The locale to test against | Yes | en_US |
| device[orientation] | The orientation of the device | Yes | portrait |
| app_apk | The path for your app apk | Yes | app/build/outputs/apk/debug/ app-debug.apk |
| android_test_apk | The path for your android test apk | Yes | app/build/outputs/apk/androidTest/ debug/app-debug-androidTest.apk |
| timeout | The max time this test execution can run before it is cancelled | Yes | 30m |
| output_dir | The directory to save the output results | Yes | firebase |
| bucket_url | The bucket url where the test results were stored | Yes | Parsed automatically from tests output |
| delete_firebase_files | A flag to control if the firebase files should be deleted from the bucket or not | Yes | false |
| extra_options | Extra options that you need to pass to the gcloud command | Yes | empty string |
| gcloud_service_key_file | File path containing the gcloud auth key | Yes | Created from GCLOUD_SERVICE_KEY environment variable |
| download_results_from_firebase | A flag to control if the firebase files should be downloaded from the bucket or not | Yes | true |
Run tests for this plugin
To run both the tests, and code style validation, run
rake
To automatically fix many of the styling issues, use
rubocop -a
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.