当前位置：首页 > news >正文

Linux 上生成 AppStoreInfo.plist，App Store 上架 iOS

news 2026/5/26 19:42:48

在 Linux 服务器上处理 iOS 上传时，很多人会卡在一个奇怪的问题上，IPA 签名完成之后，等待上传的时候，但工具提示缺少AppStoreInfo.plist。

这个文件容易让人误解。它不是 App 里的资源文件，也不是放进Payload里的配置文件。它属于上传阶段的数据，和 IPA 一起被提交给 App Store Connect。

确认 Linux 负责的是上传

在这套流程里 Linux 的作用是接收已经签名完成的 IPA，调用命令行上传工具将包提交到 App Store Connect
IPA 可以来自：Xcode Archive、Fastlane 构建、Flutter / React Native 的 macOS 构建节点、HBuilderX 或云打包服务，Linux 不需要参与 iOS 编译，只处理上传。

AppStoreInfo.plist 为什么会在 Linux 上传时出现

如果使用 Xcode 的图形化上传流程，相关 metadata 会由 Xcode 自动处理，我们很少看到它。

但在 Linux 上，没有 Xcode，也没有 Transporter 图形界面。上传工具如果没有自动生成 metadata，就可能出现Missing AppStoreInfo.plist，或者上传阶段直接失败。

这类问题不代表 IPA 损坏，也不代表证书无效。它说明上传缺少 App Store 所需的描述信息。

不建议手动创建 AppStoreInfo.plist

手动创建 plist 看起来可行，但维护成本很高。因为，metadata 字段会随 Apple 上传接口变化、不同上传方式需要的结构可能不同、手写字段出错后，报错会变得更难排查，如果只是为了上传 IPA，手动维护 plist 并不是稳定方案。

使用 AppUploader CLI 自动生成并上传

在 Linux 上，可以使用AppUploader（开心上架）的命令行工具完成上传。

Linux 版本的appuploader_cli位于下载包的runtime目录中。

进入目录后，可以先赋予执行权限chmod +x 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

这里的参数含义：

-f指定 IPA 文件路径
-u指定 Apple 开发者账号
-p指定 App 专用密码
--type ios指定上传 iOS 应用

执行上传时，CLI 会自动处理上传 metadata，其中就包括AppStoreInfo.plist，不需要开发者单独生成。

在 CI 里怎么接入

如果 Linux 节点跑在 Jenkins、GitLab CI 或其他发布系统中，可以把上传命令放进脚本：

if [ ! -f build/app.ipa ]; then echo "IPA not found" exit 1 fi ./appuploader_cli upload \ -f build/app.ipa \ -u "$APPLE_ID" \ -p "$APP_PASSWORD" \ --type ios

这样上传流程就变成了一个自动可以重复使用的步骤了：