{"id":18103542,"url":"https://github.com/mgrebenets/fastlane-plugin-transporter","last_synced_at":"2025-04-13T19:25:31.256Z","repository":{"id":56845958,"uuid":"183442411","full_name":"mgrebenets/fastlane-plugin-transporter","owner":"mgrebenets","description":"Manage Apple iTMSTransporter installation","archived":false,"fork":false,"pushed_at":"2019-05-20T01:53:06.000Z","size":60,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-03-27T10:08:06.151Z","etag":null,"topics":["apple","appstore","appstoreconnect","continuous-integration","enterprise","fastlane","fastlane-plugin","ipa","itmstransporter","itunesconnect"],"latest_commit_sha":null,"homepage":null,"language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mgrebenets.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-04-25T13:41:39.000Z","updated_at":"2024-10-18T18:44:23.000Z","dependencies_parsed_at":"2022-09-17T22:21:41.180Z","dependency_job_id":null,"html_url":"https://github.com/mgrebenets/fastlane-plugin-transporter","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mgrebenets%2Ffastlane-plugin-transporter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mgrebenets%2Ffastlane-plugin-transporter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mgrebenets%2Ffastlane-plugin-transporter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mgrebenets%2Ffastlane-plugin-transporter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mgrebenets","download_url":"https://codeload.github.com/mgrebenets/fastlane-plugin-transporter/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248766901,"owners_count":21158346,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["apple","appstore","appstoreconnect","continuous-integration","enterprise","fastlane","fastlane-plugin","ipa","itmstransporter","itunesconnect"],"created_at":"2024-10-31T22:12:28.383Z","updated_at":"2025-04-13T19:25:31.231Z","avatar_url":"https://github.com/mgrebenets.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# transporter plugin\n\n[![license](https://img.shields.io/github/license/mgrebenets/fastlane-plugin-transporter.svg)](https://github.com/mgrebenets/fastlane-plugin-transporter)\n[![fastlane Plugin Badge](https://rawcdn.githack.com/fastlane/fastlane/master/fastlane/assets/plugin-badge.svg)](https://rubygems.org/gems/fastlane-plugin-transporter)\n[![version](https://img.shields.io/github/tag/mgrebenets/fastlane-plugin-transporter.svg?color=green\u0026label=version)](https://github.com/mgrebenets/fastlane-plugin-transporter)\n[![CircleCI](https://circleci.com/gh/mgrebenets/fastlane-plugin-transporter.svg?style=svg)](https://circleci.com/gh/mgrebenets/fastlane-plugin-transporter)\n[![Travis CI](https://img.shields.io/travis/mgrebenets/fastlane-plugin-transporter.svg?label=%20\u0026logo=travis)](https://travis-ci.org/mgrebenets/fastlane-plugin-transporter)\n[![Coverage Status](https://coveralls.io/repos/github/mgrebenets/fastlane-plugin-transporter/badge.svg)](https://coveralls.io/github/mgrebenets/fastlane-plugin-transporter)\n[![Inline docs](http://inch-ci.org/github/mgrebenets/fastlane-plugin-transporter.svg)](http://inch-ci.org/github/mgrebenets/fastlane-plugin-transporter)\n\n## Getting Started\n\nThis project is a [_fastlane_](https://github.com/fastlane/fastlane) plugin. To get started with `fastlane-plugin-transporter`, add it to your project by running:\n\n```shell\nfastlane add_plugin transporter\n```\n\n## About transporter\n\nAdds actions to manage Apple iTMSTransporter installation.\n\nApart from installing Transporter, this plugin allows you to configure Transporter installation.\nThis is very useful in enterprise environment, where you need to work with self-signed root CA and/or company proxy.\n\n⚠️ Only Mac OS X is supported at the moment.\n\n### install_transporter\n\nThe `install_transporter` action downloads and unpacks Transporter package and installs it to specified path.\n\nInstead 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.\n\n### configure_transporter\n\nThe `configure_transporter` action allows configuring Transporter after installation.\n\nIf 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.\n\nTo enable Basic authentication for Transporter network calls, set `enable_basic_auth` to `true`.\n\n### update_transporter_path\n\nThis 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`.\n\n## Example\n\nCheck out the [example `Fastfile`](fastlane/Fastfile) to see how to use this plugin. Try it by cloning the repo, running `fastlane install_plugins` and `bundle exec fastlane test`.\n\nThe 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.\n\n## Run tests for this plugin\n\nTo run both the tests, and code style validation, run\n\n```shell\nrake\n```\n\nTo automatically fix many of the styling issues, use\n\n```shell\nrubocop -a\n```\n\n## Issues and Feedback\n\nFor any other issues and feedback about this plugin, please submit it to this repository.\n\n### Linux and Windows Support\n\nTransporter 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.\n\nTo support Linux and Windows a different package would have to be downloaded and installed.\nThe installation script is different from just unpack-and-copy version of Mac OS X.\nFor example, [this is the Linux installation script](https://itunesconnect.apple.com/WebObjects/iTunesConnect.woa/ra/resources/download/Transporter__linux/bin/).\n\n### Remove or Overwrite Root CA Certificates\n\nQ: Why is there no way to remove or overwrite existing root CA entry in Transporter's keystore?\n\nThis is a valid option but root CA certs don't expire that often.\nThere's always a workaround of just reinstalling Transporter.\nIf such option becomes very important, it can be added in the future.\n\n## Troubleshooting\n\nIf you have trouble using plugins, check out the [Plugins Troubleshooting](https://docs.fastlane.tools/plugins/plugins-troubleshooting/) guide.\n\n## Using _fastlane_ Plugins\n\nFor more information about how the `fastlane` plugin system works, check out the [Plugins documentation](https://docs.fastlane.tools/plugins/create-plugin/).\n\n## About _fastlane_\n\n_fastlane_ is the easiest way to automate beta deployments and releases for your iOS and Android apps. To learn more, check out [fastlane.tools](https://fastlane.tools).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmgrebenets%2Ffastlane-plugin-transporter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmgrebenets%2Ffastlane-plugin-transporter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmgrebenets%2Ffastlane-plugin-transporter/lists"}