Project

fastlane-plugin-saucelabs_appdist

0.0
The project is in a healthy, maintained state
fastlane-plugin-saucelabs_appdistsaucelabs/fastlane-plugin-saucelabs_appdistHomepageDocumentationSource CodeBug TrackerWiki
A Sauce Labs fastlane plugin for uploading iOS and Android builds to Mobile App Distribution.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
2026
 Popularity
Downloads
578
Stars
0
Forks
0
Watchers
0
 Releases
Current version
0.3.2
Total releases
3
First release
2026-02-19
Latest release
2026-03-04
 Pull Requests
Open Pull Requests
0
Closed Pull Requests
0
Merged Pull Requests
2
Pull Request Acceptance Rate
100%
 Development
Primary Language
Ruby
Licenses
MIT
Average date of last 50 commits
2026-02-22
Reverse Dependencies
0

 Dependencies

Development

bundler
>= 0
fastlane
>= 2.0
pry
>= 0
rake
>= 0
rspec
>= 0
rubocop
= 1.50.2

Runtime

faraday
~> 1.0
faraday_middleware
~> 1.0
 Project Readme

fastlane-plugin-saucelabs_appdist

Gem Version License: MIT

A Sauce Labs fastlane plugin for uploading builds to Mobile App Distribution.

For more information about Sauce Labs Mobile App Distribution, see the product page.

Installation

fastlane add_plugin saucelabs_appdist

Or add the plugin manually to your project's Pluginfile:

gem 'fastlane-plugin-saucelabs_appdist'

Usage

saucelabs_appdist(
  api_key: "your_api_key",
  ipa: "./path/to/app.ipa",
  comment: "Build #{lane_context[SharedValues::BUILD_NUMBER]}"
)

Parameters

Key Description Default
api_key API Key for Sauce Labs App Distribution —
ipa Path to your IPA file (iOS) —
apk Path to your APK file (Android) —
symbols_file Symbols mapping file —
upload_url API URL for App Distribution https://app.testfairy.com
testers_groups Array of tester groups []
metrics Array of metrics to record []
comment Additional release notes No comment provided
auto_update Auto-upgrade users (on/off) off
notify Send email to testers (on/off) off
options Array of options []
custom Custom options string ""
timeout Request timeout in seconds —
tags Custom tags for builds []
folder_name Dashboard folder name ""
landing_page_mode Landing page visibility (open/closed) open
upload_to_saucelabs Upload to Sauce Labs (on/off) off
platform Platform override ""
community_token Custom URL token for the landing page ""
app_description Description text to display on the landing page ""

Response

The SAUCELABS_APPDIST_UPLOAD_RESPONSE shared value contains the full JSON response from the upload API. It is set in lane_context and can be accessed in subsequent lanes:

lane_context[SharedValues::SAUCELABS_APPDIST_UPLOAD_RESPONSE]

Example response:

{
  "status": "ok",
  "build_id": "1",
  "project_id": "1",
  "app_name": "My Demo App",
  "app_version": "2.0.2 - 2026-02-19 02:51:05",
  "file_size": 2319620,
  "build_url": "https://app.testfairy.com/projects/1/builds/1",
  "download_page_url": "https://app.testfairy.com/join/xxxxxx",
  "app_url": "https://app.testfairy.com/download/.../getapp",
  "invite_testers_url": "https://app.testfairy.com/projects/1/builds/1/invite",
  "icon_url": "https://app.testfairy.com/icons/.../icon.png",
  "options": "video-quality=medium,screenshot-interval=1,session-length=60m,video,logcat,shake,cpu,memory,phone-signal,battery,wifi",
  "platform": "iOS",
  "tags": [],
  "metadata": [],
  "has_testfairy_sdk": true,
  "symbols_download_url": null,
  "attachments": null,
  "landing_page_url": "https://app.testfairy.com/join/xxxxxx",
  "build_specific_landing_page_url": "https://app.testfairy.com/join/xxxxxx?id=1",
  "landing_page_mode": "closed"
}