没有 Mac,就无法构建 iOS
Apple 的构建工具需要 macOS。使用 Windows 或 Linux 的开发者无法在自己的机器上编译或签名 iOS 构建。
面向 Windows 和 Linux 开发者
Capgo 会在云端 Mac 机器上编译并签名您的 Capacitor iOS 应用。在 Windows、Linux 或 CI 中运行一条 CLI 命令,签名后的构建就会上传到 App Store Connect,供 TestFlight 使用。
14 天无限免费试用。无需信用卡 14 天退款保证。随时取消。
npx @capgo/cli@latest build init --platform ios
npx @capgo/cli@latest build request --platform ios
# signed build runs on an ephemeral Mac runner
# logs stream back to your terminal 云端 Mac 机器
iOS 构建在专用 Mac mini M4 机器上运行。你可以从现有电脑直接发起构建。
已签名并上传
Build 已用你的证书签名并上传到 App Store Connect,可直接用于 TestFlight。
问题
Apple 的构建工具需要 macOS。使用 Windows 或 Linux 的开发者无法在自己的机器上编译或签名 iOS 构建。
证书和配置文件常常只放在某个人的 Mac 上。这个人不在或配置文件过期时,发布就得等。
租来的 macOS runner 仍然需要更新 Xcode、维护 Fastlane lane、管理签名密钥,并在 Apple 有改动时调试。
工作原理
你需要一个 Capacitor App、一个 Capgo 账号以及一个 Apple Developer 账号。下面的每条命令都来自 Capgo CLI 文档。
Onboarding 会读取你的 Capacitor 项目,创建发布证书和 Provisioning Profile,并保存到你的机器上。
npx @capgo/cli@latest build init --platform ios iOS Build 指南 如果你的团队已有证书和描述文件,可以用 App Store Connect API 密钥保存它们。它们会保留在本地凭据文件中。
npx @capgo/cli@latest build credentials save --platform ios \
--apple-team-id YOUR_TEAM_ID \
--apple-key ./AuthKey_XXXXX.p8 \
--apple-key-id YOUR_KEY_ID \
--apple-issuer-id YOUR_ISSUER_ID \
--certificate ./certificate.p12 \
--ios-provisioning-profile ./profile.mobileprovision 凭据管理 将 Web build 同步到 iOS 项目,然后发起构建请求。日志会流式输出到你的终端,签名后的 build 会上传到 App Store Connect 用于 TestFlight。
npx cap sync ios
npx @capgo/cli@latest build request com.example.app --platform ios 首次构建指南 使用 build credentials manage 将已保存的凭据导出为 CI secrets,设置 CAPGO_TOKEN,然后在 GitHub Actions、GitLab CI 或任意 runner 中运行 build request。
npx @capgo/cli@latest build credentials manage
# in your CI job
npx @capgo/cli@latest build request com.example.app --platform ios GitHub Actions 设置 解决方案
当 native code 发生变化时,Native Build 会在云端运行;Web 变更则在两次商店发布之间继续以 Live Updates 交付。
iOS 构建在预装 Xcode 的专用 Mac mini M4 机器上运行。你的 Windows 或 Linux 笔记本,或 CI runner,只需从终端发起请求。
Capgo Build 概览build init 会为您创建分发证书和描述文件。它使用 App Store Connect API 密钥,您可以在 Windows 或 Linux 上的浏览器中创建该密钥。
iOS Build 指南只需保存一次凭据,即可从终端、GitHub Actions、GitLab CI 或任何其他 pipeline 中运行 build request。
build 命令参考当插件、权限、图标或 Capacitor 版本发生变化时,使用 Capgo Build。在用户安装商店构建后,将 JavaScript、CSS 和资源更改作为 Live Update 发布。
Live update 还是 Native Build?信任模型
凭据只保留在你的机器上或 CI secrets 中。Capgo 只在构建运行期间持有它们。
CLI 会上传原生平台文件夹和原生依赖。你的完整仓库仍留在你的机器上。
构建日志会在构建运行期间实时流式输出,不会存储在 Capgo 服务器上。
证书和描述文件只在构建期间于内存中使用,构建完成后即被删除。每次构建都在隔离环境中运行,结束后该环境会被销毁。
使用 Capacitor 构建的应用
当团队主要由 Web、支持或运维人员组成时,学校、交通和支持类应用仍需要签名的移动端版本。托管构建工作流消除了单机瓶颈,同时让签名步骤保持可重复。
学校通讯应用,非原生团队仍需要可靠的签名发布版本。
交通预订应用,发布交接不应依赖某台开发机。
为需要可重复移动端构建记录的运维团队提供的支持工具。
设计,圆角半径 5
“Capgo Build 帮我们简化了 Capacitor 应用的发布流程。通过一套清晰的工作流,我们就能构建并发布 iOS 和 Android 应用。”
Tellent 移动平台首席工程师
“我们最初是通过插件发现 Capgo 的,事实证明,这为我们的团队开启了一个更高效的发布流程。”
常见问题
Windows 和 Linux 开发者在首次云端 iOS 构建前常问的问题。
编译、签名或上传都不需要。构建在 Capgo 的 Mac mini M4 机器上运行。你仍然需要 Apple Developer 账号。在 Windows 或 Linux 上,你在浏览器里创建 App Store Connect API 密钥,然后由 CLI 处理证书和描述文件。
iOS Build 指南典型的原生构建需要 2–3 分钟。运行期间日志会实时输出到终端,出错时你能立刻看到。
首次构建指南可以。凭据里配置好 App Store Connect API 密钥后,签名构建会上传到 App Store Connect,你可以在 TestFlight 中测试并提交 App Store 审核。如果还需要 IPA 的下载链接,加上 --output-upload 即可。
Build 配置默认保存在你本机的 ~/.capgo-credentials/credentials.json 中,或者放在 CI secrets 里。它们只在构建期间发送到 Capgo,构建结束后即被删除。
凭据管理不需要。插件、权限、图标和 Capacitor 版本变更才需要新的原生构建。JavaScript、HTML、CSS 和资源变更可以通过 Live Updates 推送给已经装了商店版本的用户。
Live update 还是 Native Build?在 14 天免费试用期间完成首次已签名的 iOS build,需要时再添加 Android、CI 和 Live Updates。 享受 14 天退款保证,完成首次已签名的 iOS build,需要时再添加 Android、CI 和 Live Updates。
在 Capgo 云端 Mac 上构建并签名您的 Capacitor iOS 应用。
来自 Martin 的人工支持
14 天无限免费试用。无需信用卡 14 天退款保证。随时取消。
有企业级需求? 联系我们的团队