学习使用CMake构建工程

本文记录学习使用CMake的过程。

安装CMake请参考：
http://blog.csdn.net/alex_my/article/details/17310001
本文使用Win7X64, VS2012。

参考了这篇文章：

/article/8584756.html

本文所用到的代码已打包：
http://download.csdn.net/detail/alex_my/6904069
请耐心一行行的看下去!

目录：

1、单个文件示例；

2、多个文件示例；

3、生成库文件示例；

4、多个目录示例；

5、指定输出目录示例；

6、编译动态库示例；

7、使用CMake生成sln项目；

0、一些信息：

SET 命令用于设置变量

ADD_EXECUTABLE 告诉工程生成一个可执行文件

ADD_LIBRARY 告诉工程生成一个库文件

1、单个文件示例：

1) 首先建立文件夹CMakeTest/Src

2) 在文件夹Src中建立两个文件main.c和CMakeLists.txt

3) main.c:

#include <stdio.h>

int main()

{

printf("hello world.");

getchar();

return 0;

}

4) CMakeLists.txt

PROJECT (HELLO)

SET (SRC_LIST main.c)

ADD_EXECUTABLE (hello ${SRC_LIST})

5) 打开：开始--Microsoft Visual Studio 2012--Visual Studio Tools--VS2012 x86 Native Tools Command Prompt

6) 进入到CMakeTest/build/Src目录，执行以下代码

mkdir build & cdbuild

cmake .. -G"NMake Makefiles"

nmake

运行结果如下两张图：

# 插入图片cmake_step11.png



# 插入图片cmake_step12.png



7) Src/build下生成hello.exe。

2、多文件示例

1) 建立文件夹CMakeTest/Src2

2) 在文件夹Src2中建立三个文件：main.c, hello.h, hello.c

3) hello.h

#ifndef __SRC2_HELLO_H__

#define __SRC2_HELLO_H__

void Hello2(const char* text);

#endif // __SRC2_HELLO_H__

4) hello.c

#include "hello.h"

#include <stdio.h>

void Hello2(const char* text)

{

if(text)

printf("Hello %s!\n", text);

}

5) main.c

#include "hello.h"

int main()

{

Hello2("Alex");

getchar();

return 0;

};

6) CMakeLists.txt

PROJECT (HELLO)

SET (SRC_LIST main.c hello.c)

ADD_EXECUTABLE (hello ${SRC_LIST})

7) 通过VS2012 x86 Native Tools Command Prompt 进入到Src3，执行与1 相同的代码：

mkdir build & cdbuild

cmake .. -G"NMake Makefiles"

nmake

8) Src3/build下生成hello.exe。

3、生成库文件示例

1) 建立文件夹CMakeTest/Src3。

2) 将Src2目录下的hello.c, hello.h, main.c, CMakeLists.txt复制到Src3中。

3) 修改CMakeLists.txt

PROJECT (HELLO)

SET (SRC_LIBHELLO hello.c)

SET (SRC_APP main.c)

ADD_LIBRARY (libhello ${SRC_LIBHELLO})

ADD_EXECUTABLE (hello ${SRC_APP})

TARGET_LINK_LIBRARIES(hello libhello)

4) 通过VS2012 x86 Native Tools Command Prompt 进入到Src3，执行与1 相同的代码：

mkdir build & cdbuild

cmake .. -G"NMake Makefiles"

nmake

5) Src3/build下生成hello.exe。

6) 如果想指定生成库的名称,可以添加一句：

SET_TARGET_PROPERTIES(libhello PROPERTIES OUTPUT_NAME "hello")

4、多个目录示例

1) 建立文件夹CMakeTest/Src4，在Src4中建立文件夹lib和src。

2) 将Src2中的hello.h, hello.c复制到Src4/lib中。

3) 将Src2中的main.c复制到Src4/src中。

4) 在Src4根目录下新建文件CMakeLists.txt。

内容：

PROJECT (HELLO)

ADD_SUBDIRECTORY (src)

ADD_SUBDIRECTORY (lib)

5) 在Src4/lib中新建文件CMakeLists.txt。

内容：

CMAKE_MINIMUM_REQUIRED (VERSION 2.8)

SET (SRC_LIB hello.c)

ADD_LIBRARY(libhello ${SRC_LIB})

6) 在Src4/src中新建问价CMakeLists.txt。

内容：

CMAKE_MINIMUM_REQUIRED (VERSION 2.8)

INCLUDE_DIRECTORIES (${PROJECT_SOURCE_DIR}/lib)

SET (SRC_APP main.c)

ADD_EXECUTABLE (hello ${SRC_APP})

TARGET_LINK_LIBRARIES (hello libhello)

