CMake入门实战

本文用来记录基本的Cmake用法，以一个实例，讲解如何通过cmake构建一个一个基本的工程，文件的目录如下：



说明：

• bin文件夹下的debug和release分别存放编译输出的文件和相关依赖的动态库。
• common为公共目录，include为公共头文件，libs里面是公共静态库。
• mysqlpp目录下是当前项目的源代码。
• CMakeList.txt是用来编写组织工程结构配置的文件。

编写CMakeList.txt

CMakeList.txt的详细内容如下，每一个配置都有详细的说明，可以根据实际需求删减部分配置或者增添部分配置。这里的实例是生成一个动态库的

#需要cmake的最低版本
CMAKE_MINIMUM_REQUIRED (VERSION 3.5.2)

#设置一个变量作为工程名字以及输出文件名
SET ( MYSQLPP_LIBRARY_NAME "mysqlpp" )

PROJECT (${MYSQLPP_LIBRARY_NAME})

#头文件包含路径
INCLUDE_DIRECTORIES(
	common/include
	common/include/mysql
)

#预编译宏 所有宏都以 -D 开头
ADD_DEFINITIONS(
	-D_USRDLL
	-DDLL_EXPORTS
	-DUNICODE
	-D_UNICODE
	-DMYSQLPP_MAKING_DLL
	-DHAVE_MYSQL_SSL_SET
)

#静态库库路径
LINK_DIRECTORIES(
	common/libs
)

#添加需要链接的静态库名称(此处添加的是存在debug版本的静态库)
SET(LINK_LIBRARY
	libmysql
)

#配置debug版本静态库的名字后面加 'd',区别debug与release版本，这里规则可能不一样，根据实际情况调整
set (LINK_LIST "")
foreach(x ${LINK_LIBRARY})
    list (APPEND LINK_LIST debug ${x}d optimized ${x})
endforeach()

#头文件
FILE(GLOB CURRENT_HEADERS "mysqlpp/*.h")
SOURCE_GROUP("Header Files" FILES ${CURRENT_HEADERS})

#源文件
FILE(GLOB SOURCES "mysqlpp/*.cpp")

#设置输出路径
set(LIBRARY_OUTPUT_PATH bin)

#指定输出静态库的名字
ADD_LIBRARY(${MYSQLPP_LIBRARY_NAME} SHARED
	${SOURCES} ${CURRENT_HEADERS}
)

#添加所有链接的静态库
target_link_libraries(
	${MYSQLPP_LIBRARY_NAME}

	#只有release版本的库单独写到这里,就是debug与release均链接这个库，不做区分
	ws2_32          

	#存在debug与release两个版本的静态库直接引用上面经过处理的宏
	${LINK_LIST}
)

生成工程文件

以windows下生成指定版本的vs工程文件为例，讲解如何用命令行生成指定版本的vs工程。

1. 打开cmd命令行，切换到CmakeList.txt所在的目录。
2. 输入如下命令并执行：

1. 生成的vs解决方案如下：

   

   说明： -G表示生成的目标工程类型，这里指定的vs2008的工程，默认的32位工程，也可以通过参数指定要生成的工程位数为64为，具体参数如下：

   

到这里，一个简易的基本的cmake配置文件的框架就完成了。cmake功能非常强大，更复杂的功能参考CMake官网。