Ubuntu上配置VTK开发环境——基于Visual Studio Code 与 GCC

环境说明

vtk版本7.1.1
visual studio 1.16.1
Ubuntu 16.04 + 自带的gcc

编译过程与windows下类似还好，运行自己的代码开始面对cmake与make的各种命令以及文件的编译关系一脸懵逼，特别是一堆头文件的依赖和库依赖不知道从哪加起，瞬间发现visual studio写c++的代码简直是神器。

貌似Linux下比较智能的可以用eclipse（我喜欢的idea开发c++只有收费版），懒得折腾得太多，就选择了个轻量级的visual studio code搭建环境试试。

建议开始前稍微熟悉下cmake+gcc的编译模式，相关命令多基于百度Google，有问题之处欢迎交流。

vtk 环境编译

编译前需要先安装opengl的运行库
sudo apt-get install freeglut3-dev

基于cmake-gui编译，我编译选项中主要修改为：

BUILD_SHARED_LIBS  选中  编译可分享的库文件
CMAKE_BUILD_TYPE    release   如果有调试的需要还需选中debug
CMAKE_INSTALL_PREFIX   （默认位在/usr/local目录下，make install 命令会将编译出的静态链接库放入此目录下）
VTK_USE_CXX11_FEATURES    使用c++11标准
VTK_RENDERING_BACKEND     使用opengl的版本，我的显卡支持opengl，不支持默认的opengl2 !!!! 设置为opengl2可以编译成功但运行时会出错

还可以考虑是否需要编译Python Java等接口，是否需要编译示例代码等

cmake 编译出结果后，在输出目录调用make命令编译（台式机core i3处理器 半个多小时）

编译完成后 make install （不确定没有install会不会出问题）

基于命令行编译使用vtk运行示例代码

复制目录下的代码文件和cmake文件到项目文件夹 vtk-7.1.1/Examples/Tutorial/Step1/Cxx

运行命令：

cmake ./
make

在编译自己的代码时，对CMakeLists.txt文件内容需要略作修改：

PROJECT (myVolumeRendering)

# 1. 如果提示找不到VTK则设置vtk的编译输出路径
SET(ENV{VTK_DIR} /home/Hadoop/vtk-7.1.1/_bin) 

find_package(VTK REQUIRED)
include(${VTK_USE_FILE})

# 2. 此处设置为自己的cpp文件，直接添加即可
SET(SRC_FILES
  myVolumeRender.cpp
  MyVtkTool.cpp)


add_executable(myVolumeRendering ${SRC_FILES})

target_link_libraries(myVolumeRendering ${VTK_LIBRARIES})

配置visual studio code编译运行示例代码

复制目录下的代码文件和cmake文件到项目文件夹 vtk-7.1.1/Examples/Tutorial/Step1/Cxx

重点在于设置tasks.json文件（调用cmake与make命令编译源代码）与launch.json文件（生成的可执行文件运行或调试）

task 文件设置

用vs code打开项目文件夹，ctrl+shift+p, 输入选择 tasks:configure task runner，选择c++ 或者other会在.vscode文件夹下新建一个tasks.json文件。 貌似需要新建build文件夹。

粘贴以下内容：

{//Seehttps://go.microsoft.com/fwlink/?LinkId=733558//forthedocumentationaboutthetasks.jsonformat"version":"2.0.0","options":{"cwd":"${workspaceRoot}/build"},"tasks":[{"taskName":"cmake","command":"cmake","args":["-G","Unix Makefiles","-DCMAKE_BUILD_TYPE=relese",".."]},{"taskName":"make","command":"make","args":[],"group":{"kind":"build","isDefault":true}}]}

launch.json文件设置

f5运行，会提示生成默认的launch.json文件，复制以下内容

{"version":"0.2.0","configurations":[{"name":"(gdb) Launch","type":"cppdbg","request":"launch","program":"${workspaceRoot}/helloa",//此处设置可执行文件名"args":[],//可以设置调试参数等"stopAtEntry":false,"cwd":"${workspaceRoot}","environment":[],"externalConsole":true,"MIMode":"gdb","setupCommands":[{"description":"Enable pretty-printing for gdb","text":"-enable-pretty-printing","ignoreFailures":true}]}]}

cmakelists.txt文件设置

添加vtk的路径（不修改默认的INSTALL_PREFIX路径时不确定），此处设置为cmake的output路径
SET(ENV{VTK_DIR} /home/hadoop/vtk-7.1.1/_bin)

编译运行

1. ctrl+shift+p 输入run task命令，运行cmake
2. 可以同上运行make task（或者直接ctrl+shift+b）
3. F5运行或调试

添加头文件路径 如果不需要代码补全等功能，此步可以省略。

包含头文件的位置会出现绿色波浪线提示找不到头文件，需要指定头文件的路径。点击头文件，然后点击左方出现的黄灯，选择某个设置选项会在.vscode目录下新建c_cpp_properties.json文件，在includePath与browse{path}下添加vtk的包含目录。

在运行cmake task后，build/CMakeFiles/you_execute_name.dir/DependInfo.cmake文件里有相关的包含目录,用带正则表达式的查找替换选项将 "$ 替换为 ", 即可添加后方的逗号。

{"name":"Linux","includePath":[//作用不详，不确定去掉的影响……"/usr/include/c++/5","/usr/include/x86_64-linux-gnu/c++/5","/usr/local/include","/usr/include","/usr/include/x86_64-linux-gnu","${workspaceRoot}","/home/hadoop/vtk-7.1.1/_bin/Common/Core","/home/hadoop/vtk-7.1.1/Common/Core",//……"/home/hadoop/vtk-7.1.1/Utilities/EncodeString"],"defines":[],"intelliSenseMode":"clang-x64","browse":{//用于代码补全"path":["/usr/include/c++/5","/usr/include/x86_64-linux-gnu/c++/5","/usr/local/include","/usr/include","/usr/include/x86_64-linux-gnu","${workspaceRoot}","/home/hadoop/vtk-7.1.1/_bin/Common/Core","/home/hadoop/vtk-7.1.1/Common/Core",//……],"limitSymbolsToIncludedHeaders":true,"databaseFilename":""}},