██████╗ ██╗ █████╗ ██████╗ ███████╗
██╔══██╗██║ ██╔══██╗██╔══██╗██╔════╝
██████╔╝██║ ███████║██║ ██║█████╗
██╔══██╗██║ ██╔══██║██║ ██║██╔══╝
██████╔╝███████╗██║ ██║██████╔╝███████╗
╚═════╝ ╚══════╝╚═╝ ╚═╝╚═════╝ ╚══════╝
Blade是一个方便易用高性能的现代化代码构建系统,特别适合公司内的大规模代码库的敏捷构建,内置了对多种编程语言及单元测试框架的直接支持。
Blade is an easy-to-use, fast and modern build system for trunk based development in large scale monorepo codebase.
Click here to read README in English.
- 仓库名从typhoon-blade改名为blade-build。
- Blade 发布1.1.2,包含以下特性:
- python 最低版本要求2.6
- 对Java,scala构建的完善支持
- 支持扩展
1.1.2版是最后一个1.x版本,我们正在开发2.0版本(最新代码在在master分支上),包含以下特性:
- 后端支持ninja,大幅度提高构建性能
- 全面支持Python构建
- 完善对扩展的支持
- 支持kotlin,rust构建
- python2只支持2.7
敬请期待。
Blade 是一个现代构建系统,期望的目标是强大而好用,把程序员从构建的繁琐中解放出来。
Blade主要定位于linux下的大型C++项目,密切配合研发流程,比如单元测试,持续集成,覆盖率统计等。 但像unix下的文本过滤程序一样,保持相对的独立性,可以单独运行。目前重点支持i386/x86_64 Linux,未来可以考虑支持其他的类Unix系统。
在腾讯公司“台风”云计算平台开发过程中,为了解决 GNU Make, Autotools 的难用和繁琐的问题,参考Google工程博客上的一些文章,我们开发了这个全新的构建系统,整个系统基于多个声明式的构建脚本,在构建脚本里, 只需要声明要构建什么目标,目标的源代码,以及其直接依赖的其它目标,不需要说明如何构建。大大降低了使用难度,提高了开发效率。
2012年,Blade对外开源,成为腾讯公司最早的开源项目。目前已经广泛应用于腾讯广告系统、微信后台服务、腾讯游戏后台服务、腾讯基础架构,以及小米,百度,爱奇艺等其他公司,也收到了来自公司内外的多个Pull Requests。
代码开源后,托管到googlecode上,因后来googlecode关闭,迁移到chen3feng个人git仓库继续维护。
首先,Blade解决了依赖问题。 当你在构建某些目标时,头文件有变化,会自动重新构建。 最方便的是,Blade也能追踪库文件的依赖关系。比如 库 foo 依赖库 common,那么在库 foo 的 BUILD 文件中列入依赖:
cc_library(
name = 'foo',
srcs = ...,
deps = ':common'
)
那么对于使用foo的程序,如果没有直接用到common,那么就只需要列出foo,并不需要列出common。
cc_binary(
name = 'my_app',
srcs = ...,
deps = ':foo'
)
这样当你的库实现发生变化,增加或者减少库时,并不需要通知库的用户一起改动,Blade自动维护这层间接的依赖关系。当构建my_app时,也会自动检查foo和common是否也需要更新。
说到易用性,除了依赖关系的自动维护,Blade还可以做到,用户只需要敲一行命令,就能把整个目录树的编译链接和单元测试全部搞定。例如:
递归构建和测试common目录下所有的目标
$ blade test common...
以32位模式构建和测试
$ blade test -m32 common...
以调试模式构建和测试
$ blade test -pdebug common...
显然,你可以组合这些标志
$ blade test -m32 -pdebug common...
- 自动分析头文件依赖关系,构建受影响的代码。
- 增量编译和链接,只构建因变更受影响而需要重新构建的代码。
- 自动计算库的间接依赖,库的作者只需要写出直接依赖,构建时自动检查所依赖的库是否需要重新构建。
- 在任意代码树的任意子目录下都能构建。
- 支持一次递归构建多个目录下的所有目标,也支持只构建任意的特定的目标。
- 无论构建什么目标,这些目标所依赖的目标也会被自动连坐更新。
- 内置 debug/release 两种构建类型。
- 彩色高亮构建过程中的错误信息。
- 支持 ccache
- 支持 distcc
- 支持基于构建多平台目标
- 支持构建时选择编译器(不同版本的gcc,clang等)
- 支持编译 protobuf,lex, yacc, swig
- 支持自定义规则
- 支持测试,在命令行跑多个测试
- 支持并行测试(多个测试进程并发运行)
- 支持增量测试(无需重新运行的测试程序自动跳过)
- 集成 gperftools,自动检测测试程序的内存泄露
- 构建脚本 vim 语法高亮
- svn 式的子命令命令行接口。
- 支持 bash 命令行补全
- 用 python 编写,无需编译,直接安装使用。
彻底避免以下问题:
- 头文件更新,受影响的模块没有重新构建。
- 被依赖的库需要更新,而构建时没有被更新,比如某子目录依
- Blade 是受 Google 官方博客发表的这篇文章启发而开发的: 云构建:构建系统是如何工作的
- 现阶段 Blade 生成 SCons 脚本进行构建,因此 Blade 的运行还需要依赖 SCons。
- Python 是一种简单易用而又强大的语言,我们喜欢python。
- Google 开放的一些库强大而好用,我们很喜欢,我们把对这些库的支持集成进了Blade中,既方便了库的使用, 又增强了 Blade,这些库包括 glog, protobuf, gtest, gperftools。
我们的理念:解放程序员,提高生产力。用工具来解决非创造性的技术问题。
欢迎使用以及帮助我们改进Blade,我们期待你的贡献。目前的贡献者名单
看到这里,你应该觉得Blade是个不错的工具,那么,阅读完整文档,开始使用吧。
如果遇到有问题,可以试试先查一下FAQ,也许有你需要的信息。