Cordova Plugins と Ionic Native を使う
Capacitorを使ったアプリを開発するとき、CordovaとIonic Nativeの両方のプラグインを使うことができます。
選択したプラグインをインストールし、プロジェクトを同期し、必要なNativeプロジェクト構成を完了するだけで、次の作業を開始できます:
npm install cordova-plugin-name
npx cap sync
インストール手順と同様です。cordovaプラグインを最新バージョンにアップデートするだけで、変更が反映されます。
npm install cordova-plugin-name@latest
npx cap updateIf 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 updateIf 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で動作しないものや、競合する代替品を提供するものがあります。 非互換のリストについて詳しく知りたい場合はこちらをご覧ください。
