跳过主要内容
Cordova to Capacitor migration

Move your Cordova app to Capacitor without rewriting it

保持您的 web 应用,code,并用原生壳替换。使用免费的Capgo插件来实现 Cordova 插件的功能,使用Capgo构建和实时更新,并让我们的团队为您完成迁移。

人工支持来自Martin

Capgo 插件免费开源,遵循 MPL-2.0 协议。

团队为什么会转向

The web code is fine. The Cordova layer slows you down.

大多数 Cordova 应用程序保留其 UI 和逻辑。工作在插件、native 配置和发布过程中。

插件停止接收更新

许多 Cordova 插件不再维护。当一个新的 iOS 或 Android SDK 破坏一个时,您的团队会将其分叉并携带补丁。

native 项目生成

Cordova 重建了从 config.xml 和 hooks 中的平台/,因此手动 native 编辑很容易丢失。 Capacitor 保留了您在 Xcode 和 Android Studio 中打开的真实 ios/ 和 android/ 项目。

新设备功能需要新插件

Passkeys、生物识别、内购和后台位置都需要一个维护的native 插件。在 Capacitor 上,您可以从官方插件和 Capgo 插件中选择。

每个修复都需要等待商店审查

没有实时更新,一行 JavaScript 修复需要一个新的二进制文件。商店审查通常需要 24-48 小时,有时更长时间,用户仍然需要更新。

Capgo 给 Cordova 团队提供了什么

新栈的插件、构建和实时更新

只使用您需要的插件。插件是免费的,平台有 14 天的试用期,我们的团队可以运行迁移。

免费替代插件

Capgo维护了Capacitor插件,包括生物识别、社交登录、SQLite、内购、内浏览器、后台定位等。它们是开源的,遵循MPL-2.0许可。

浏览Capgo插件

优先修复插件

在任何Capgo计划中,您的插件bug报告和功能请求将由维护插件的团队处理。

查看计划

实时更新,仍在Cordova中

@capgo/cordova-updater将Capgo实时更新带到Cordova iOS 7+和Android 13+。在迁移后,保持相同的Capgo应用ID和频道,并切换到Capacitor插件。

Cordova更新指南

云构建iOS和Android

Capgo Build在云端编译和签署您的新Capacitor项目,并可以将它们发送到商店。一个典型的本机构建需要2-3分钟。

Capgo Build指南

原生兼容性检查

Capgo在您上传的捆绑包中与您的项目中的原生插件进行比较,并在您的应用程序启动时调用notifyAppReady()。如果在10秒内没有调用它,设备将切换回最后一次工作的版本。

Live update兼容性

自动回滚

当您的应用程序启动时,请调用notifyAppReady()。如果在10秒内没有调用它,设备将切换回最后一次工作的版本。

notifyAppReady的工作原理

我们的团队进行的迁移

我们以固定价格的项目方式运行Cordova到Capacitor的迁移。您将获得一个包含范围和时间表的提案,之后是免费的发现电话。

迁移咨询

在发布后获得高级支持

直接访问Capacitor工程师以解决原生崩溃、构建失败、商店拒绝和插件冲突等问题。

高级支持

保留您的网页应用。替换原生壳。

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

什么保持不变
  • 您的 UI、路由和 Web 框架
  • 您的 JS/TS code 和状态管理
  • 您的后端、API 和分析
  • 您的应用 ID 和商店列表
什么改变
  • ios/ 和 android/ 项目已提交到您的仓库
  • config.xml 设置已移动到 capacitor.config 和原生文件
  • Cordova 插件已替换,或者在兼容的情况下保留
  • 构建、签名和发布设置
解决发布后 Web 错误

一旦你在 Capacitor 上线, 就可以将 JavaScript、HTML 和 CSS 修复作为实时更新发布。 原生更改仍然需要通过商店进行

Capacitor 更新器设置
逐步发布更新

在测试频道中首先发送一个 live update, 然后在生产设备的百分比中发送。 扩大发布范围或从 CLI 回滚

渐进式发布

如何工作

How Cordova teams move to Capacitor with Capgo

