cmake简单模板（一）—— 编译动态库静态库

用于同时编译生成libhello.a和libhello.so的CMakeLists.txt 模板。

 

#check version
cmake_minimum_required(VERSION 3.5)

#project name
# 工程名称，可随意指定
PROJECT(libhello)

#target name
# 目标文件的名称，如需要编译动态库libabc.so，则TARGET名称应设置为abc
SET(TARGET hello)

#build type
# different build type will use different options
# CMAKE_BUILD_TYPE={DEBUG/MINSIZEREL/RELWITHDEBINFO/RELEASE}
# 预设不同的编译类型，可为每种类型定义不同的编译选项，然后在这里选择编译哪种类型
# 如选择RELEASE类型，可添加一些优化选项，具体的设置在下面
SET(CMAKE_BUILD_TYPE RELEASE)

#install path
# 安装路径
SET(CMAKE_INSTALL_PREFIX ./output)

##
# source
#
# output header files
# 动态库和静态库需要输出的头文件名称
SET(OUTPUT_HEADER_FILES inc/hello.h)

# header file path
# 工程内部用到的头文件路径
INCLUDE_DIRECTORIES(inc/)

# source directory
# 源码目录
AUX_SOURCE_DIRECTORY(src/ SRC_DIR)

##
#compile options
#
# CFLAGS
# 通用编译选项
set(CMAKE_C_FLAGS "-fPIC")
# DEBUG类型指定的编译选项
#set(CMAKE_C_FLAGS_DEBUG "put your flags")
# MINSIZEREL类型指定的编译选项
#set(CMAKE_C_FLAGS_MINSIZEREL "put your flags")
# RELWITHDEBINFO类型指定的编译选项
#set(CMAKE_C_FLAGS_RELWITHDEBINFO "put your flags")
# RELEASE类型指定的编译选项
set(CMAKE_C_FLAGS_RELEASE "-O2")

# LDFLAGS
# force to use local 'global variable'
# 链接选项
set(CMAKE_LD_FLAGS "-Wl,-Bsymbolic")

##
#compile target
#
# compile shared/static library
# 指定编译目标
ADD_LIBRARY(${TARGET} SHARED ${SRC_DIR})
# 不能同时设置两个相同名字的ADD_LIBRARY目标
ADD_LIBRARY(${TARGET}_static STATIC ${SRC_DIR})
#set static library name
SET_TARGET_PROPERTIES(${TARGET}_static PROPERTIES OUTPUT_NAME ${TARGET})

# cmake在构建一个新的target时，会尝试清理掉其他使用这个名字的库，
# 因此，在构建libhello.a时，就会清理掉libhello.so.
# 为了回避这个问题，设置CLEAN_DIRECT_OUTPUT属性为1。
set_target_properties(${TARGET} PROPERTIES CLEAN_DIRECT_OUTPUT 1)
set_target_properties(${TARGET}_static PROPERTIES CLEAN_DIRECT_OUTPUT 1)

##
#install
#
# 安装库文件
INSTALL(TARGETS ${TARGET} ${TARGET}_static 
                LIBRARY DESTINATION lib
                ARCHIVE DESTINATION lib
)
# 安装头文件
INSTALL(FILES ${OUTPUT_HEADER_FILES}
        TYPE INCLUDE
)