学习使用CMake构建工程
本文记录学习使用CMake的过程。
安装CMake请参考:
http://blog.csdn.net/alex_my/article/details/17310001
本文使用Win7X64, VS2012。
参考了这篇文章:
本文所用到的代码已打包:
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;
}
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__
#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);
}
#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;
};
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)
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})
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)
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)
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)
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__
#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)
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