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文件夹。

粘贴以下内容：

{
    // See https://go.microsoft.com/fwlink/?LinkId=733558
    // for the documentation about the tasks.json format
    "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": ""
            }
        },