跳转至正文
从 Cordova 迁移至 Capacitor

无需重写代码，即可将 Cordova 应用迁移至 Capacitor

保留您的 Web code 并替换原生壳层。使用免费的 Capgo 插件来替代原有的 Cordova 插件，配合 Capgo Native Build 和 Live Update 进行发布。如果您需要专业团队代劳，我们也可以为您提供迁移服务。

Capgo 插件在 MPL-2.0 下免费且开源

为什么团队选择迁移

Web code 没问题，问题在于 Cordova 层拖慢了速度。

大多数 Cordova 应用可以保留其 UI 和逻辑。核心工作在于插件、原生配置以及发布流程。

插件停止更新

许多 Cordova 插件已不再维护。当新的 iOS 或 Android SDK 导致插件失效时，你的团队不得不 fork 它并自行修复补丁。

原生项目被重新生成

Cordova 会根据 config.xml 和 hooks 重新构建 platforms/，导致手动进行的原生修改极易丢失。Capacitor 会在你的仓库中保留真实的 ios/ 和 android/ 项目，你可以直接在 Xcode 和 Android Studio 中打开它们。

新设备特性需要新插件

Passkeys、生物识别、应用内购买和后台定位都需要持续维护的原生插件。在 Capacitor 上，你可以从官方插件和 Capgo 插件中进行选择。

每次修复都要等待应用商店审核

如果没有 Live Update，哪怕只是改一行 JavaScript 代码也需要重新打包二进制文件。应用商店审核通常需要 24-48 小时，有时甚至更久，而且用户仍需手动更新。

Capgo 为 Cordova 团队带来的价值

为新技术栈提供插件、build 和 Live Update

按需使用。插件免费，平台提供 14 天试用，我们的团队还可以协助完成迁移。

免费的替代插件

Capgo 维护着用于生物识别、社交登录、SQLite、应用内购买、应用内浏览器、后台定位等功能的 Capacitor 插件。这些插件均基于 MPL-2.0 开源协议。

浏览 Capgo 插件

优先修复插件问题

在任何 Capgo 方案中，您的插件 Bug 报告和功能请求都会由插件维护团队优先处理。

查看方案

在 Cordova 阶段即可实现 Live Update

@capgo/cordova-updater 为 Cordova iOS 7+ 和 Android 13+ 带来了 Capgo 功能。迁移后，您可以保留原有的 Capgo App ID 和 channels，只需切换到 Capacitor 插件即可。

Cordova 更新器指南

iOS 和 Android 的云端 Build

Capgo Build 会在云端编译并签名您的全新 Capacitor 项目，并可直接发送至应用商店。典型的 Native Build 仅需 2-3 分钟。

Capgo Build 指南

Native 兼容性检查

当你上传 bundle 时，Capgo 会将项目中的 native plugins 与该 channel 上运行的 bundle 进行对比，并在需要重新进行 store build 时及时通知你。

Live update 兼容性

自动回滚

在应用启动时调用 notifyAppReady()。如果新 bundle 在 10 秒内未调用该方法，设备将自动回滚至上一个可用版本。

notifyAppReady 工作原理

由我们团队执行的迁移服务

我们将 Cordova 到 Capacitor 的迁移作为固定价格项目开展。在免费的咨询电话后，你会收到一份包含项目范围和时间表的方案。

迁移咨询

上线后的高级支持

针对 native crashes、build failures、store rejections 以及 plugin conflicts，你可以直接联系 Capacitor 工程师。

高级支持

保留你的 Web App，仅更换 Native Shell。

迁移会改变原生层和发布流程，但对用户而言，您的产品体验保持不变。

保持不变的内容
  • 您的 UI、路由和 Web 框架
  • 您的 JS/TS code 和状态管理
  • 您的后端、API 和分析工具
  • 您的 App ID 和应用商店详情页
需要变更的内容
  • 提交至代码库的 ios/ 和 android/ 项目
  • 将 config.xml 设置迁移至 capacitor.config 和原生文件
  • 替换 Cordova 插件，或在兼容时予以保留
  • Build、签名及发布流程的配置
上线后修复 Web 端 Bug

接入 Capacitor 后，即可通过 Live Update 发布 JavaScript、HTML 和 CSS 修复。Native 变更仍需通过应用商店发布。

Capacitor updater 设置
分阶段发布更新

先将 live update 推送到测试频道，再逐步覆盖一定比例的生产设备。你可以扩大发布范围，或从 CLI 中回滚。

渐进式发布

工作原理

Cordova 团队如何通过 Capgo 迁移至 Capacitor

无论你是手动操作、交给 AI agent，还是由我们的团队来执行，流程都遵循相同的四个步骤。

  1. 列出你的插件和 Native 配置

    导出你的插件列表和 platforms。请留意 config.xml 中的偏好设置、插件变量、hooks 以及 platforms/ 目录下的任何手动修改。这些是迁移的基础输入。

    cordova plugin list
cordova platform ls
    逐步迁移指南

  2. 在 Web build 旁添加 Capacitor

    安装 Capacitor，将 webDir 设置为你的 build 输出目录，并添加 iOS 和 Android 项目。构建好的 Web App 会被同时复制到这两个项目中。

    bun add @capacitor/core @capacitor/cli
