build2 模块体系全解析config、test、install、version 核心模块指南【免费下载链接】build2build2 build system项目地址: https://gitcode.com/gh_mirrors/bu/build2对于刚接触build2 构建系统的开发者来说最让人困惑的往往不是语法本身而是它那套清晰却略显庞杂的模块体系。build2 并非一个大而全的单一程序而是由config、test、install、version等多个核心模块组合而成的现代化 C/C 构建工具链。本篇文章将带你完整梳理 build2 模块体系用最直白的方式讲清楚每个模块的职责、常用配置与实战用法帮你快速建立起对这套构建系统的整体认知。为什么 build2 需要模块化架构传统构建工具如 Make把所有能力揉在一个引擎里功能多了以后互相纠缠、难以维护。build2 选择了另一条路按职责拆分成独立模块每个模块负责一类构建任务通过统一接口协作。config 模块管理配置与构建环境test 模块运行测试与 testscript 脚本install 模块完成安装与卸载version 模块自动生成与校验项目版本这套设计让 build2 既能保持核心引擎的轻量又能按需加载能力。从源码目录libbuild2/下可以清楚看到每个模块都有独立的init.cxx模块初始化、operation.cxx操作实现和rule.cxx规则定义结构一目了然。config 模块项目配置管理的基石config 模块是 build2 模块体系中所有配置的总开关负责把构建配置持久化到build/config.build文件中并处理命令行上的config.*变量覆盖。一键配置与持久化机制当你执行b configure时config 模块会收集所有config.*变量并保存到build/config.build下次构建时自动复用。这意味着配置一次、处处生效无需重复传参。$ b configure config.cxxg-11 config.cxx.stdlatest密封构建Hermetic Build配置config 模块最具特色的能力之一是密封构建配置通过config.config.hermetictrue开启后构建时影响项目的环境变量如PATH会被连同配置一起保存之后所有操作都在该环境下执行保证构建结果的可复现性$ b configure config.config.hermetictrue常用的 config 模块配置项配置变量作用config.config.hermetic是否开启密封构建config.config.environment指定参与密封的环境变量列表config.report系列控制变量是否出现在配置报告中感兴趣的话可以直接阅读 config 模块初始化源码 了解它的完整实现逻辑。test 模块让测试运行变得简单test 模块负责把测试变成构建流程的一等公民。它不仅仅能运行普通可执行文件还支持一套强大的testscript脚本语言用来描述复杂的测试场景如重定向、环境变量、退出码校验等。用 config.test 精准筛选测试当项目测试很多时用config.test变量可以精准定位要运行的测试目标或脚本$ b test config.testfoo/exe{driver} # 只测试指定目标 $ b test config.testbar/baz # 只运行指定 testscript 用例testscript 让测试活起来在 build2 中*.test.testscript文件用描述性语言定义测试步骤而不用写一堆 shell 脚本。项目里大量的lexer*.test.testscript、parser*.test.testscript文件就是典型例子——它们把词法、语法解析器的各种边界情况都覆盖到了。test 模块的核心逻辑在 test 模块初始化源码 中其中config.test、test.options、test.arguments等变量都从这里注册进变量池。install 模块安装与卸载的标准答案install 模块定义了 build2 的标准安装位置体系让把项目装到系统里这件事有了一套统一约定。它内置了从root到man的十几级安装路径全部支持通过config.install.*简写c.i.*覆盖。标准安装位置速查安装位置默认路径覆盖变量root/usr/local/c.i.rootbinroot/bin/c.i.binlibroot/lib/c.i.libincluderoot/include/c.i.includeshareroot/share/c.i.sharemanroot/share/man/c.i.man最简安装三步走$ b configure --prefix/opt/mylib # 1. 指定安装前缀 $ b # 2. 构建 $ b install # 3. 安装值得一提的是install 模块还支持变量替换如project、version自动展开源码实现见 install 模块初始化源码。version 模块版本管理的自动化引擎version 模块是 build2 模块体系中最聪明的一个它读取项目manifest文件中的版本声明自动派生出一整套标准版本变量如project.version、project.version.major等供 buildfile 和安装路径使用。标准版本格式build2 推荐遵循语义化版本SemVer风格的标准版本格式major.minor.patch[-prerel]例如1.2.3、1.2.3-a.1。在 C/C 语境下patch 对应二进制兼容改动minor 对应源码兼容改动major 对应破坏性改动。version 模块的自动化魔法从 git 仓库自动计算开发快照版本如0.1.0-a.0.20231001无需手动维护自动生成version.hxx头文件把版本号变成代码常量与 dist 模块协作打包时自动生成带版本号的发布包名版本模块的数据结构定义在 version 模块头文件 中可以看到它封装了version、committed、rewritten等关键状态。四个核心模块如何协同工作build2 模块体系的价值在于模块间的无缝协作config模块先完成环境配置把编译器、路径、特性开关固化下来version模块从 manifest 读出版本注入到编译宏和安装路径test模块在构建完成后执行测试保证产物正确install模块把通过验证的产物安装到标准位置整套流程只需几条命令即可串联$ b configure $ b test $ b install总结掌握 build2 模块体系就是掌握构建全流程通过本文可以看到build2 模块体系的精髓在于各司其职、协同作战config管配置、test管验证、install管交付、version管版本。对于新手而言先理解这四个核心模块的职责与常用变量就足以驾驭日常的构建、测试与安装工作想要深入直接阅读libbuild2/下各模块的源码与官方文档doc/manual.cli是不错的选择。无论你是从零开始学习 build2还是想从 Make/CMake 迁移过来理清这套模块体系都会让后续的学习事半功倍。现在就打开你的项目试着用b configure、b test、b install跑通一次完整流程吧【免费下载链接】build2build2 build system项目地址: https://gitcode.com/gh_mirrors/bu/build2创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 build2 模块体系全解析：config、test、install、version 核心模块指南
build2 模块体系全解析config、test、install、version 核心模块指南【免费下载链接】build2build2 build system项目地址: https://gitcode.com/gh_mirrors/bu/build2对于刚接触build2 构建系统的开发者来说最让人困惑的往往不是语法本身而是它那套清晰却略显庞杂的模块体系。build2 并非一个大而全的单一程序而是由config、test、install、version等多个核心模块组合而成的现代化 C/C 构建工具链。本篇文章将带你完整梳理 build2 模块体系用最直白的方式讲清楚每个模块的职责、常用配置与实战用法帮你快速建立起对这套构建系统的整体认知。为什么 build2 需要模块化架构传统构建工具如 Make把所有能力揉在一个引擎里功能多了以后互相纠缠、难以维护。build2 选择了另一条路按职责拆分成独立模块每个模块负责一类构建任务通过统一接口协作。config 模块管理配置与构建环境test 模块运行测试与 testscript 脚本install 模块完成安装与卸载version 模块自动生成与校验项目版本这套设计让 build2 既能保持核心引擎的轻量又能按需加载能力。从源码目录libbuild2/下可以清楚看到每个模块都有独立的init.cxx模块初始化、operation.cxx操作实现和rule.cxx规则定义结构一目了然。config 模块项目配置管理的基石config 模块是 build2 模块体系中所有配置的总开关负责把构建配置持久化到build/config.build文件中并处理命令行上的config.*变量覆盖。一键配置与持久化机制当你执行b configure时config 模块会收集所有config.*变量并保存到build/config.build下次构建时自动复用。这意味着配置一次、处处生效无需重复传参。$ b configure config.cxxg-11 config.cxx.stdlatest密封构建Hermetic Build配置config 模块最具特色的能力之一是密封构建配置通过config.config.hermetictrue开启后构建时影响项目的环境变量如PATH会被连同配置一起保存之后所有操作都在该环境下执行保证构建结果的可复现性$ b configure config.config.hermetictrue常用的 config 模块配置项配置变量作用config.config.hermetic是否开启密封构建config.config.environment指定参与密封的环境变量列表config.report系列控制变量是否出现在配置报告中感兴趣的话可以直接阅读 config 模块初始化源码 了解它的完整实现逻辑。test 模块让测试运行变得简单test 模块负责把测试变成构建流程的一等公民。它不仅仅能运行普通可执行文件还支持一套强大的testscript脚本语言用来描述复杂的测试场景如重定向、环境变量、退出码校验等。用 config.test 精准筛选测试当项目测试很多时用config.test变量可以精准定位要运行的测试目标或脚本$ b test config.testfoo/exe{driver} # 只测试指定目标 $ b test config.testbar/baz # 只运行指定 testscript 用例testscript 让测试活起来在 build2 中*.test.testscript文件用描述性语言定义测试步骤而不用写一堆 shell 脚本。项目里大量的lexer*.test.testscript、parser*.test.testscript文件就是典型例子——它们把词法、语法解析器的各种边界情况都覆盖到了。test 模块的核心逻辑在 test 模块初始化源码 中其中config.test、test.options、test.arguments等变量都从这里注册进变量池。install 模块安装与卸载的标准答案install 模块定义了 build2 的标准安装位置体系让把项目装到系统里这件事有了一套统一约定。它内置了从root到man的十几级安装路径全部支持通过config.install.*简写c.i.*覆盖。标准安装位置速查安装位置默认路径覆盖变量root/usr/local/c.i.rootbinroot/bin/c.i.binlibroot/lib/c.i.libincluderoot/include/c.i.includeshareroot/share/c.i.sharemanroot/share/man/c.i.man最简安装三步走$ b configure --prefix/opt/mylib # 1. 指定安装前缀 $ b # 2. 构建 $ b install # 3. 安装值得一提的是install 模块还支持变量替换如project、version自动展开源码实现见 install 模块初始化源码。version 模块版本管理的自动化引擎version 模块是 build2 模块体系中最聪明的一个它读取项目manifest文件中的版本声明自动派生出一整套标准版本变量如project.version、project.version.major等供 buildfile 和安装路径使用。标准版本格式build2 推荐遵循语义化版本SemVer风格的标准版本格式major.minor.patch[-prerel]例如1.2.3、1.2.3-a.1。在 C/C 语境下patch 对应二进制兼容改动minor 对应源码兼容改动major 对应破坏性改动。version 模块的自动化魔法从 git 仓库自动计算开发快照版本如0.1.0-a.0.20231001无需手动维护自动生成version.hxx头文件把版本号变成代码常量与 dist 模块协作打包时自动生成带版本号的发布包名版本模块的数据结构定义在 version 模块头文件 中可以看到它封装了version、committed、rewritten等关键状态。四个核心模块如何协同工作build2 模块体系的价值在于模块间的无缝协作config模块先完成环境配置把编译器、路径、特性开关固化下来version模块从 manifest 读出版本注入到编译宏和安装路径test模块在构建完成后执行测试保证产物正确install模块把通过验证的产物安装到标准位置整套流程只需几条命令即可串联$ b configure $ b test $ b install总结掌握 build2 模块体系就是掌握构建全流程通过本文可以看到build2 模块体系的精髓在于各司其职、协同作战config管配置、test管验证、install管交付、version管版本。对于新手而言先理解这四个核心模块的职责与常用变量就足以驾驭日常的构建、测试与安装工作想要深入直接阅读libbuild2/下各模块的源码与官方文档doc/manual.cli是不错的选择。无论你是从零开始学习 build2还是想从 Make/CMake 迁移过来理清这套模块体系都会让后续的学习事半功倍。现在就打开你的项目试着用b configure、b test、b install跑通一次完整流程吧【免费下载链接】build2build2 build system项目地址: https://gitcode.com/gh_mirrors/bu/build2创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考