capacitor-plugin-upgrades

Capacitor プラグインのアップグレード

Capacitor プラグインを新しいメジャーバージョン（4→5、5→6、6→7、または7→8）にアップグレードします。

前提条件

対象バージョン	Node.js
5	16+
6	18+
7	20+
8	22+

プロジェクトはCapacitorプラグインである必要があります（アプリプロジェクトは対象外です）。

手順

ステップ1：現在のバージョンを確認する

package.json（devDependenciesまたはpeerDependencies）から@capacitor/coreのバージョンを確認します。現在のメジャーバージョンを特定します。

ユーザーに対象バージョンを尋ねます。指定がない場合は、最新バージョン（8）を使用します。

ステップ2：アップグレードを実行する

現在のバージョンから対象バージョンまでのメジャーバージョンの移行ごとに、該当するアップグレードガイドを順番に適用します。

現在 → 対象	参照
4 → 5	references/upgrade-v4-to-v5.md
5 → 6	references/upgrade-v5-to-v6.md
6 → 7	references/upgrade-v6-to-v7.md
7 → 8	references/upgrade-v7-to-v8.md

複数バージョンをまたぐアップグレード（例：5 → 8）では、各アップグレードを次の順序で適用します。

1. references/upgrade-v5-to-v6.mdを読み、適用します
2. npm install && npx cap syncを実行し、ビルドしてプラグインのテスト用／サンプルアプリを検証します
3. references/upgrade-v6-to-v7.mdを読み、適用します
4. npm install && npx cap syncを実行し、ビルドしてプラグインのテスト用／サンプルアプリを検証します
5. references/upgrade-v7-to-v8.mdを読み、適用します
6. npm install && npx cap syncを実行し、ビルドしてプラグインのテスト用／サンプルアプリを検証します

中間バージョンをスキップしないでください。

ステップ3：最終確認

すべてのアップグレード手順の完了後：

npm install
npx cap sync

両プラットフォームでプラグインのテスト用／サンプルアプリをビルドして、動作を確認します。

エラー処理

• 自動アップグレードツールが失敗した場合は、ターミナル出力で失敗した手順を確認し、該当する参照ファイルの手順に従って手動で適用します。
• アップグレード後にAndroidのビルドが失敗する場合は、Android Studioで Tools > AGP Upgrade Assistant を実行します。
• iOSのビルドが失敗する場合は、デプロイメントターゲットが参照ファイルに記載された対象バージョンの要件を満たしていることを確認します。
• Gradleのプロパティ構文に関する警告が表示された場合（v8以降）、すべての.gradleファイルで=のないプロパティ代入を検索し、修正します。
• 複数バージョンにまたがるアップグレードの途中で失敗した場合は、次に進む前に現在のバージョンの手順を修正します。

関連スキル

• capacitor-app-upgrades — アプリプロジェクト自体もアップグレードする必要がある場合は、このスキルを使用します。
• capacitor-plugin-spm-support — プラグインをCapacitor 6以降にアップグレードした後、このスキルを使用してSwift Package Managerのサポートを追加します。
• capacitor-plugin-development — スキャフォールディング、ネイティブ実装、公開を含め、Capacitorプラグインをゼロから作成する場合に使用します。