メインコンテンツにジャンプ
2026 AI-Assisted Migration

AI-Assisted Cordova to Capacitor Migration (2026)

Capacitorの実用的なチェックリスト + プラグイン置き換えマップ + コピペAIプロンプト。チームが少ない驚き、高速切り替え、安定したCapacitor基準を求めるために作られた。

Last updated:

Cordova から離れるときの変更点

Capacitor は、ホストするウェブアプリのネイティブアプリに近い。実際の Xcode と Android Studio のプロジェクトを配信し、既存のウェブ code を維持し、Capacitor-先の API でプラグインをモダナイズします。

移行チェックリスト (実践的な順序)

1) Cordova アプリを検証する

現在のものをエクスポートし、移行入力として保存してください:

# In your Cordova project
cordova plugin list
cordova platform ls
  • config.xml 設定 (オリエンテーション、ステータス バーなど)
  • プラグイン変数 (API キー、マニフェストプレースホルダー、URL スキーム)
  • 依存するカスタムホック/スクリプト
  • アプリ内で手動でネイティブエディット platforms/

2) 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) ビルド + 同期

bun run build
bunx cap sync

プラグイン置き換えマップ (Capgo-First)

マイグレーションは「ほとんど動く」プラグインの動作を認める最悪の時期です。高リスクのプラグイン (認証、決済、バックグラウンドサービス) を早期に置き換えることが重要です。

使用例 Cordova プラグイン (例) 推奨 Capacitor 置き換え
カメラ撮影 cordova-plugin-camera @capacitor/camera + @capgo/capacitor-camera-preview
インアプリブラウザ cordova-plugin-inappbrowser @nicholasalx/capacitor-inappbrowser
バックグラウンド位置情報 @transistorsoft/cordova-background-geolocation-lt / cordova-plugin-geolocation @capgo/capacitor-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 @nicholasalx/capacitor-data-storage-sqlite / @nicholasalx/capacitor-fast-sql
インアプリ購入 cordova-plugin-purchase @capgo/capacitor-native-purchases
ドキュメントスキャン cordova-plugin-document-scanner @capgo/capacitor-document-scanner
OTA / ライブアップデート Ionic Appflow @capgo/capacitor-updater

Browse 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/capacitor-background-geolocation
- @capgo/capacitor-social-login
- @capgo/capacitor-native-biometric
- @capgo/capacitor-native-purchases
- @nicholasalx/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 に変換する + ネイティブの変更

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: 実機テスト計画 (Cutover)

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 コーディングエージェント (Cursor、Claude Code、など) を使用している場合、エージェントが Capacitor の移行に一貫したプレイブックを実行することで、結果が改善されます。 Capgo は、Capacitor: プラグイン、ベストプラクティス、デバッグ、CI/CD、ライブアップデートのオープンソーススキルを公開しています。

詳細はこちら Capacitor スキル for AI エージェント.

すべてを含むオプションが必要ですか?

既存のユーザーに対してアップグレードパスリスクやアプリストアブロッカー、プラグインのバックレッジなどを心配している場合、移行をエンドツーエンドで実行することができます。

Apps built with Capacitor

複雑なアプリは、隠された移行チェックリストを公開します。

マーケットプレイス、銀行、チケットアプリは、検索、口座、メディア、位置、取引フローを組み合わせます。AIが支援する移行は、機能表面をCapacitor プラグインマップ、テスト計画、ステージドロールアウトチェックリストに変換します。

アプリの種類
AIが支援する移行
ストアのカテゴリ
自動車、金融、旅行、地域
ソース
パブリックストアデータセット
Cars.co.zaアプリアイコン

自動車

Cars.co.za

マーケットプレースアプリは、メディア、検索、口座、リード生成パスをマップします。

1.9M インストール 4.4 評価
Google Play リストを表示
Vyom - Union Bank of India アプリアイコン

FINANCE

Vyom - Union Bank of India

決済、割引、サポート、セキュリティに敏感な画面を持つ銀行アプリ

28.0M インストール 3.7 評価
Google Play リストを表示
KAI Access: Train Booking App アプリアイコン

TRAVEL AND LOCAL

KAI Access: Train Booking App

利用者優先の予約、変更、旅行状況のフローを備えたチケットアプリ。

13.5M インストール 3.6 評価
Google Play リストを表示