跳转至正文

面向 Windows 和 Linux 开发者

无需 Mac 即可构建 iOS 应用

Capgo 会在云端 Mac 机器上编译并签名您的 Capacitor iOS 应用。在 Windows、Linux 或 CI 中运行一条 CLI 命令,签名后的构建就会上传到 App Store Connect,供 TestFlight 使用。

2–3 分钟
典型 Native Build 耗时
iOS + Android
来自同一个 CLI
TestFlight
直接上传到 App Store Connect
Capgo 构建
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。

问题

Xcode 只能在 macOS 上运行

没有 Mac,就无法构建 iOS

Apple 的构建工具需要 macOS。使用 Windows 或 Linux 的开发者无法在自己的机器上编译或签名 iOS 构建。

签名只在一台笔记本上

证书和配置文件常常只放在某个人的 Mac 上。这个人不在或配置文件过期时,发布就得等。

自建 macOS CI 本身就是个工程

租来的 macOS runner 仍然需要更新 Xcode、维护 Fastlane lane、管理签名密钥,并在 Apple 有改动时调试。

隐藏的工作

除了 Mac,发布构建还需要什么

购买 Mac 只解决了硬件部分。你仍需配置 Apple 账号、准备签名文件,并维护需要有人持续打理的构建工具链。

1

Apple 账号配置

拥有管理员权限的 Apple Developer 账号、Bundle ID、App Store Connect 应用记录,以及用于上传的 API 密钥。

2

签名文件与描述文件

导出为 .p12 的发布证书、每个 Bundle ID 对应的 Provisioning Profile,以及过期后的续期。

3

构建工具链

合适的 Xcode 版本、CocoaPods 或 Swift Package Manager、Fastlane,以及存放 CI 密钥的地方。

工作原理

Windows 和 Linux 开发者如何通过 Capgo 发布 iOS 应用

你需要一个 Capacitor App、一个 Capgo 账号以及一个 Apple Developer 账号。下面的每条命令都来自 Capgo CLI 文档。

  1. 一次性完成 iOS 签名设置

    Onboarding 会读取你的 Capacitor 项目,创建发布证书和 Provisioning Profile,并保存到你的机器上。

    npx @capgo/cli@latest build init --platform ios
    iOS Build 指南
  2. 或保存已有的签名文件

    如果你的团队已有证书和描述文件,可以用 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
    凭据管理
  3. 发起构建请求

    将 Web build 同步到 iOS 项目,然后发起构建请求。日志会流式输出到你的终端,签名后的 build 会上传到 App Store Connect 用于 TestFlight。

    npx cap sync ios
    npx @capgo/cli@latest build request com.example.app --platform ios
    首次构建指南
  4. 在 CI 中运行同一条命令

    使用 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 设置

解决方案

Capgo Build 为您处理的一切

当 native code 发生变化时,Native Build 会在云端运行;Web 变更则在两次商店发布之间继续以 Live Updates 交付。

仅在 Build 时使用云端 Mac

iOS 构建在预装 Xcode 的专用 Mac mini M4 机器上运行。你的 Windows 或 Linux 笔记本,或 CI runner,只需从终端发起请求。

Capgo Build 概览

引导式 iOS 签名

build init 会为您创建分发证书和描述文件。它使用 App Store Connect API 密钥,您可以在 Windows 或 Linux 上的浏览器中创建该密钥。

iOS Build 指南

本地与 CI 使用相同命令

只需保存一次凭据,即可从终端、GitHub Actions、GitLab CI 或任何其他 pipeline 中运行 build request。

build 命令参考

原生构建加 Live Update

当插件、权限、图标或 Capacitor 版本发生变化时,使用 Capgo Build。在用户安装商店构建后,将 JavaScript、CSS 和资源更改作为 Live Update 发布。

Live update 还是 Native Build?

信任模型

使用云硬件,无需交出您的 code 和密钥

凭据只保留在你的机器上或 CI secrets 中。Capgo 只在构建运行期间持有它们。

仅上传原生项目

CLI 会上传原生平台文件夹和原生依赖。你的完整仓库仍留在你的机器上。

日志流式输出到终端

构建日志会在构建运行期间实时流式输出,不会存储在 Capgo 服务器上。

凭据只在构建期间存在

证书和描述文件只在构建期间于内存中使用,构建完成后即被删除。每次构建都在隔离环境中运行,结束后该环境会被销毁。

使用 Capacitor 构建的应用

业务应用不应受限于单台本地 Mac

当团队主要由 Web、支持或运维人员组成时,学校、交通和支持类应用仍需要签名的移动端版本。托管构建工作流消除了单机瓶颈,同时让签名步骤保持可重复。

IRIS ParentMail 应用图标 教育

IRIS ParentMail

学校通讯应用,非原生团队仍需要可靠的签名发布版本。

Google Play 安装量
120万
应用商店评分
2.8
KAI Access:火车票预订应用图标 旅游与本地

KAI Access:火车票预订 App

交通预订应用,发布交接不应依赖某台开发机。

Google Play 安装量
1350万
应用商店评分
3.6
Técnico Virtual – 技术支持 App 图标 工具

虚拟技术员 – 技术支持

为需要可重复移动端构建记录的运维团队提供的支持工具。

Google Play 安装量
10.3M
应用商店评分
4.3

客户证言

使用 Capgo 交付的团队怎么说

5.0/5 开发者团队评分 9,400+ 团队 查看评价

sikafanka

设计,圆角半径 5

“Capgo Build 帮我们简化了 Capacitor 应用的发布流程。通过一套清晰的工作流,我们就能构建并发布 iOS 和 Android 应用。”

Mikołaj Wilczek 的肖像

Mikołaj Wilczek

Tellent 移动平台首席工程师

“我们最初是通过插件发现 Capgo 的,事实证明,这为我们的团队开启了一个更高效的发布流程。”

常见问题

关于无需 Mac 构建 iOS 的疑问

Windows 和 Linux 开发者在首次云端 iOS 构建前常问的问题。

我在任何阶段都需要 Mac 吗?

编译、签名或上传都不需要。构建在 Capgo 的 Mac mini M4 机器上运行。你仍然需要 Apple Developer 账号。在 Windows 或 Linux 上,你在浏览器里创建 App Store Connect API 密钥,然后由 CLI 处理证书和描述文件。

iOS Build 指南

iOS 构建需要多长时间?

典型的原生构建需要 2–3 分钟。运行期间日志会实时输出到终端,出错时你能立刻看到。

首次构建指南

构建可以直接进 TestFlight 吗?

可以。凭据里配置好 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?

不用买 Mac 也能发布 iOS

在 14 天免费试用期间完成首次已签名的 iOS build,需要时再添加 Android、CI 和 Live Updates。 享受 14 天退款保证,完成首次已签名的 iOS build,需要时再添加 Android、CI 和 Live Updates。