【C++】cMakeLists介绍（以简单的OpenCV展示图片为例）

1. CMakeLists

编写CMakeLists.txt可以调用其他的.h头文件和.so/.a库文件，通过跨平台编译工具CMake，将.cpp/.c/.cc文件编译成可执行文件或者新的库文件。

2. 相关命令行安装

brew install cmake
brew install opencv

3. 编译流程

1. 编写CMakeLists.txt文件；
2. 用cmake命令将CMakeLists.txt文件转化为make所需要的makefile文件；
3. 用make命令编译源码生成可执行程序(父目录，常见.exe格式)或共享库（子目录，.a/.so(shared object)）。

4. CMakeLists的基本结构

命令的官方网站：CMake Reference Documentation

最常用的命令如下(仅供后期查询，初期不需要细看)：

# 本CMakeLists.txt的project名称
# 会自动创建两个变量，PROJECT_SOURCE_DIR和PROJECT_NAME
# ${PROJECT_SOURCE_DIR}：本CMakeLists.txt所在的文件夹路径
# ${PROJECT_NAME}：本CMakeLists.txt的project名称
project(xxx)

# 获取路径下所有的.cpp/.c/.cc文件，并赋值给变量中
aux_source_directory(路径 变量)

# 给文件名/路径名或其他字符串起别名，用${变量}获取变量内容
set(变量 文件名/路径/...)

# 添加编译选项
add_definitions(编译选项)

# 打印消息
message(消息)

# 编译子文件夹的CMakeLists.txt
add_subdirectory(子文件夹名称)

# 将.cpp/.c/.cc文件生成.a静态库
# 注意，库文件名称通常为libxxx.so，在这里只要写xxx即可
add_library(库文件名称 STATIC 文件)

# 将.cpp/.c/.cc文件生成可执行文件
add_executable(可执行文件名称 文件)

# 规定.h头文件路径
include_directories(路径)

# 规定.so/.a库文件路径
link_directories(路径)

# 对add_library或add_executable生成的文件进行链接操作
# 注意，库文件名称通常为libxxx.so，在这里只要写xxx即可
target_link_libraries(库文件名称/可执行文件名称 链接的库文件名称)

通常一个CMakeLists.txt需按照下面的流程：

project(xxx)                                          #必须

add_subdirectory(子文件夹名称)                         #父目录必须，子目录不必

add_library(库文件名称 STATIC 文件)                    #通常子目录(二选一)
add_executable(可执行文件名称 文件)                     #通常父目录(二选一)

include_directories(路径)                              #必须
link_directories(路径)                                 #必须

target_link_libraries(库文件名称/可执行文件名称 链接的库文件名称)       #必须

5. 实例

编写cmakeLists.txt

cmake_minimum_required(VERSION 3.12)
project(c__)

set(CMAKE_CXX_STANDARD 11)

find_package(OpenCV REQUIRED)

include_directories(${OpenCV_INCLUDE_DIRS})
set(CMAKE_CXX_STANDARD 11)

add_executable(c__ main.cpp)

target_link_libraries(c__ ${OpenCV_LIBS})

编写main.cpp

#include
#include
#include 
using namespace cv;

void ImageThreshold(String str) {
    Mat image = imread(str);

    imshow("test_opencv", image);
    waitKey(0);
}
int main() {
    String str = "/Users/xxx/Pictures/me.jpg";
    std::cout << "Hello, world" << std::endl;
    ImageThreshold(str);
    std::cout << str << std::endl;
    return 0;
}

在编写完代码后，在CMakeLists.txt所在目录输入命令，便生成了可执行文件。
mkdir build && cd build && cmake ..
make

Reference

1.【CMake】CMakeLists.txt的超傻瓜手把手教程（附实例源码）

2. mac安装opencv(C++)