使用版本控制系统与 Kanzi。

当您将您的 Kanzi 项目添加到版本控制系统时，不要添加这些文件和目录：

  • .kzproj_N

  • .proj.kzm_N

  • .lock

  • .autosave

  • .user

  • assets

  • build_vs2022

  • compressed

  • cubemaps

  • gen

  • mipmaps

  • output

  • lib

  • thumbnails

备注

上面排除的 cubemaps 和 mipmaps 目录存放基于图像的光照 cubemap 纹理所生成的面和粗糙度 mipmaps。当这些内容缺失时（例如在全新克隆之后），Kanzi Studio 会根据源图像重新生成它们。因此，还要将用于创建每个基于图像的光照 cubemap 纹理的源 hdr 或 exr 图像添加到版本控制中。没有该图像，Kanzi Studio 就无法重新生成这些内容。Kanzi Studio 会在 Log 窗口中报告原因，并在缺少这些内容的情况下打开工程。请参阅 使用基于图像的照明立方体贴图纹理。

将被引用的工程移出另一个工程的目录

当您打开的工程将某个被引用的工程存放在包含另一个工程的工程文件的目录中时，Kanzi Studio 会要求将该被引用的工程移到同级目录中，并保存因此次移动而更改了路径的每个工程。这会更改您工作副本的目录布局，并且无法撤消。

Check the project file of the project you open, and the project file of every project it references, out of version control first. Kanzi Studio cancels the open when it finds a read-only project file, because it cannot save it after the move. It also cancels the open when one of those projects is open in another Kanzi Studio instance.

移动还会删除因此变为空的目录，因此您的工作副本既会新增目录，也会失去目录。

Kanzi Studio 仅更新其自身管理的路径。请您自行更新版本控制配置、.gitignore 或等效文件以及构建脚本中的路径。请参阅 在何处存储被参考的工程 和 Kanzi 4.1.1 迁移指南。

使用版本控制工具合并工程

在配置版本控制工具后，您可以使用 Kanzi 合并工具进行 Kanzi 项目的更新和合并。对于集成，Kanzi 需要一个版本控制工具，该工具为 Kanzi 合并工具提供必要的参数。

参数类型示例

描述 (Description)

MINE

源工程的参数。

THEIRS

目标工程的参数。

基准 (Base)

基准工程的参数。

MERGED

合并工程的参数。

将 Kanzi 合并工具与版本控制工具集成

要将 Kanzi 合并工具与版本控制工具集成：

  1. 将您的版本控制工具配置为对 .kzproj 文件使用 Kanzi 合并工具 (<KanziInstallation>/Studio/Bin/KanziMergeTool.bat)。

  2. 将 KanziStudio.exe 的绝对路径传递给您的版本控制工具。例如，C:\Program Files\Rightware\Kanzi\Studio\Bin\KanziStudio.exe。

  3. 为 Kanzi 合并工具设置版本控制工具参数。例如，这些参数可以称为 MINE、THEIRS、BASE、MERGED。

将 Kanzi 合并工具与 SVN 版本控制软件集成

要将 Kanzi 合并工具与 SVN 版本控制软件集成，请将 Kanzi 合并工具添加为用于合并 .kzproj 扩展名文件的外部程序。

例如，如果您在使用 Tortoise SVN，在 TortoiseSVN 中选择 SVN > 设置 > 外部程序 > 合并工具 > 高级，然后进行设置：

  • 文件名、扩展名或 MIME 类型设为 .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

另请参阅

合并工程

工程 (Projects)