构建工具blade

概述

Blade 是一个现代构建系统，期望的目标是强大而好用，把程序员从构建的繁琐中解放出来。

Blade主要定位于linux下的大型C++项目，密切配合研发流程，比如单元测试，持续集成，覆盖率统计等。但像unix下的文本过滤程序一样，保持相对的独立性，可以单独运行。目前重点支持i386/x86_64 Linux，未来可以考虑支持其他的类Unix系统。

在腾讯公司“台风”云计算平台开发过程中，为了解决 GNU Make，Autotools 的难用和繁琐的问题，我们开发了这个全新的构建系统，整个系统基于多个声明式的构建脚本，在构建脚本里，只需要声明要构建什么目标，目标的源代码，以及其直接依赖的其它目标，不需要说明如何构建。大大降低了使用难度，提高了开发效率。

首先，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。
为了支持python 2.6及更低版本，我们把python 2.7中的argparse.py放入了源码包。
Google 开放的一些库强大而好用，我们很喜欢，我们把对这些库的支持集成进了Blade中，既方便了库的使用，又增强了 Blade，这些库包括 glog, protobuf,gtest, gproftools。

更多文档请参考Blade wiki。

应用

自己尝试使用scons和Blade分别编译了一下my_consistent_hash。

scons编译

项目文件(SConstruct是scons编译所需的配置文件，相当于makefile)：

scons编译所需配置文件SConstruct内容(下面的Glob表示的是glob模式：指 shell 所使用的简化了的正则表达式。支持*,[],?,[0-9]等正则表达式的操作)：

Program('conhash', Glob('*.cpp'),CCFLAGS='-std=c++11')

编译：

编译后该目录下的文件：

run:

直接运行 ./conhash 即可

clean：

Blade编译

项目文件(BUILD是Blade编译所需的配置文件，相当于makefile，Blade获取源代码根的方法是，无论当前从哪一级子目录运行，都从当前目录开始向上查找BLADE_ROOT文件，故在项目根目录需要有BLADE_ROOT文件，此处的BLADE_ROOT用的是blade里面自带的，除了cc_config中的内容，增加了对C++11的支持)：

Blade编译所需配置文件BUILD内容：

编译：