跳转至正文
2026 AI 辅助迁移

AI 辅助 Cordova 至 Capacitor 迁移 (2026)

为你的 AI coding agent 提供可执行的方案:安装 Capgo 的 cordova-to-capacitor 技能,将插件列表粘贴到下方的 prompts 中,检查插件映射图,并连接 Capgo MCP server 以上传 bundles 并请求 builds。所有变更均由你亲自审核。

最后更新:

来自 Martin 的人工支持

工作原理

如何使用 AI Agent 执行迁移

单一技能、统一清单、细致的审核步骤,以及发布前的真机测试。

  1. 安装 Capgo 技能

    将 cordova-to-capacitor 技能添加到你的 coding agent 中。它会为 agent 提供迁移指令和 Capacitor 插件选择。

    npx skills add https://github.com/Cap-go/capgo-skills --skill cordova-to-capacitor
    Capacitor AI Agent 技能集
  2. 从插件映射表开始,而不是 code

    先让 Agent 读取你的 Cordova 项目并返回一份插件替换表。在进行任何文件更改前,请先进行审核。

    Use the cordova-to-capacitor skill from Cap-go/capgo-skills to migrate this Cordova app to Capacitor. Start with a plugin replacement table and wait for my review before changing files.
    复制完整 Prompt
  3. 检查每一步并进行真机测试

    让 Agent 通过小步提交的方式添加 Capacitor、迁移 config.xml 设置并替换插件。在真机上测试权限、Deep Links 以及从当前应用商店版本进行的升级流程。

    bunx cap sync
    bunx cap run ios
    bunx cap run android
    迁移清单
  4. 连接 Capgo MCP server 即可发布

    MCP server 运行后,Agent 可以上传 bundle、管理 channels 并请求 Native Build。请注意,插件变更仍需通过应用商店发布。

    npx @capgo/cli@latest login YOUR_API_KEY
    npx @capgo/cli@latest mcp
    MCP 命令参考

离开 Cordova 后会有哪些变化

Capacitor 是托管 Web 应用的原生应用。你只需提交真实的 Xcode 和 Android Studio 项目,保留现有的 Web code,并将 Cordova 插件替换为 Capacitor 插件。这使得工作可以轻松拆分为 Agent 可执行且由你审核的小步骤。

迁移清单(实用步骤)

1) 审计你的 Cordova 应用

导出你当前的内容,并将其作为迁移的输入:

# In your Cordova project
cordova plugin list
cordova platform ls
  • config.xml preferences(方向、状态栏等)
  • 插件变量(API 键、manifest 占位符、URL schemes)
  • 你所依赖的自定义 hooks/scripts
  • 任何手动进行的 native 编辑 platforms/

2) 在 Web App 中添加 Capacitor

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

请确保您的 webDir 与您的 build 输出目录匹配 (例如: dist, build, www).

3) 添加 iOS + Android 项目

bun add @capacitor/ios @capacitor/android
bunx cap add ios
bunx cap add android

4) 构建 + 同步

bun run build
bunx cap sync

插件替换对照表 (Capgo 首选)

优先替换高风险插件:登录、支付、存储和后台服务。Capgo 插件在 MPL-2.0 下免费且开源,且在任何 Capgo 方案中,您的插件 Bug 报告都将获得优先处理。

使用场景 Cordova 插件 (示例) 推荐的 Capacitor 替代方案
相机拍摄 cordova-plugin-camera @capacitor/camera + @capgo/camera-preview
应用内浏览器 cordova-plugin-inappbrowser @capgo/capacitor-inappbrowser
后台定位 @transistorsoft/cordova-background-geolocation-lt / cordova-plugin-geolocation @capgo/background-geolocation
生物识别 cordova-plugin-fingerprint-aio / cordova-plugin-touch-id @capgo/capacitor-native-biometric
社交登录 cordova-plugin-googleplus / cordova-plugin-facebook4 / cordova-plugin-sign-in-with-apple @capgo/capacitor-social-login
SQLite cordova-sqlite-storage @capgo/capacitor-data-storage-sqlite / @capgo/capacitor-fast-sql
应用内购买 cordova-plugin-purchase @capgo/native-purchases
文档扫描 cordova-plugin-document-scanner @capgo/capacitor-document-scanner
OTA / 实时更新 Ionic Appflow Deploy @capgo/capacitor-updater ( @capgo/cordova-updater 且仍在使用 Cordova 时)

浏览 Capgo 的插件目录,按功能进行匹配: Capgo 插件.

可直接复制/粘贴的 AI Prompts

这些 prompts 旨在生成可用的输出(如表格、清单、计划),而非模糊的建议。

Prompt 1:制定插件替换计划

You are a senior Capacitor engineer.

I am migrating a Cordova app to Capacitor. Here is my `cordova plugin list` output:
<PASTE HERE>

