No commit activity in last 3 years
No release in over 3 years
Publish your builds on Shuttle.tools
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
 Dependencies

Development

Runtime

~> 1.0.4
 Project Readme

Shuttle fastlane plugin

fastlane Plugin Badge Gem Version

Getting Started

This project is a fastlane plugin. To get started with fastlane-plugin-shuttle, add it to your project by running:

fastlane add_plugin shuttle

About Shuttle

Publish your builds on your Shuttle.tools instance

This plugin provides a shuttle action which allows you to upload and distribute your apps to your testers via your Shuttle instance interface.

Usage

To get started, first, obtain an API access token in your Shuttle instance admin section. The API Access Token is used to authenticate with the Shuttle API in each call.

url = shuttle(
      access_token: <shuttle access token>,
      package_path: <path to your IPA or APK binary file>,
      release_name: <release name displayed in Shuttle>,
      release_notes: <release notes>,
      base_url: "https://<your instance name>.shuttle.tools/")

The action parameters access_token can be omitted when its value is set as environment variables. Below a list of all available environment variables:

  • SHUTTLE_ACCESS_TOKEN - API Access Token for Shuttle API
  • SHUTTLE_BASE_URL - Shuttle instance URL (eg. https://<your instance name>.shuttle.tools/)
  • SHUTTLE_RELEASE_NAME - The name of the release (eg. Sprint #14)
  • SHUTTLE_PACKAGE_PATH - Build release path for android or ios build (if not provided, it'll check in shared values GRADLE_APK_OUTPUT_PATH or IPA_OUTPUT_PATH)
  • SHUTTLE_ENV_ID - The uniq ID of the app's environment you want to publish the build to (if not provided, it will try to guess it or ask to select/create it interactively then display the value so you can set it definitively)
  • SHUTTLE_RELEASE_NOTES - Release notes

Example

Check out the example Fastfile to see how to use this plugin. Try it by cloning the repo, running fastlane install_plugins and bundle exec fastlane test.

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.