RMVL 的编译、配置选项

目录

• 1. 介绍
• 2. 通用选项
  • 2.1 调试构建
  • 2.2 静态构建与动态构建
  • 2.3 构建测试
  • 2.4 构建有限的模块集
• 3. 功能特性

上一篇教程：安装总览 ↑
下一篇教程：构建并安装 RMVL ↓

---

1. 介绍

配置选项可以通过几种不同的方式设置：

• 命令行：cmake -Doption=value ...
• 初始化缓存文件：cmake -C my_options.txt ...
• 通过GUI进行交互：cmake-gui ..

大多数选项可以在 RMVL 的 cmake 脚本中找到：rmvl/CMakeLists.txt。

可以使用 CMake 工具打印所有可用选项：

cd build
# 初始化配置
cmake ..
# 打印所有选项
cmake -L ..
# 打印所有选项并显示帮助信息
cmake -LH ..
# 打印包含高级变量的所有选项
cmake -LA ..

最常见以及最有用的选项一般均以 BUILD_、WITH_、RMVL_、ENABLE_ 开头。

2. 通用选项

2.1 调试构建

CMAKE_BUILD_TYPE 选项可用于启用调试构建。生成的二进制文件将包含调试符号，并且大多数编译器优化将被关闭。

在某些平台上（例如 Linux），必须在配置阶段设置构建类型：

cmake -DCMAKE_BUILD_TYPE=Debug ..
cmake --build .

在其他平台上，不同类型的构建可以在同一个构建目录下生成（例如Visual Studio，XCode）：

cmake <options> ..
cmake --build . --config Debug

参见

• Build type in CMake documents
• Build type in C++ manual

2.2 静态构建与动态构建

BUILD_SHARED_LIBS 选项控制是否生成动态（*.dll，*.so，*.dylib）或静态（*.a，*.lib）库。默认值取决于目标平台，在大多数情况下它是 OFF。

示例:

cmake -DBUILD_SHARED_LIBS=ON ..

参见

• Static library in Wiki

ENABLE_PIC 启用或禁用 位置无关代码 的生成，在构建动态库或打算链接到动态库的静态库时，必须启用此选项，该选项默认值为ON。

参见

• PIC in Wiki

2.3 构建测试

有两种测试：准确性（rmvl_*_test）和性能（rmvl_*_perf），默认情况下禁用测试。

对应的 CMake 选项:

cmake \
  -DBUILD_TESTS=ON \
  -DBUILD_PERF_TESTS=ON \
  ..

2.4 构建有限的模块集

每个模块都是 modules 目录的一个子目录。可以禁用一个模块：

cmake -DBUILD_rmvl_armor_detector=OFF ..

3. 功能特性

有许多可选的依赖关系和特性可以打开或关闭，CMake 有一个特殊的选项，允许打印所有可用的配置参数：

cmake -LH ..

此外，CMake 在运行后也会通过一系列的 message() 命令输出到终端或 GUI 界面，可在此界面查看部分配置情况。