cmake构建静态或动态库(三)

前言

前文的的最终目标都是构建一个可执行文件,本文目标是如何构建静态库或者动态库
目标如下:
1、创建一个静态库libmath.a,提供一个函数接口double power(double base, int exponent);供外部调用
2、创建一个动态库libmath.so,提供一个函数接口double power(double base, int exponent);供外部调用
3、同时构建一个静态库libmath.a和一个动态库libmath.so,提供一个函数接口double power(double base, int exponent);供外部调用
4、构建动态库时添加版本号,提供一个函数接口double power(double base, int exponent);供外部调用

代码准备

创建sample6目录,然后创建src文件夹,将sample2中Math.h Math.cpp拷贝到src中,创建构建目录 build,最终目录如下:

./sample6
    |
    +--- CMakeLists.txt
    |
    +--- src/
          +--- CMakeLists.txt
          |
          +--- Math.h
          |
          +--- Math.cpp

工程根目录下CMakeLists.txt内容为:

# CMake 最低版本号要求
cmake_minimum_required (VERSION 2.8)
# 项目工程名
project (sample6)
message(STATUS "root This is BINARY dir " ${PROJECT_BINARY_DIR})
message(STATUS "root This is SOURCE dir " ${PROJECT_SOURCE_DIR})

# 添加子目录
ADD_SUBDIRECTORY(src)

构建静态库

这里构建libmath.a静态库,那么src目录下CMakeLists.txt文件内容为:

message(STATUS "src This is BINARY dir " ${PROJECT_BINARY_DIR})
message(STATUS "src This is SOURCE dir " ${PROJECT_SOURCE_DIR})

# 定义源文件列表
AUX_SOURCE_DIRECTORY(. SRC_LIST)

# 指定最终生成的可执行文件的路径
SET(LIBRARY_OUTPUT_PATH ${PROJECT_BINARY_DIR}/lib)

# 指定生成目标 目标名字随便写;${SRC_LIST}代表前面定义的源文件列表变量
ADD_LIBRARY(math ${SRC_LIST})

上一篇文章用EXECUTABLE_OUTPUT_PATH指定最终可执行程序的生成路径,这里用LIBRARY_OUTPUT_PATH指定最终静态库或者动态库的生成路径,所以这里最终的libmath.a静态库将在build/lib目录下生成

ADD_EXECUTABLE()用来构建可执行程序,这里用ADD_LIBRARY()来构建静态库或者动态库

