很多开发者是在上传 IPA 时，才发现 Info.plist 这个文件。

尤其是在 Windows 打包 iOS、Linux CI 上传 IPA、非 Xcode 上传流程里，经常会碰到：
Missing Info.plist或者：Could not find Info.plist

有些文章会建议：手动创建 plist、用 Xcode 导出、使用 Transporter 自动生成

但如果当前环境就是 Windows，这些方法并不方便。

Info.plist 是什么

它本质上是上传 App Store 时附带的一份元数据文件

里面包含 Apple 上传识别信息、包结构描述和上传任务参数

它不是应用运行需要的文件。

Windows 环境要怎么办

在 Xcode 中 Archive 和 Export IPA，这两个步骤会自动生成相关 metadata。

但如果是：

  • Flutter Windows 打包
  • Unity 导出 IPA
  • HBuilder 云打包
  • React Native CI

IPA 已经生成，但是上传 metadata 没生成，这时上传工具就可能报错。

常见误区，手写 plist

网上有些方案会建议：

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

然后自己拼接 plist 内容，问题在于 Apple 上传字段会变化、Transporter 版本不同、metadata 结构不同。结果容易出现，上传失败（metadata validation failed）

更直接的方法就是让上传工具自动生成

如果目标只是上传 IPA 到 App Store Connect，那没有必要自己生成 plist。

可以使用 AppUploader CLI 的处理方式，在 Windows、Linux、Mac 中，使用命令行上传时会自动生成 Info.plist。因此 不需要手动创建、不需要 Xcode、不需要 Transporter GUI

Windows 下的实际上传流程

  1. 准备 IPA，确认是已签名、可以正常安装、Bundle ID 正确

  2. 找到 appuploader_cli，位置在runtime/下，Windows 下载包内即可找到。

  3. 执行上传命令，例如：

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，其中就包括：Info.plist

自动调用上传接口

直接上传至App Store Connect

命令行方式更适合 CI

在持续集成环境里不适合打开 GUI 也不适合依赖 Xcode

CLI 的好处是可以脚本化、可以接 Jenkins / GitLab CI、可以放进 Docker。CI 示例：

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

容易忽略的问题，App 专用密码

上传时，-p 不是 Apple 登录密码，需要在 Apple ID 后台创建 App-Specific Password，否则上传会认证失败。

命令参数解释

参数 作用
--upload-app 上传应用
-f IPA 文件路径
-u Apple ID
-p App 专用密码
--type ios iOS 包

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