3DSlicer6：编译、调试、规范化的开发

1.编译

Step1：CMake生成Slicer工程文件

使用Cmake生成Slicer的解决方案（Solution）包括两小点：

• 指定源代码目录：C:/myProjects/Slicer4；目标目录：C:/myProjects/Slicer4-SuperBuild-Debug
• Configure后，添加qmake路径：QT_QMAKE_EXECUTABLE=C:/myProject/Qt-4.6.3/bin/qmake.exe（要根据实际情况进行修改）。Generate后完成工程的创建。

Step2：编译Slicer

打开Slicer.sln，整个工程有28个项目组成，包括我们熟悉的VTK、ITK、DCMTK、CTK等库。鼠标右键点击ALL_BUILD编译所有项目。等待编译完成，大概3~4小时~~~

Notice1：每个项目在工程中所起到的作用不同，其编译过程也遵循一定的顺序，如果其中一个项目处想问题，那么在这个项目编译之后的所有项目都会出错。

Notice2：如果真的很不幸，在编译的过程中出现了错误。考虑到重新编译一次时间太长，可以按照输出窗口的提示进行纠错，然后从此处为起点进行编译。

Notice3：工程中的VTK、ITK等项目的源代码并没有包含在Slicer的源码中，他们是在编译的过程中，利用Git或SVN向远程服务器请求下载。因此编译速度的快慢很大程度上取决于网络环境。

2.调试

编译之后还无法对Slicer的程序进行调试，需要以下几个步骤：

1) cd slicer-superbuild-debug\slicer-build
2) cmake.exe –VV --debug-output .    (注意这里还有一个 . )
3) slicer.exe --VisualStudio slicer.sln /out buildlog.txt /build  然后相关文件生成在切片机构建/ bin /调试目录
4) slicerQt-real.exe 就是调试文件.
5) slicer.exe –VisualStudio slicer.sln  
打开VisualStudio后，浏览左边的项目，将qSlicerQT设置为启动项目，否则会被要求指定调试的项目。

3.Slicer的缺陷跟踪系统

目前，Slicer已经有超过120万代码，并变得越来越庞大。尽管3DSlicer管理人员在各种操作系统、各种硬件设备情况下调试，但由于功能复杂、代码庞大，也会出现管理人员无法发现的问题。

为了保证Slicer软件的质量，以及对功能的完成度进行控制，保证软件开发的顺利进行，3Dslicer项目采用缺陷跟踪系统Mantis对Slicer继续管理。

缺陷管理平台Mantis ，也做MantisBT，全称Mantis Bug Tracker。Mantis是一个基于PHP技术的轻量级的开源缺陷跟踪系统，以Web操作的形式提供项目管理及缺陷跟踪服务。个人可定制的Email通知功能，每个用户可根据自身的工作特点只订阅相关缺陷状态邮件。

报告3DSlicer应用程序相关问题流程：

1.https://issues.slicer.org/view_all_bug_page.php在View Issues中创建一个话题；

2.详细填写问题缘由；

3.箱Slicer开发者邮箱发送一份邮件，邮件中必须包含创建的话题，邮件格式名称如下：[Bug]bug名称。如下所示：

4.规范化的3DSlicer开发

单词缩写的大小写应该保持一致，保持大写或小写。例如

• RASToSlice   √   RasToSlice  ×
• vtkMRML      √    vtkMrml    ×
• vtkSlicer        √    vTKSlicer   ×

单词应该拼写完整。例如

• GetWindow not GetWin

文件名称必须遵循驼峰式大小写约定，例如

• TestMyFeature.cxx not Test-My_Feature.cxx

注释规则

• 大部分注释应该写在头文件中。
• 代码做出修改后及时更新注释。
• 使用关键字“\todo”（待办事项）来标记点需要重新审视的代码。
• 源文件中注释掉的代码块也需要进行注释，如果需要，可以插入svn的版本链接作为注释。

其他规则

• 3D视图中使用RAS坐标。
• 所有单位为毫米表示。
• 每行代码不超过80个字符。