跳转至正文

面向 v0 构建者:无需 Mac,无需 Xcode

把你的 v0 应用变成 iOS 和 Android 应用

导出 v0 项目,用 Capacitor 封装,再用 Capgo Build 构建已签名的 App Store 和 Google Play 应用。无需 Mac。上线后,你在 v0 里做的改动会以实时更新同步到已安装的应用。

无需 Mac
即可进行 iOS 构建
2–3 分钟
典型 Native Build 耗时
Live Updates
针对在 v0 中进行的更改

v0 项目

使用 v0 生成 Next.js 应用。将其推送到 GitHub,以便 code 存储在代码仓库中。

导出并封装

Capacitor 外壳

使用 Capacitor 构建静态 out 文件夹并添加 iOS 和 Android 项目。

构建和更新

Capgo 发布循环

使用 Capgo Build 构建已签名的二进制文件,然后通过 GitHub Actions 将 Web 变更作为 Live Updates 发布。

问题

v0 构建应用,但应用商店还需要更多。

应用止步于浏览器

v0 项目本质是 Web App。应用商店上架、推送通知和设备功能都需要一个原生壳。

v0 无法运行原生工具链

签名、Xcode、Android Studio 和应用商店上传都在 v0 之外完成。你需要 code 和构建服务。

每次变更都要等审核

首次上架应用商店后,每个新版本都要重新走商店审核,通常 24–48 小时,有时更久。

技术栈

各工具的作用

v0 构建 Web 应用

通过 prompt 迭代页面、流程、文案和后端逻辑。生产构建会生成一个静态 out 文件夹,供你封装。

Capacitor 负责封装

Capacitor 使用你的 App ID、图标和权限,将构建好的 Web 应用放入原生 iOS 和 Android 项目中。code 保持不变。

Capgo 负责构建和更新

Capgo Build 会创建已签名的二进制文件并上传到应用商店。Live Updates 则把后续的 Web 变更推送到已安装的应用。

解决方案

从 v0 到应用商店的 Capgo 路径

v0 继续构建产品。Capacitor 和 Capgo 则补上 Native Build、商店上传和更新步骤。

推送到 GitHub 并添加静态导出

通过 v0 的 Git 面板把 v0 项目推送到 GitHub(或下载 code)然后 clone 它。v0 应用是 Next.js,所以在 next.config 中设置 output: 'export',并 build 到 out 文件夹。

使用 Capgo Build 构建

向 CLI 申请已签名的 iOS 和 Android build。iOS build 在云端 Mac 上运行,一次典型 build 需要 2–3 分钟。

将每次更改作为 live update 发布

连接 GitHub 仓库后,你在 v0 中做的更改会 push commit 到仓库。GitHub Action 会构建应用并上传 bundle,因此已安装的应用无需在应用商店重新发版就能拿到 Web 更新。

让你的 AI agent 负责发布

Capgo MCP server 让 Claude Code、Codex 或 Cursor 能够 upload bundle、管理 channel 并请求 build。Capgo skills 为 agent 添加 Capgo 专用指令。

工作原理

v0 构建者如何使用 Capgo 发布移动应用

从 v0 项目到应用商店构建和 Live Updates。你可以自己运行这些命令,也可以让 coding agent 来运行。

  1. 推送到 GitHub 并添加静态导出

    通过 v0 的 Git 面板把 v0 项目推送到 GitHub(或下载 code)然后 clone 它。v0 应用是 Next.js,所以在 next.config 中设置 output: 'export',并 build 到 out 文件夹。

    git clone https://github.com/you/your-v0-app.git
    cd your-v0-app
    npm install
    # next.config: output: 'export', images: { unoptimized: true }
    npm run build
    Web 应用转 Capacitor 指南
  2. 添加 Capacitor 和 Capgo

    添加原生项目,然后运行 Capgo onboarding。它会添加你的应用、创建 production channel,并安装 updater 插件。

    npm install @capacitor/core @capacitor/cli @capacitor/ios @capacitor/android
    npx cap init "Your App" com.company.app --web-dir out
    npx cap add ios && npx cap add android
    npx @capgo/cli@latest init
    CLI onboarding 指南
  3. 在云端构建已签名的 App

    签名只需配置一次,之后即可发起 iOS 和 Android 构建。签名后的构建会上传到 App Store Connect 和 Google Play 进行审核。

    npx @capgo/cli@latest build init
    npx @capgo/cli@latest build request --platform ios
    npx @capgo/cli@latest build request --platform android
    Capgo 构建文档
  4. 将每次更改作为 live update 发布

    将 CAPGO_TOKEN 添加为 GitHub secret,并添加一个在 push 时构建并上传的 workflow。新增插件或权限仍需要重新打一次商店包。

    # step in .github/workflows, with CAPGO_TOKEN from secrets
    npm ci && npm run build
    npx @capgo/cli@latest bundle upload --channel=production --auto-bump
    GitHub Actions 集成

AI Agent Prompt

让你的 coding agent 搞定配置

拿到 v0 code 后,把它粘贴到 Claude Code、Codex 或 Cursor 等编程 Agent 中。它会安装 Capgo MCP server,添加 Capacitor 和 updater,并留下签名相关的 TODO,而不是凭空编造密钥。

给你的 coding agent 的 prompt

I want this project, exported from v0, to become a Capacitor mobile app using Capgo from the start.

