远程 Mac mini GitLab Runner iOS 自动化打包

如何使用远程 Mac mini 搭建 GitLab Runner 实现 iOS 自动化打包 🚀

12 分钟阅读
GitLab Runner iOS 自动化 Mac mini

在 iOS 开发流程中,打包发布往往是最耗时且最让开发者头疼的环节。本地打包不仅占用开发机资源,导致电脑发热卡顿,还难以实现团队协作的标准化。💻 使用远程 Mac mini 搭建 GitLab Runner,实现 CI/CD 自动化流水线,已经成为现代 iOS 团队的标配方案。本文将手把手带你完成这一高效配置。

📊 方案对比:为什么选择远程 Mac mini?

在选择 iOS 自动化方案时,开发者通常在本地构建、云端共享构建和专用远程主机之间权衡。

维度 本地打包 (Manual) 远程 Mac mini (CI/CD)
开发效率 低 (阻塞开发任务) 高 (后台自动执行)
环境一致性 差 (因人而异) 极佳 (标准化容器/环境)
构建速度 取决于本地硬件 极快 (专用高性能主机)
团队协作 难以共享 一键触发,全员可见

🛠️ 核心搭建流程

1通过 VNC 连接到远程 Mac mini

首先,你需要访问你的远程 Mac。使用 VNCMac 提供的云端物理机,你可以通过 macOS 自带的“屏幕共享”或 VNC 客户端秒级接入。这种“无头服务器”模式让你无需显示器即可像操作本地电脑一样配置环境。

💡 提示:VNCMac 的 M4 机型支持高清画面同步,操作延迟极低。

2安装 GitLab Runner

在 Mac mini 上打开终端,通过 Homebrew 快速安装:

brew install gitlab-runner
gitlab-runner install
gitlab-runner start
3注册与配置 Runner

从 GitLab 项目的 Settings > CI/CD > Runners 获取 Token,然后在终端执行:

gitlab-runner register

在配置过程中,Executor 请务必选择 shell,因为 iOS 打包需要直接调用系统级的 Xcode 命令和证书。

4配置 Fastlane 自动化工具

Fastlane 是 iOS 自动化的灵魂。在项目根目录初始化:

fastlane init

编写 Fastfile 定义 lane :beta,实现自动增加版本号、Archive 打包及上传 TestFlight。

📝 编写 .gitlab-ci.yml

最后,在项目根目录创建 .gitlab-ci.yml,将代码提交与构建任务挂钩。

stages:
  - build

build_job:
  stage: build
  tags:
    - ios  # 对应 Runner 注册时的标签
  script:
    - bundle install
    - bundle exec fastlane beta
  only:
    - master

🔐 关于证书与签名

这是最容易踩坑的地方。⚠️ 我们推荐使用 Fastlane Match。它通过一个私有的 Git 仓库统一管理团队的证书和描述文件。在远程 Mac mini 上执行 fastlane match readonly,即可一键同步所有签名环境,避免“找不到证书”的错误。

总结

通过远程 Mac mini 搭建 GitLab Runner,你不仅解放了自己的开发机,更获得了一个稳定、高效、可追溯的自动化构建环境。配合 VNCMac 的高性能 M4 云端物理机,iOS 项目的打包时间可从半小时缩短至几分钟。🚀

如果你还没有尝试过在云端部署你的 CI/CD,现在就是最佳时机。只需几分钟配置,即可享受自动化带来的极致开发体验!

即刻拥有高性能 iOS 构建机

在 VNCMac 租用专属 M4 Mac mini,专为 GitLab Runner 与 Fastlane 优化,让自动化打包快如闪电。

  • 全新 M4 芯片,Xcode 编译性能巅峰
  • 预装高效环境,一键开启 CI/CD
  • 独享带宽,上传 App Store 零延迟