This project is a fastlane plugin. To get started with
fastlane-plugin-altool, add it to your project by running:
fastlane add_plugin altool
This plugin has configurable Apple ID and password but you probably don't want to hardcode that. You need to have Fastlane setup with
FASTLANE_PASSWORD environmenal varibales setup. Fastlane will ask it when you run
fastlane init but if not you have to set these variables.
You can set that easily for bash shell
$ export FASTLANE_USER="firstname.lastname@example.org"; $ export FASTLANE_PASSWORD="your_super_xecret_password";
You can do the same for your choice of shell if you aren't using bash.
This plugin can be used to upload IPA to iTunes Connect using altool.
Currently Fastlane deliver uses iTMSTransporter to upload an ipa files to iTunes Connect but there is slick way to do this using
This plugin can be used for uploading generated
ipa file using Gym to iTunes Connect.
This plugin assume that, you already have that Fastlane setup and your details are configured as ENV variables in
FASTLANE_PASSWORD by default.
You can configure this plugin using
altool( altool_username: ENV["FASTLANE_USER"], altool_password: ENV["FASTLANE_PASSWORD"], altool_app_type: "ios", altool_ipa_path: "./build/Your-ipa.ipa", altool_output_format: "xml", )
This might print the username and password to build console in the commands, pipe the output to
/dev/null or use similar approach so that fastlane don't print command to console.
Example Project Repo
This is a example project Altool-Demo available on GitHub which has its own README.
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.
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.