CMake的常用命令
1. cmake_minimum_required(VERSION 2.8) #检查cmake的版本,至少为2.8
2. project(helloworld) #工程名为helloworld
3. aux_source_directory(. SRC_LIST) 查找当前目录下所有的源文件并保存到SRC_LIST变量中
4. include_directories(./include ./abc) 将./include和./abc加入包含目录列表
5. link_directories(./lib) 将 ./lib加入编译器链接阶段的搜索目录列表
6. add_executable(hello $(SRC_LIST}) 使用SRC_LIST源文件列表里的文件生成一个可执行文件hello
7. add_library(hello STATIC ${SRC_LIST}) 使用SRC_LIST源文件列表里的文件生成一个静态链接库libhello.a
8. add_library(hello SHARD ${SRC_LIST}) 使用SRC_LIST源文件列表里的文件生成一个动态链接库libhello.so
9. target_link_libraries(hello a b.a c.so) 将若干库文件链接到目标hello中,target_link_libraries里的库文件的顺序符合gcc/g++链接顺序的规则,即被依赖的库放在依赖它的库的后面,如果顺序有错,链接时会报错。target_link_libraries( … … …) 其中 必须在当前目录中被add_executable()命令或add_library()命令创建出来。
10. 自定义链接选项
11. 自定义Makefile目标
12. FIND_PATH( name1 [path1 path2 …]) 该命令在参数path1, path2…指示的目录中查找文件name1并将查找到的路径保存到变量VAR中
13. FIND_LIBRARY 同FIND_PATH类似,用于查找链接库并将结果保存在变量中
Example:在开发软件的时候我们会用到一些函数库,这些函数库在不同的系统中安装的位置可能不同,编译的时候需要首先找到这些头文件以及链接库所在的目录以便生成编译选项。
小型程序的CMakeLists.txt模板:
cmake_minimum_required(VERSION 2.8) //cmake的最低版本
project(example) //项目名
include_directories("/usr/include") //程序所需头文件的位置
link_directories("/usr/lib") //程序所需库文件的位置
add_executable(example example.cpp) //编译example.cpp生成example对象文件
target_link_libraries(example gsl) //链接libgsl.a链接库文件到example对象文件中
target_link_libraries(example gslcblas) //链接libgslcblas.a链接库文件到example对象文件中
第一步,在项目的根目录中创建目录cmake/modules/, cmake/modules/下创建文件Findlibxx.cmake,内容如下:
MESSAGE(STATUS "Using budled findlibxx.cmake...")
FIND_PATH(
LIB_XX_INCLUDE_DIR
XX.h
/usr/include/
/use/local/include/
)
//在/usr/lib/ 和/usr/local/lib/目录下,寻找名为xx的链接库,并将结果保存在 LIB_XX_LIBRARIES中
FIND_LIBRARY(
LIB_XX_LIBRARIES NAMES XX
PATHS /usr/lib/ /usr/local/lib/
)
第二步,项目的根目录中的CmakeList.txt
project(main)
cmake_minimum_required(version 2.8)
set(CMAKE_SOURCE_DIR .)
set(CMAKE_MODULE_PATH ${CMAKE_ROOT}/Modules ${CMAKE_ROOT}/cmake/modules}
aux_source_directory(. DIR_SRCS)
add_executable(main ${DIR_SRCS})
find_package(XX required)
mark_as_advanced(
LIB_XX_INCLUDE_DIR
LIB_XX_LIBRARIES
)
多目录多CMakeLists.txt
|
|----addlib
|------CMakeLists.txt
|------addfunc.h
|------addfunc.cpp
|----subdll
|------CMakeLists.txt
|------subfunc.h
|------subfunc.cpp
|----main
|------CMakeLists.txt
|------main.cpp
|------func
|------func.h
|------func.cpp
|----CMakeLists.txt
|
根目录下的CMakeLists.txt
# cmake 的最低版本要求
cmake_minimum_required(VERSION 2.8)
#指定项目的名称,一般和项目的文件夹名称对应
project(CMakeDemo)
#设置静态库的输出目录
set(CMAKE_ARCHIVE_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}/${PROJECT_NAME}/lib)
#设置动态库的输出目录
set(CMAKE_LIBRARY_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}/${PROJECT_NAME}/dll)
#设置可执行文件的输出目录
set(CMAKE_RUNTIME_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}/${PROJECT_NAME})
#添加子目录,子目录中的CMakeLists.txt将会被处理
add_subdirectory(addlib)
add_subdirectory(subdll)
#添加子目录,子目录中的CMakeLists.txt将会被处理
add_subdirectory(main)
main 目录下的main.cpp
#include <iostream>
#include "func.h"
int main()
{
int a = 2;
int b = 1;
int ret = -1;
func1(a, b, 1, ret);
std::cout << a << " + " << b << " = " << ret << std::endl;
func1(a, b, 2, ret);
std::cout << a << " - " << b << " = " << ret << std::endl;
return 0;
}
main 目录下的CMakeLists.txt
#CMakeLists.txt
#头文件目录
include_directories(.)
include_directories(..)
include_directories(func)
#include_directories(../addlib)
#include_directories(../subdll)
aux_source_directory(. EXE_DIR_SRCS)
aux_source_directory(func EXE_DIR_SRCS)
message(${EXE_DIR_SRCS})
#添加要编译的可执行文件 前面是生成可执行文件的名称,后面是编译此可执行文件所需要的源文件
#add_executable(${PROJECT_NAME}
#main.cpp
#func/func.cpp
#)
add_executable(${PROJECT_NAME}
${EXE_DIR_SRCS}
func/func.h)
#添加可执行文件所需要的库,比如我们用到了libm.so(命名规则:lib+name+.so),就添加该库的名称
target_link_libraries(${PROJECT_NAME} addlib)
target_link_libraries(${PROJECT_NAME} subdll)
func目录下的func.cpp
#include "func.h"
#include "addlib/addfunc.h"
#include "subdll/subfunc.h"
bool func1(int a, int b, int type, int& result)
{
if(type == 1)
{
result = add(a, b);
return true;
}
else if (type == 2)
{
result = sub(a, b);
return true;
}
else if (type == 3)
{
//result = mul(a, b);
return false;
}
else if (type == 4)
{
//result = dev(a, b);
return false;
}
else
return false;
}
func目录下的func.h
bool func1(int a, int b, int type, int& result);
addlib 目录下的CMakeLists.txt
#addlib/CMakeLists.txt
#将当前目录下的所有源文件保存到变量ADDLIB_DIR_SRCS中
aux_source_directory(. ADDLIB_DIR_SRCS)
#生成静态库
add_library(addlib STATIC
${ADDLIB_DIR_SRCS}
addfunc.h
)
#也可以使用下面的方式,但如果文件较多,上面的方式更好
#add_library(addlib STATIC
#addlib.cpp
#)
addlib目录下的addlib.cpp
#include "addfunc.h"
int add(int a, int b)
{
return a + b;
}
addlib目录下的addlib.h
int add(int a, int b);
subdll 目录下的CMakeLists.txt
#subdll/CMakeLists.txt
#生成动态库
add_library(subdll SHARED
subfunc.cpp
subfunc.h
)
subdll目录下的subdll.cpp
#include "subfunc.h"
int sub(int a, int b)
{
return a * b;
}
subdll目录下的subdll.h
// 导出函数声明,若没有这个声明,外部无法调用dll内部的函数,并且不会生成lib符号文件
__declspec(dllexport) int sub(int a, int b);
// 本示例中是C++调用C++编写的dll,因此没有加extern "C"
以上
另外:
1、设置输出编译文件的输出目录
一. SET(EXECUTABLE_OUTPUT_PATH ${PROJECT_SOURCE_DIR}/…/bin)
上面的语句能设置可执行文件的输出目录
在Win + VS环境下,会自动在你所设置的目录后面扩展一层 目录,所以最终生成的Debug版本程序会在 ${PROJECT_SOURCE_DIR}/…/bin/Debug 目录下,Release版本程序会在 ${PROJECT_SOURCE_DIR}/…/bin/Release 目录下.
在Linux + GCC环境下,无论是Debug还是Release,生成的可执行程序会直接放在你所设置的目录下,不会有差异.
二. SET(LIBRARY_OUTPUT_PATH ${PROJECT_SOURCE_DIR}/…/lib)
上面的语句能设置库文件的输出目录
在Win + VS环境下,会自动在你所设置的目录后面扩展一层 目录,所以最终生成的Debug版本库会在 ${PROJECT_SOURCE_DIR}/…/lib/Debug 目录下,Release版本库会在 ${PROJECT_SOURCE_DIR}/…/lib/Release 目录下.
在Linux + GCC环境下,无论是Debug还是Release,生成的库文件会直接放在你所设置的目录下,不会有差异.
三. set(CMAKE_RUNTIME_OUTPUT_DIRECTORY_DEBUG ${PROJECT_SOURCE_DIR}/…/bin) set(CMAKE_RUNTIME_OUTPUT_DIRECTORY_RELEASE ${PROJECT_SOURCE_DIR}/…/bin)
上面两条语句分别设置了Debug版本和Release版本可执行文件的输出目录,
一旦设置上面的属性,在任何环境下生成的可执行文件都将直接放在你所设置的目录.
四. set(CMAKE_ARCHIVE_OUTPUT_DIRECTORY_DEBUG ${PROJECT_SOURCE_DIR}/…/lib) set(CMAKE_ARCHIVE_OUTPUT_DIRECTORY_RELEASE ${PROJECT_SOURCE_DIR}/…/lib)
上面两条语句分别设置了Debug版本和Release版本库文件的输出目录,
一旦设置上面的属性,在任何环境下生成的库文件都将直接放在你所设置的目录.
五. set(CMAKE_DEBUG_POSTFIX “_d”) set(CMAKE_RELEASE_POSTFIX “_r”)
上面两条语句分别设置了Debug版本和Release版本下库文件的后缀名.
六. set_target_properties( $ {TARGET_NAME} PROPERTIES DEBUG_POSTFIX “_d”) set_target_properties(${TARGET_NAME} PROPERTIES RELEASE_POSTFIX “_r”)
上面两条语句分别设置了Debug版本和Release版本下可执行文件的后缀名.