OpenCASCADE构建场景下CMake与genproj工具的差异及genproj Windows配置咨询

• 工具定位与起源
  • CMake是跨平台通用开源构建系统，是OpenCASCADE从7.0版本开始官方主力替代WOK的构建方案，设计目标是覆盖Windows、Linux、macOS全平台的编译流程生成，适配所有主流编译器。
  • genproj是OpenCASCADE早期面向Windows平台开发的轻量工程生成工具，本质是原WOK构建体系的Windows裁剪版，仅支持Windows环境，没有跨平台能力。
• 环境依赖
  • CMake不存在对单一编译器的绑定，Windows下可直接对接MSVC编译环境，全程不需要额外安装gcc/MinGW即可完成编译，也可按需切换其他编译器。
  • genproj原生仅适配MSVC环境，设计初衷就是免去gcc安装步骤，但这个特性现在已经不是独占优势。
• 可配置能力
  • CMake支持细粒度的编译开关，可按需裁剪编译模块、开关Qt绑定/VTK集成/示例程序、指定第三方依赖路径（Tcl、FreeType等），支持生成Makefile、Ninja、VS工程等多种输出格式，编译流程可通过命令行自动化执行。
  • genproj的配置项极少，仅能通过命令行指定需要编译的核心模块、选择对应VS版本，生成的工程路径硬编码占比高，几乎没有自定义编译裁剪的空间，也不支持自动化流程。
• 维护状态
  • CMake接入OpenCASCADE主线后，由官方团队持续迭代，会同步适配最新的VS版本、CMake新特性，每一个OpenCASCADE正式版本都会配套更新对应的CMake配置文件。
  • genproj早已停止主线维护，目前可获取的版本最高仅适配到VS2019对应的工具集，对新版本VS没有官方兼容性保障。

整体来说CMake的便捷度远高于genproj，核心差异体现在几个方面：

• 学习成本：目前公开渠道90%以上的OpenCASCADE编译教程都是基于CMake流程搭建的，遇到报错的排查参考资料充足，新手只要跟着步骤就能跑通。genproj没有官方维护的文档，所有操作都需要靠零散的经验总结，排错成本极高。
• 兼容性：CMake支持从VS2017到最新VS2022的所有版本，只要调整生成器参数就能适配，不会因为源码路径调整出现硬编码报错。genproj不同版本对VS工具集的匹配要求非常严格，稍微移动源码存放路径就会导致工程找不到依赖，编译失败。
• genproj仅存的优势是生成的VS工程文件体积更小、无额外CMake缓存目录，工程加载速度略快，但这个优势远抵不上它停更带来的兼容问题、排错成本。对于绝大多数用户，尤其是新入门的开发者，优先选择CMake即可。

首先需要明确：单独散落的genproj配套DLL是无法独立运行的，如果你只拿到DLL文件，说明获取的资源包不完整，缺少主程序genproj.exe的版本没有办法正常使用。
完整的安装配置流程如下：

1. 获取完整资源包
   找到和自身使用的VS工具集匹配的完整genproj发布包，要求包内同时包含genproj.exe主程序、所有配套的TK开头的运行时DLL。将所有文件统一存放在无中文、无空格的独立目录下，比如C:\dev\tools\genproj\，不要将文件分散在不同文件夹。
2. 配置系统环境
   将genproj的存放目录添加到系统Path环境变量中，无需单独注册DLL，只要主程序和DLL在同一目录下，就可以被正常加载调用。
3. 生成工程并编译
   • 将OpenCASCADE源码解压到无中文、无空格的路径下，比如D:\dev\occt\src，避免路径特殊字符导致生成失败。
   • 打开和genproj适配版本匹配的MSVC开发命令行（比如适配VS2017的genproj不要在VS2022的命令行环境下运行），切换到OpenCASCADE源码的根目录。
   • 执行带参数的genproj命令，比如genproj -vcvars=vc14,vs2017 -TKern -TKBin指定需要编译的模块，命令执行完成后会在源码根目录生成对应版本的VS解决方案.sln文件。
   • 用MSVC打开生成的解决方案，手动在工程属性中指定Tcl、FreeType等第三方依赖的路径，即可开始编译。

• 常见问题排查：如果运行genproj.exe直接报缺失DLL，说明获取的资源不完整，需要更换完整资源包；如果生成的工程打开后提示路径不存在，删除源码目录下的gen_conf缓存文件夹，重新执行生成命令即可。

内容的提问来源于stack exchange，提问作者Mahesh Srirang Patil