在 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，实际上并不是。 下面几种情况就容易出现：
| 场景 | 结果 |
|---|---|
| 使用命令行上传 | metadata 缺失 |
| 自定义上传脚本 | plist 未生成 |
| CI 上传 | 只生成 IPA |
| 非 Xcode 上传 | 没有 metadata 阶段 |
Xcode 为什么很少报这个问题
因为Archive → Export流程中，Xcode 自动生成 metadata，自动组装上传结构，开发者感知不到。
真正的问题其实在上传阶段
比如 IPA 已签名，可以安装，Bundle ID 正确，但上传时报 plist 错误，说明上传工具缺 metadata 生成能力
不要手动拼 plist
网上有些方法会建议：
xml
<?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 ,上传命令:
例如：
css
appuploader_cli --upload-app -f Payload.ipa -u user@example.com -p xxxx-xxxx-xxxx-xxxx --type ios或者：
sql
appuploader_cli upload -f Payload.ipa -u user@example.com -p xxxx-xxxx-xxxx-xxxx --type iosCLI 上传时会自动解析 IPA，读取Bundle ID、Version、Build Number
自动创建 metadata，包括AppStoreInfo.plist，然后调用上传接口上传至App Store Connect
命令行更适合长期项目
如果项目已经接入：
- Fastlane
- Jenkins
- GitHub Actions
- GitLab CI
GUI 上传会变得不方便。
CLI 更适合：
| 场景 | 优势 |
|---|---|
| 自动化构建 | 可脚本化 |
| 多项目上传 | 易批处理 |
| 远程服务器 | 无 GUI 依赖 |
例如：
- Flutter 打包 IPA
- mac mini 作为 CI 节点
- Jenkins 自动上传
脚本：
diff
./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 文件。