不用 Mac 也能开发 iOS,这个 CLI 工具直接把 GitHub Actions 拉来当构建机

技术上它没有重新发明 Xcode，只是把远程构建和设备端控制做成了流水线。仓库里检测到你的项目类型——原生、Flutter、React Native、Expo 甚至 Cordova——自动生成对应的 .github/workflows/ios-build.yml。触发 build 后，Actions 拉代码、跑 xcodebuild，打出 IPA  artifact，再由 CLI 下载到本地 ./dist/ 目录。整个过程不需要你在本地装任何 Apple 工具链。MobAI 那部分负责把 IPA 装到真机，并暴露设备控制接口，让 dev 命令能直接 watch 文件变化、发 hot reload。边界很清楚：构建依赖 GitHub 的 macOS runner（免费额度够小项目用），设备调试必须接物理 iPhone，模拟器目前不支持。

GitHub Actions 远程构建到底解决了什么痛点

先说最直观的。以前想编译 iOS 项目，Windows 用户只能 SSH 到一台 Mac，或者用虚拟机，但虚拟机里的 Xcode 又慢又不稳定。现在 Builder 把这步全扔给云端。CLI 执行 builder ios build 的时候，它先把仓库的最新代码 push 一下（或者用已有 workflow），然后 GitHub Actions 自动 checkout、安装依赖、执行 build。下载回来的 IPA 直接就能用。

这套机制聪明的地方在于，它不强制你改项目结构。支持的框架它都能自动识别：原生项目根目录下找 scheme，Flutter 去 ios/ 文件夹，React Native 也是 ios/，Expo ejected 同样。init 命令交互式问你几个问题，生成 workflow 文件后还问要不要直接 commit、push 并触发第一次 build。整个过程像是在本地操作，但实际计算发生在 GitHub 的 macOS 机器上。

当然，这也带来一些边界条件。GitHub Actions 的 macOS runner 有分钟数限制，小团队免费额度够用，但大型 CI 还是得考虑成本。代码签名默认关闭，如果你想出 signed IPA，就得提前跑 builder signing setup，把证书和 provisioning profile 转 base64 上传到仓库 Secrets。命令执行完后，build 就会自动用这些 secret 签名。不签名的场景也支持，加 --unsigned 参数就行。之前一直以为远程构建只能出 unsigned 包，后来才发现签名逻辑其实已经集成进 workflow 了，而且影响比预期更大——签名成功后，MobAI 安装环节会省掉很多手动重签名步骤。

高并发或者依赖复杂的项目，Actions 里的 build 时间大概在几分钟到十几分钟不等，取决于项目大小。CLI 下载 artifact 的环节会显示进度，下载完直接告诉你文件在 ./dist/ 里。理论上这套流程能覆盖绝大多数 iOS 项目，但如果你的 App 用到某些只有本地 Mac 才能跑的私有 pod 或者硬件调试，那还是得老老实实准备一台 Mac。毕竟远程 runner 再强，也没法直接插 USB 设备。

MobAI 让 Flutter 和 React Native 的热重载在 Windows 上成了现实

热重载这部分才是真正让我觉得“值了”的地方。以前 Flutter iOS 开发，改个 Dart 文件就要重新 build 整个 IPA，再手动安装到真机，循环一次好几分钟。现在 builder dev flutter 命令启动后，CLI 一边 watch lib/ 目录下的 .dart 文件，一边通过 MobAI 把变更推到设备。保存文件，设备上的 App 几乎立刻 hot reload，体验接近 Android 上的本地开发。

MobAI 这里扮演的角色是设备网关。它需要你在 Windows（或 Linux）上单独安装 MobAI 客户端，把 iPhone 用 USB 连上，然后在 MobAI 里开启 API server 的外部连接（WSL 用户尤其要注意 hostname.local:8686 这个地址）。dev 命令启动时会先检查设备连接，提示你安装 IPA（如果没装过），然后自动跑 flutter attach，把热重载通道打通。默认 watch 配置只盯 lib/ 目录，忽略 .g.dart 和 .freezed.dart 这类生成文件，debounce 设为 100ms，避免频繁触发。

React Native 的流程也差不多，builder dev rn 命令走同样的逻辑，只是 bundle 端口和 Metro 配置可以自定义。实际操作中我发现一个细节：第一次安装后，bundle ID 会带上 team ID 后缀（com.example.myapp.TEAMID），后面用 --skip-install --bundle-id 参数就能跳过重复安装步骤。改纯 Dart/JS 代码不需要重新 build，只有原生部分改动（Podfile、Swift 文件）才需要再跑一次 builder ios build。

当然，这里有个前提——必须是物理设备，模拟器目前不支持。连接不稳定的时候，CLI 会给出明确提示：关闭 App、重新插拔 USB、重启 MobAI，或者直接跑 builder mobai ping 测试连通性。这些小细节让整个流程不像黑箱，而是能快速定位问题。

快速上手完整流程，照着做就能跑通第一个 IPA

先安装 CLI 本身。Windows 用户去 Releases 页面下载 builder.exe 加到 PATH；macOS/Linux 直接跑 curl 安装脚本，或者源码 go build 也行。

# 第一步：认证 GitHub，避免后面触发 workflow 时权限不够builder auth github

这一步会打开浏览器让你登录 GitHub，拿到 token 后本地存起来。

# 第二步：在你的 iOS 项目目录里初始化cd your-ios-projectbuilder init

init 命令会自动检测项目类型，生成 .github/workflows/ios-build.yml，还问你要不要 commit 并 push。整个过程交互式，不需要手动编辑 YAML。

# 第三步：触发构建builder ios build

命令跑完后，CLI 会等待 Actions 完成，然后把 IPA 下载到 ./dist/ 目录。你会看到类似“Download completed: ./dist/MyApp.ipa”的提示。如果要不签名版本，加 --unsigned 参数。

想做热重载的话，先确保 MobAI 客户端已安装并连上 iPhone，再执行：

# Flutter 热重载（默认开启文件监听）builder dev flutter

MobAI 会引导你完成第一次安装，后续改 Dart 文件保存即可看到热重载。如果只想打印 flutter attach 命令用于 IDE 集成，加 --no-attach 参数。整个流程跑下来，最容易出错的地方是 MobAI 的 API server 没开外部连接，或者 bundle ID 没带 team ID 后缀。

收尾

现在回头看，我之前一直觉得 iOS 开发和 Mac 是绑定死的，结果这个工具把构建和设备控制彻底解耦了。构建靠云端 Actions，调试靠 MobAI 桥接，CLI 把所有步骤粘成一条命令链。普通开发者能少花几千块硬件钱，团队里 Windows/Linux 开发者也能真正参与 iOS 项目。边界还在——大型项目、复杂原生依赖、模拟器场景依然需要 Mac——但对大多数日常开发来说，这已经够用了。

你们团队现在开发 iOS 主要卡在哪一步？是构建环境还是设备调试？💬