This project is a fastlane plugin. To get started with
fastlane-plugin-transporter, add it to your project by running:
fastlane add_plugin 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.
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 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
This action updates
FASTLANE_ITUNES_TRANSPORTER_PATH with the specified install path. This environment variable is used by Fastlane to run actions like
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
To automatically fix many of the styling issues, use
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/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.
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.
fastlane is the easiest way to automate beta deployments and releases for your iOS and Android apps. To learn more, check out fastlane.tools.