快速导航至主要内容

适用于 Windows 和 Linux 开发人员

在不拥有 Mac 的情况下构建 iOS 应用

Capgo Build 在云 Mac 机器上编译并签署您的 Capacitor iOS 应用。从 Windows、Linux 或 CI 运行一个 CLI 命令,签名的构建将上传到 App Store Connect 进行 TestFlight

2–3 分钟
典型原生构建
iOS + Android
从同一个 CLI
测试飞行
直接上传到 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 机器上运行。您可以从您已经使用的计算机启动它们。

已签名并上传

问题

问题

Xcode仅在macOS上运行

没有Mac,无法构建iOS

Apple的构建工具需要macOS。开发者无法在Windows或Linux上编译或签署iOS构建。

签名只在一台笔记本上

证书和配置文件通常存储在一个人mac上。当那个人不在或配置文件过期时,发布等待。

自主macOS CI是自己的项目

租用的macOS运行器仍需要Xcode更新、Fastlane通道、签名密钥和调试,当Apple改变时。

隐藏的工作

发布构建需要的东西除了Mac

购买Mac仅解决了硬件部分。您仍然需要Apple账户设置、签名文件和保持工作的构建工具。

1

Apple账户设置

Apple开发者账户具有管理员权限、一个bundle ID、App Store Connect应用程序记录和API密钥用于上传。

2

签名文件和配置文件

您需要一个 .p12 导出的分布式证书、每个 bundle ID 的配置文件以及到期时的续期。

3

构建工具

正确的 Xcode 版本、CocoaPods 或 Swift Package Manager、Fastlane,以及用于 CI 的密钥存储位置。

如何工作

Windows和Linux开发者如何在Capgo中发布iOS

您需要一个 Capacitor 应用程序、一个 Capgo 账户和一个 Apple Developer 账户。以下每个命令都来自 Capgo CLI 文档。

  1. 设置 iOS 签名一次

    The onboarding reads your Capacitor project, creates the distribution certificate and provisioning profile, and saves them on your machine.

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

    If your team already has a certificate and profile, save them with your App Store Connect API key. They stay in a local credentials file.

    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 构建同步到 iOS 项目,然后请求构建。日志流向您的终端,签名的构建上传到 App Store Connect 进行 TestFlight 测试。

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

    将您的保存的凭据导出为 CI 秘密,使用构建凭据管理器设置 CAPGO_TOKEN, 并在 GitHub Actions、GitLab CI 或任何运行器中运行构建请求。

    npx @capgo/cli@latest build credentials manage
    # in your CI job
    npx @capgo/cli@latest build request com.example.app --platform ios
    GitHub GitHub Actions

解决方案

What Capgo Build handles for you

原生构建在云端运行,仅当原生code发生变化时才会触发。网页变化则持续推送为实时更新,直到下一个商店发布。

解决方案

build init creates the distribution certificate and provisioning profile for you. It uses an App Store Connect API key, which you create in your browser when you are on Windows or Linux.

iOS 构建指南

CI 和本地使用相同的命令

只需保存一次凭据,然后从终端、GitHub Actions、GitLab CI 或任何其他管道中运行构建请求

构建命令参考

原生构建加上实时更新

使用 Capgo 构建时,插件、权限、图标或 Capacitor 版本发生变化时。将 JavaScript、CSS 和资产更改作为实时更新发送给用户后,他们安装了商店构建

Live update 或原生构建?

信任模型

不需要将您的 code 和密钥交给云硬件

凭据只在您的机器或 CI 秘密中存储。Capgo 只在构建运行时保留它们

仅上传原生项目

CLI 上传原生平台文件夹和原生依赖项。您的完整仓库仍然在您的机器上

实时日志流向您的终端

构建日志实时流向您的终端并不会在Capgo服务器上存储。

凭证仅在构建期间存在

证书和配置文件在构建期间使用内存并在完成后删除。每个构建在一个隔离环境中运行,并在完成后销毁。

使用Capacitor构建的应用

运营应用不应等待一台本地Mac

学校、交通和支持应用仍需要签名的移动发布版本,尤其是团队主要是web、支持或运维。托管构建工作流程移除了单机瓶颈,同时保持签名步骤可重复。

IRIS ParentMail应用图标 教育

IRIS ParentMail

学校通信应用,非母语团队仍需要可靠的签名发布。

Google Play安装
1.2万
店铺评分
2.8
KAI Access: Train Booking App 应用图标 交通和地理

KAI Access: 火车票预订应用

不依赖于一台开发机器的交通预订应用。

Google Play 安装
13.5万
店铺评分
3.6
技术支持 – 技术支持应用图标 工具

技术支持 – 技术支持

支持操作团队需要可重复的移动构建记录的工具。

Google Play 安装
10.3万
应用评分
4.3

客户证明

使用 Capgo 的团队说什么

5.0/5 开发者团队评级 9,400+ 团队 查看评论

sikafanka

设计,半径 5

“Capgo 构建帮助我们简化了 Capacitor 应用程序发布流程。我们可以从一个清晰的工作流程中构建和部署 iOS 和 Android 应用程序。”

米科拉伊·维尔切克的肖像

米科拉伊·维尔切克

Tellent 移动平台工程师

“我们最初通过插件发现了 Capgo,并且这成为进入我们团队更高效发布流程的很好的入口点。”

常见问题

关于不使用 Mac 构建 iOS 的问题

Windows 和 Linux 开发者在第一次云 iOS 构建之前会问什么?

是否需要 Mac?

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

iOS 构建指南

iOS 构建需要多长时间?

典型的本地构建需要 2-3 分钟。日志会流式传输到您的终端,直到它运行完成,您就可以看到错误。

第一次构建指南

是否可以直接将构建上传到 TestFlight?

是的。使用 App Store Connect API 密钥,您可以将签名的构建上传到 App Store Connect,测试它并提交它进行 App Store 审核。添加 --output-upload 如果您还想下载 IPA 的链接。

构建配置

我的证书在哪里?

在您的机器上,~/.capgo-credentials/credentials.json(默认)或在您的 CI 秘密中。它们只在构建期间发送到 Capgo,然后删除。

管理凭证

我需要为每次更改编译一个新的构建吗?

不。插件、权限、图标和Capacitor版本的更改需要一个新的本机构建。JavaScript、HTML、CSS和资产的更改可以作为实时更新向已经有商店构建的用户发送。

Live update或本机构建?

不用买Mac就可以发布iOS

在14天的免费试用期内,运行您的第一个签名的iOS构建,然后在需要时添加Android、CI和实时更新。