bun add @capacitor/ios @capacitor/android
bunx cap init
bunx cap add ios
bunx cap add android

  3. 替换 Cordova 插件

    将每个插件映射到官方 Capacitor 插件或 Capgo 插件。Capacitor 可以运行许多 Cordova 插件，但对于登录、支付和存储，使用有维护的替代方案更安全。

    bun add @capgo/capacitor-native-biometric
bun add @capgo/capacitor-social-login
bunx cap sync
    浏览 Capgo 插件

  4. 构建、发布并进行实时更新

    使用 Capgo 进行构建和签名，并使用相同的 App ID 发布应用商店更新，从而覆盖原有的 Cordova 版本。之后，即可通过 Live Update 发布 Web 层修复。

    npx @capgo/cli@latest build init
npx @capgo/cli@latest build request --platform ios
# after the store release, for web-layer fixes
npx @capgo/cli@latest bundle upload --channel production
    Capgo 构建指南

为您搞定

我们的团队将交付的内容

  • 您仓库中可在 Xcode 和 Android Studio 中构建的 Capacitor iOS 和 Android 项目
  • 插件映射表：说明每个 Cordova 插件是替换、保留还是重构，并附带原因
  • 将 config.xml 设置、权限和 Deep Links 迁移至原生项目
  • 经过测试的迁移分支和发布清单，包括从当前应用商店版本的升级方案
  • 在您自己的 CI 中或使用 Capgo Build 完成构建与发布配置
  • 交付时，Code、插件和文档的所有权将移交给贵公司

免费初步沟通后，我们会给出包含范围和时间线的固定报价方案。如果您需要还不存在的插件，我们也可以帮您开发。

迁移咨询

想自己动手？

跟着免费的 Capgo 插件分步指南操作，或者让 AI coding agent 借助 Capgo skills 和插件映射表来执行这些步骤。

阅读迁移指南 使用 AI 迁移指南

按团队类型的解决方案

找到符合团队需求的解决方案

AI 迁移指南（2026）

面向 AI coding agent 的 Prompts、Capgo skills 和插件映射表。

企业版

支持多应用、多团队部署

初创公司

快速交付，告别繁琐流程

生产环境更新

即时向生产环境推送修复

使用 Capacitor 构建的应用

Capacitor 支持大规模公开应用

这些应用基于 Capacitor 构建：在原生 iOS 和 Android 外壳中运行 Web code，这与您的 Cordova 应用迁移后的模式完全一致。

Resultados 应用图标 工具

Resultados

来自巴西高等选举法院的选举结果应用。

Google Play 安装量
15.0M
应用商店评分
2.8
Windy.com - 天气预报应用图标 天气

Windy.com - 天气预报

带地图、雷达图层和预警的天气预报应用。

Google Play 安装量
32.9M
应用商店评分
4.7
BURGER KING® 应用图标 应用

汉堡王®

包含优惠信息和餐厅查询功能的德国汉堡王 App。

Google Play 安装量
1430万
应用商店评分
3.9

客户证言

使用 Capgo 交付的团队怎么说

5.0/5 开发者团队评分 9,400+ 团队 查看评价
Mikołaj Wilczek 的肖像

Mikołaj Wilczek

Tellent 移动平台首席工程师

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

Sergiu S 的肖像

Sergiu S

drivolino GmbH 首席开发者

“Capgo Capacitor Updater 插件彻底改变了我们的更新发布方式。过去需要几天的工作，现在只需几分钟。”

Michael Haberler 肖像

Michael Haberler

nethead emeritors

“更新插件做得太棒了。对我来说运行得非常完美，Live Update 极大地缩短了快速测试的周期。”

常见问题

关于从 Cordova 迁移到 Capacitor 的常见问题

团队在开始迁移前通常会关心的问题。

我们需要重写 App 吗？

不需要。您的 UI 和业务逻辑可以保留。工作量主要集中在原生项目、插件、配置和构建设置上。大部分 code 的改动都发生在调用插件 API 的地方。

逐步迁移指南

我们可以保留 Cordova 插件吗？

Capacitor 可以运行许多 Cordova 插件，因此您可以在迁移期间保留部分插件。对于登录、支付、存储和其他关键路径，建议使用维护良好的 Capacitor 插件。Capgo 插件在 MPL-2.0 协议下是免费的。

浏览 Capgo 插件

在迁移之前可以使用 Capgo Live Update 吗？

可以。@capgo/cordova-updater 支持 Cordova iOS 7+ 和 Android 13+，并使用相同的 CLI 和 channels。当您迁移到 Capacitor 时，请保留 Capgo App ID 和 channels，并切换到 @capgo/capacitor-updater.。

Cordova 更新指南

迁移需要多长时间？

这取决于您使用的插件数量以及有多少自定义原生 code。如果由我们的团队来执行，在免费的咨询通话后，我们会为您提供包含工作范围和时间表的固定价格方案。

迁移咨询

迁移后，我们可以通过 live update 发布哪些内容？

JavaScript、HTML、CSS 和资源文件。添加或升级原生插件需要重新做一次应用商店 build。上传 bundle 时，Capgo 会对照 channel 上当前生效的 bundle 检查原生兼容性。

Live update 兼容性

规划您的 Cordova 迁移方案

在您的 App 上试用 Capgo Live Updates 和 Capgo Build，或预约通话，与我们的团队一起确定迁移范围。

14 天免费试用，无需信用卡。Capgo 插件在 MPL-2.0 协议下免费使用。