runner-images icon indicating copy to clipboard operation
runner-images copied to clipboard

Add Transporter

Open thomasbach-dk opened this issue 1 month ago • 5 comments

Tool name

Transporter

Tool license

Free but proprietary (Apple-licensed, Mac App Store distribution only).

Add or update?

  • [x] Add
  • [ ] Update

Desired version

Latest version available in the Mac App Store

Approximate size

No response

Brief description of tool

Transporter (previously known as iTMSTransporter) is Apple’s official tool for securely uploading app binaries, metadata, and other assets to App Store Connect and TestFlight. Since altool has been deprecated, Transporter is now (soon) the only supported method to programmatically upload .ipa files to App Store Connect. It must be installed through the Mac App Store and cannot be installed via Homebrew or obtained from command-line packages.

URL for tool's homepage

https://apps.apple.com/us/app/transporter/id1450874784

Provide a basic test case to validate the tool's functionality.

# Verify Transporter installation location
if [ ! -d "/Applications/Transporter.app" ]; then
    echo "Transporter.app not found"
    exit 1
fi

# Check that the iTMSTransporter executable exists
if [ ! -f "/Applications/Transporter.app/Contents/itms/bin/iTMSTransporter" ]; then
    echo "iTMSTransporter binary missing"
    exit 1
fi

# Run a simple command to ensure it executes
/Applications/Transporter.app/Contents/itms/bin/iTMSTransporter \
    -help

if [ $? -ne 0 ]; then
    echo "Transporter failed to run"
    exit 1
fi

echo "Transporter installation validated successfully"

Platforms where you need the tool

  • [ ] Azure DevOps
  • [ ] GitHub Actions

Runner images where you need the tool

  • [ ] Ubuntu 22.04
  • [ ] Ubuntu 24.04
  • [ ] Ubuntu Slim
  • [ ] macOS 13
  • [ ] macOS 13 Arm64
  • [ ] macOS 14
  • [ ] macOS 14 Arm64
  • [ ] macOS 15
  • [x] macOS 15 Arm64
  • [x] macOS 26 Arm64
  • [ ] Windows Server 2019
  • [ ] Windows Server 2022
  • [ ] Windows Server 2025

Can this tool be installed during the build?

No

Tool installation time in runtime

No response

Are you willing to submit a PR?

Yes but I guess it's not an option in this case

thomasbach-dk avatar Dec 04 '25 10:12 thomasbach-dk

Hey @thomasbach-dk, we will evaluate adding the tool. It also seems that the tool can be installed in runtime. Could you check if adding following step works in your scenario?

      - run: |
          url="https://itunesconnect.apple.com/WebObjects/iTunesConnect.woa/ra/resources/download/public/Transporter__OSX/bin/"
          curl -fsSL $url -o "/tmp/itmstransporter.pkg"
          sudo installer -pkg "/tmp/itmstransporter.pkg" -target /
          /usr/local/itms/bin/iTMSTransporter -help

shamil-mubarakshin avatar Dec 04 '25 16:12 shamil-mubarakshin

Hey @thomasbach-dk, we will evaluate adding the tool. It also seems that the tool can be installed in runtime. Could you check if adding following step works in your scenario?

  - run: |
      url="https://itunesconnect.apple.com/WebObjects/iTunesConnect.woa/ra/resources/download/public/Transporter__OSX/bin/"
      curl -fsSL $url -o "/tmp/itmstransporter.pkg"
      sudo installer -pkg "/tmp/itmstransporter.pkg" -target /
      /usr/local/itms/bin/iTMSTransporter -help

I was able to install the transporter using this. Thank you so much!

YazdanRa avatar Dec 07 '25 20:12 YazdanRa

@shamil-mubarakshin, I’m curious how you found the public URL to download the transporter.

YazdanRa avatar Dec 07 '25 20:12 YazdanRa

@YazdanRa, this guide contains download links for different OSes. Wondering if it links to the latest version though.

shamil-mubarakshin avatar Dec 08 '25 08:12 shamil-mubarakshin

@YazdanRa, this guide contains download links for different OSes. Wondering if it links to the latest version though.

Thanks! The link installed the latest version for me.

YazdanRa avatar Dec 08 '25 15:12 YazdanRa