简介Application Loader是苹果开发者生态中独立于Xcode的免费上传工具面向需要将iOS、watchOS、tvOS应用发布到App Store的开发者尤其适合Xcode上传失败、大文件提交或需更严格验证的场景。资源包共1280个文件约99.26MB以strings、nib、xml、jar、tiff、png、dylib、plist等为主涵盖界面资源、本地化文本、配置描述、动态库与证书相关文件完整保留了工具运行所需的目录结构。已有865人学习下载说明其在iOS发布流程中具有实用参考价值。通过这份资源读者可了解IPA文件的验证与上传机制、证书与Provisioning Profile的匹配要点、元数据检查方法以及网络中断、文件大小限制等常见问题的排错思路从而更顺畅地完成应用提交减少发布环节的延误。1. 从一次上传卡在“正在验证”说起Application Loader 到底解决什么问题如果你做过 iOS 开发或负责过 App 上架大概率遇到过这种场景Archive 打完包Organizer 里点上传进度条走到一半卡住或者干脆报一个语焉不详的“正在验证 App”然后失败。网络没问题账号也没问题但就是传不上去。这时候很多老工程师会甩出一个工具——Application Loader。它不是什么新东西苹果官方出品专门用来把.ipa包提交到 App Store Connect。相比 Xcode 内置的上传通道Application Loader 的反馈更细能明确告诉你卡在验证的哪一步、是证书问题、描述文件问题还是包体本身的问题。它适合两类人一是 Xcode 上传反复失败、需要看详细日志定位的开发者二是需要批量或脚本化上传的团队。这篇笔记就把这个工具从安装、配置到排错完整拆一遍重点放在“为什么传不上去”和“怎么让它传上去”。2. Application Loader 的获取与运行环境为什么它不在 Xcode 里了2.1 工具定位与版本来源Application Loader 早期是独立应用放在/Applications/Xcode.app/Contents/Applications/下面。后来苹果把它整合进了 Xcode 的 Organizer独立入口一度被隐藏。但直到现在你仍然可以通过 Xcode 菜单里的Open Developer Tool找到它或者直接从 Xcode 包内容里把Application Loader.app拖出来单独用。常见做法是在 Finder 里右键 Xcode → 显示包内容 → Contents → Applications → 找到 Application Loader。这个路径在不同 Xcode 版本里基本稳定但如果你用的是较新的 Xcode苹果可能已经用Transporter替代了它。Transporter 是 Application Loader 的继任者界面更简洁但底层上传逻辑和报错机制一脉相承。所以这篇笔记里提到的很多排查思路在 Transporter 上同样适用。需要明确一点Application Loader 本身不负责打包它只负责上传和验证。你必须在 Xcode 里先 Archive 出.xcarchive再导出成.ipa然后才能交给它。很多人第一次用会误以为它能直接编译结果找不到入口。正确的流程是Xcode → Product → Archive → Distribute App → 选择 iOS App Store → 导出.ipa。这个.ipa才是 Application Loader 的输入。2.2 运行环境与依赖检查Application Loader 依赖 Java 运行环境。早期版本需要 JRE 6 或 JRE 8如果系统里没有启动时会直接弹窗提示“需要 Java SE 6”。在 macOS 10.15 之后苹果不再预装 Java所以你需要手动装一个。常见做法是去 Oracle 官网下载 JDK 8或者用brew install --cask temurin8装 Temurin 8。装完后在终端执行java -version确认版本。如果版本太高比如 JDK 17Application Loader 可能启动闪退这是血泪经验——不是越新越好它只认老版本 Java。另外Application Loader 对网络环境有要求。它需要访问 Apple 的上传接口端口通常是 443 和 8080。如果你在公司内网防火墙可能拦了这些端口表现就是一直卡在“正在连接”。这时候可以先用nc -vz upload.appstore.com 443测一下连通性。如果连不上找网管开端口别急着怀疑工具本身。提示Application Loader 在 macOS 10.14 之后已经不再随 Xcode 默认安装你需要从 Xcode 包内容里手动提取或者直接改用 Transporter。Transporter 在 Mac App Store 里可以搜到安装更省事。3. 用 Application Loader 上传 ipa 的完整操作链从导出包到提交成功3.1 从 Xcode 导出符合上传要求的 ipa在 Xcode 里选中你的项目确保 Scheme 选的是Generic iOS Device或Any iOS Device然后 Product → Archive。Archive 完成后Organizer 窗口会自动弹出。点右侧的Distribute App选择iOS App Store然后一路 Next。这里有几个关键选项Upload直接上传不走 Application Loader。Export导出.ipa文件这才是我们要的。选Export后Xcode 会问你要不要Strip Swift symbols、要不要Upload your apps symbols。一般保持默认即可。最后选择一个导出目录Xcode 会生成一个包含.ipa的文件夹。这个.ipa就是 Application Loader 的输入文件。代码块里给一个用xcodebuild命令行导出.ipa的示例适合 CI 环境# 先 archive xcodebuild -workspace YourApp.xcworkspace \ -scheme YourApp \ -sdk iphoneos \ -configuration Release \ -archivePath ./build/YourApp.xcarchive \ archive # 再导出 ipa xcodebuild -exportArchive \ -archivePath ./build/YourApp.xcarchive \ -exportPath ./build/ipa \ -exportOptionsPlist ./ExportOptions.plist逻辑说明第一条命令把项目编译并归档到./build/YourApp.xcarchive。第二条命令根据ExportOptions.plist里的配置把归档转成.ipa。ExportOptions.plist里最关键的是method字段上架 App Store 要填app-store。如果你填了ad-hoc或development导出的包 Application Loader 会拒收报错“Invalid Signature”或“Unsupported method”。参数-exportPath指定输出目录目录必须提前存在否则命令会失败。3.2 在 Application Loader 中登录并选择包打开 Application Loader第一件事是登录。这里用的账号必须是 App Store Connect 里有上传权限的账号通常是 Apple ID 加专用密码。如果你开了双重认证普通密码不行必须去 appleid.apple.com 生成一个 App 专用密码。这个坑非常常见很多人输入账号密码后一直提示“无法登录”其实就是没生成专用密码。登录成功后主界面会显示“选取要上传的 App 包”。点“选取”找到刚才导出的.ipa。选中后Application Loader 会先做一轮本地验证检查包体结构、证书、描述文件。如果这一步就报错说明包本身有问题不用继续往下走。常见报错包括Invalid Provisioning Profile描述文件过期或类型不对。Missing Icon缺少 1024x1024 的 App Store 图标。Unsupported Architecture包含了模拟器架构需要剔除。本地验证通过后点“发送”。这时候才是真正的上传。上传过程中会显示进度条和当前步骤比如“正在验证 App”“正在上传文件”“正在处理”。如果卡在“正在验证 App”多半是包体里有不合规的 API 或隐私描述缺失。3.3 上传过程中的日志与状态解读Application Loader 的日志窗口是排查问题的核心。点菜单栏Window→Log可以打开。日志里会记录每一步的详细输出包括 HTTP 请求和响应。比如你看到ERROR ITMS-90000之类的错误码可以直接拿这个码去搜。常见的 ITMS 错误码有错误码含义常见原因ITMS-90000包体验证失败缺少图标、架构不对ITMS-90208无效的包结构嵌套了多余的.appITMS-90474设备架构不匹配包含了 armv7 但未支持ITMS-90683隐私描述缺失用了相机但没写用途日志里还会显示上传速度。如果速度一直是 0检查网络代理设置。Application Loader 不走系统代理需要在偏好设置里手动填。但注意这里说的代理是公司内网的正向代理不是其他东西。如果你不确定直接关掉代理试。注意上传成功后Application Loader 会提示“上传成功”但 App Store Connect 里不会立刻显示。通常需要等 10 到 30 分钟处理。如果超过 1 小时还没出现去 App Store Connect 的“活动”页面看有没有“处理中”的记录。如果连记录都没有说明上传其实没成功只是本地显示成功这时候要回看日志。4. 上传失败排查证书、描述文件与包体的五个高频坑4.1 证书与描述文件不匹配现象Application Loader 本地验证时报Invalid Provisioning Profile或Certificate not found。原因导出.ipa时用的证书和描述文件不匹配。比如描述文件是开发类型的但导出时选了 App Store 分发或者证书过期了Xcode 没自动更新。解决去 Apple Developer 后台检查证书和描述文件的有效期。确保描述文件类型是App Store并且绑定的证书是Production而不是Development。然后在 Xcode 的Preferences→Accounts里点Download Manual Profiles重新拉取。如果还不行删掉本地~/Library/MobileDevice/Provisioning Profiles/下的旧文件重新下载。4.2 包体包含模拟器架构现象上传到一半报Unsupported Architecture或ITMS-90474。原因Archive 时 Xcode 可能把模拟器架构也打进去了尤其是用了某些第三方库比如老版本的 Firebase时。解决在 Build Settings 里把Excluded Architectures设为arm64对应模拟器或者在导出.ipa后用lipo -info检查二进制。如果包含x86_64或i386用lipo -remove剔除。更彻底的做法是在Podfile里加post_install钩子自动剔除模拟器架构。# Podfile 里剔除模拟器架构 post_install do |installer| installer.pods_project.targets.each do |target| target.build_configurations.each do |config| config.build_settings[EXCLUDED_ARCHS[sdkiphonesimulator*]] arm64 end end end逻辑说明这段脚本在pod install后执行把所有 Pod 目标的模拟器架构排除掉。EXCLUDED_ARCHS[sdkiphonesimulator*]表示在模拟器 SDK 下排除 arm64。这样 Archive 出来的包就不会带模拟器架构了。参数arm64可以根据需要改成x86_64但通常排除 arm64 就够了。4.3 隐私描述缺失现象上传成功但 App Store Connect 里显示“被拒绝”或者 Application Loader 报ITMS-90683。原因App 里用了相机、相册、定位等权限但Info.plist里没写对应的用途描述。苹果从 iOS 10 开始强制要求。解决在Info.plist里补上NSCameraUsageDescription、NSPhotoLibraryUsageDescription等键值。描述要具体不能写“需要相机权限”这种废话要写“用于拍摄商品照片上传”。改完后重新 Archive 再传。4.4 网络超时与重传现象上传进度条走到 90% 后卡住然后报Network timeout。原因上传文件较大超过 2GB或者网络不稳定。Application Loader 默认超时时间较短。解决在偏好设置里把Timeout调大比如 600 秒。另外尽量用有线网络别用 Wi-Fi。如果还是断可以试试分卷上传但 Application Loader 不支持断点续传断了就得重来。所以大包建议直接用 Transporter它对大文件更友好。4.5 账号权限不足现象登录成功但点“发送”后报You are not authorized to upload。原因当前 Apple ID 没有上传权限。通常是团队里的开发者账号但没被授予App Manager或Admin角色。解决让团队管理员在 App Store Connect 的Users and Access里把你的角色改成App Manager或Admin。改完后退出 Application Loader 重新登录。提示如果以上都排查了还是失败把 Application Loader 的日志导出成文本搜ERROR关键字。日志里会给出具体的失败原因比界面上的提示详细得多。5. 进阶技巧用 Transporter 替代与命令行自动化上传5.1 Transporter 的迁移与对比Transporter 是苹果现在主推的上传工具界面和 Application Loader 很像但底层用了新的上传协议。它支持拖拽上传也支持命令行。如果你还在用 Application Loader建议逐步迁到 Transporter。迁移成本很低登录方式一样包体要求一样报错码也基本一致。区别在于 Transporter 对网络波动的容忍度更高而且支持后台队列。我一般会同时装两个Application Loader 用来快速验证包体Transporter 用来实际上传。5.2 用 iTMSTransporter 做命令行上传Transporter 自带一个命令行工具叫iTMSTransporter路径在/Applications/Transporter.app/Contents/itms/bin/下面。这个工具可以集成到 CI 里实现全自动上传。用法如下# 先验证包体 /Applications/Transporter.app/Contents/itms/bin/iTMSTransporter \ -m verify \ -u youremail.com \ -p app-specific-password \ -f /path/to/YourApp.ipa \ -v informational # 验证通过后上传 /Applications/Transporter.app/Contents/itms/bin/iTMSTransporter \ -m upload \ -u youremail.com \ -p app-specific-password \ -f /path/to/YourApp.ipa \ -v informational逻辑说明-m verify表示只验证不上传用来快速检查包体是否合规。-m upload才是真正上传。-u和-p分别是 Apple ID 和 App 专用密码。-f指定.ipa路径。-v控制日志级别informational会输出足够详细的日志方便排查。注意-p后面跟的是专用密码不是你的 Apple ID 登录密码。如果你在 CI 里用建议把密码放到环境变量里别硬编码在脚本中。这个命令跑完后如果成功终端会输出Package Summary和Upload succeeded。如果失败会输出具体的错误码。我习惯在 CI 里先跑verify通过了再跑upload这样能避免传了一半才发现包有问题。5.3 一个我踩过的坑专用密码过期App 专用密码不是永久有效的。如果你在 appleid.apple.com 里撤销了某个密码或者密码超过一年没换它可能会失效。表现就是iTMSTransporter报Authentication failed。这时候别怀疑账号直接去重新生成一个专用密码。从那以后我每次配 CI都会在脚本里加一个检查如果上传失败且错误码是401就提示“请检查专用密码是否过期”。这个习惯帮我省了很多半夜排查的时间。希望帮到你。本文还有配套的精品资源点击获取