跳转至正文
Cursor 标志

在 Cursor 中用 Capgo 发布移动应用

Cursor 能构建、发布并实时更新你的 Capacitor 应用:无需 Mac 即可构建 iOS 和 Android 版本,几分钟内完成 OTA 修复,一键回滚。

  • IDE
  • 托管 MCP
  • 本地 MCP
  • 技能
  • CLI

在 Cursor 中配置 Capgo

最多三步。按原样复制每个代码块。

  1. 第 1 步

    添加托管的 Capgo MCP

    把这段内容加到 ~/.cursor/mcp.json 可对所有项目生效,或加到 .cursor/mcp.json 只对单个项目生效。Cursor 会在服务器旁显示“需要登录”:点击即可登录。无需 API 密钥。

    ~/.cursor/mcp.json
    {
      "mcpServers": {
        "capgo": {
          "url": "https://api.capgo.app/mcp"
        }
      }
    }
  2. 第 2 步

    添加用于构建和上传的本地 CLI MCP

    在终端里运行一次 npx @capgo/cli@latest login,然后在 capgo 旁边添加 capgo-cli 条目。

    ~/.cursor/mcp.json
    {
      "mcpServers": {
        "capgo": {
          "url": "https://api.capgo.app/mcp"
        },
        "capgo-cli": {
          "command": "npx",
          "args": [
            "@capgo/cli@latest",
            "mcp"
          ]
        }
      }
    }
  3. 第 3 步

    安装 Capgo skills

    Cursor 从 .agents/skills 和 .cursor/skills 读取 skills。

    终端
    $ npx skills add Cap-go/capgo-skills

你可以问 Cursor 什么

复制 prompt 并粘贴到 Cursor 中。把 app ID 和版本换成你自己的。

  • 构建

    “使用 Capgo Build 为此应用构建一个已签名的 iOS release 版本。”

  • 发布

    “请求一个 Android release 构建,并发送到 Google Play 内部测试轨道。”

  • 更新

    “检查这个改动是否需要 Native Build,还是可以直接作为 live update 发布。”

  • 更新

    “构建 Web 应用,并将这个修复推送到 production 渠道。”

  • 回滚

    “回滚 production channel 上的最后一个 bundle。”

  • Observe

    “显示 v2.3.0 的更新统计数据:有多少设备已安装,有多少安装失败。”

  • Observe

    “为什么我上次的 iOS build 失败了?看看 build logs,给个修复建议。”

  • 构建

    “在构建前,先在这个项目上运行 Capgo doctor,并修复它报告的问题。”

完整的发布闭环

一个账号就能覆盖从首次 build 到下一次线上修复的每一步。

  1. 1

    构建

    在云端完成 iOS 和 Android 的签名 build。你这边无需 Mac,也无需 Xcode。

    Capgo Build(原生应用)
  2. 2

    发布

    将 build 发送到 TestFlight 和 Google Play,或提交给应用商店审核。

    无需 Mac 即可构建并发布 iOS 应用
  3. 3

    更新

    几分钟内即可将 JavaScript、HTML 和 CSS 修复推送到频道,一步回滚。

    Capgo 实时更新
  4. 4

    Observe

    查看谁接收了更新、哪些环节失败,以及每次发布的表现。

    使用 Capgo Observe

Cursor 说明与限制

  • Cursor agent 可以运行终端命令,因此也能直接调用 Capgo CLI。
  • Cursor Cloud Agents 无法获得只存在于你本机的技能。把 .agents/skills 提交到仓库即可共享。
  • 在 Cursor 设置中关掉不需要的工具,让工具列表保持精简。

常见问题

Capgo 与 Cursor:常见问题

Cursor 可以在没有 Mac 的情况下构建我的 iOS 应用吗?

可以。Cursor 运行 Capgo CLI,把项目上传到 Capgo Build。Capgo 在云端签名并构建 iOS 和 Android 应用,还能发送到 TestFlight 和 Google Play。

Native Build 文档

使用 Cursor 需要 Capgo API 密钥吗?

托管版 MCP 不需要 API 密钥:它通过 OAuth 登录。本地 CLI MCP 和 CLI 使用一个只需用 npx @capgo/cli@latest login 保存一次的 API 密钥。请在 Capgo 控制台的 Settings > Organization > API keys 下创建该密钥。

创建 Capgo API 密钥

Cursor 能回滚有问题的更新吗?

可以。让 Cursor 把 channel 指回上一个 bundle。设备会在下次检查更新时切换。Capgo updater 还会在新 bundle 启动失败时自动回滚。

Live update 文档

App Store 和 Google Play 允许使用 Live Updates 吗?

可以,但仅限 Web 层:JavaScript、HTML、CSS 和静态资源。Native code、新权限和新插件仍需通过应用商店发布,Capgo Build 可以帮你完成。

在 Cursor 中使用 Capgo 需要多少费用?

MCP servers、skills 和 CLI 均可免费使用。你需要 Capgo 方案,每个方案都提供 14 天免费试用,无需信用卡。Build、Live Updates 和 Observe 都包含在每个方案中。

定价

在 Cursor 中发布你的下一个版本

立即创建 Capgo 账号,连接 Cursor,并推送你的第一个 build 或 live update。

文档

相关页面