CMakeLists教程详解

发布时间:2023-05-19

一、CMake教程

CMake是一个跨平台的自动化编译和安装工具,可以使用简单的语句来描述所有平台的编译过程,并生成任意类型的本地或跨平台构建文件。CMake是基于树的结构来组织项目的,其中最顶层的目录为项目源代码目录,可以包含多个子目录和文件。 在使用CMake时,需要编写CMakeLists.txt文件来指导构建系统进行编译。CMakeLists.txt文件包含一系列命令,可以用来指定如何构建源代码目录,其中最重要的命令为add_executabletarget_link_librariesadd_executable命令用于指定可执行文件信息,target_link_libraries命令用于指定项目需要链接的库。 以下是一个简单的CMakeLists.txt示例代码:

cmake_minimum_required(VERSION 3.10) 
project(my_project) 
add_executable(my_binary my_source.cpp) 
target_link_libraries(my_binary my_library)

二、CMake Windows教学

CMake可以在Windows上进行编译和构建,但需要进行一些特定的配置。Windows系统需要安装Visual Studio或者MinGW,同时需要安装CMake。 在使用CMake构建Windows应用程序时,需要将CMakeLists.txt文件作为参数传递给CMake,并指定相关的构建生成器。在Visual Studio中,可以使用Visual Studio命令行工具来生成MSBuild项目文件。在MinGW中,可以使用MinGW Makefiles生成器来生成Makefile文件。 以下是一个使用Visual Studio编译Windows应用程序的CMakeLists.txt示例代码:

cmake_minimum_required(VERSION 3.10) 
project(my_project) 
set(CMAKE_CXX_STANDARD 11) 
add_executable(my_binary my_source.cpp) 
target_link_libraries(my_binary my_library)

在上面的示例代码中,我们指定了使用C++11标准进行编译,并使用MSBuild工具来生成Visual Studio项目文件。

三、CMakeLists示例

下面是一个较为完整的CMakeLists示例,用于构建一个C++程序和一个相关的Python模块。

cmake_minimum_required(VERSION 2.8.12) 
# 定义项目名和版本号 
project(my_project VERSION 1.0) 
# 设置C++编译标准 
set(CMAKE_CXX_STANDARD 11) 
# 添加可执行文件 
add_executable(my_binary my_source.cpp) 
# 添加Python模块 
add_subdirectory(pybind11) 
pybind11_add_module(my_module my_module.cpp) 
target_link_libraries(my_module PRIVATE pybind11::module) 
# 添加其他库 
find_package(Boost REQUIRED COMPONENTS system) 
target_link_libraries(my_binary ${Boost_LIBRARIES}) 
# 添加测试 
enable_testing() 
add_test(NAME my_test COMMAND my_binary) 
# 安装目标 
install(TARGETS my_binary DESTINATION bin) 
install(TARGETS my_module DESTINATION lib) 
# 打包项目 
set(CPACK_GENERATOR "TGZ") 
include(CPack) 

在上面的示例代码中,我们使用CMake编译一个C++程序,并添加了一个相关的Python模块。同时,使用了Boost库和pybind11库。我们还添加了一些测试用例,并对项目进行了打包。

四、总结

本文介绍了CMake及其在Windows下的使用,同时提供了一个较为完整的CMakeLists示例,希望对读者有所帮助。