Learn CMake(4)--链接库文件

发表于 | 分类于 | | 阅读次数:

很多时候我们都要在程序中链接外部库文件，不论是我们自己创建的，还是第三方的（例如OpenCV）。这里介绍如何使用CMake来方便的在项目中链接库文件。

链接自己的创建的库文件

沿用上一个示例中创建的库文件，文件目录：

1
2
3
4
5
6
7
8
9
10
11
12
aincrad@Inspiron:~/Desktop/HelloWorld$ tree
.
├── CMakeLists.txt
├── include
│   └── HelloWorld.h
├── lib
│   ├── libHelloWorld.a
│   └── libHelloWorld.so
└── src
    └── main.cpp

3 directories, 5 files

将库文件放在了lib文件夹中，因为有了库文件所以我们不再需要HelloWorld.cpp。

CMakeLists.txt中的内容：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
cmake_minimum_required(VERSION 3.5.1)
project(HelloWorld_lib)

#For the shared library:
set(PROJECT_LINK_LIBS libHelloWorld.so)
link_directories(lib)

#For the static library:
#set(PROJECT_LINK_LIBS libHelloWorld.a)
#link_directories(lib)

include_directories(include)

add_executable(hello src/main.cpp)
target_link_libraries(hello ${PROJECT_LINK_LIBS})

源文件main.cpp中的内容：

1
2
3
4
5
6
7
#include "../include/HelloWorld.h"

int main(int argc, char* argv[]){
    HelloWorld hi;
    hi.sayHello();
    return 0;
}

链接第三方库文件

CMake提供了一个find_package()命令来搜寻这些依赖库。比如，如果我们需要链接OpenCV库文件，可以加入以下几条命令：

1
2
find_package(OpenCV REQUIRED)
include_directories(${OpenCV_INCLUDE_DIRS})

然后在add_executable()之后链接库文件：

1
target_link_libraries(hello ${OpenCV_LIBS})

<NAME>_FOUND，<NAME>_INCLUDE_DIRS和<NAME>_LIBS是相应库的.cmake文件中定义好的。

find_package()并不能保证一定可以找到相应的库，如果找不到，就需要我们手动添加路径了，类Unix系统一般都在/usr/local/include和/usr/local/lib路径下。在CMakeLists.txt文件中添加以下路径。

1
2
include_directories(/usr/local/include)
link_directories(/usr/local/lib)

或者如果我们知道库源文件的具体位置(以OpenCV为例)，但其没有安装到系统目录中，添加以下命令：

1
set(OpenCV_DIR /home/aincrad/opencv/_build)

其中第二个参数是对应库在自己计算机上的路径。

OpenCV示例

文件目录：

1
2
3
4
5
6
7
aincrad@Inspiron:~/Desktop/opencv$ tree
.
├── CMakeLists.txt
├── lena_color.png
└── main.cpp

0 directories, 3 files

CMakeLists.txt中的内容：

1
2
3
4
5
6
7
8
cmake_minimum_required(VERSION 3.5.1)
project(HelloWorld_lib)

find_package(OpenCV REQUIRED)
include_directories(${OpenCV_INCLUDE_DIRS})

add_executable(img main.cpp)
target_link_libraries(img ${OpenCV_LIBS})

main.cpp中的内容：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
#include <stdio.h>
#include <opencv2/opencv.hpp>

using namespace cv;

int main(int argc, char** argv ){
    if ( argc != 2 )
    {
        printf("usage: DisplayImage.out <Image_Path>\n");
        return -1;
    }
    Mat image;
    image = imread(argv[1], 1);
    if ( !image.data )
    {
        printf("No image data \n");
        return -1;
    }
    namedWindow("Display Image", WINDOW_AUTOSIZE );
    imshow("Display Image", image);
    waitKey(0);
    return 0;
}

终端中执行以下命令后：

1
2
3
4
5
$ mkdir build
$ cd build
$ cmake ..
$ make
$ ./img ../lena_color.png

显示出lena的图片：
lena

参考链接

Introduction to CMake by Example
Jermmy’s Lazy Blog–cmake学习笔记
Using OpenCV with gcc and CMake
CMake如何查找链接库—find_package的使用方法
CMake之find_package