cmake中execute_process详解

execute_process 是 CMake 中一个非常强大的命令,用于在构建过程中执行外部程序或脚本。它提供了丰富的选项来控制执行过程,并可以捕获输出、错误和返回码。以下是 execute_process 的详细解析:

基本语法

bash 复制代码
execute_process(
    COMMAND <command>...>
    [WORKING_DIRECTORY <directory>]
    [TIMEOUT <seconds>]
    [COMMAND_ECHO <SILENT|NORMAL|DETAILED>]
    [RESULT_VARIABLE <variable>]
    [ERROR_VARIABLE <variable>]
    [ERROR_STRIP_TRAILING_WHITESPACE]
    [ERROR_CODE <variable>]
    [ERROR_CODE_VARIABLE <variable>]
    [ERROR_FILE <file>]
    [ERROR_FILE_STRIP_TRAILING_WHITESPACE]
    [OUTPUT_VARIABLE <variable>]
    [OUTPUT_STRIP_TRAILING_WHITESPACE]
    [OUTPUT_FILE <file>]
    [OUTPUT_FILE_STRIP_TRAILING_WHITESPACE]
    [INPUT <string|list>]
    [INPUT_DATA <string|list>]
)

参数详解

  • COMMAND : 要执行的命令及其参数。可以是一个字符串或列表形式。例如:COMMAND make installCOMMAND {CMAKE_COMMAND} -P ${CMAKE_SOURCE_DIR}/cmake_install.cmake
  • WORKING_DIRECTORY : 设置命令执行时的工作目录。例如:WORKING_DIRECTORY ${CMAKE_BINARY_DIR}
  • TIMEOUT : 设置命令执行的超时时间(以秒为单位)。如果命令在指定时间内未完成,则会被终止。例如:TIMEOUT 60
  • COMMAND_ECHO : 控制是否在执行命令时打印命令行。可选值为 SILENT, NORMAL, DETAILED。默认为 NORMAL
    • SILENT: 不打印任何信息。
    • NORMAL: 打印命令名称和第一个参数。
    • DETAILED: 打印完整的命令行。
  • RESULT_VARIABLE : 存储命令执行结果的变量。如果命令成功执行,该变量将被设置为 TRUE;否则为 FALSE
  • ERROR_VARIABLE : 存储命令标准错误输出的变量。可以与 ERROR_STRIP_TRAILING_WHITESPACE 一起使用来去除末尾的空白字符。
  • ERROR_STRIP_TRAILING_WHITESPACE : 如果设置了此选项,将从 ERROR_VARIABLE 中去除末尾的空白字符。
  • ERROR_CODE : 存储命令返回码的变量。如果命令成功执行,该变量将被设置为 0;否则为非零值。
  • ERROR_CODE_VARIABLE: 存储命令返回码的变量名。
  • ERROR_FILE : 将命令的标准错误输出重定向到指定的文件。可以与 ERROR_FILE_STRIP_TRAILING_WHITESPACE 一起使用来去除末尾的空白字符。
  • ERROR_FILE_STRIP_TRAILING_WHITESPACE : 如果设置了此选项,将从 ERROR_FILE 中去除末尾的空白字符。
  • OUTPUT_VARIABLE : 存储命令标准输出的变量。可以与 OUTPUT_STRIP_TRAILING_WHITESPACE 一起使用来去除末尾的空白字符。
  • OUTPUT_STRIP_TRAILING_WHITESPACE : 如果设置了此选项,将从 OUTPUT_VARIABLE 中去除末尾的空白字符。
  • OUTPUT_FILE : 将命令的标准输出重定向到指定的文件。可以与 OUTPUT_FILE_STRIP_TRAILING_WHITESPACE 一起使用来去除末尾的空白字符。
  • OUTPUT_FILE_STRIP_TRAILING_WHITESPACE : 如果设置了此选项,将从 OUTPUT_FILE 中去除末尾的空白字符。
  • INPUT: 向命令的标准输入提供数据。可以是字符串或列表形式。
  • INPUT_DATA : 类似于 INPUT,但允许使用更复杂的数据类型,例如列表。

示例

  • 简单示例:
cpp 复制代码
execute_process(
    COMMAND echo "Hello, World!"
    OUTPUT_VARIABLE output
)
message("Output: ${output}")
复制代码
带工作目录和超时:
cpp 复制代码
execute_process(
    COMMAND ls /nonexistent/path
    WORKING_DIRECTORY ${CMAKE_SOURCE_DIR}
    TIMEOUT 5
    RESULT_VARIABLE result
)
if (result)
    message("Command succeeded")
else()
    message("Command failed or timed out")
endif()
  • 捕获标准输出和错误输出:
bash 复制代码
execute_process(
    COMMAND ls /nonexistent/path
    OUTPUT_VARIABLE output
    ERROR_VARIABLE error
)
message("Output: ${output}")
message("Error: ${error}")
  • 重定向输出到文件:
bash 复制代码
execute_process(
    COMMAND ls /nonexistent/path
    OUTPUT_FILE ${CMAKE_BINARY_DIR}/output.txt
    ERROR_FILE ${CMAKE_BINARY_DIR}/error.txt
)

通过这些参数和示例,你可以看到 execute_process 命令在 CMake 中的强大功能,它可以帮助你在构建过程中灵活地执行外部命令并处理其输出。

相关推荐
凌云行者15 小时前
OpenGL入门004——使用EBO绘制矩形
c++·cmake·opengl
长弓聊编程3 天前
应该怎么理解CMakeLists.txt中一些指令的INTERFACE、PUBLIC和PRIVATE参数
cmake
凌云行者3 天前
OpenGL入门003——使用Factory设计模式简化渲染流程
c++·cmake·opengl
凌云行者4 天前
OpenGL入门002——顶点着色器和片段着色器
c++·cmake·opengl
梦起丶5 天前
CMake 生成器表达式介绍
c++·cmake
梦起丶7 天前
CMake 生成器表达式---条件表达式和逻辑运算符
c++·cmake
咩咩大主教9 天前
QtCreator通过CMake多文件编译.cpp、.qss、.h、.ui文件,达到MVC三层架构的效果
c++·qt·cmake·qtcreator·qss·多文件编译·qmake
韦易笑10 天前
Emake:你见过最简单的 C/C++ 构建工具
c++·cmake
winds~15 天前
Cmake中“目标层级“的概念(target_include_directories和include_directories的区别)
c++·cmake