パッケージマネージャー

パッケージマネージャーは、再利用可能なソフトウェアコンポーネントとアセットを共有および管理し、クロスプラットフォームのアプリケーションとプラグインの開発をサポートするためのツールです。パッケージマネージャーを使用すると、次のようなプロジェクトの依存関係をインストール、更新、および削除できます。

  • Kanzi Engine のライブラリとヘッダー

  • Kanzi Engine プラグイン

  • Kanzi Studio プラグイン

  • アセットパッケージ

注釈

パッケージマネージャーは Kanzi 3.9.11 以降で使用できます。

パッケージマネージャーのインストール

Kanzi Hub からパッケージマネージャーをダウンロードしてインストールします。

../../_images/kanzi-hub-kpm-download.png

Kanzi Hub と Kanzi Account を参照してください。

パッケージマネージャーのインストールが完了すると、次の処理が行われています。

  • Conan 2.10.0 がインストールされます。

  • Rightware の公式 Conan リポジトリ kanzi-conan-external が Conan リモートとして追加されます。

  • Kanzi に必要な Conan プロファイルと設定が追加されます。

  • Kanzi 3.9.11 以降用のパッケージマネージャー Kanzi Studio プラグインがインストールされます。

インストールが正常に完了すると、Kanzi Studio のメインメニューにパッケージマネージャーが表示されます。

../../_images/main-menu-package-manager-open.png

Kanzi Studio 用パッケージマネージャープラグイン

Kanzi Studio 用パッケージマネージャーは、Conan のリポジトリとパッケージを操作するためのグラフィカルインターフェイスを提供します。このプラグインを使用すると、コマンドラインの命令を手動で使用したり、設定ファイルを編集したりする必要がありません。

サポートされているパッケージタイプ

プラグインはさまざまなパッケージタイプを認識し、次のように処理します。

  • Kanzi Engine プラグインは、プロジェクトの依存関係として追加されます。

  • Kanzi Studio プラグインは、現在の Kanzi Studio インスタンスの依存関係として追加されます。

  • アセットパッケージは、現在の Kanzi Studio インスタンスのアセットソースとして追加されます。

パッケージの自動検出

プラグインは packages.json ファイルの変更を自動的に検出し、Kanzi Studio プロジェクトのライブラリに必要な更新を通知します。

アセットパッケージ内の Kanzi Engine プラグイン

プラグインを使用すると、Kanzi Engine プラグインをアセットパッケージの依存関係として追加できます。これにより、そのようなアセットをインポートしたときに、必要な Kanzi Engine プラグインが自動的にプロジェクトに追加されます。

Conan ベースの Kanzi Studio プロジェクトテンプレート

このプラグインには、Conan ベースの Kanzi Studio プロジェクトテンプレートのセットが含まれています。これらのテンプレートを使用すると、Kanzi Studio で Conan ベースのパッケージ管理を使用できるようになり、プロジェクトのセットアップと開発をより効率的かつ合理的に行えます。

Package Manager をインストールすると、New Project ウィンドウの Template ドロップダウンに新しいテンプレートが表示されます。

../../_images/kanzi-studio-kpm-asset-template.png

Package Manager Kanzi Studio プラグインを使用する を参照してください。

プロジェクトを新しいバージョンの Kanzi に移行する

新しいバージョンの Kanzi をインストールしたら、プロジェクトを移行してそのバージョンを使用できます。

  1. 新しいバージョンの Kanzi をインストールします。既存のバージョンと並行してインストールできます。

  2. 新しい Kanzi Studio でプロジェクトを開きます。

  3. 新しいバージョンに互換性のない変更が含まれている場合は、そのバージョンの移行ガイドに従ってください。リリースノートと移行ガイド を参照してください。

以前の Kanzi Studio で作成されたプロジェクトを開くと、新しい Kanzi Studio はポップアップを表示し、プロジェクトの移行を確認するよう求めます。確認すると、Kanzi Studio はプロジェクトを新しいバージョンに更新します。

注釈

  • プロジェクトで Code Behind 機能を使用している場合は、新しい Kanzi Studio で開く前に Code Behind プラグインを削除してください。Conan ベースのテンプレートは Code Behind をサポートしていません。

  • パッケージの依存関係によっては、移行後にパッケージの更新または再インストールが必要になる場合があります。

既知の問題

  • Conan ベースの Kanzi Studio プロジェクトテンプレートを使用している場合、Code Behind 機能はサポートされません。

  • Package Manager から提供されるテンプレートを使用している場合、Kanzi Studio から Android への Kanzi アプリケーションのデプロイは機能しません。Gradle CLI または Android Studio を使用して、アプリケーションを手動でビルドおよびデプロイできます。

  • Package Manager は Java パッケージでは機能せず、Android テンプレートには Java プラグインテンプレートが含まれていません。Java の依存関係を手動で追加し、独自の Java プラグインサブプロジェクトを作成できます。

  • 現在、Package Manager インストーラーは Conan キャッシュ内の Conan プロファイルを上書きします。Kanzi が必要とするプロファイルと一致する既存のプロファイルがある場合、Package Manager をインストールするとそれらは上書きされます。

トラブルシューティング

場合によっては、Package Manager インストーラーが失敗したり、応答しなくなったりすることがあります。その場合は、次の操作を行います。

  1. コンピューター上の Conan キャッシュ(C:\Users\<admin>\.conan2\ にあります)をクリアします。

  2. Kanzi Hub から Package Manager を再インストールします。

関連項目

Package Manager Kanzi Studio プラグインを使用する

Package Manager を使用したアセットパッケージの作成とデプロイ