Kanzi でバージョン管理システムを使用する¶

Kanzi プロジェクトをバージョン管理システムに追加する際、次のファイルとディレクトリは追加しないでください。

.kzproj_N
.proj.kzm_N
.lock
.autosave
.user
assets
build_vs2022
compressed
cubemaps
gen
mipmaps
output
lib
thumbnails

注釈

上記で除外した cubemaps ディレクトリと mipmaps ディレクトリには、イメージベースドライティングのキューブマップテクスチャの生成された面とラフネスミップマップが格納されています。これらが存在しない場合 (新規にクローンした後など)、Kanzi Studio はソースイメージからこれらを再生成します。そのため、各イメージベースドライティングのキューブマップテクスチャの作成元となった hdr または exr ソースイメージもバージョンコントロールに追加してください。そのイメージがないと、Kanzi Studio はコンテンツを再生成できません。Kanzi Studio はその理由を Log ウィンドウに報告し、そのコンテンツが欠落した状態でプロジェクトを開きます。イメージベースのライティングキューブマップテクスチャを使用するを参照してください。

参照プロジェクトを別のプロジェクトのディレクトリの外に移動する¶

別のプロジェクトのプロジェクトファイルを含むディレクトリ内に参照プロジェクトを格納しているプロジェクトを開くと、Kanzi Studio はその参照プロジェクトを兄弟ディレクトリに移動するよう求め、移動によってパスが変わるすべてのプロジェクトを保存します。これにより作業コピーのディレクトリ構成が変わり、この操作は元に戻せません。

まず、開くプロジェクトのプロジェクトファイルと、そのプロジェクトが参照するすべてのプロジェクトのプロジェクトファイルをバージョンコントロールからチェックアウトしてください。読み取り専用のプロジェクトファイルが見つかった場合、移動後に保存できないため、Kanzi Studio はプロジェクトを開く操作をキャンセルします。また、これらのプロジェクトのいずれかが別の Kanzi Studio インスタンスで開かれている場合も、プロジェクトを開く操作をキャンセルします。

移動によって空になったディレクトリも削除されるため、作業コピーではディレクトリが追加されるだけでなく、削除されることもあります。

Kanzi Studio は、自身が管理するパスのみを更新します。バージョンコントロールの設定、.gitignore またはそれに相当するファイル、およびビルドスクリプト内のパスは、ご自身で更新してください。参照プロジェクトの保存場所および Kanzi 4.1.1 移行ガイドを参照してください。

バージョン管理ツールを使用したプロジェクトのマージ¶

バージョン管理ツールを設定した後、Kanzi プロジェクトの更新とマージに Kanzi マージツールを使用できます。統合のために、Kanzi は Kanzi マージツールに必要なパラメータを提供するバージョン管理ツールを必要とします。

パラメータータイプの例	ディスクリプション (Description)
私の (MINE)	ソースプロジェクトのパラメーター。
THEIRS	ターゲットプロジェクトのパラメーター。
ベース (Base)	ベースプロジェクトのパラメーター。
マージ済み	マージされたプロジェクトのパラメータ。

Kanzi マージツールをバージョン管理ツールと統合する¶

Kanzi マージツールをバージョン管理ツールと統合するには：

バージョン管理ツールを構成して、.kzprojファイルに対して Kanzi マージツール (<KanziInstallation>/Studio/Bin/KanziMergeTool.bat) を使用してください。
KanziStudio.exe への絶対パスをバージョン管理ツールに渡します。例えば、C:\Program Files\Rightware\Kanzi\Studio\Bin\KanziStudio.exe。
Kanzi マージツールのバージョン管理ツールパラメータを設定します。例えば、これらのパラメータは MINE、THEIRS、BASE、MERGED と呼ばれることがあります。

SVNバージョン管理ソフトウェアに Kanzi マージツールを統合する¶

Kanzi マージツールをSVNバージョン管理ソフトウェアと統合するには、Kanzi マージツールを.kzproj拡張子のファイルをマージするための外部プログラムとして追加します。

例えば、Tortoise SVNを使用している場合、TortoiseSVNでSVN > 設定 > 外部プログラム > マージツール > 詳細を選択し、次のように設定します。

ファイル名、拡張子、またはmime-typeを.kzprojに

外部プログラムに

<KanziInstallation>/Studio/Bin/KanziMergeTool.bat "<KanziInstallation>/Studio/Bin/KanziStudio.exe"  %mine %theirs %base %merged

例えば、Kanzi のインストールが C:\Program Files\Rightware\Kanzi にある場合、使用します。

C:\Program Files\Rightware\Kanzi\Studio\Bin\KanziMergeTool.bat "C:\Program Files\Rightware\Kanzi\Studio\Bin\KanziStudio.exe" %mine %theirs %base %merged