CMake 编译静态库和动态库

最新推荐文章于 2025-07-11 17:51:27 发布

转载最新推荐文章于 2025-07-11 17:51:27 发布 · 2.8w 阅读

文章标签：

#cmake #库

cmake 专栏收录该内容

7 篇文章

订阅专栏

本文档为CMake初学者提供了一步一步的指南，详细介绍了如何使用CMake进行项目构建，包括配置目录结构、编译静态库和动态库、链接库文件等基本操作。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

原文: http://blog.youkuaiyun.com/yangfeng2014/article/details/50614406

本帖子适用于初学者，StepByStep的入门CMake，CMake也是一门编程语言，只不过是针对编译和链接这种程序构建的过程的语言，学习基本语法就可以初步入门，后面需要什么复杂的功能，进阶掌握需要自己去查找官方文档，后续会给出查阅的一些方式

软件平台

Win 7
VMware Workstation 12 Pro
Ubuntu 15.10
CMake 3.2.2

case 4

目录结构

+
| 
+--- CMakeLists.txt
/--+ src/
   |
   +--- CMakeLists.txt
   /--+ hellolib/
      |
      +--- CMakeLists.txt  
      /--+ include/
         |
         +--- hello.h 
      /--+ src/
         |
         +--- hello.cpp      
|
/--+ build/
   |
   /--+ lib/
      |
      +--- libhello.so
 1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

文件内容

//   /CMakeLists.txt
CMAKE_MINIMUM_REQUIRED(VERSION 2.8)
PROJECT(HELLOLIB)
ADD_SUBDIRECTORY(src)
 1
2
3
4

//  /src/CMakeLists.txt
CMAKE_MINIMUM_REQUIRED(VERSION 2.8)
ADD_SUBDIRECTORY(hellolib)

 1
2
3
4

//  /src/hellolib/CMakeLists.txt
CMAKE_MINIMUM_REQUIRED(VERSION 2.8)
SET(LIBRARY_OUTPUT_PATH "${PROJECT_BINARY_DIR}/lib")
AUX_SOURCE_DIRECTORY(${PROJECT_SOURCE_DIR}/src/hellolib/src HELLOlib_src)
INCLUDE_DIRECTORIES("${PROJECT_SOURCE_DIR}/src/hellolib/include")
ADD_LIBRARY(hello SHARED ${HELLOlib_src})
 1
2
3
4
5
6

//  /src/hellolib/include/hello.h
# ifndef HELLO_H
# define HELLO_H
# include <iostream>
void HelloFunc();
# endif
 1
2
3
4
5
6

//  /src/hellolib/src/hello.cpp
# include "hello.h"

using namespace std;

void HelloFunc(){
    cout<<"Hello My Linux !"<<endl;
}
 1
2
3
4
5
6
7
8

语法解释

ADD_LIBRARY(hello SHARED ${HELLOlib_src})
添加编译库命令：
SHARED，动态库，libhello.so
STATIC，静态库，libhello.a

SET(LIBRARY_OUTPUT_PATH “${PROJECT_BINARY_DIR}/lib”)
ELIBRARY_OUTPUT_PATH是cmake默认变量，修改它可以把库文件的路径修改，本例子中修改为build/lib

case 5

目录结构

+
| 
+--- CMakeLists.txt
/--+ src/
   |
   +--- CMakeLists.txt
   /--+ hellolib/
      |
      +--- CMakeLists.txt  
      /--+ include/
         |
         +--- hello.h 
      /--+ src/
         |
         +--- hello.cpp      
|
/--+ build/
   |
   /--+ lib/
      |
      +--- libhello.so
      +--- libhello.a
 1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

文件内容

//  /src/hellolib/CMakeLists.txt
CMAKE_MINIMUM_REQUIRED(VERSION 2.8)
SET(LIBRARY_OUTPUT_PATH "${PROJECT_BINARY_DIR}/lib")
AUX_SOURCE_DIRECTORY(${PROJECT_SOURCE_DIR}/src/hellolib/src HELLOlib_src)
INCLUDE_DIRECTORIES("${PROJECT_SOURCE_DIR}/src/hellolib/include")
ADD_LIBRARY(hello SHARED ${HELLOlib_src})
ADD_LIBRARY(hello_static STATIC ${HELLOlib_src})
SET_TARGET_PROPERTIES(hello_static PROPERTIES OUTPUT_NAME "hello")

#SET_TARGET_PROPERTIES(hello PROPERTIES CLEAN_DIRECT_OUTPUT 1)
#SET_TARGET_PROPERTIES(hello_static PROPERTIES CLEAN_DIRECT_OUTPUT 1)

#SET_TARGET_PROPERTIES(hello PROPERTIES VERSION 1.2 SOVERSION 1)
 1
2
3
4
5
6
7
8
9
10
11
12
13

其余同case4

语法解释

INCLUDE_DIRECTORIES(“${PROJECT_SOURCE_DIR}/src/hellolib/include”)
头文件目录包含指令

SET_TARGET_PROPERTIES(hello_static PROPERTIES OUTPUT_NAME “hello”)
一般我们希望同时编译出静态库和动态库，并且命名一致，但是cmake的target不允许重名，所以我们把静态库命名为hello_static，然后通过上述语句修改其输出的名字，为hello，这样就可以在lib目录下生成libhello.a和lobhello.so。

SET_TARGET_PROPERTIES(hello PROPERTIES CLEAN_DIRECT_OUTPUT 1)
如果执行make后只生成了一种库，说明生成第二个库的时候删除了同名的其他库。上面的语句可以显示指定不删除同名的库。

SET_TARGET_PROPERTIES(hello PROPERTIES VERSION 1.2 SOVERSION 1)
一般动态库会包含一个版本号，使用上述命令可以携带版本号：VERSION代表同太苦版本，SOVERSION指代API版本。

case 6

目录结构

+
| 
+--- CMakeLists.txt
/--+ src/
   |
   +--- CMakeLists.txt
   /--+ hellolib/
      |
      +--- CMakeLists.txt  
      /--+ include/
         |
         +--- hello.h 
      /--+ src/
         |
         +--- hello.cpp
   /--+ mycmake/
      |
      +--- CMakeLists.txt 
      /--+ src/
         |
         +--- mycmake.cpp 
|
/--+ build/
   |
   /--+ lib/
      |
      +--- libhello.so
      +--- libhello.a
   /--+ bin/
      |
      +--- mycmake
 1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31

文件内容

//  /src/CMakeLists.txt
CMAKE_MINIMUM_REQUIRED(VERSION 2.8)
ADD_SUBDIRECTORY(hellolib)
ADD_SUBDIRECTORY(mycmake)

 1
2
3
4
5

//  /src/mycmake/CMakeLists.txt
CMAKE_MINIMUM_REQUIRED(VERSION 2.8)
SET(EXECUTABLE_OUTPUT_PATH "${PROJECT_BINARY_DIR}/bin")
AUX_SOURCE_DIRECTORY(${PROJECT_SOURCE_DIR}/src/mycmake/src mycmake_src)
INCLUDE_DIRECTORIES("${PROJECT_SOURCE_DIR}/src/hellolib/include")
LINK_DIRECTORIES("${PROJECT_BINARY_DIR}/lib")
ADD_EXECUTABLE(mycmake ${mycmake_src})
TARGET_LINK_LIBRARIES(mycmake libhello.a)
#TARGET_LINK_LIBRARIES(mycmake libhello.so)
 1
2
3
4
5
6
7
8
9