AI支援による Cordova から Capacitor への移行 (2026)

Cordovaを離れることで変わること

Capacitor は、Webアプリをホストするネイティブアプリです。実際の Xcode や Android Studio プロジェクトをコミットし、既存の Web code を維持しながら、Cordova プラグインを Capacitor プラグインに置き換えます。これにより、エージェントが実行し、ユーザーがレビューできる小さなステップに作業を簡単に分割できます。

移行チェックリスト（推奨手順）

1) Cordova アプリの監査

現在の構成をエクスポートし、移行時のインプットとして保持してください:

# In your Cordova project
cordova plugin list
cordova platform ls

• config.xml preferences (画面の向き、ステータスバーなど)
• プラグイン変数 (API キー、manifest プレースホルダー、URL スキーム)
• 依存しているカスタムフック/スクリプト
• 内部で手動で行ったネイティブ編集 platforms/

2) Webアプリに Capacitor を追加

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

次の設定（ webDir ）がビルド出力フォルダと一致しているか確認してください (例: dist, build, www).

3) iOS + Android プロジェクトの追加

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

4) Build + Sync

bun run build
bunx cap sync

プラグイン置換マップ (Capgo優先)

ログイン、決済、ストレージ、バックグラウンドサービスといった高リスクのプラグインから先に置き換えましょう。Capgo プラグインは MPL-2.0 ライセンスで無料かつオープンソースとして提供されており、どの Capgo プランでもプラグインのバグ報告は優先対応されます。

Capgoのプラグインカタログを閲覧し、機能別に比較しましょう: Capgo プラグイン.

コピー＆ペーストで使えるAIプロンプト

これらのプロンプトは、曖昧なアドバイスではなく、実用的なアウトプット（表、チェックリスト、計画書）を生成するように設計されています。

プロンプト 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).

プロンプト 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.

プロンプト 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.

AIエージェント向け Capgo スキル

スキルを使用することで、エージェントは推測ではなく、検証済みのプレイブックを実行できます。cordova-to-capacitor スキルは移行順序をカバーし、capacitor-plugins はプラグインの選定とインストールを、capgo-live-updates は移行後のアップデーター設定を支援します。これらのスキルはオープンソースで、コマンド一つでインストール可能です。

参照: AIエージェント向け Capacitor スキル.

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

Capgo MCP サーバー

Capgo CLI でログイン後、ローカルの MCP サーバーを実行してください。これにより、エージェントがアプリ一覧の取得、bundle の upload、channel の管理、Native の互換性チェック、Native Build のリクエストを行えるようになります。ローカル環境がない場合は、api.capgo.app/mcp のホスト型 MCP サーバーにエージェントを接続して、アカウント管理やドキュメント検索が可能です。

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

• MCP コマンドリファレンス
• Capgo MCP サーバーについて

オールインワンオプションが必要ですか？

App Store のブロッカー、プラグインのリグレッション、既存ユーザーのアップグレードパスに不安がある場合は、当社チームが移行をエンドツーエンドで実行します。

• Cordova から Capacitor への移行サービス
• ネイティブ対応とリリース対応を継続的に支援するプレミアムサポート