altool plugin

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_USER and 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="your_apple_id@yourcompany.com";
$ 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 altool

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_USER and 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",
    )

Security Note:

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.

This is a example project Altool-Demo available on GitHub which has its own README.

To run both the tests, and code style validation, run

rake

To automatically fix many of the styling issues, use

rubocop -a

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.

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.