首页
/ Boost.Build V2 教程:从入门到项目构建实战

Boost.Build V2 教程:从入门到项目构建实战

2025-06-06 17:56:56作者:丁柯新Fawn

前言

Boost.Build V2 是 Boost 项目中的一套强大的跨平台构建系统,它采用声明式的构建描述方式,能够自动处理依赖关系、多平台构建等复杂问题。本文将带你从最基础的 "Hello World" 开始,逐步掌握 Boost.Build V2 的核心概念和使用技巧。

基础入门

Hello World 示例

让我们从一个最简单的项目开始。在项目的根目录下创建 Jamroot 文件,内容如下:

exe hello : hello.cpp ;

这个简单的配置已经能完成很多工作:

  1. 直接运行 b2 命令会编译 hello.cpp 并链接生成 hello 可执行文件
  2. 默认会构建 debug 版本
  3. 要构建 release 版本,可以运行:
    b2 release
    

Boost.Build 的一个强大之处在于不同变体(variant)会生成在不同的目录中,这意味着你可以:

  • 在不同变体间自由切换
  • 同时构建多个变体而不会导致不必要的重新编译

多目标构建

我们可以扩展项目,在 Jamroot 中添加另一个目标:

exe hello2 : hello.cpp ;

现在可以同时构建两个目标的 debug 和 release 版本:

b2 debug release

Boost.Build 会智能地复用已编译的对象文件,避免重复编译。

清理构建产物

要清理所有构建产物,可以使用:

b2 --clean debug release

也可以针对特定目标进行清理:

b2 --clean hello2

构建属性详解

属性基础概念

Boost.Build 使用**特性(features)值(values)**的组合来表示构建配置。例如:

  • debug-symbols 特性可以有 onoff
  • 一个属性就是一个(特性,值)对

构建时,Boost.Build 会自动将这些属性转换为编译器、链接器等工具的命令行参数。

属性使用示例

以下命令构建 release 版本,禁用内联并启用调试符号:

b2 release inlining=off debug-symbols=on

属性语法为:feature-name=feature-value

隐式特性

variant 是一个常用的隐式特性,以下两种写法等价:

b2 variant=release
b2 release

构建请求与目标需求

构建请求

命令行指定的属性集合构成构建请求,描述了对目标构建的期望属性。

目标需求

项目可以通过 Jamfile 指定目标需求,这些需求会与构建请求合并。例如:

exe hello
    : hello.cpp
    : <include>boost <threading>multi
    ;

这里指定了两个需求:

  1. 包含 boost 目录
  2. 启用多线程编译

项目级属性

为避免重复,可以在项目级别指定通用需求:

project
    : requirements <include>/path/to/boost <threading>multi
    ;

exe hello : hello.cpp ;
exe hello2 : hello.cpp ;

这样,hellohello2 都会继承这些需求。

项目层次结构

项目树结构

大型项目通常组织成树形结构:

top/
  |
  +-- Jamroot
  |
  +-- app/
  |    |
  |    +-- Jamfile
  |    `-- app.cpp
  |
  `-- util/
       |
       +-- foo/
       .    |
       .    +-- Jamfile
       .    `-- bar.cpp
  • 根项目:top/
  • 子项目:top/app/top/util/foo/

继承机制

子项目会继承父项目的所有属性(如需求),并可以与自己的需求合并。

构建控制

默认情况下,构建父项目不会自动构建子项目,除非显式声明:

build-project app ;

目标依赖关系

基本概念

当目标 X 依赖目标 Y(如需要链接库 Y),Y 称为 X 的依赖,X 称为 Y 的依赖项

使用依赖库

假设 top/util/foo/Jamfile 中有:

lib bar : bar.cpp ;

top/app/Jamfile 中可以这样使用:

exe app : app.cpp ../util/foo//bar ;

这里 ../util/foo//bar 是对另一个项目中 bar 库的引用。

属性传播

当构建 app 时指定某些属性:

b2 app optimization=full define=USE_ASM

这些属性会自动传播到依赖的库 bar,确保构建一致性。

总结

通过本教程,我们学习了 Boost.Build V2 的核心概念:

  1. 基础项目配置与多目标构建
  2. 构建属性和变体管理
  3. 项目层次结构与继承机制
  4. 目标依赖关系的声明与使用

Boost.Build V2 的强大之处在于其声明式的构建描述和智能的依赖管理,能够大大简化跨平台项目的构建过程。掌握这些基础知识后,你已经可以开始使用 Boost.Build 来管理自己的项目了。

登录后查看全文

项目优选

收起
leetcodeleetcode
🔥LeetCode solutions in any programming language | 多种编程语言实现 LeetCode、《剑指 Offer(第 2 版)》、《程序员面试金典(第 6 版)》题解
Java
51
15
RuoYi-Vue3RuoYi-Vue3
🎉 (RuoYi)官方仓库 基于SpringBoot,Spring Security,JWT,Vue3 & Vite、Element Plus 的前后端分离权限管理系统
Vue
535
406
openGauss-serveropenGauss-server
openGauss kernel ~ openGauss is an open source relational database management system
C++
63
145
ohos_react_nativeohos_react_native
React Native鸿蒙化仓库
C++
120
207
cherry-studiocherry-studio
🍒 Cherry Studio 是一款支持多个 LLM 提供商的桌面客户端
TypeScript
397
37
Cangjie-ExamplesCangjie-Examples
本仓将收集和展示高质量的仓颉示例代码,欢迎大家投稿,让全世界看到您的妙趣设计,也让更多人通过您的编码理解和喜爱仓颉语言。
Cangjie
297
1.03 K
openHiTLSopenHiTLS
旨在打造算法先进、性能卓越、高效敏捷、安全可靠的密码套件,通过轻量级、可剪裁的软件技术架构满足各行业不同场景的多样化要求,让密码技术应用更简单,同时探索后量子等先进算法创新实践,构建密码前沿技术底座!
C
98
251
HarmonyOS-ExamplesHarmonyOS-Examples
本仓将收集和展示仓颉鸿蒙应用示例代码,欢迎大家投稿,在仓颉鸿蒙社区展现你的妙趣设计!
Cangjie
358
342
CS-BooksCS-Books
🔥🔥超过1000本的计算机经典书籍、个人笔记资料以及本人在各平台发表文章中所涉及的资源等。书籍资源包括C/C++、Java、Python、Go语言、数据结构与算法、操作系统、后端架构、计算机系统知识、数据库、计算机网络、设计模式、前端、汇编以及校招社招各种面经~
50
5
金融AI编程实战金融AI编程实战
为非计算机科班出身 (例如财经类高校金融学院) 同学量身定制,新手友好,让学生以亲身实践开源开发的方式,学会使用计算机自动化自己的科研/创新工作。案例以量化投资为主线,涉及 Bash、Python、SQL、BI、AI 等全技术栈,培养面向未来的数智化人才 (如数据工程师、数据分析师、数据科学家、数据决策者、量化投资人)。
Jupyter Notebook
51
54