1) Create a table mapping each Cordova plugin to a recommended Capacitor alternative.
2) Prefer official Capacitor plugins when possible.
3) When official plugins are limited (background geolocation, social login, biometrics, IAP, in-app browser, live updates), recommend Capgo plugins:
- @capgo/background-geolocation
- @capgo/capacitor-social-login
- @capgo/capacitor-native-biometric
- @capgo/native-purchases
- @capgo/capacitor-inappbrowser
- @capgo/capacitor-updater
4) For each mapping, list migration steps and common pitfalls.
Return a prioritized plan (highest risk first).

Prompt 2:将 config.xml 配置转换为 Capacitor + Native 变更

You are migrating Cordova to Capacitor.

Here is my Cordova `config.xml`:
<PASTE HERE>

Create a migration checklist:
1) What goes into capacitor.config.ts (appId, appName, webDir, server config for dev only).
2) What must be moved to iOS (Info.plist, entitlements, URL schemes, permissions strings).
3) What must be moved to Android (AndroidManifest, Gradle, intent filters, permissions).
Be explicit about file names and what to change.

Prompt 3:切流测试计划(真机)

You are the QA lead for a Cordova -> Capacitor migration.

App description:
<PASTE HERE>

Features that rely on native plugins:
<LIST HERE>

Create a test plan for iOS and Android that includes:
- permission flows (fresh install, denied, restricted, limited)
- background behavior (if any)
- deep links / universal links (if any)
- upgrade path from the existing Cordova app version
Output as a checklist that an engineer can run in 2-3 hours per release candidate.

Capgo AI Agent 技能集

技能集为你的 Agent 提供经过验证的 playbook,而非凭空猜测。cordova-to-capacitor 技能涵盖了迁移顺序;capacitor-plugins 协助挑选并安装插件;capgo-live-updates 则在迁移完成后配置 updater。这些技能均为开源,只需一条命令即可安装。

参见: Capacitor AI Agent 技能集.

npx skills add https://github.com/Cap-go/capgo-skills --skill cordova-to-capacitor

Capgo MCP Server

使用 Capgo CLI 登录后,运行本地 MCP server,即可让你的 Agent 列出 App、upload bundles、管理 channels、检查 Native 兼容性并请求 Native Build。若未进行本地安装,请将 Agent 连接至托管的 MCP server:api.capgo.app/mcp,以管理账户并搜索文档。

npx @capgo/cli@latest login YOUR_API_KEY
npx @capgo/cli@latest mcp

需要全方位解决方案?

如果您担心 App Store 审核受阻、插件功能回退或现有用户的升级路径,我们的团队可以为您提供端到端的迁移服务。

使用 Capacitor 构建的应用

复杂应用会暴露隐藏的迁移清单

电商、银行和票务类应用集成了搜索、账户、媒体、定位和交易流程。AI 辅助迁移能将这些功能需求转化为 Capacitor 插件映射、测试计划和分阶段发布清单。

Cars.co.za 应用图标 汽车与交通工具

Cars.co.za

包含列表、搜索、照片和账户流程的汽车交易类应用。

Google Play 安装量
190万
应用商店评分
4.4
Vyom - Union Bank of India 应用图标 金融

Vyom - 印度联合银行 (Union Bank of India)

包含支付和账户界面的 Union Bank of India 移动银行应用。

Google Play 安装量
28.0M
应用商店评分
3.7
KAI Access:火车票预订应用图标 旅游与本地

KAI Access:火车票预订 App

用于火车订票、改签及查询行程状态的印尼铁路应用。

Google Play 安装量
1350万
应用商店评分
3.6

客户证言

使用 Capgo 交付的团队怎么说

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

Mikołaj Wilczek

Tellent 移动平台首席工程师

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

Michael Haberler 的肖像

Michael Haberler

nethead emeritors

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

Sergiu S 的肖像

Sergiu S

drivolino GmbH 首席开发者

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

常见问题

AI 迁移常见问题

在将 Cordova 迁移任务交给 AI Agent 之前,团队通常会关心的问题。

AI Agent 能独立完成 Cordova 应用迁移吗?

它可以完成大部分机械性工作:添加 Capacitor、迁移 config.xml 设置以及更换插件。你仍需审核变更、在真机上测试,并处理签名和应用商店发布。

Capacitor AI Agent 技能集

我们应该安装哪种 Capgo 技能?

从 cordova-to-capacitor 开始。需要选择插件时添加 capacitor-plugins,迁移后设置 Live Updates 时添加 capgo-live-updates。如果你愿意,一条命令就能安装整套。

Capacitor AI Agent 技能集

Capgo MCP server 能做什么?

本地服务器可以列出并创建应用、上传并列出 bundle、管理 channel、检查原生兼容性、读取统计信息,以及请求 Native Build。它使用你的 Capgo CLI 登录信息。

MCP 命令参考

地图中的 Capgo 插件需要付费吗?

不需要。Capgo 插件以 MPL-2.0 协议开源。Capgo 方案还包含 Live Updates、Native Build,以及优先处理你的插件 Bug 报告。

Capgo 插件

如果 Agent 卡住了怎么办?

把难题交给我们的团队。我们以固定价格项目的形式执行 Cordova 到 Capacitor 的迁移,Premium Support 还能让你直接对接 Capacitor 工程师。

Cordova 到 Capacitor 迁移服务