Package Manager Kanzi Studio プラグインを使用する¶
パッケージブラウザ¶
パッケージブラウザでは、作業に必要なパッケージの参照、インストール、アップデート、削除を行います。Kanzi Studio でパッケージブラウザを開くには、Package Manager > Open Package Browser を選択します。
パッケージブラウザには 2 つのペインがあります。
左側のペインにはパッケージが一覧表示され、パッケージの入手元に応じて Remote、Local、Project、Studio の 4 つのタブに分類されています。
右側のペインには、リストで選択したパッケージの詳細（バージョン、作成者、ライセンス、説明、依存関係 (Requires)）と、そのパッケージをインストールまたは削除するボタンが表示されます。
アクションボタンのラベルは、パッケージのインストールによって何が行われるかを示し、これはパッケージのタイプによって異なります。
Kanzi Engine プラグインの Add to project / Remove from project。このプラグインは、オープンしているプロジェクトの依存関係になります。
Kanzi Studio プラグインの場合は Add to Studio / Remove from Studio です。
アセットパッケージの場合は Add as Asset Source / Remove です。
Remote¶
Remote タブには、接続されている Conan リモートリポジトリで利用可能なパッケージ（Rightware やチームが公開したパッケージなど）が一覧表示されます。参照するリポジトリを Repository ドロップダウンから選択し、更新ボタンを使用してそのパッケージリストを再読み込みします。
構成済みのリポジトリを追加、削除、または管理するには、Repositories セクションを展開します。リモートリポジトリの追加 を参照してください。
Local¶
Local タブには、ローカルの Conan キャッシュ内のパッケージ（リモートからダウンロードしたパッケージとローカルで作成したパッケージ）が一覧表示されます。Cache: のパスはディスク上のキャッシュの場所を示し、更新ボタンでリストを再読み込みします。
キャッシュの下にある別の Editable Packages リストには、編集可能な パッケージが表示されます。編集可能なパッケージとは、Conan がキャッシュ内のビルド済みパッケージからではなく、コンピューター上のフォルダ（その conanfile.py を含むフォルダ）から解決するパッケージです。これにより、ディスク上の変更が、パッケージを再ビルドおよび再公開することなく反映されます。編集可能なパッケージは、詳細ペインで (Editable) と表示されます。Kanzi Studio はプラグイン開発中にこれらのエントリを自動的に作成します。パッケージブラウザ自体には、パッケージを編集可能にするための操作はありません。
プロジェクト (Project)¶
Project タブには、現在開いている Kanzi Studio プロジェクトのパッケージ依存関係が一覧表示されます。Packages file バーには、プロジェクトの依存関係ファイルへのパスが表示され、そのファイルをテキストエディタで開くボタンと、プロジェクトに記載されているすべての依存関係を再インストールする Restore ボタンがあります。
依存関係を削除するには、その依存関係を選択し、詳細ペインで Remove from project をクリックします。パッケージを削除すると Kanzi Studio プロジェクトファイルが変更される場合は、Package Removal ダイアログが表示され、変更を適用する前に確認を求められます。
Studio¶
Studio タブには、現在の Kanzi Studio バージョンにインストールされている Kanzi Studio プラグインが一覧表示されます。単一のプロジェクトに追加する Kanzi Engine プラグインとは異なり、Kanzi Studio プラグインは Kanzi Studio 自体にインストールされ、その Kanzi Studio バージョンで開くすべてのプロジェクトで使用できます。Project タブと同様に、Packages file バーには依存関係ファイルが表示され、Restore ボタンがあります。
プロジェクトにパッケージをインストールする¶
Kanzi Studio 用 Package Manager プラグインを使用してパッケージをインストールするには、次の手順を実行します。
Remote タブを選択します。左パネルでプロジェクトに追加したいパッケージを選択し、右パネルでパッケージ名の下にあるボタンをクリックします。
Package Manager プラグインは、パッケージのタイプに応じてパッケージをインストールします。次のように追加します。
Kanzi Engine プラグインはプロジェクトの依存関係として追加します。
Kanzi Studio プラグインは現在の Kanzi Studio インスタンスの依存関係として追加します。
アセットパッケージは現在の Kanzi Studio インスタンスのアセットソースとして追加します。
プロジェクトからパッケージを削除する¶
削除するには、次の操作を行います。
Kanzi Engine パッケージの場合は、Package Manager プラグインの Project タブで削除したいパッケージを選択し、Remove from project をクリックして削除を確定します。
アセットパッケージの場合は、Asset Packages ウィンドウでアセットソースを右クリックし、Remove を選択します。
リモートリポジトリを追加する¶
Package Manager プラグインを使用すると、複数の Conan リモートリポジトリを追加、削除、管理できます。
Conan リモートリポジトリを追加するには、次の手順を実行します。
Package Manager プラグインで Remote タブを選択します。Repositories で + Add Repository をクリックします。
Repository Setup ウィンドウで、次のように設定します。
Conan リポジトリを識別するために使用したい名前を Repository Name に設定します。
Repository Url を Conan リポジトリの URL に設定
User を Conan リポジトリのユーザー名に設定
Password を Conan リポジトリのパスワードに設定
OK をクリックします。
Package Manager プラグインに、追加したリポジトリのパッケージが一覧表示されます。
Package Manager プラグインは、一度に 1 つの Conan リポジトリのパッケージのみを表示します。ドロップダウンリストを使用してリポジトリを切り替えることができます。
依存関係の復元¶
プロジェクトは、依存するパッケージをパッケージファイルに記録します。依存関係がまだローカルの Conan キャッシュにないプロジェクトを開いた場合（たとえば、プロジェクトをクローンした後、別のコンピューターでチェックアウトした後、または新しい Kanzi バージョンに移行した後）、各パッケージを手動で追加する代わりに、1 回の手順ですべてを再インストールできます。
開いているプロジェクトの依存関係を復元するには、次の手順に従います。
パッケージブラウザで Project タブを選択します。Kanzi Studio プラグインを復元する場合は、代わりに Studio タブを選択します。
Restore をクリックします。
パッケージマネージャーは、パッケージファイルに記載されているすべてのパッケージを再インストールします。
現在のソリューション内のすべてのプロジェクトの依存関係を一度に復元するには、Package Manager > Restore Solution を選択します。
ローカルキャッシュのクリア¶
パッケージマネージャーは、ダウンロードおよびビルドしたパッケージをローカルの Conan キャッシュに保持します。このキャッシュは Local タブに Cache: として表示されます（デフォルトは %USERPROFILE%\.conan2\）。インストールの失敗後など、パッケージマネージャーが予期しない動作をし始めた場合は、キャッシュをクリアすると、Kanzi はパッケージをリモートリポジトリから強制的に再ダウンロードします。
キャッシュをクリアするには、Package Manager > Clear local cache... を選択し、Kanzi Studio から確認を求められたら承認します。これにより、ローカルの Conan キャッシュからすべてのパッケージが削除されます。
次回パッケージをインストールまたは復元するときに、Package Manager は接続されているリモートからパッケージを再度ダウンロードします。