fastlane-plugin-run_tests_firebase_testlab

Runs Android tests in Firebase Test Lab.


Keywords
android, fastlane, fastlane-plugin, firebase, instrumentation-tests, testing
License
MIT
Install
gem install fastlane-plugin-run_tests_firebase_testlab -v 0.3.1

Documentation

run_tests_firebase_testlab plugin

fastlane Plugin Badge Build Status Gem Version

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_testlab

About 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.