很多开发者是在上传 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 下的实际上传流程
-
准备 IPA,确认是已签名、可以正常安装、Bundle ID 正确
-
找到 appuploader_cli,位置在runtime/下,Windows 下载包内即可找到。
-
执行上传命令,例如:
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 文件。