cclean：一个cmake sanitizer

摘要

cclean 清理cmake最杂乱的构建工件。

示例

$ cd example

$ cmake .
$ cmake --build . --target hello
$ tree
.
├── CMakeCache.txt
├── CMakeFiles
...
├── CMakeLists.txt
├── Makefile
├── bin
│   └── hello
├── cmake_install.cmake
└── hello.c

$ cclean
$ tree
.
├── CMakeLists.txt
└── hello.c

有关更多选项，请参阅 cclean -h。

关于

cclean 协助cmake删除常见内部工件。这有助于释放磁盘空间。

cmake 常进入损坏状态，需要手动干预。cclean 自动将cmake重置为干净状态的过程。

cclean 对于跨平台工作流程特别有用。例如，在WSL中一次构建相同的宿主目录，然后在PowerShell中再次构建。

显著特性

• cclean 独立于cmake运行，使其能够删除粘性的cmake工件，如 .ninja_log
• cclean 移除自定义 -B 构建目录
• cclean 包装cmake全局 clean 目标
• cclean 移除缓存的 conan 包

与cmake一样，cclean 鼓励可移植的构建步骤。这使得cmake项目能够在更多环境中更可靠地构建。

警告

仔细配置cmake全局 clean 目标（特别是 ADDITIONAL_CLEAN_FILES），以避免意外。

CRATE

https://crates.io/crates/cclean

从源安装

$ cargo install --force --path .

运行时要求

• cmake 3.4+

贡献

有关开发cclean本身的更多详细信息，请参阅 DEVELOPMENT.md。

许可证

FreeBSD

参见

• git，一个分布式版本控制系统
• gitignore.io，社区维护的gitignore模板
• make，经典、简单的构建系统
• ninja，快速、简单的构建系统
• unmake，手动编写的makefile的代码检查器