在 macOS 上上传 IPA 到 App Store Connect 时，有一类问题比较容易发现，就是 IPA 已经导出成功，签名也正常，Xcode Archive 没有报错。但上传阶段却提示 Missing AppStoreInfo.plist或者 Could not locate AppStoreInfo.plist.
很多开发者看到 .plist 文件后，会下意识去手动创建 plist、从旧工程复制，然后解压 IPA 后补文件

结果问题没有解决，反而引入新的 metadata 错误。

这篇文章直接分析，AppStoreInfo.plist 是在哪一步生成的，以及 mac 上如何避免手动维护它。

IPA 内部其实并没有这个文件

有些开发者会 unzip app.ipa来 解压 IPA ，然后在 Payload 中搜索 AppStoreInfo.plist，结果发现根本不存在，这是正常的，因为 AppStoreInfo.plist 并不属于应用内容本身。

它属于 上传 metadata，而不是App Bundle

为什么在 mac 上也会缺失

很多人认为有 Mac 就不会缺 plist，实际上并不是。
下面几种情况就容易出现：

Xcode 为什么很少报这个问题

因为Archive → Export流程中，Xcode 自动生成 metadata，自动组装上传结构，开发者感知不到。

真正的问题其实在上传阶段

比如 IPA 已签名，可以安装，Bundle ID 正确，但上传时报 plist 错误，说明上传工具缺 metadata 生成能力

不要手动拼 plist

网上有些方法会建议：

<?xml version="1.0" encoding="UTF-8"?>

然后自己写字段。问题在于 Apple metadata 字段会变化、上传协议会更新、不同 Transporter 版本结构不同，如果字段不完整就会上传直接失败

更省事的方法就是上传时自动生成

在 macOS 环境里，一个更稳定的方式是上传工具自动生成 AppStoreInfo.plist

这样不需要维护 plist，也不需要研究 metadata 格式，不需要手工拼 XML。

使用 AppUploader CLI 上传

工具位置

mac 版本：AppUploader.app/runtime/，进入 runtime 后即可使用 appuploader_cli ,上传命令:

例如：

appuploader_cli --upload-app -f Payload.ipa -u user@example.com -p xxxx-xxxx-xxxx-xxxx --type ios

或者：

appuploader_cli upload -f Payload.ipa -u user@example.com -p xxxx-xxxx-xxxx-xxxx --type ios

CLI 上传时会自动解析 IPA，读取Bundle ID、Version、Build Number

自动创建 metadata，包括AppStoreInfo.plist，然后调用上传接口上传至App Store Connect

命令行更适合长期项目

如果项目已经接入：

• Fastlane
• Jenkins
• GitHub Actions
• GitLab CI

GUI 上传会变得不方便。

CLI 更适合：

例如：

• Flutter 打包 IPA
• mac mini 作为 CI 节点
• Jenkins 自动上传

脚本：

./appuploader_cli upload \
-f build/ios/app.ipa \
-u ci@example.com \
-p xxxx-xxxx-xxxx-xxxx \
--type ios

上传时 metadata 自动生成、不需要人工干预 plist

AppStoreInfo.plist 属于 metadata 生成阶段，不是应用构建阶段。

如果上传工具已经支持自动生成 metadata，就没有必要再手动维护 plist 文件。