如何使用 iTMSTransporter 命令行上传 ipa 到 App Store

一、安装 Transporter 命令

方法1：（XCode 11 及以上）

直接在【终端】执行安装命令：

xcrun iTMSTransporter

安装好以后，iTMSTransporter 的文件位置在：

/Applications/Xcode.app/Contents/SharedFrameworks/ContentDeliveryServices.framework/itms/bin/iTMSTransporter

(藏得真深 =_=b)

方法2：（推荐）

从 Mac App Store 下载 Transporter 应用。下载地址：

https://apps.apple.com/cn/app/transporter/id1450874784?mt=12

安装好以后，则可以在 app 包里找到 iTMSTransporter 命令：

/Applications/Transporter.app/Contents/itms/bin/iTMSTransporter

二、准备“App 专用密码” （后面要用到）

1. 进入苹果官网 http://www.apple.com/cn/
2. 拉到页底，选择账户-管理你的Apple ID

3. 登录（如果开启双重验证，在点击登录后需要输入一个6位的密码，可以在使用相同密码已登录的其他设备上找到。）
4. 在“登录和安全”栏目里找到一个叫“APP专用密码”的条目，点击进去按系统系统提示操作生成专用密码即可。

 

5. 最后生成的专用密码赶紧保存下来，关掉这个弹窗就看不到了（只能重新生成）。

 三、使用 iTMSTransporter 命令上传 ipa

直接上命令：

/Applications/Transporter.app/Contents/itms/bin/iTMSTransporter -m upload -assetFile <ipa_path> -u <user_name> -p <private_password> -v informational

命令详解：

• /Applications/Transporter.app/Contents/itms/bin/iTMSTransporter：命令所在的位置。根据第一部分中的描述找到自己电脑中安装的 iTMSTransporter 命令。

设置好 TRANSPORTER_HOME 环境变量后，可以不用带上命令路径，直接使用命令。

若要添加 TRANSPORTER_HOME 环境变量，请在您的 .bash_profile 中添加以下行：export TRANSPORTER_HOME=<file path to Transporter>。

•  -m upload：指定 Transporter 模式。我们是上传 ipa，所以模式指定为 upload。其他模式参见官方文档（https://help.apple.com/itc/transporteruserguide/#/apdA3ae5a8b0）。
•  -assetFile <ipa_path>：指定 ipa 文件的绝对路径。
• -u <user_name>：你的开发者账号 Apple ID。
• -p <private_password>：这就是前面第二部分生成的“App 专用密码”。
• -v informational：指定要使用的日志级别。informational 表示只接收高级别的 Transporter 注释和所有错误信息。默认级别是 eXtreme，会收到太多详细信息，看瞎眼过的同学都懂。
• 最简单的参数有这些就够了，更多参数配置参见官方选项说明（https://help.apple.com/itc/transporteruserguide/#/apdAa073cb45）

给个示例：

/Applications/Transporter.app/Contents/itms/bin/iTMSTransporter -m upload -assetFile /Users/crazycao/Downloads/MyApp.ipa -u crazycao@mymail.com -p aaaa-bbbb-cccc-dddd -v informational

上传时间看网速了，总体来说我感觉速度还可以。最后看到如下日志，就是上传成功了。

Package Summary:
 
1 package was uploaded successfully:
	/var/folders/50/csnv2w15449_2tqdfl4t5cnr0000gn/T/DeveloperAPIUpload14096758983631912947/1589762792.itmsp
[2021-12-15 17:33:39 CST] <main> DBG-X: Returning 0

-------

参考文档：《Transporter 用户指南 2.2》（官方文档·中文）
https://help.apple.com/itc/transporteruserguide/#/itc0d5b535bf