windows环境下基于3DSlicer 源代码编译搭建工程开发环境详细操作过程和中间关键错误解决方法说明

说明该文档适用于 首次/重新 搭建3D-Slicer工程环境 Clean up非增量 编译生成1. 3D-slicer 软件介绍13D Slicer为处理MRI\CT等图像数据软件可以实行基于MRI图像数据的目标分割、标记测量、坐标变换及三维重建等功能其源于3D slicer 4.13.0-2022-01-19开源代码框架并进行moudles和扩展模块的增删而编译生成。23D-slicer 源代码自官网github checkout 到本地以后需编译生成解决方案工程并build以生成软件的开发调试版本debug和软件发布版本release)。https://download.slicer.org/https://github.com/Slicer/Slicer2. 3D-slicer 软件编译生成如3D slicer 4.13软件的解决方案生成及编译对PC电脑的配置、软件安装环境、畅通访问github网站等条件具有同样严格的配置要求和工序流程。1编译准备为了满足编译3D slicer软件的先决条件首先应查阅Slicer官方文档https://slicer.readthedocs.io/en/latest/developer_guide/build_instructions/windows.html详细了解其需要的配置条件。具体软件条件如下可见编译生成3D-slicer软件应在编译设备PC机上首先应安装了满足条件的Cmake、Git、Visual Studio、Qt5、NSIS(打包选)。如我们编译3D-slicer 应该选择硬件配置较好i5/i7内存8G有GPU模块的PC机并可以安装如下软件版本 Windows 10 21H2 x64Windows SDK 19041 Git 2.34.1 https://git-scm.com/downloads CMake 3.22.2(https://cmake.org/files/安装默认路径、add到环境变量、创建桌面快捷方式 Qt 5.15.2(https://mirrors.tuna.tsinghua.edu.cn/help/qt/)安装MSVC2019 64-bit, QtWebEngine,… Visual Studio 2019https://visualstudio.microsoft.com/zh-hans/vs/older-downloads/ SVN 代码管理工具https://tortoisesvn.net/downloads.html安装参考学习网站https://qiqij.notion.site/VS2019-Qt5-15-2-50ff5de3bd01474390821d2d3a57e364https://blog.csdn.net/qq_41368848/article/details/1290773472编译配置1清理环境变量中一切python配置建议卸载已安装的所有python因为slicer生成有自带依赖的python版本当PC机提前装有python,并配置环境变量易造成编译时python链接错误而生成失败问题。2在PC盘规划并新建好源代码和编译生成文件夹路径要求源代码和编译生成路径均无中文建议无空格、下划线、横杠、斜杠等特殊字符且其绝对路径长度均应126字符。3自服务器经SVN checkout Slicer 源代码到规划好的本地目录。4配置好本地网络环境(需要科学上网开启全代理确保网路不中断且git hub可以自由访问。5打开Cmake-gui界面选中输入、输出路径并配置生成解决方案环境。如路径应命名简短、且有代表意义如SlicerORG文件夹表示的是源代码路径SlicerBD 表示Slicer-build-debug,也就是生成Slicer的debug解决方案路径。Configure进入配置界面Visual studio 19 应与编译准备阶段的安装版本匹配platform应配置为X64。Finish。》》Configure update经Configure 按键多次update 直到页面无红色填色标记且输出信息栏显示Configure done。 常见error1 Qt5_DIR not found解决方法在Cmake-gui界面把Qt5_DIR 的value引用本地Qt 5.15.2的安装路径。如C:\Qt\5.15.2\msvc2019_64\lib\cmake\Qt5具体由PC中安装Qt5.15.2的路径决定。2 Missing:Path_EXECUTABLE解决办法在Cmake-gui界面把Path_EXECUTABLE 的value 路径修改为将本地安装Git下的patch.exe。如C:/Program Files (x86)/Git/usr/bin/patch.exe具体由安装时patch.exe的位置决定。3 信息提示栏显示http://github… 之类的网址错误该错误表示设备没有办法打开github网站无法下载解决办法应该检查网络配置科学上网开通全代理确保github可以访问畅通。3编译生成解决方案框架当cmake执行完configure done 且无error异常后为了缩短编译时间可以去掉选中BUILD TESTING 和Slicer_USE_QtTesting选项可以避免编译生成过程中下载test数据占用过长时间。其他选项建议保持默认。Generate 生成解决方案框架直到Generate done并通过Open Project经VS 2019打开解决方案此时源代码的框架解决方案49个已经生成。4生成过程技巧及错误解决1网络保持科学上网、代理全开能够畅通访问github。2提前拷贝build过程中工程会自动下载很多包到路径属于边下载边编译生成的过程可以思想把下载好的包放至目标路径以节省上网卡顿时间。如在VS build之前把如下CTK、Open SSL、Python、tbb等5个包拷贝至之前规划的解决方案生成路径SlicerBD文件夹下将如下swigwin-4.0.2.zip包拷贝至解决方案生成文件夹SlicerBD下的Swig-prefix\src路径下。以上资源文件详见https://download.csdn.net/download/learner_jj/895336193生成在经VS2019 打开的解决方案中选种ALL BUILD 右键生成即启动build。持续保持科学上网过程中应逐层解决错误多轮反复生成ALL BUILD直到所有解决方案生成成功。每一轮生成过程是逐步增量编译的过程每一轮生成完成后继续生成不是重新生成。生成时间比较漫长需要足够的耐心第一轮生成完成网络不佳预估7-10小时第2轮4-6小时第三轮3小时左右时间依次递减错误依次减少成功生成解决方案越来越多。经验预估计需要生成3~5轮最终全部生成成功。 编译ALLBUILD错误解决方案》》download 错误均是由于网路不稳定链接下载/访问失败在保持代理开的前提下反复生成增量下载经多轮生成以后可以解决。》》Python 错误该错误需要暂时关闭代理但是不关闭网络生成一轮后即可以解决此类问题。待python问题解决以后仍然需要打开代理科学上网。》》PythonQt 错误单独重新编译SlicerBD文件夹下CTK-build 路径下PythonQt 工程ALL BUILD可以解决很多PythonQt error。》》CTK 错误https://blog.csdn.net/Topsort/article/details/129217485