Mac 上生成 AppStoreInfo.plist 文件，App Store 上架

在 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 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 更适合：

场景	优势
自动化构建	可脚本化
多项目上传	易批处理
远程服务器	无 GUI 依赖

例如：

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 文件。