Capacitor を使ったアプリを開発するとき、Cordova と Ionic Native の両方のプラグインを使うことができます。
選択したプラグインをインストールし、プロジェクトを同期し、必要な Native プロジェクト構成を完了するだけで、次の作業を開始できます:
npm install cordova-plugin-name
npx cap sync
インストール手順と同様です。cordova プラグインを最新バージョンにアップデートするだけで、変更が反映されます。
npm install cordova-plugin-name@latest
npx cap update
If you don’t want to risk to introduce breaking changes, use
npm update cordova-plugin-name
instead of
@latest
as
update
respects semver.
Ionic Native は、Cordova プラグインを使用した開発を容易にするために、TypeScript ラッパーと一貫した API および命名規則を提供します。これは Capacitor でサポートされているので、使いたい Ionic Native ラッパーが見つかったら、JavaScript コードをインストールし、対応する Cordova プラグインをインストールし、プロジェクトを同期させます:
npm install @ionic-native/javascript-package-name
npm install cordova-plugin-name
npx cap sync
インストール手順に従います。Ionic Native JavaScript ライブラリを更新し、Cordova プラグインを削除してから再追加し、プロジェクトを更新します。
npm install @ionic-native/javascript-package-name@latest
npm install cordova-plugin-name@latest
npx cap update
If you don’t want to risk to introduce breaking changes, use
npm update cordova-plugin-name
instead of
@latest
.
See the list of Capacitor and Cordova plugins (and their exact version numbers) installed in your project with:
npx cap ls
Capacitor は Cordova のインストール変数、自動設定、フックをサポートしていません。これは Native プロジェクトのソースコード(フックのようなものが不要であることを意味する)をコントロールできるようにするという哲学によるものです。プラグインで変数や設定を設定する必要がある場合は、プラグインとplugin.xml
間をマッピングして、これらの設定を手動で適用する必要があります。これは、iOS と Android で必要な設定です。
各プラットフォームの設定方法については iOS と Android の構成ガイドを参照してください。
Cordova プラグインの中には、Capacitor で動作しないものや、競合する代替品を提供するものがあります。 非互換のリストについて詳しく知りたい場合はこちらをご覧ください。