cmake : add_library详解

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名会根据STATICSHARED成为name.aname.lib
这里的STATICSHARED可不设置,通过全局的BUILD_SHARED_LIBSFALSETRUE来指定
windows下,如果dll没有export任何信息,则不能使用SHARED,要标识为MODULE

添加的库会被输出到以下几个目录
ARCHIVE_OUTPUT_DIRECTORY, LIBRARY_OUTPUT_DIRECTORYRUNTIME_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的属性不同:

  1. 常规的library,其属性以INTERFACE_开头
  2. imported的library,其属性以IMPORTED_开头

INTERFACE_IMPORTED_开头的变量有哪些,参见interface libraries,还需再研究。

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

  1. IMPORTED_LOCATION:标明library在硬盘上的位置,可以用更具体的IMPORTED_LOCATION_的标注,其中的可以是DEBUG/RELEASE或其他
  2. IMPORTED_OBJECTS:标明对象library在硬盘上的位置,相应的有IMPORTED_OBJECTS_来标识具体编译类型
  3. 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添加一个别名,后续可使用来替代

add_library(<name> ALIAS <target>)

使用有如下限制:

  1. 不能是ALIAS
  2. 可用于判断target是否存在、链接。
  3. ALIAS的library不能修改属性,不能调用set_property(), set_target_properties()target_link_libraries()等方法
  4. 不能用于install()

interface library

创建一个接口库,

add_library(<name> INTERFACE [IMPORTED [GLOBAL]])

这类库有属性,能install()exportimported,但可能没有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)

你可能感兴趣的:(cmake,cmake)