[cmake][转载]add_library详解

àì夳堔傛蜴生んèń 2022-09-17 04:19 469阅读 0赞

add\_library是写cmake必备的一个函数，但一直没仔细研究过，今天把它折解下。主要参考  
cmake官方文档

normal library  
add\_library(<name> \[STATIC | SHARED | MODULE\]  
\[EXCLUDE\_FROM\_ALL\]  
\[source1\] \[source2 ...\])  
  
添加名为name的库，库的源文件可指定，也可用target\_sources()后续指定。  
库的类型是STATIC(静态库)/SHARED(动态库)/MODULE(模块库)之一。

name属性必须全局唯一  
生成的library名会根据STATIC或SHARED成为name.a或name.lib  
这里的STATIC和SHARED可不设置，通过全局的BUILD\_SHARED\_LIBS的FALSE或TRUE来指定  
windows下，如果dll没有export任何信息，则不能使用SHARED，要标识为MODULE

添加的库会被输出到以下几个目录  
ARCHIVE\_OUTPUT\_DIRECTORY, LIBRARY\_OUTPUT\_DIRECTORY和 RUNTIME\_OUTPUT\_DIRECTORY，详见cmake 常用设定及函数  
设置EXCLUDE\_FROM\_ALL，可使这个library排除在all之外，即必须明确点击生成才会生成

imported library  
add\_library(<name> <SHARED|STATIC|MODULE|OBJECT|UNKNOWN> IMPORTED  
\[GLOBAL\])  
  
这种用法直接导入已经生成的库，cmake不会给这类library添加编译规则。  
这种用法的关键在于添加变量IMPORTED。  
另外，GLOBAL可用于设置这个library为全局可见。  
常规和imported的library的属性不同：

常规的library，其属性以INTERFACE\_开头  
imported的library，其属性以IMPORTED\_开头  
INTERFACE\_和IMPORTED\_开头的变量有哪些，参见interface libraries，还需再研究。

imported的library最重要的几个属性是：

IMPORTED\_LOCATION:标明library在硬盘上的位置，可以用更具体的IMPORTED\_LOCATION\_<CONFIG>的标注，其中的<CONFIG>可以是DEBUG/RELEASE或其他  
IMPORTED\_OBJECTS：标明对象library在硬盘上的位置，相应的有IMPORTED\_OBJECTS\_<CONFIG>来标识具体编译类型  
PUBLIC\_HEADER：如果install这个library的话，这个值保存头文件的目录  
UNKNOWN类型，在不需要明确library类型时使用。

object library  
add\_library(<name> OBJECT <src>...)  
库的类型固定为OBJECT，这种库编译了源文件，但不链接。实际中没用过，没有仔细研究。使用方法：

add\_library(... $<TARGET\_OBJECTS:objlib> ...)  
add\_executable(... $<TARGET\_OBJECTS:objlib> ...)  
alias library（别名库）  
为给定library添加一个别名，后续可使用<name>来替代<target>。

add\_library(<name> ALIAS <target>)  
使用有如下限制：

<target>不能是ALIAS  
可用于判断target是否存在、链接。  
ALIAS的library不能修改属性，不能调用set\_property(), set\_target\_properties()和target\_link\_libraries()等方法  
不能用于install()  
interface library  
创建一个接口库，

add\_library(<name> INTERFACE \[IMPORTED \[GLOBAL\]\])  
这类库有属性，能install()，export和imported，但可能没有build过程。像纯头文件库或完全针对target的设计（这条参见interface libraries）  
所有INTERFACE \_\*属性从如下几个方法中设置  
set\_property()、target\_link\_libraries(INTERFACE)、target\_link\_options(INTERFACE)、target\_include\_directories(INTERFACE)、target\_compile\_options(INTERFACE)、target\_compile\_definitions(INTERFACE)和target\_sources(INTERFACE)。

手工配置库  
参考 cmake引入外部库

静态库

add\_library(baz STATIC IMPORTED)  
set\_target\_properties(baz PROPERTIES  
IMPORTED\_LOCATION\_RELEASE $\{CMAKE\_CURRENT\_SOURCE\_DIR\}/libbaz.a  
IMPORTED\_LOCATION\_DEBUG $\{CMAKE\_CURRENT\_SOURCE\_DIR\}/libbazd.a)  
  
静态库(添加依赖项)

add\_library(bar STATIC IMPORTED)  
set\_target\_properties(bar PROPERTIES  
IMPORTED\_LOCATION\_RELEASE $\{CMAKE\_CURRENT\_SOURCE\_DIR\}/libbar.a  
IMPORTED\_LOCATION\_DEBUG $\{CMAKE\_CURRENT\_SOURCE\_DIR\}/libbard.a  
IMPORTED\_LINK\_INTERFACE\_LIBRARIES baz) \# <-- dependency is here  
  
动态库

add\_library(bar SHARED IMPORTED)  
set\_property(TARGET bar PROPERTY IMPORTED\_LOCATION c:/path/to/bar.dll)  
set\_property(TARGET bar PROPERTY IMPORTED\_IMPLIB c:/path/to/bar.lib) \# 多了lib信息  
add\_executable(myexe src1.c src2.c)  
target\_link\_libraries(myexe bar)  
  
当然，也可以直接引用库文件

TARGET\_LINK\_LIBRARIES(skiaSampleCode  
debug skiaCored.lib  
optimized skiaCore.lib)  
原文链接：https://blog.csdn.net/LaineGates/article/details/108242803