CMake的add_library与target_link_libraries

一、add_library介绍

使用该命令可以在Linux下生成（静态/动态）库so或者.a文件，Windows下就是dll与lib文件，它有两种命令格式

1.1 第一种格式 ：

 Normal Libraries，add_library命令的格式为

add_library(<name> [STATIC | SHARED | MODULE]
            [EXCLUDE_FROM_ALL]
            [<source>...])

生成一个名为 < name > 的library，注意以下规则：

1. < name > 应该保证在一个项目中的唯一性。
2. 实际生成的library文件名是基于平台的约定规则，比如linux下的lib< name >.a， Windows下的< name >.lib等
3. STATIC,SHARED,MODULE用于指定创建的library类型。
4. STATIC库：生成obj文件后，将其链接成静态库，用于链接到其他targets。
5. SHARED库：生成obj文件后，将其链接成动态库，用于运行时加载。
6. MODULE库：不能链接到其他targets，但是可以用dlopen之类的方法在运行时动态加载。
7. 如果没有明确指定要生成的library的类型到底是STATIC,SHARED还是MODULE。则查看BUILD_SHARED_LIBS变量，如果值为ON，则默认是SHARED，否则默认STATIC。
8. 对于SHARED和MODULE类型的库，POSITION_INDEPENDENT_CODE属性自动置为ON。
9. EXCLUDE_FROM_ALL：表明该target是否从默认构建target中排除。
10. source参数可以使用generator表达式（$ <…>）。

 1.2 第二种格式 ：

生成一个obj文件对象，该对象库只编译源文件，但不链接。

add_library(<name> OBJECT [<source>...])

由add_library()或 add_executable()创建的目标可以使用$<TARGET_OBJECTS:name>这样的表达式作为源引用对象，其中，name是对象库的名称。格式如下:

add_library(... $<TARGET_OBJECTS:name> ...)
add_executable(... $<TARGET_OBJECTS:name> ...)

 二、target_link_libraries的介绍

指定链接给定目标和/或其依赖项时要使用的库。命名的<tartget>必须是由add_executable()或add_library()之类的命令创建的。一般与 link_directories连用（添加外部库的搜索路径 ）

target_link_libraries命令的格式

target_link_libraries(<target> ... <item>... ...)

三、add_library的实例

四个文件hello.h,hello.cpp,main.cpp,CMakelist.txt，目录如下

 hello.h

#include <string>
 
void test(std::string str);

hello.cpp

#include "hello.h"
#include <iostream>
 
void test(std::string str)
{
    std::cout << str << std::endl;
}

main.cpp

#include "hello.h"
#include <iostream>
 
int main(int argc, char** argv)
{
    std::cout << "In main..." << std::endl;
    test("hello, world!");
    return 0;
}

 CMakeList文件

第一种library格式

cmake_minimum_required (VERSION 3.12.1)

project (Demo)

# 生成对象库文件
add_library(hello hello.cpp)

# 添加头文件目录
target_include_directories(hello PUBLIC ${CMAKE_SOURCE_DIR}/public)

# 生成可执行文件
add_executable(Demo main.cpp)

# 链接对象库
target_link_libraries(Demo hello)

第二种library格式

cmake_minimum_required (VERSION 3.12.1)

project (Demo)

# 生成对象库文件
add_library(hello OBJECT hello.cpp)

# 添加头文件目录
target_include_directories(hello PUBLIC ${CMAKE_SOURCE_DIR}/public)

# 添加编译选项 -Wall
target_compile_options(hello PUBLIC -Wall)

# 生成可执行文件
add_executable(Demo main.cpp $<TARGET_OBJECTS:hello>)

# 添加头文件目录
target_include_directories(Demo PUBLIC ${CMAKE_SOURCE_DIR}/public)

编译，运行

 另一种写法

cmake_minimum_required (VERSION 3.12.1)

project (Demo)

# 生成对象库文件，不链接
add_library(hello OBJECT hello.cpp)

# 添加头文件目录
target_include_directories(hello PUBLIC ${CMAKE_SOURCE_DIR}/public)

# 添加编译选项 -Wall
target_compile_options(hello PUBLIC -Wall)

# 生成可执行文件
add_executable(Demo main.cpp)

# 链接对象库
target_link_libraries(Demo hello)

编译，运行

大家习惯通过 $<TARGET_OBJECTS:name>引用object文件。其实object library与静态库，动态库一样，都是可以设置PUBLIC/PRIVATE属性的，再通过target_link_library()命令链接

参考：

add_library — CMake 3.22.0 Documentation

target_link_libraries — CMake 3.22.0 Documentation

cmake指令基础知识_ShawnRacine的博客-CSDN博客
cmake使用示例与整理总结_carl_wang_cn的博客-CSDN博客_cmake使用示例与整理总结