无论您是否亲自处理,还是将其交给 AI agent 还是让我们的团队处理,四个步骤都相同

  1. 列出您的插件和原生配置

    导出您的插件列表和平台。 注意 config.xml 首选项、插件变量、钩子和在 platforms/ 中进行的手动编辑。 这是您的迁移输入

    cordova plugin list
    cordova platform ls
    逐步迁移指南
  2. 在您的 web 构建旁边添加 Capacitor

    安装 Capacitor,设置 webDir 为您的构建输出目录,添加 iOS 和 Android 项目。您的构建的 web 应用将被复制到两者中。

    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,并将相同的应用 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 构建指南

已完成

我们的团队交付的内容

  • CapgoCapacitor iOS 和 Android 项目在您的仓库中,使用 Xcode 和 Android Studio 构建
  • 插件映射:每个 Cordova 插件的替换、保留或重建,包括原因
  • config.xml 设置、权限和深度链接已移动到本机项目
  • 一个经过测试的迁移 branch 和发布清单,包括从您的当前商店版本升级
  • 一个构建和发布设置,在您的 CI 或使用 CapgoCapgo Build
  • Code、插件和文档将在交付时分配给您的公司

在免费的发现电话后,固定价格的提议将包含范围和时间表。如果您需要一个尚未存在的插件,我们可以为您构建它。

迁移咨询

自己来吗?

遵循免费的Capgo插件的逐步指南,或者让AI编码代理使用Capgo技能和插件映射运行步骤。

使用 Capacitor 构建的应用

Capacitor 运行着大型公共应用

这些应用使用 Capacitor: 在原生 iOS 和 Android 外壳中运行 Web code,这是 Cordova 应用将要迁移到的相同模型。

应用结果图标 工具

结果

巴西最高选举法院的选举结果应用

Google Play 安装
15.0万
商店评分
2.8
风向网 - 天气预报应用图标 WEATHER

风向网 - 天气预报

一个集成地图、雷达层和警报的天气预报应用

Google Play 安装
32,900万
应用评分
4.7
BURGER KING®应用图标 应用

BURGER KING

德国BURGER KING应用,提供优惠和餐厅定位功能

Google Play安装数
1.43亿
应用评分
3.9

客户证明

使用 Capgo 的团队说什么

5.0/5 评分 9,400+ 团队 查看评论
米科拉伊·维尔切克的肖像

米科拉伊·维尔切克

Tellent的移动平台工程师

“我们最初通过Capgo的插件发现它,结果证明这是我们团队进入一个更高效的发布流程的绝佳入口点。”

塞尔吉乌·S的肖像

塞尔吉乌·S

drivolino GmbH的首席开发官

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

迈克尔·哈伯勒的肖像

迈克尔·哈伯勒尔

nethead emeritors

“Capgo更新插件的工作非常出色,live更新对快速测试回归的加速作用非常显著。”

常见问题

Cordova to Capacitor questions

Cordova 到 Capacitor 的常见问题

在迁移之前,团队会问些什么问题。

No. Your UI and business logic stay. The work is in the native projects, plugins, config, and build setup. Most code changes are in the places where you call a plugin API.

不用。您的 UI 和业务逻辑保持不变。工作在原生项目、插件、配置和构建设置中。Capacitor 的大部分更改发生在您调用插件的地方。

迁移指南

Capacitor can run many Cordova plugins, so you can keep some while you migrate. For login, payments, storage, and other critical paths, use a maintained Capacitor plugin. Capgo plugins are free under MPL-2.0.

浏览Capgo插件

我们是否可以在迁移之前使用Capgo实时更新?

Yes. @capgo/cordova-updater supports Cordova iOS 7+ and Android 13+ with the same CLI and channels. When you move to Capacitor, keep the Capgo app ID and channels and switch to @capgo/capacitor-updater.

Cordova更新指南

迁移需要多长时间?

这取决于您使用的插件数量和自定义本机code的数量。如果我们的团队处理它,您将获得一个固定的价格提议,包括范围和时间表,之后会有一个免费的发现电话。

迁移咨询

我们在迁移之后可以发布什么样的live update?

JavaScript、HTML、CSS和资产的更改。添加或升级本机插件需要一个新的商店构建。当您上传一个捆绑包时,Capgo会检查本机兼容性并在通道上实时检查。

Live update兼容性

计划从Cordova迁移

尝试Capgo实时更新和Capgo构建您的应用,或预约一个电话来与我们的团队规划迁移。

来自马丁的专业支持

14天免费试用,不需要信用卡。Capgo插件免费使用MPL-2.0许可证