Package Manager を使用した Engine プラグインの作成とデプロイ¶
Engine プラグインプロジェクトの作成¶
Package Manager を使用して Kanzi Studio で Engine プラグインを作成するには:
New Project ウィンドウで、Application with Kanzi Engine plugin テンプレートを使用してプロジェクトを作成します。
Kanzi Studio で File > Open in File Explorer を選択し、
<MyProject>\Applicationフォルダに移動します。このフォルダには、プラグインのビルドとデプロイを支援する以下のファイルが含まれています:README.mdは、プラグインをビルド、パッケージ化、デプロイする方法を簡単にまとめたリファレンスです。build.batはプラグインをビルドします。create_and_deploy_plugin.batは、Conan コマンドを実行してプラグインパッケージを作成し、指定した Conan リポジトリにデプロイする便利なスクリプトです。
Package Manager モードでプラグインをビルドします:
<MyProject>\Applicationフォルダ内の何もない領域を右クリックし、Open in Terminal を選択します。
ビルドスクリプトを実行します:
build.bat kpm
これによりプラグインアプリケーションがコンパイルされ、パッケージング手順で Conan パッケージを作成するために使用される Package Manager のビルド出力が生成されます。このスクリプトはパッケージを作成しません。また、パッケージを作成するためにこのスクリプトを実行する必要はありません。パッケージングの前にコンパイルを検証する必要がある場合に、このビルドスクリプトを実行してください。
注釈
Windows 以外のプラットフォームでは、代わりに build.sh スクリプトを使用します。
プラグインをローカルの Conan パッケージとして作成する¶
ローカルでテストできるプラグインパッケージを作成するには:
デプロイスクリプトを実行します。
create_and_deploy_plugin.bat
プラグインをビルドし、パッケージをローカルの Conan キャッシュに公開します。パッケージをリモートにアップロードすることはありません。
注釈
このスクリプトは、
my_engine_plugin/1.0.0@kanzi-4.1.0-engine-plugins/stableという形式のリファレンスで識別される Conan パッケージを作成します。ユーザーセグメントkanzi-4.1.0-engine-pluginsはスクリプト内のKANZI_VERSION変数から構成され、チャネルstableはスクリプトのデフォルトです。Kanzi Studio でパッケージマネージャーを開きます。
Local タブを選択します。
更新アイコンを押して、ローカルパッケージリストを更新します。
新しいプラグインがローカルパッケージの下に表示されます。
注釈
Windows 以外のプラットフォームでは、代わりに create_and_deploy_plugin.sh スクリプトを使用します。
プラグインを作成してリモートリポジトリにデプロイする¶
プラグインパッケージを作成してリモートリポジトリに公開するには:
プロファイルとリモート名を指定してデプロイスクリプトを実行します。
create_and_deploy_plugin.bat win64_vs2022_release <remote>プラグインをビルドし、パッケージをローカルの Conan キャッシュに公開して、リモート
<remote>にアップロードします。注釈
このスクリプトは、
my_engine_plugin/1.0.0@kanzi-4.1.0-engine-plugins/stableという形式のリファレンスで識別される Conan パッケージを作成します。ユーザーセグメントkanzi-4.1.0-engine-pluginsはスクリプト内のKANZI_VERSION変数から構成され、チャネルstableはスクリプトのデフォルトです。Kanzi Studio でパッケージマネージャーを開きます。
Remote タブを選択します。
Repository ドロップダウンリストで、プラグインをデプロイしたリポジトリを選択します。
更新アイコンを押して、リポジトリリストを更新します。
新しいプラグインがリポジトリパッケージの下に表示されます。
注釈
Windows 以外のプラットフォームでは、代わりに create_and_deploy_plugin.sh スクリプトを使用します。