跳转至正文
从 Cordova 迁移到 Capacitor

无需重写,即可将 Cordova 应用迁移到 Capacitor

保留 Web code,替换原生壳层。用免费的 Capgo 插件替代原 Cordova 插件的功能,通过 Capgo Build 和 Live Updates 发布;如果希望我们代做迁移,也可以让我们的团队介入。

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 维护 Capacitor 插件,涵盖生物识别、社交登录、SQLite、应用内购买、应用内浏览器、后台定位等。这些插件都以 MPL-2.0 协议开源。

浏览 Capgo 插件

优先修复插件问题

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

查看方案

在 Cordova 上也能用 Live Updates

@capgo/cordova-updater 为 Cordova iOS 7+ 和 Android 13+ 带来 Capgo Live Updates。迁移后,沿用相同的 Capgo App ID 和 channels,并切换到 Capacitor 插件。

Cordova 更新器指南

iOS 和 Android 云端构建

Capgo Build 会在云端编译并签名你的新 Capacitor 项目,并可直接提交到应用商店。一次典型的原生构建只需 2–3 分钟。

Capgo Build 指南

原生兼容性检查

上传 bundle 时,Capgo 会对比项目中的原生插件与频道上正在运行的 bundle,并在某处改动需要新的商店构建时告知您。

Live update 兼容性

自动回滚

在应用启动时调用 notifyAppReady()。如果新 bundle 在 10 秒内没有调用它,设备就会回退到上一个正常工作的版本。

notifyAppReady 工作原理

由我们的团队执行迁移

我们以固定价格项目的形式执行 Cordova 到 Capacitor 的迁移。一次免费的初步沟通电话后,您会收到包含范围和时间线的提案。

迁移咨询

上线后的高级支持

直接联系 Capacitor 工程师,处理原生崩溃、构建失败、商店拒审和插件冲突。

高级支持

保留您的 Web 应用。替换原生外壳。

迁移会改变原生层和发布流程。对用户来说,产品保持不变。

保持不变的部分
  • 您的 UI、路由和 Web 框架
  • 您的 JS/TS code 和状态管理
  • 您的后端、API 和分析
  • 您的应用 ID 和商店上架信息
变化内容
  • 提交到仓库的 ios/ 和 android/ 项目
  • config.xml 中的设置迁移到 capacitor.config 和原生文件
  • 替换 Cordova 插件,或在兼容时保留
  • 构建、签名和发布配置
上线后修复 Web 端 Bug

迁移到 Capacitor 后,即可通过 Live Update 推送 JavaScript、HTML 和 CSS 修复。原生变更仍需通过应用商店发布。

Capacitor 更新器配置
分阶段推送更新

先将 live update 发送到测试通道,再推送给一定比例的生产设备。您可以从 CLI 扩大推送范围或回滚。

渐进式发布

工作原理

Cordova 团队如何借助 Capgo 迁移到 Capacitor

无论是自行操作、交给 AI 代理,还是由我们的团队执行,都适用相同的四个步骤。

  1. 列出插件和原生配置

    导出插件列表和平台。记录 config.xml 中的偏好设置、插件变量、hooks 以及 platforms/ 目录中的任何手动编辑。这是您的迁移输入。

    cordova plugin list
    cordova platform ls
    分步迁移指南
  2. 在 Web 构建旁添加 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 版本。之后,把 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 Build 指南

为您搞定

我们团队的交付内容

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

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

迁移咨询

想自己动手?

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

使用 Capacitor 构建的应用

Capacitor 支持大型公开应用

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

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

“这个 updater 插件做得太棒了。它在我这儿运行完美,live updates 对快速测试迭代是极大的加速。”

常见问题

Cordova 迁移到 Capacitor 的常见问题

团队在开始迁移前常问的问题。

我们需要重写 App 吗?

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

分步迁移指南

我们可以保留现有的 Cordova 插件吗?

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

浏览 Capgo 插件

在迁移前可以使用 Capgo Live Updates 吗?

可以。@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 协议下免费使用。