7) 通过VS2012 x86 Native Tools Command Prompt 进入到Src4，执行与1 相同的代码：

mkdir build & cdbuild

cmake .. -G"NMake Makefiles"

nmake

8) Src4/build下生成hello.exe。

9) ADD_SUBDIRECTORY命令告诉CMake去子目录中查找可用的CMakeLists.txt文件。

INCLUDE_DIRECTORIES命令用来指明头文件所在路径。

5、指定输出目录示例

1) 将执行文件和库文件输出到指定文件中。二者可以存放到不同的目录下，也可以存放到相同的

目录下，本文存放到相同的目录下。

2) 新建文件夹CMakeTest/Src5。

3) 将Src4中的内容除build之外复制到Src5中。

4）修改Src5/lib中的CMakeLists.txt。

CMAKE_MINIMUM_REQUIRED (VERSION 2.8)

SET (SRC_LIB hello.c)

ADD_LIBRARY(libhello ${SRC_LIB})

# 添加以下这句，注意/bin要与"}"紧贴，bin文件夹如果不存在，会自动创建。

SET (LIBRARY_OUTPUT_PATH ${PROJECT_BINARY_DIR}/bin)

5）修改Src5/src中的CMakeLists.txt。

CMAKE_MINIMUM_REQUIRED (VERSION 2.8)

INCLUDE_DIRECTORIES (${PROJECT_SOURCE_DIR}/lib)

SET (SRC_APP main.c)

# 添加这句，将lib存放到与执行文件相同的目录下，也可以存放到不同目录。

SET (EXECUTABLE_OUTPUT_PATH ${PROJECT_BINARY_DIR}/bin)

ADD_EXECUTABLE (hello ${SRC_APP})

TARGET_LINK_LIBRARIES (hello libhello)

6) 通过VS2012 x86 Native Tools Command Prompt 进入到Src5，执行与1 相同的代码：

mkdir build & cdbuild

cmake .. -G"NMake Makefiles"

nmake

7) Src5/build/bin下生成hello.exe。

6、编译动态库示例

1) 新建文件夹CMakeTest/Src6。

2) 将Src5中的内容除build之外复制到Src6中。

3) 修改Src6/lib文件夹中的hello.h

内容：

#ifndef __HELLO_H__

#define __HELLO_H__

#ifdef WIN32

#if LIBHELLO_BUILD

#define LIBHELLO_API __declspec(dllexport)

#else

#define LIBHELLO_API __declspec(dllimport)

#endif // #ifdef LIBHELLO_BUILD

#else

#define LIBHELLO_API

#endif // #ifdef WIN32

LIBHELLO_API void Hello2(const char* text);

#endif // __HELLO_H__

7) 修改Src6/lib文件夹中的CMakeLists.txt

内容：

CMAKE_MINIMUM_REQUIRED(VERSION 2.8)

SET(SRC_LIB hello.c)

ADD_DEFINITIONS("-DLIBHELLO_BUILD")

ADD_LIBRARY(libhello SHARED ${SRC_LIB})

SET(LIBRARY_OUTPUT_PATH${PROJECT_BINARY_DIR}/bin)

8) 通过VS2012 x86 Native Tools Command Prompt 进入到Src6，执行与1 相同的代码：

mkdir build & cdbuild

cmake .. -G"NMake Makefiles"

nmake

9) Src6/build/bin下生成hello.exe。将Src6/build/lib下的libhello.dll和libhello.lib拷贝到bin目录，运行hello.exe;

7、使用CMake生成sln项目

1) 以上是一些基本应用，现在我们将要生成sln项目供VS直接使用，当然，也可以生成供XCODE使用或者linux等等。

2) 本机配置：WIN7 X64，VS2012 X64。本次使用CMakeTest/Src5做为示例。

3) 运行CMake, 将Src5包含在源文件中，在Src5下新建build目录(也可以先不建，会自动生成)，将其包含到生成文件中。

如图：

# 配图 cmake_step71.png



4) 运行上图中红框指示的Configure按钮，在弹出框中选择Visual Studio 11 WIN64（根据你的需要进行选择，注意的是VS2012 对应

的版本号是110，因此选11， VS2010 对应的版本号是100，因此选10）。点击下图中红框指示的Finish按钮。

# 配图 cmake_step72.png



5) 运行结束后如下图所示，如果有错误，会在红框指示区提示。请再次点击 Configure按钮。

# 配图 cmake_step73.png



6) 运行结束后如下图所示, 然后请点击Generate按钮。

# 配图 cmake_step74.png



7) 打开CMakeTest/Src5/build，会发现生成的HELLO.sln。

# 配图 cmake_step75.png



8) 用VS2012将项目打开，选择ALL_BUILD为启动项，编译。

# 配图 cmake_step76.png