{"id":14973135,"url":"https://github.com/cats-oss/fastlane-plugin-firebase_test_lab_android","last_synced_at":"2025-08-21T04:30:30.301Z","repository":{"id":34243983,"uuid":"173228348","full_name":"cats-oss/fastlane-plugin-firebase_test_lab_android","owner":"cats-oss","description":"Test your app with Firebase Test Lab with ease using fastlane for Android","archived":false,"fork":false,"pushed_at":"2022-04-22T08:54:39.000Z","size":543,"stargazers_count":48,"open_issues_count":8,"forks_count":8,"subscribers_count":16,"default_branch":"master","last_synced_at":"2025-07-27T16:56:52.186Z","etag":null,"topics":["android","fastlane","firebase","firebase-test-lab"],"latest_commit_sha":null,"homepage":null,"language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cats-oss.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-03-01T03:27:01.000Z","updated_at":"2023-06-29T03:37:03.000Z","dependencies_parsed_at":"2022-08-08T00:02:21.543Z","dependency_job_id":null,"html_url":"https://github.com/cats-oss/fastlane-plugin-firebase_test_lab_android","commit_stats":null,"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/cats-oss/fastlane-plugin-firebase_test_lab_android","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cats-oss%2Ffastlane-plugin-firebase_test_lab_android","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cats-oss%2Ffastlane-plugin-firebase_test_lab_android/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cats-oss%2Ffastlane-plugin-firebase_test_lab_android/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cats-oss%2Ffastlane-plugin-firebase_test_lab_android/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cats-oss","download_url":"https://codeload.github.com/cats-oss/fastlane-plugin-firebase_test_lab_android/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cats-oss%2Ffastlane-plugin-firebase_test_lab_android/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":270837423,"owners_count":24654379,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-17T02:00:09.016Z","response_time":129,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","fastlane","firebase","firebase-test-lab"],"created_at":"2024-09-24T13:48:10.679Z","updated_at":"2025-08-21T04:30:29.939Z","avatar_url":"https://github.com/cats-oss.png","language":"Ruby","readme":"# Firebase Test Lab plugin for fastlane\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"art/screenshot_github.png\" width=\"75%\" /\u003e\n\u003c/p\u003e\n\nInspired by [Firebase test lab plugin for ios](https://github.com/fastlane/fastlane-plugin-firebase_test_lab)\n\n\n## Getting Started\n\n[![License](https://img.shields.io/github/license/cats-oss/fastlane-plugin-firebase_test_lab_android.svg)](https://github.com/cats-oss/fastlane-plugin-firebase_test_lab_android/blob/master/LICENSE)\n[![Gem](https://img.shields.io/gem/v/fastlane-plugin-firebase_test_lab_android.svg?style=flat)](https://rubygems.org/gems/fastlane-plugin-firebase_test_lab_android)\n[![fastlane Plugin Badge](https://rawcdn.githack.com/fastlane/fastlane/master/fastlane/assets/plugin-badge.svg)](https://rubygems.org/gems/fastlane-plugin-firebase_test_lab_android)\n\n### Step 0. Enable the Google Cloud Testing API and Cloud Tool Results API \n\nYou must enable the Google Cloud Testing API and Cloud Tool Results API in the [Google Developers Console API Library page](https://console.developers.google.com/apis/library).\n\n### Step 1. First of all, get started with Firebase Test Lab from the gcloud Command Line\n\nPlease check [Firebase documents](https://firebase.google.com/docs/test-lab/android/command-line)\n\nUsing with Google Cloud SDK.\n```\n# gcloud firebase test android run \\\n  --type robo \\\n  --app app-debug-unaligned.apk \\\n  --device model=Nexus6,version=24,locale=en,orientation=portrait  \\\n  --timeout 90s\n  \nHave questions, feedback, or issues? Get support by visiting:\n  https://firebase.google.com/support/\n\nAPI [toolresults.googleapis.com] not enabled on project \n[************]. Would you like to enable and retry (this will take a \nfew minutes)? (y/N)? y\n\nEnabling service [toolresults.googleapis.com] on project [************]...\nOperation \"operations/acf.********-****-****-****-************\" finished successfully.\n  ...\n  ...\n  ...\n\nRobo testing complete.\n\nMore details are available at [https://console.firebase.google.com/project/*******/testlab/histories/**********/matrices/********].\n┌─────────┬───────────────────────┬──────────────┐\n│ OUTCOME │    TEST_AXIS_VALUE    │ TEST_DETAILS │\n├─────────┼───────────────────────┼──────────────┤\n│ Passed  │ Nexus6-24-en-portrait │ --           │\n└─────────┴───────────────────────┴──────────────┘\n```\n\n### Step 2. Add to your project\nThis project is a [_fastlane_](https://github.com/fastlane/fastlane) plugin. To get started with `fastlane-plugin-firebase_test_lab_android`, add it to your project by running:\n\n```\nfastlane add_plugin firebase_test_lab_android \n```\n\n### Step 3. Find the devices you want to test on\n\nUsing [gcloud tool](https://cloud.google.com/sdk/gcloud/), you can run.\n\n```\ngcloud firebase test android models list\n```\n\nto get a list of supported devices and their identifiers.\n\nAlternatively all available devices can also be seen [here](https://firebase.google.com/docs/test-lab/ios/available-testing-devices). \n\n\n### Step 4. Add settings to your Fastfile\n\nTest your app with Firebase Test Lab with ease using fastlane.  \nCheck out the [example `Fastfile`](fastlane/Fastfile) to see how to use this plugin.\n\n```ruby\nbefore_all do\n    ENV[\"SLACK_URL\"] = \"https://hooks.slack.com/services/XXXXXXXXX/XXXXXXXXX/XXXXXXXXXXXXXXXXXXXXXXXX\"\n  end\n\nlane :test do\n\n  # Get Pull request number from CI\n  pr_number = ENV[\"CI_PULL_REQUEST\"] != nil ? ENV[\"CI_PULL_REQUEST\"][/(?\u003c=https:\\/\\/github.com\\/cats-oss\\/android\\/pull\\/)(.*)/] : nil\n\n  # Upload to Firebase Test Lab\n  firebase_test_lab_android(\n    project_id: \"cats-firebase\",                                    # Your Firebase project name.\n    gcloud_service_key_file: \"fastlane/client-secret.json\",         # File path containing the gcloud auth key.\n    # gcloud_components_channel: \"beta\",                            # If you use gcloud component channel option (alpha/beta).     \n    type: \"robo\",                                                   # Optional: Test type (robo/instrumentation).\n    devices: [                                                      # Devices\n      {\n        model: \"Nexus6P\",\n        version: \"23\",\n        locale: \"ja_JP\",\n        orientation: \"portrait\"\n      },\n      {\n        model: \"Pixel2\",\n        version: \"28\"\n      }\n    ],\n    app_apk: \"app-debug.apk\",                                       # The path for your android app apk.\n    # app_test_apk: \"app-test.apk\",                                 # The path for your android instrumentation test apk.\n    # use_orchestrator: false,                                      # If you use orchestrator when set instrumentation test.\n    console_log_file_name: \"fastlane/console_output.log\",  \n    timeout: \"3m\",                                                  \n    firebase_test_lab_results_bucket: \"firebase_cats_test_bucket\",  # If you want to naming bucket of GCS \n    # firebase_test_lab_results_dir: \"firebase_cats_test_dir\",      # If you want to naming results of GCS. (Maybe don't need it.) \n    slack_url: ENV[\"SLACK_URL\"],                                    # If you want notify to Slack.\n\n    # If you want notify to Github pull requests.\n    github_owner: \"******\",                                         # Owner name. \n    github_repository: \"************\",                              # Repository name.\n    github_pr_number: pr_number,                                    # If you using run on CI that need pull request number for auto comment.\n    github_api_token: ENV[\"GITHUB_API_TOKEN\"],                      # https://github.com/settings/tokens\n    download_dir: \".results\",                                       # If you want to download to the results of Firebase test lab.  \n\n    # If you want to ignore some social sign-in buttons.\n    extra_options: \"--robo-directives ignore:image_button_sign_in_twitter=,ignore:image_button_sign_in_instagram=\"\n  )\nend\n```\n\n### Finish. Check your slack or Github PR\n\n**If you set `slack_url: ENV[\"SLACK_URL\"]` to Fastfile.**\n\n\u003cimg src=\"art/screenshot_slack.png\" width=\"75%\" /\u003e\n\n**If you set `github_owner, github_repository, github_pr_number, github_api_token` to Fastfile.**\n\n\u003cimg src=\"art/screenshot_github.png\" width=\"75%\" /\u003e\n\n\n## Issues and Feedback\n\nFor any other issues and feedback about this plugin, please submit it to this repository.\n\n## Troubleshooting\n\nIf you have trouble using plugins, check out the [Plugins Troubleshooting](https://docs.fastlane.tools/plugins/plugins-troubleshooting/) guide.\n\n## Using _fastlane_ Plugins\n\nFor more information about how the `fastlane` plugin system works, check out the [Plugins documentation](https://docs.fastlane.tools/plugins/create-plugin/).\n\n## About _fastlane_\n\n_fastlane_ is the easiest way to automate beta deployments and releases for your iOS and Android apps. To learn more, check out [fastlane.tools](https://fastlane.tools).\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcats-oss%2Ffastlane-plugin-firebase_test_lab_android","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcats-oss%2Ffastlane-plugin-firebase_test_lab_android","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcats-oss%2Ffastlane-plugin-firebase_test_lab_android/lists"}