transporter plugin

Getting Started

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

fastlane add_plugin transporter

About transporter

Adds actions to manage Apple iTMSTransporter installation.

Apart from installing Transporter, this plugin allows you to configure Transporter installation. This is very useful in enterprise environment, where you need to work with self-signed root CA and/or company proxy.

⚠️ Only Mac OS X is supported at the moment.

install_transporter

The install_transporter action downloads and unpacks Transporter package and installs it to specified path.

Instead of downloading Transporter package from remote source a path to local copy of tarball can be specified or even a path to already unpacked Transporter directory.

configure_transporter

The configure_transporter action allows configuring Transporter after installation.

If you need to use Transporter in enterprise setup with self-signed root CA used to encrypt all your network traffic, you need to add this root CA certificate to Transporter's keystore using root_ca parameter. This parameter can be either a path to the certificate or certificate Common Name.

To enable Basic authentication for Transporter network calls, set enable_basic_auth to true.

update_transporter_path

This action updates FASTLANE_ITUNES_TRANSPORTER_PATH with the specified install path. This environment variable is used by Fastlane to run actions like deliver or pilot.

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.

The example lane installs Transporter to ~/itms, then adds Apple iPhone Certification Authority certificate to Transporter keystore and finally sets the FASTLANE_ITUNES_TRANSPORTER_PATH environment variable so that Fastlane can use this custom installation.

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.

Linux and Windows Support

Transporter package for Linux and Windows is different from the OS X version. The java binaries like java/bin/java and java/bin/keytool are actual executables compiled for target platform.

To support Linux and Windows a different package would have to be downloaded and installed. The installation script is different from just unpack-and-copy version of Mac OS X. For example, this is the Linux installation script.

Remove or Overwrite Root CA Certificates

Q: Why is there no way to remove or overwrite existing root CA entry in Transporter's keystore?

This is a valid option but root CA certs don't expire that often. There's always a workaround of just reinstalling Transporter. If such option becomes very important, it can be added in the future.

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.