构建跨平台 CI/CD 流程时，iOS 上架真的是最大绊脚石

一个用 GitHub Actions、Fastlane 和 App 开发助手实现 iOS 自动上传的实战记录

前言：CI/CD 不该被平台限制

当我们说起 CI/CD，大部分人的第一反应是：自动化构建、测试、部署。没错，我最初的目标也是如此——我希望我用 Flutter 写的项目，能像 Web 应用一样，一键打包、一键发布。Android 这一端做得非常丝滑：Gradle、Keystore、Play Console 都有相对成熟的解决方案。

然而，到了 iOS，我几乎停滞了整整两周。

难点在哪？简单总结三件事：

1. 构建环境依赖 macOS：
   Apple 的构建工具链要求你必须在 macOS 上运行，Xcode 是无法在 Windows/Linux 上安装的，哪怕是上传 IPA，也离不开工具链。
2. 签名体系复杂且难自动化：
   开发证书、发布证书、描述文件一套流程，很多操作默认你有图形化界面（比如钥匙串助手）。CI 环境下如何实现自动生成和使用？
3. 上传流程依赖 Application Loader/Transporter：
   这些工具本身是 mac-only 的，虽然 Apple 提供了 altool，但支持有限，而且有时还需要 Xcode CLI 环境。

第一次尝试：Mac 虚拟机 + Fastlane

我在公司一台老 Mac mini 上架设了远程 Runner，尝试使用 Fastlane 配置自动构建与上传。遇到的最大问题是：

• 虚拟机网络不稳定
• Xcode CLI 版本不兼容
• Fastlane 有时能 build，有时找不到 profile

搞了三天，最终放弃。

第二次尝试：非构建式上传 + 手动准备证书

这个思路是从 CI 中导出 IPA，然后在本地上传。

问题是，上传仍然得用 Mac，我在一台个人笔记本上勉强跑了一次 Application Loader，上传成功，但完全没有可复用性和自动化性。

转机：App 开发助手（Application Uploader）

一次逛论坛时，有人提到一个冷门工具：App 开发助手，可以在非 Mac 系统中上传 IPA，支持证书创建、描述文件管理等功能。我抱着试试看的心态，用了它之后，彻底打通了我这条上传链路。

它的优势：

• 运行平台不限：Windows、Linux、Mac 都能跑
• 证书申请不需要钥匙串助手：输入开发者邮箱、证书名即可
• 描述文件自动管理：支持创建、更新、下载，甚至共享证书
• 支持 metadata 和截图上传：可结合 Fastlane metadata 使用
• 上传 IPA 无需 Xcode CLI：直接调用 Apple API 上传，更轻量

我的 CI/CD 流程现在是这样的：

1. GitHub Actions 拉取源码，执行 Flutter build ipa
2. 构建完成后上传 IPA 到一台中转服务器
3. App 开发助手监听上传目录，自动打包 + 上传到 App Store
4. Fastlane 提前生成 metadata.json，截图等通过 deliver 格式导出
5. 上传完成后通过邮件通知项目组，进入 Apple 审核流程

安全性考虑

很多人关心：“这样传 IPA 到服务器、上传证书安全吗？”

• App 开发助手支持 token 授权方式连接 App Store，避免明文密码
• 描述文件和证书创建过程可以封装在脚本中，结合环境变量避免泄露
• 上传通道使用 HTTPS，且工具本身并不记录私钥内容
• 证书共享策略可以精确控制成员访问权限

成果：节省了大量人力+时间

以前每次打包 iOS，我们至少需要：

• 找到一台空闲的 Mac
• 本地构建、签名
• 用图形界面上传 App Store
• 手动填写 metadata，上传截图等

现在：10分钟构建 + 上传，全自动化。 非常适合我们这种一周迭代两次以上的团队。

结语

并不是所有人都适合 App 开发助手，很多用 Xcode 的原生 iOS 团队可能不需要它。

但如果你：

• 用的是 Flutter、React Native、Cordova 这类跨平台框架
• 没有稳定的 Mac 构建机
• 想把上架流程集成到 CI/CD 中

这绝对是值得一试的组合方案。

如果你也遇到类似的问题，欢迎留言讨论，我们可以交流更多自动化打包与上传经验。