CMake命令--add_custom_command

最新推荐文章于 2025-07-10 21:54:43 发布
原创 最新推荐文章于 2025-07-10 21:54:43 发布 · 952 阅读 · 4 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#cmake

一 概述

add_custom_command 是 CMake 中用于定义自定义构建规则的指令。这个命令允许你指定一个或多个依赖项，一个或多个输出文件，以及当依赖项改变时需要执行的命令。当依赖项比输出文件新，或者输出文件不存在时，指定的命令就会执行。

add_custom_command 的基本语法如下：

cmake复制代码

add_custom_command(OUTPUT output1 [output2 ...]
COMMAND command1 [ARGS] [args1...]
[COMMAND command2 [ARGS] [args2...] ...]
[MAIN_DEPENDENCY depend]
[DEPENDS [depends...]]
[IMPLICIT_DEPENDS <lang> depend1 ...]
[WORKING_DIRECTORY dir]
[COMMENT comment]
[VERBATIM] </
最低0.47元/天 解锁文章
CMake基础教程（29）add_custom_command添加定制化命令
二进制君
03-27 6317
custom一词应该翻译成定制化比较合适，表示cmake提供了让用户添加定制化命令的手段。 该命令有两种格式， 1、用法1 添加一个伪目标用以执行某些命令 add_custom_command(OUTPUT output1 [output2 ...] COMMAND command1 [ARGS] [args1...] [COMMAND command2 [ARGS] [args2...] ...]
CMake基础教程：使用add_custom_command添加自定义命令（嵌入式）
CodeSageX的博客
09-23 535
在这个例子中，我们使用CMake的内置命令${CMAKE_COMMAND}和-E来执行一条命令，即将生成的可执行文件复制到CMAKE_BINARY_DIR目录下的bin文件夹中。在本教程中，我们将重点介绍如何使用CMake的add_custom_command函数来添加自定义命令，以满足嵌入式系统项目中的特定需求。在这个示例中，我们首先指定了CMake的最低版本要求，并设置了项目的名称为"EmbeddedProject"。在构建过程中，我们定义的自定义命令将被执行，将可执行文件复制到指定目录。
CMake实战指南一：add_custom_command
binary0010的博客
04-07 1677
add_custom_command 是 CMake 中实现构建流程自定义的关键工具，支持在编译前 / 后插入脚本、生成动态文件、集成外部工具等，解决跨平台构建中的个性化需求（如配置文件生成、部署自动化、复杂依赖管理）。
cmake add_custom_command详解
qq_37805392的博客
06-27 1892
在 CMake 中，add_custom_command 命令用于向构建过程添加自定义的命令。这些自定义命令可以用来生成文件、复制文件、执行脚本或其他任何必要的构建步骤。通常情况下，add_custom_command 用于描述某个文件或目标的生成过程。
CMake I add_custom_command命令详解（构建）
该用户还没想到好的昵称的博客
02-10 3万+
add_custom_command 向目标添加规则，并通过执行命令生成指定输出的文件。
使用ADD_CUSTOM_COMMAND 添加自定义命令
weixin_30242907的博客
11-02 1474
e.g. ADD_CUSTOM_COMMAND( TARGET world_server COMMAND cp ${CMAKE_SOURCE_DIR}/CMakeLists.txt ${EXECUTABLE_OUTPUT_PATH} ) 上面这句所得到的效果是，当目标world_server 被新生成时，执行COMMAND 后面的命令。 ...
cmake-3.4.3-Linux-x86_64.zip
06-28
7. **自定义构建步骤**：用户可以通过add_custom_command和add_custom_target等命令添加自定义的构建步骤。 在使用CMake时，开发者通常会按照以下步骤操作： 1. **初始化**：使用`cmake_minimum_required()`指定...
cmake-3.26.4-windows-x86-64
05-26
例如，为了将Rust程序编译为WebAssembly，可能需要配置CMake来使用Rust的Cargo构建系统，这可能涉及到设置`find_program(CARGO cargo)`来定位Cargo可执行文件，并使用`add_custom_command`来调用Cargo进行构建。...
cmake add_custom_command 使用
weixin_33878457的博客
03-10 991
cmake add_custom_command 使用今天整理编译工程，想在编译工程前面用tolua生成c文件， 使用命令add_custom_command后，附加的命令并不执行，如下： add_custom_command (OUTPUT ${COMPLETE_NAME_C} PRE_BUILD COMMAND ${COMMAND_TOLUA...
cmake的add_custom_command和add_custom_target指令
taosimin87的专栏
11-02 1183
在很多时候，需要在cmake中创建一些目标，如clean、copy等等，这就需要通过add_custom_target来指定。同时，add_custom_command可以用来完成对add_custom_target生成的target的补充。 本文实例源码github地址：https://github.com/yngzMiao/yngzmiao-blogs/tree/master/2019Q4/20191029。 add_custom_target 如果你写过MakeFile，那么一定知道，可以.
CMake中add_custom_command的使用
网络资源是无限的
12-08 4489
CMake中add_custom_command的使用
CMake命令之add_custom_comand 和 add_custom_target
热门推荐
山庄来客的专栏
05-09 5万+
add_custom_command: 增加客制化的构建规则到生成的构建系统中。对于add_custom_command，有两种使用形式。第一种形式是增加一个客制命令用来产生一个输出。  add_custom_command(OUTPUT output1 [output2 ...]                      COMMAND command1[ARGS] [args1...]
CMake指令：add_custom_command和add_custom_target详解
红军不怕远征难，万水千山只等闲
07-10 1546
CMake中的add_custom_command和add_custom_target命令解析： add_custom_command用于定义构建阶段的自定义操作，主要分为两种模式： 生成文件模式（通过OUTPUT指定输出文件），需其他目标依赖该文件才会触发执行； 目标关联模式（通过TARGET），可在目标构建前后执行命令（如POST_BUILD用于编译后操作）。 add_custom_target则创建可直接执行的伪目标，特点包括： 可通过make命令直接调用； 支持ALL选项加入默认构建流程； 常与ad
cmake文档中文翻译-add_custom_command
weixin_34148456的博客
01-15 367
为什么80%的码农都做不了架构师？>>> ...
CMake深度解析：掌握add_custom_command，精通Makefile生成规则
探索C++编程的奥秘，分享深入的技术见解和实践，旨在激发读者创造力与解决问题的思维。
06-01 1802
CMake深度解析：掌握add_custom_command，精通Makefile生成规则
ios-cmake 使用add_custom_command执行xcrun命令
qq_38743313的博客
10-22 569
需求 在一个由CMake管理着的底层算法库中，有一个自己训练出来的detect_model.mlmodel，需要编译并生成相应的文件，并在ios和osx中使用。 方法有两个： 直接将detect_model.mlmodel拖入Xcode中，会自动生成所需文件。 使用指令编译并生成（参考)： mkdir output xcrun coremlc compile detect_model.mlmo...
Cmake 命令
ahxieqi的博客
05-31 230
2019 May 31 cmake Cmake 命令 add_custom_command 用法① 为了生成输出文件，添加一条自定义命令 语法格式① add_custom_command(OUTPUT output1 [output2 ...] COMMAND command1 [ARGS] [args1...] ...
【CMake】add_custom_command命令详解-添加自定义构建规则
weixin_43510208的博客
06-13 584
add_custom_command主要用于在构建过程中生成文件或执行特定操作。
CMakeList下添加终端命令(add_custom_command)--以proto文件编译为例
Draja
11-19 2828
这里写自定义目录标题欢迎使用Markdown编辑器新的改变功能快捷键合理的创建标题，有助于目录的生成如何改变文本的样式插入链接与图片如何插入一段漂亮的代码片生成一个适合你的列表创建一个表格设定内容居中、居左、居右SmartyPants创建一个自定义列表如何创建一个注脚注释也是必不可少的KaTeX数学公式新的甘特图功能，丰富你的文章UML 图表FLowchart流程图导出与导入导出导入 欢迎使用Markdown编辑器 你好！ 这是你第一次使用 Markdown编辑器 所展示的欢迎页。如果你想学习如何使用Mar
cmake build_command = f"cmake --build {output_path} -j12 --clean-first" 并行运行失败
最新发布
10-11
<think>我们正在解决用户在执行 `cmake --build {output_path} -j12 --clean-first` 时遇到的并行运行失败问题。根据之前讨论，并行编译涉及两个层面：CMake构建系统并行（通过`-j12`控制）和编译器内部并行（如MSVC的`/MP`选项）。失败可能由多种原因导致，我们将逐步排查。 ### 解决步骤 #### 1. **验证CMake生成器支持并行** 检查CMake使用的底层构建工具是否支持多线程： ```bash cmake --build {output_path} --help ``` - **关键输出**： - 若使用`Ninja`，显示`--parallel [=N]`则支持 - 若使用`Visual Studio`生成器，显示`/maxcpucount[:n]`则支持 - 若使用`MinGW Makefiles`，需确保为`make`而非`nmake` > ⚠️ 注意：部分生成器（如`Visual Studio 10`）需显式启用并行： > `cmake --build -- /m:12`代替`-j12`[^1] #### 2. **检查资源冲突** 当同时启用构建系统并行和编译器内部并行时，可能因线程超额订阅导致崩溃： - **典型症状**：编译中途报错`fatal error C1060`（MSVC内存不足）或`g++: fatal error: Killed signal terminated program cc1plus` - **解决方案**： - **方案A**：降低总并行度 将`-j12`改为`-j$(nproc)`（Linux）或`-j$env:NUMBER_OF_PROCESSORS`（PowerShell），并关闭编译器内部并行： ```cmake # CMakeLists.txt 调整 if(MSVC) add_compile_options($<$<CONFIG:RELEASE>:/MP2>) # Release模式只用2线程 endif() ``` - **方案B**：手动平衡资源 总线程数公式：$$ \text{CMake并行数} \times \text{编译器线程数} \leq \text{CPU逻辑核心数} $$ 例如8核CPU：`cmake --build build -j4` + MSVC设置`/MP2` #### 3. **处理依赖问题** `--clean-first`可能在并行清理时引发竞态条件： - **现象**：清理未完成即开始编译，导致文件丢失 - **解决方案**： - 分步执行清理和构建： ```bash cmake --build {output_path} --target clean cmake --build {output_path} -j12 ``` - 或在CMake中显式声明依赖： ```cmake add_custom_target(clean_all COMMAND ${CMAKE_COMMAND} -E remove_directory ${PROJECT_BINARY_DIR}/*) add_dependencies(your_target clean_all) # 强制清理先于编译 ``` #### 4. **诊断编译器兼容性** 某些编译器在特定版本下存在并行编译缺陷： - **MSVC**：v16.11之前版本可能因`/MP`与预编译头冲突而崩溃 - **GCC**：`-flto`与`-pipe`组合时可能死锁 - **排查方法**： ```bash cmake --build {output_path} -j1 # 单线程测试是否基础编译通过 ``` 若单线程成功，则问题在并行逻辑。 #### 5. **捕获错误日志** 通过重定向输出定位具体失败点： ```bash cmake --build {output_path} -j12 --clean-first -- VERBOSE=1 2>&1 | tee build.log ``` - **关键分析点**： - 搜索`error:`或`fatal error` - 检查是否在链接阶段失败（可能因并行编译目标未完成） ### 配置调整示例 ```cmake # 禁用问题编译器的内部并行（以Clang为例） if(CMAKE_CXX_COMPILER_ID STREQUAL "Clang") set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -j1") # 强制单线程编译 endif() # 设置全局并行构建线程数（需CMake≥3.12） set(CMAKE_BUILD_PARALLEL_LEVEL 6) # 覆盖命令行-j12 ``` ### 备选方案 如上述方法无效，可尝试切换构建系统： ```bash # 切换到Ninja（通常有更好的并行稳定性） cmake -G "Ninja" -S . -B {output_path} cmake --build {output_path} -j12 ``` §§相关问题§§ 1. 如何修复CMake并行编译中的`fatal error LNK1104: cannot open file 'xxx.lib'`错误？ 2. 嵌入式系统中如何优化CMake编译内存消耗？ 3. CMake如何为不同目标设置差异化的并行编译策略？ 4. 如何利用CMake的`try_compile`测试编译器并行兼容性？ </think>### 解决方法：`cmake --build {output_path} -j12 --clean-first` 并行失败问题 #### 1. **验证构建系统支持并行** [^1] - **问题**：部分构建工具（如旧版 NMake）不支持 `-j` 参数 - **诊断**：检查 CMake 生成的构建文件类型： ```bash cat {output_path}/CMakeCache.txt | grep "CMAKE_GENERATOR" ``` - 若输出 `CMAKE_GENERATOR:INTERNAL=NMake Makefiles` → 不支持并行 - **解决**：重新生成支持并行的构建系统： ```bash # 切换到 Ninja（推荐） cmake -G "Ninja" -S . -B {output_path} # 或使用 Makefiles cmake -G "Unix Makefiles" -S . -B {output_path} ``` #### 2. **解决依赖冲突** - **问题**：`--clean-first` 可能破坏并行依赖关系 - **现象**：清理未完成时编译已启动，导致文件缺失 - **解决**：分步执行清理和构建： ```bash cmake --build {output_path} --target clean # 先完成清理 cmake --build {output_path} -j12 # 再并行编译 ``` #### 3. **避免资源争用** - **问题**：并行任务过多导致内存/CPU 超载 - **诊断**：观察失败时的系统资源占用（任务管理器） - **优化**：动态计算线程数（Windows PowerShell）： ```powershell $cores = (Get-CimInstance Win32_ComputerSystem).NumberOfLogicalProcessors cmake --build build -j ($cores * 0.8) # 使用 80% 核心数 ``` #### 4. **检查编译器并行兼容性** | 编译器 | 并行选项 | 常见问题 | |----------|---------------|-------------------------| | MSVC | `/MP` | 需禁用预编译头 (`/Y-`) | | GCC/Clang| `-flto=auto` | 需足够内存（每线程 2GB+）| | GHS | `-jobs=n` | 需许可证支持多线程 | **解决方案**： ```cmake # 在 CMakeLists.txt 中关闭问题选项 if(MSVC) add_compile_options(/MP0) # 禁用 MSVC 内部并行 endif() ``` #### 5. **诊断构建日志** - **捕获详细日志**： ```bash cmake --build {output_path} -j12 --clean-first -- VERBOSE=1 2>&1 | tee build.log ``` - **关键排查点**： - `fatal error LNK1104`: 文件被多个进程争用 - `cannot open output file ... in use`: 清理与编译同时访问文件 - `C1060: compiler is out of heap space`: 内存耗尽 #### 6. **强制单线程测试** ```bash cmake --build {output_path} -j1 --clean-first # 测试基础功能 ``` - 若成功 → 确认是并行问题 - 若失败 → 检查代码/环境配置问题 ### 推荐配置模板 ```cmake # CMakeLists.txt 最佳实践 cmake_minimum_required(VERSION 3.12) project(MyProject) # 设置全局并行级别 (CMake 3.12+) set(CMAKE_BUILD_PARALLEL_LEVEL $ENV{NUMBER_OF_PROCESSORS}) # 按需禁用编译器内部并行 if(CMAKE_CXX_COMPILER_ID MATCHES "MSVC") add_compile_options(/MP0) # 显式禁用 MSVC 并行 endif() ```
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
表情包 代码片
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

小蘑菇二号

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值