CMake学习--如何在CMake中编译静态库、动态库并在主程序中调用

news2025/4/3 17:55:31

一、背景知识

在C/C++开发中，库（Library）是预先编译好的代码集合，可供多个程序使用。根据链接方式不同，库分为静态库和动态库。静态库在编译时将代码直接链接到可执行文件中，可执行文件体积较大，但运行时无需额外库文件；动态库在运行时加载，可执行文件体积小，便于更新和共享，但依赖外部库文件存在。

CMake是一个跨平台的自动化构建工具，通过编写CMakeLists.txt文件来定义项目的构建规则，可以方便地编译静态库、动态库以及主程序，并处理它们之间的依赖关系。

二、使用方法

（一）编译静态库

math作为库项目， app作为测试项目

文章配图

my_math.cpp




#include "my_math.h"

int add(int a, int b) {

    return a + b;
}



int subtract(int a, int b) {

    return a - b;
}

my_math.h


#ifndef MATH_FUNCTIONS_H

#define MATH_FUNCTIONS_H



int add(int a, int b);

int subtract(int a, int b);



#endif

math/CMakeLists.txt


# 设置这个目录项目的最低版本

cmake_minimum_required(VERSION 3.10)



# 定义一个静态库 math

add_library(math STATIC my_math.cpp)



# 设置头文件公共目录，方便其他模块包含

target_include_directories(math PUBLIC ${CMAKE_CURRENT_SOURCE_DIR})

main.c


#include <stdio.h>

#include "../math/my_math.h"



int main() {

    int sum = add(1, 2);
    int difference = subtract(4, 2);


    printf("Sum: %d\n", sum);
    printf("Difference: %d\n", difference);


    return 0;
}

app/CMakeLists.txt


cmake_minimum_required(VERSION 3.10)



# 定义一个可执行文件

add_executable(DemoApp main.cpp)



# 链接 math 静态库

target_link_libraries(DemoApp PRIVATE math)

编写项目根目录下的CMakeLists.txt


cmake_minimum_required(VERSION 3.10)



project(DemoProject VERSION 1.0)



# 添加 math 目录

add_subdirectory(math)



# 添加 app 目录

add_subdirectory(app)

构建项目
在项目根目录下打开终端，执行以下命令：


mkdir build

cd build

cmake ..

cmake --build .

（二）编译动态库

创建项目目录结构同静态库部分。
修改math目录下的math/CMakeLists.txt


cmake_minimum_required(VERSION 3.10)



# 定义一个动态库 math

add_library(math SHARED my_math.cpp)



# 设置动态库的公共头文件位置

target_include_directories(math PUBLIC ${CMAKE_CURRENT_SOURCE_DIR})