源代码下载: CMake-cn
CMake 是一个跨平台且开源的自动化构建零碎工具。通过该工具你能够对你的源代码进行测试、编译或创立安装包。
CMake 试图去解决Makefile 跨平台的主动配置问题(不同的make解释器有不同的命令),以及链接第三方库时的易用性问题。
CMake 是一个可扩大的开源零碎,它以操作系统和与编译器无关的形式治理构建过程。与其余许多跨平台零碎不同的是,
CMake 被设计为与本机的构建环境联合应用。它通过被搁置于每个源文件目录下的简略配置文件(名为 CMakeLists.txt 的文件)
来生成惯例应用的规范构建文件(比方:Unix 下的 makefiles 文件或 Windows MSVC 中的 projects/workspaces)。
# 在 CMake 中, 这是一条命令# 要运行咱们的代码,请执行以下命令:# - mkdir build && cd build# - cmake ..# - make# # 通过上述命令,咱们将遵循最佳实际在子目录中进行编译# 在第二行命令中咱们申请Cmake 生成新的依赖于零碎的Makefile文件。# 最初,咱们运行本地的make 命令。#------------------------------------------------------------------------------# 根底局部#------------------------------------------------------------------------------## Cmake文件必须被命令为 “CMakeLists.txt” 。# 设置生成Makefile的CMake所需最低版本要求cmake_minimum_required (VERSION 2.8)# 当版本小于2.8时,须要退出关键字 FATAL_ERROR。cmake_minimum_required (VERSION 2.8 FATAL_ERROR)# 在这里定义了我的项目的名称,同时会影响Cmake 生成的目录命名约定。# 咱们能够将代码的语言作为第二个参数传入。project (learncmake C)# 设置我的项目的源目录(仅仅是因为常规)set( LEARN_CMAKE_SOURCE_DIR ${CMAKE_CURRENT_SOURCE_DIR} )set( LEARN_CMAKE_BINARY_DIR ${CMAKE_CURRENT_BINARY_DIR} )# 在构建零碎中用“semver”格调为咱们代码设置以后版本是很有用的。set (LEARN_CMAKE_VERSION_MAJOR 1)set (LEARN_CMAKE_VERSION_MINOR 0)set (LEARN_CMAKE_VERSION_PATCH 0)# 将变量(版本号)发送到源代码头configure_file ( "${PROJECT_SOURCE_DIR}/TutorialConfig.h.in" "${PROJECT_BINARY_DIR}/TutorialConfig.h")# 蕴含目录# 在 GCC中, 该语句等同于 "-I" 命令include_directories( include )# 在哪里装置其余库?留神:在此处提供includes门路,后续查看将解决所有其余问题set( CMAKE_MODULE_PATH ${CMAKE_MODULE_PATH} "${CMAKE_SOURCE_DIR}/CMake/modules/" )# 条件if ( CONDITION ) # 输入! # 附带信息 message(STATUS "My message") # CMake 正告,持续解决 message(WARNING "My message") # CMake 正告 (dev),持续解决 message(AUTHOR_WARNING "My message") # CMake 谬误,持续解决然而会跳过生成 message(SEND_ERROR "My message") # CMake 谬误,进行解决和生成 message(FATAL_ERROR "My message")endif()if( CONDITION )elseif( CONDITION )else( CONDITION )endif( CONDITION )# 循环foreach(loop_var arg1 arg2 ...) COMMAND1(ARGS ...) COMMAND2(ARGS ...) ...endforeach(loop_var)foreach(loop_var RANGE total)foreach(loop_var RANGE start stop [step])foreach(loop_var IN [LISTS [list1 [...]]] [ITEMS [item1 [...]]])while(condition) COMMAND1(ARGS ...) COMMAND2(ARGS ...) ...endwhile(condition)# 逻辑运算if(FALSE AND (FALSE OR TRUE)) message("Don't display!")endif()# 将惯例,缓存或环境变量设置为给定值。# 如果指定了PARENT_SCOPE选项,则将在以后作用域上的作用域中设置变量# `set(<variable> <value>... [PARENT_SCOPE])`# 如何在带引号和不带引号的参数中援用变量?How to reference variables inside quoted and unquoted arguments?# 如果未设置变量,变量援用由变量值或空字符串替换。${variable_name}# 清单# 设置源文件列表set( LEARN_CMAKE_SOURCES src/main.c src/imagem.c src/pather.c)# 调用编译器## ${PROJECT_NAME} 即 Learn_CMake add_executable( ${PROJECT_NAME} ${LEARN_CMAKE_SOURCES} )# 链接库target_link_libraries( ${PROJECT_NAME} ${LIBS} m )# 在哪里装置其余库?留神:在此处提供includes门路,后续查看将解决所有其余问题set( CMAKE_MODULE_PATH ${CMAKE_MODULE_PATH} "${CMAKE_SOURCE_DIR}/CMake/modules/" )# 编译条件 (gcc ; g++)if ( "${CMAKE_C_COMPILER_ID}" STREQUAL "GNU" ) message( STATUS "Setting the flags for ${CMAKE_C_COMPILER_ID} compiler" ) add_definitions( --std=c99 )endif()# 查看 OSif( UNIX ) set( LEARN_CMAKE_DEFINITIONS "${LEARN_CMAKE_DEFINITIONS} -Wall -Wextra -Werror -Wno-deprecated-declarations -Wno-unused-parameter -Wno-comment" )endif()
资源
- CMake tutorial
- CMake documentation
- Mastering CMake
- An Introduction to Modern CMake
有倡议?或者发现什么谬误?在Github上开一个 issue ,或者发动 pull request !
原著 Bruno Alano,并由 0 个好心人批改。
© 2022 Bruno Alano
Translated by: tx23
本作品采纳 CC BY-SA 3.0 协定进行许可。