ADD_LIBRARY(libname [SHARED|STATIC|MODULE] [EXCLUDE_FROM_ALL]

  • libname代表要生成的静态库或者动态库的名字,名字前不用带lib 系统会自动加上。比如要生成libmath库名,写math就好
  • [SHARED|STATIC|MODULE] 分别表示构建动态库(一般.so结尾,mac os 系统为.dyld)、(.a)静态库、动态库(mac os 系统为.so,如果不支持 则当做SHARED看待);默认参数为STATIC
  • EXCLUDE_FROM_ALL 意思是这个库不会被默认构建,除非有其他的组件依赖或者手工构建

接下在build目录下执行 cmake .. ;make 成功后将在build/lib目录下生成libmath.a静态库

构建动态库

这里构建libmath.so动态库,只需要将上一步骤中ADD_LIBRARY(math ${SRC_LIST})改成ADD_LIBRARY(math SHARED ${SRC_LIST})即可,那么src目录下CMakeLists.txt文件内容为:

message(STATUS "src This is BINARY dir " ${PROJECT_BINARY_DIR})
message(STATUS "src This is SOURCE dir " ${PROJECT_SOURCE_DIR})

# 定义源文件列表
AUX_SOURCE_DIRECTORY(. SRC_LIST)

# 指定最终生成的可执行文件的路径
SET(LIBRARY_OUTPUT_PATH ${PROJECT_BINARY_DIR}/lib)

# 指定生成目标 目标名字随便写;${SRC_LIST}代表前面定义的源文件列表变量
ADD_LIBRARY(math MODULE ${SRC_LIST})

tips:
我这里的环境是mac os x,如果用SHARED则生成的是.dyld动态库,换成MODULE才生成的是.so动态库;其它linux/unix系统可以试试

同时构建静态库和动态库

上面两个步骤是分别构建静态库和动态库,如何同时构建libmath.a静态库和libmath.so动态库呢?如果再src的CMakeLists.txt文件的最后添加构建ADD_LIBRARY(math MODULE ${SRC_LIST})和ADD_LIBRARY(math STATIC ${SRC_LIST}) 会怎样?试着执行发现会提示错误:
"ADD_LIBRARY cannot create target "math" because another target with thesame name already exists."

也就是ADD_LIBRARY()或者ADD_EXECUTABLE()指令同一构建目标同时只能出现一次

那如果改成ADD_LIBRARY(math MODULE ${SRC_LIST})和ADD_LIBRARY(static_math STATIC ${SRC_LIST}) 会怎样?试着执行发现最终构建成功,再build/lib目录下同时生成了libstatic_math.a和libmath.so两个文件

如果要同时生成libmath.a和libmath.so两个库,方法为:
使用指令实现 SET_TARGET_PROPERTIES(target1 target2 ... PROPERTIES prop1 value1 prop2 value2 ...)

1、它可以指定构建静态库目标的最终库名
2、它可以指定构建动态库目标的版本号

首先实现指定构建静态库目标的最终库名,所以要实现同时生成libmath.a和libmath.so两个库那最终的CMakeLists.txt文件内容为:

message(STATUS "src This is BINARY dir " ${PROJECT_BINARY_DIR})
message(STATUS "src This is SOURCE dir " ${PROJECT_SOURCE_DIR})

# 定义源文件列表
AUX_SOURCE_DIRECTORY(. SRC_LIST)

# 指定最终生成的可执行文件的路径
SET(LIBRARY_OUTPUT_PATH ${PROJECT_BINARY_DIR}/lib)

# 指定生成目标 目标名字随便写;${SRC_LIST}代表前面定义的源文件列表变量
ADD_LIBRARY(math MODULE ${SRC_LIST})
# 指定静态库名 
ADD_LIBRARY(math_static STATIC ${SRC_LIST})
# 改变最终生成的静态库的名字
SET_TARGET_PROPERTIES(math_static PROPERTIES OUTPUT_NAME math)
# 获取指定构建目标的指定属性的值;这里获取math_static的属性OUTPUT_NAME值赋值给OUTPUT_VALUE变量
GET_TARGET_PROPERTY(OUTPUT_VALUE math_static OUTPUT_NAME)
MESSAGE(STATUS "This is the math_static OUTPUT_NAME:" ${OUTPUT_VALUE})

SET_TARGET_PROPERTIES(math_static PROPERTIES OUTPUT_NAME math),会将默认的库名math_static改成math

重新再build目录下执行 cmake ..;make,最终在buil/lib目录下生成libmath.a和libmath.so两个库

GET_TARGET_PROPERTY(VAR target property) 与前面的指令对应

  • 获取指定目标target的属性property值并赋值给VAR变量

构建动态库时添加版本号

为了实现动态库版本号,我们仍然需要使用SET_TARGET_PROPERTIES 指令,具体方法为:
SET_TARGET_PROPERTIES(math PROPERTIES VERSION 1.2 SOVERSION 1)

  • VERSION 指代动态库版本,SOVERSION 指代API版本。

最终CMakeLists.txt文件内容如下:

message(STATUS "src This is BINARY dir " ${PROJECT_BINARY_DIR})
message(STATUS "src This is SOURCE dir " ${PROJECT_SOURCE_DIR})

# 定义源文件列表
AUX_SOURCE_DIRECTORY(. SRC_LIST)

# 指定最终生成的可执行文件的路径
SET(LIBRARY_OUTPUT_PATH ${PROJECT_BINARY_DIR}/lib)

# 指定生成目标 目标名字随便写;${SRC_LIST}代表前面定义的源文件列表变量
ADD_LIBRARY(math SHARED ${SRC_LIST})

# 给动态库添加版本号
SET_TARGET_PROPERTIES(math PROPERTIES VERSION 1.2 SOVERSION 1)

重新构建,最终在build/lib中生成三个文件动态文件
libmath.1.2.dylib、libmath.1.dylib、libmath.dylib

  • 可能有人会注意了,这里ADD_LIBRARY()指令怎么会变成 SHARED,由于我这里使用的是MAC OS 系统,如果换成MODULE 会失败,提示
    "clang: error: invalid argument '-compatibility_version 1.0.0' only allowed with '-dynamiclib'"

至此,目标全部实现

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 212,686评论 6 492
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,668评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 158,160评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,736评论 1 284
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,847评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,043评论 1 291
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,129评论 3 410
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,872评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,318评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,645评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,777评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,470评论 4 333
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,126评论 3 317
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,861评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,095评论 1 267
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,589评论 2 362
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,687评论 2 351

推荐阅读更多精彩内容