Set up the project so an AI agent can use Capgo's MCP release tools through install-mcp:

1. Install the Capgo CLI MCP server for the active AI client. For Codex, run:
   - npx @capgo/cli@latest login
   - npx install-mcp 'npx @capgo/cli@latest mcp' --client codex
   Replace codex with cursor, claude-code, gemini-cli, or windsurf if that is the client this project uses.
2. Read Capgo's MCP metadata when tool details are needed (the hosted server is https://api.capgo.app/mcp):
   - https://capgo.app/.well-known/mcp/server-card.json
   - https://capgo.app/.well-known/agent-skills/capgo-cli-mcp/SKILL.md
   If this client supports agent skills, also run: npx skills add Cap-go/capgo-skills
3. Add a short docs/agent-mobile-release.md file that tells the agent to use the Capgo CLI MCP server as a local stdio server, not a remote HTTP endpoint.
4. Add Capacitor for iOS and Android using the package manager already used by this project.
5. Configure capacitor.config.ts with:
   - appName: the current v0 app name
   - appId: a production-style bundle ID I can edit later, such as com.company.app
   - webDir: the production build output folder (usually out)
   - plugins.CapacitorUpdater.defaultChannel: production
6. Install and configure @capgo/capacitor-updater.
7. Add package scripts for:
   - building the web app
   - syncing Capacitor
   - uploading a production Capgo bundle
   - starting Capgo Build setup for iOS
   - requesting an iOS cloud build
8. Create a first production channel plan:
   - production for users
   - preview for stakeholder review
   - staging for internal testing
9. Keep normal docs and README commands copy-pasteable with npm/npx unless this project already uses another package manager. Keep the Capgo MCP install command exactly as shown above.
10. Do not fake native signing credentials. Leave clear TODOs for the Capgo API key, Apple team details, and bundle ID.
11. After making changes, summarize exactly what changed and what command I should run next.

使用 Capacitor 构建的应用

模板与学习类产品是移动端的天然选择

创作类和学习类 App 说明,只要打包、签名和更新处理得当,Web 风格的流程也能变成可直接上架的移动端体验。

Invitation Maker Card Design 应用图标 活动

邀请函制作卡片设计

模板驱动的设计流程,能自然地从响应式网页映射到移动端。

Google Play 安装量
20.0M
应用商店评分
4.6
Infinite Japanese 应用图标 教育类

无限的日语

专注学习的应用,课程和 onboarding 的小改进会持续累积。

Google Play 安装量
180万
应用商店评分
4.6
StudySmarter - 学校与大学应用图标 教育

StudySmarter - 学校与大学

学习工作流:应用打包后仍可继续迭代 Web 产品。

Google Play 安装量
650万
应用商店评分
4.8

客户证言

使用 Capgo 交付的团队怎么说

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

sikafanka

设计,圆角半径 5

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

Kapil

NuTriQ 创始人

“无需等待完整的 App Store 审核周期,就能即时推送生产环境的 OTA 更新,这为我们带来了巨大的运营优势。”

Luis Dominguez 的肖像

Luis Dominguez

谁付钱,谁说了算

“自从开始使用 Capgo,一切都更快了,我也能在不耽误日常生活的情况下,把用户应得的时间留给他们。”

常见问题

v0 构建者常问的问题

关于将 v0 应用发布到 App Store 和 Google Play 的简短解答。

v0 能直接发布到 App Store 吗?

不能。v0 构建的是 Web 应用。你需要导出 code,用 Capacitor 进行封装,并通过 Capgo Build 构建签名的 iOS 和 Android 应用,然后将其上传至 App Store Connect 和 Google Play。

Web 应用转 Capacitor 指南

我需要 Mac 或 Xcode 吗?

不需要。Capgo Build 在云端 Mac 机器上执行 iOS 构建。你仍然需要 Apple Developer 账号才能上架 App Store,以及 Google Play 开发者账号才能发布 Android 应用。

Capgo 构建文档

我的 v0 应用使用了 Server Actions 或 API 路由。它能正常工作吗?

移动应用仅包含静态导出内容。请将服务器 code 部署在 Vercel 上,并在应用中通过完整的 https URL 调用它。页面和客户端组件可以按原样工作。

使用 Capacitor 的 Next.js

shadcn/ui 组件在移动端能正常工作吗?

可以。它们是带有 Tailwind 样式的 React 组件,因此在原生 WebView 中的渲染效果与在浏览器中一致。请在真机上检查触摸目标和安全区域。

我在 v0 中做的更改会同步到移动应用吗?

连接 GitHub 仓库后,您在 v0 中做的更改会推送 commit 到仓库。是的,Web 层更改可以同步。每次推送都会触发 GitHub Action 执行 bundle upload,已安装的应用会下载更新。新增插件或权限仍需新的商店构建。

GitHub Actions 集成

我的 AI agent 能处理发布步骤吗?

可以。npx @capgo/cli mcp 会启动一个本地 MCP server,Claude Code、Codex 或 Cursor 可以用它来上传 bundle、管理 channel 和发起 build。Capgo skills 会为 agent 添加 Capgo 专属指令。

Capgo MCP 服务器

将您的 v0 应用上架商店

开始 14 天免费试用,导出您的 v0 项目,并从 CLI 请求您的首个 iOS 和 Android 构建。 选择包含 14 天退款保证的计划,导出您的 v0 项目,并从 CLI 请求您的首个 iOS 和 Android 构建。