コンテンツにスキップ

QFieldプラグイン

QFieldにはQML/Javascriptプラグイン・フレームワークがあり、このフレームワークを通して新しい機能をスクリプトとして追加することができます。

プラグインの種類

プラグインは2つの方法で提供することができます:

  • プロジェクト固有のプラグインとして、プロジェクト・セッションの間アクティブになります;
  • アプリケーション・プラグインとして作成し、QFieldの起動時に有効にします。

備考

プラグインを有効にする前に許可ダイアログが表示され、個々のプラグインを許可または拒否することができます。

プロジェクトのプラグイン

プロジェクトプラグインは、指定されたプロジェクトファイルのサイドカーファイルとしてデプロイされ、拡張子.qmlで同じファイル名を共有する必要があります。例えば、プロジェクトファイルが 「tree_inventory_qfield.qgs」の場合、プラグインのメインQMLファイルは 「tree_inventory_qfield.qml 」でなければなりません。

クラウドプロジェクトでは、関連する QML ファイルをローカルのクラウドプロジェクトフォルダに追加し、qfieldsync を使用して新しく追加したファイルを QGIS にアップロードするだけです。この方法により、スムーズなプラグインの展開と現場のデバイスへの更新が保証されます。

クラウド以外のプロジェクトについては、QFieldの ストレージを使用する方法を参照して、プロジェクトをデバイスにインポートする方法を学んでください。

アプリケーションのプラグイン

アプリケーションプラグインは、QFieldの設定パネルからアクセスできるプラグインポップアップからインストールされます。単に「URLからプラグインをインストール」ボタンを押して、zip圧縮されたプラグインファイルを指すURLを貼り付けるだけです。

インストールされると、プラグインはポップアップにあるプラグインリストに表示され、プラグインの有効化を切り替えるスイッチも表示されます。