Fastlane 结合 开心上架，构建跨优秀的平台可发布的 iOS 自动化流水线实践

在现代移动开发中，Fastlane 已经是 iOS 自动化的代名词：打包、签名、发布、通知……几乎所有重复动作都能被脚本化。
然而在真实团队中，下面这件事情依旧普遍存在：

Fastlane 只能在 macOS 上运行，最后的“上传 IPA”步骤仍然被绑定在 Mac 上。

对于跨平台项目（如 uni-app、Flutter、RN、H5 容器），团队成员大部分在 Windows 或 Linux 环境。构建、打包都可以在 CI 机器上完成，但上传到 App Store（尤其是 TestFlight）仍是流程中最难被彻底“去 Mac 化”的环节。

我们就在这样的场景下尝试了一种新的组合方式：

Fastlane 负责构建流程自动化，开心上架（Appuploader）负责跨平台 IPA 上传。

结果非常理想：
团队实现了在 Windows / Linux / Mac 任意系统下触发 iOS 自动发布，彻底摆脱了 Transporter 对 macOS 的依赖。

---

一、为什么要把 Fastlane 与开心上架结合？

Fastlane 本身非常强大，但 iOS 上传阶段依旧依赖：

• deliver
• transporter（底层调用）
• macOS 环境
• Apple 的 Java 工具链

这带来了几个现实问题：

1. Linux CI 无法上传 IPA

团队的构建节点普遍是 Linux，构建完成后依然需要：

• 人工上传
• 或远程调用一台 Mac
• 才能进入 TestFlight/发布审核

这让自动化只能做一半。

---

2. Windows 用户完全无法参与上传流程

测试、运营、项目经理无法在自己的电脑上传构建，只能“等 iOS 负责人”，极大拖慢进度。

---

3. Transporter 出现问题时，Fastlane 也会一起失败

尤其是：

• 登录失败
• 上传挂起
• 版本兼容问题

导致流水线时不时被打断。

---

我们需要的其实是：

跨平台（Win/Linux/Mac）
可脚本化
可自动化
不依赖 macOS
稳定可复用

这正是开心上架（Appuploader）命令行版本的能力范围。

---

二、开心上架（Appuploader）在整个自动化链中的作用

为了让 Fastlane 可以在任何平台持续运行，我们将上传阶段替换为开心上架的 CLI 工具。

功能如下：

---

1. 跨平台 IPA 上传（Windows / Linux / macOS）

开心上架 CLI 工具支持：

• 免 Mac 上传
• 免 Transporter
• 支持新旧上传通道（-c 1 or -c 2）
• 使用 Apple 专用密码
• 稳定、无设备指纹限制

上传命令示例：

appuploader_cli -u team@icloud.com -p xxx-xxx-xxx-xxx -c 2 -f build.ipa

结合 Fastlane 时只需要在 Lane 中调用此命令即可。

图形化界面：

---

2. 跨平台证书管理（创建 p12 / 描述文件）

Fastlane 在处理签名时也依赖证书。
团队不想每次到 Mac 钥匙串导出证书，所以：

• 使用开心上架生成证书
• 下载 p12
• 下载描述文件（Provisioning Profile）
• 在 GitLab/Jenkins/Linux 服务器中直接导入

Windows、Linux 构建节点均可使用相同证书。

这让整个流水线一致性更高。

---

3. 批量处理 App Store 信息（截图、描述、关键词）

虽然 Fastlane 的 deliver 也能批处理后台资料，但它依赖 Mac 环境。
部分团队选择：

• 用 Fastlane 控制构建
• 用开心上架批量上传截图与文案

这样可以避免因 macOS 环境差异导致的脚本失败。

---

4. 网页端工具作为人工补充

在自动化以外：

网址：https://web.applicationloader.net/

团队成员可随时：

• 上传 IPA
• 替换构建
• 填写资料
• 查看状态

这让自动化与人工流程互相补充。

---

三、完整的 Fastlane + 开心上架 自动化上架方案示例

团队实际使用流程如下：

---

① Fastlane 自动构建 IPA

lane :build dogym(scheme: "AppName",export_method: "app-store",output_directory: "./build")
end

---

② 上传阶段调用开心上架命令行

lane :upload dosh "appuploader_cli -u #{ENV['APPLE_ID']} -p #{ENV['APP_SPECIFIC_PW']} -c 2 -f ./build/AppName.ipa"
end

---

③ 合并为完整的发布 Lane

lane :release dobuildupload
end

此时：

• Windows 可执行
• Linux CI 可执行
• Mac 也可执行

整个流程终于真正意义上“脱 Mac 化”。

---

四、自动化后的收益：不是提效，而是 workflow 被彻底解放

经过一段时间运行，我们得到了几项明显收益：

---

1. Windows 团队第一次能独立完成 TestFlight 发布

不必借 Mac
不必开远程桌面
不必等待 iOS 负责人

---

2. Linux CI 可以全自动完成构建与上传

过去：
“Fastlane 自动构建 → 手动上传”

现在：
“Fastlane 自动构建 → 自动调用开心上架 CLI → 上传完毕”

完全无人值守。

---

3. Transporter 波动不再影响流水线

上传稳定度显著提升。

---

4. iOS 发布变成团队协作，而不是少数人才具备的能力

这一点对跨平台项目意义尤其大。

---

Fastlane 解决构建自动化，开心上架解决跨平台执行

我们发现：真正强大的不是单一工具，而是多工具组合上架

在这套组合中：

• Fastlane 负责流程：构建、签名、版本、通知
• 开心上架（Appuploader） 负责跨平台执行：上传 IPA、管理证书、批量处理 App Store 内容

两个工具互补，最终形成一条完整、稳定且真正“去 Mac 化”的 iOS 发布链路。

对于跨端团队，这是目前我们验证过最稳、最灵活的组合方式之一。
命令行参考链接：https://www.appuploader.net/tutorial/zh/83/83.html