发表于 | 分类于

blade的背景我也就不详细介绍了，总体来说，
它是腾讯开源的一个构建工具，基于scons而非make，采用python编写，
目前的版本定位于linux下的C++程序。
它的设计思路来源于google的官方博客上的一篇文章，
Build in the Cloud: How the Build System works，
好吧，刚刚发现上面的网址挂了~~，大家将就一下，看这里吧,
有兴趣的同学可以去看一下。事实上这是一个系列，
里面讲述了google对大规模协作开发的理解，推荐大家看看。

blade是一个基于scons的构建系统，它做的主要工作是分析代码之间的依赖，
然后生成相应的scons的配置文件SConstruct，由于这一系列生成的中间文件的路径，
都是有blade根据规则自动创建，可以保证每个文件只会被编译一次，
而且中间结果可以被复用，这样就大大提高了大规模构建时的效率。
这篇文章仅仅对blade中的build过程进行分析，不会对run以及test进行描述，
事实上blade对test的支持相当的好，也许有时间研究了我会再写一篇文章来描述，
这是后话，暂且不提。

为了读懂blade，势必要了解什么是scons，scons是一个用python写的构建工具，
这里是它的官网，这篇文章的重点不在scons上面，
所以不会对它的好处和特点进行详细的说明，大家可以参考这里。
scons是通过读取项目根目录下的SConstruct文件来开始执行构建的，事实上，
SConstruct就是一个python脚本，scons为构建提供了一系列函数，
开发者在写SConstruct时，其实就是在写一个python的脚本。
这里介绍一下scons的简单用法：

  • scons ： 执行SConstruct中的脚本
  • scons -c : 相当于make clean，会根据默认规则和SConstruct定义的规则做Clean
  • scons -Q : 只显示编译信息，去除多余的打印信息

scons为它的配置脚本提供了一系列的函数用来构建，这里列举一些常用的：

  • Program : 生成可执行文件，如Program('foo','foo.cc')
    将会生成一个名为foo的可执行文件
  • Object : 故名思议，就是用来生成目标文件的函数，如Object('foo.cc')，
    在linux下将会生成foo.o
  • Library : 生成静态库和动态库文件，
    其中SharedLibrary将会仅仅生生成.so，而StaticLibrary将会生成.a
  • SourceSignatures : 判断源文件是否更改，可以通过时间戳或者MD5或者二者来判断
  • TargetSignatures : 判断目标文件是否更改，可以根据编译结果或者是内容来判断
  • Ignore : 用于忽略某个依赖关系，如Ignore(foo, 'foo.h')，
    则当foo.h改变时，不会重新编译foo
  • Depends : 用于显示的指定某个依赖关系，如Depends(foo, joke)，
    会将joke作为foo的依赖，joke的变更将会导致foo的重新编译
  • Command : 用于执行命令行命令，这个命令比较复杂，这里不详细展开，
    给出官方的UserGuide
  • Enviroment : 用于设定环境变量
  • Builder : 用于构建自己的Builder，如
    foobld = Builder(action = 'foobuild <$SOURCE> <$TARGET>')，
    这个用法也相对复杂，这里不详细展开，
    可以参考官方的UserGuide

以上用法的详细信息都可以在scons的官方文档上找到。

介绍完了scons，我们可以正式开始研究blade了。

首先我们来看一下blade的BUILD文件，在BUILD文件中，常用的函数有cc_library，
cc_test，cc_binary，proto_library等等，这些函数，做了两件事情，
首先创建一个target，然后将这个target注册给blade。

这里就不得不解释一下什么是target，在blade中，定义了一个抽象的父类叫Target，
它用于描述一个抽象的scons的target，子类如CcLibrary，CcBinary都会继承于它，
它定义了get_rules和scons_rules两个公共的抽象方法，
用于获取自身相关的scons rule。target中定义了一系列属性，用于描述该target，
我们主要需要关心的有下面这些：

  • name：target的name，就是在BUILD文件中定义的name属性，用来唯一标识一个target
  • path：这个属性通过blade来产生，用来标志target的路径
  • srcs：这个属性通过BUILD文件中的srcs来定义，存储了target相应的源码文件，
    也有可能是一个目录
  • deps：这个属性通过BUILD文件中得deps来定义，存储了target的依赖
  • expand_deps：这个属性通过blade生成，用来表示target中deps的deps
  • data：这个属性用来存储各种额外的信息，比如warning，incs等等

上面曾经说到，BUILD文件中你调用的函数，将会把target注册给blade，
于是blade就可以调用该target的scons_rules来生成SConstruct中的相应部分。

下面我以一个来举一个例子，来描述blade的build的流程。
首先我们创建一个创建了Fool和Me的代码如下：

Fool++view raw
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
// Copyright 2013, Kingslanding Inc.
// Author: Pine <cdtsgsz@gmail.com>
//
// Description: a simple test code
#ifndef TEST_FOOL_H_
#define TEST_FOOL_H_

namespace kingslanding {
namespace test {
    class Fool {
        public:
            void Say();
    };
}  // namespace test
}  // namespace kingslanding

#endif  // TEST_FOOL_H_
Fool++view raw
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
// Copyright 2013, Kingslanding Inc.
// Author: Pine <cdtsgsz@gmail.com>
//
// Description: fool implement file

#include "test/fool.h"

#include <stdio.h>

namespace kingslanding {
namespace test {
    void Fool::Say() {
       printf("haha, I'm a fool!!!");
    }
}  // namespace test
}  // namespace kingslanding
Me++view raw
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
// Copyright 2013, Kingslanding Inc.
// Author: Pine <cdtsgsz@gmail.com>
//
// Description: simple test code

#ifndef TEST_ME_H_
#define TEST_ME_H_

#include "test/fool.h"

namespace kingslanding {
namespace test {
class Me {
    public:
        void IntroduceSelf();
    private:
        Fool m_fool;
};
}  // namespace test
}  // namespace kingslanding
#endif  // TEST_ME_H_
Me++view raw
1
2
3
4
5
6
7
8
9
10
11
12
13
14
// Copyright 2013, Kingslanding Inc.
// Author: Pine <cdtsgsz@gmail.com>
//
// Description: implement me

#include "test/me.h"

namespace kingslanding {
namespace test {
    void Me::IntroduceSelf() {
        m_fool.Say();
    }
}  // namespace test
}  // namespace kingslanding

接着我们建立BUILD文件如下：

BUILDview raw
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
cc_library (
    name = 'fool',
    srcs = [
        'fool.cc',
    ],
)

cc_library (
    name = 'me',
    srcs = [
        'me.cc',
    ],
    deps = [
        ':fool',
    ],
)

通过blade build命令，
blade将会在blade-bin/test目录下build出一个libfool.a和libme.a。

当在命令行输入了blade build命令，blade做了什么呢？
我们可以从blade_main.py开始看起：

  • 首先自然是要需要解析出build这个动作，将它和相应的函数映射起来，
    可以看到blade_main中调用了CmdArguments()这个方法，
    这个方法由command_args模块提供，这个方法将会从命令行中parse出command和target、
    options，返回的是blade中真正的处理函数名。
  • 接着，blade将找到BLADE_ROOT所在的目录，将当前目录切换到BLADE_ROOT所在的目录，
    然后通过configparse这个模块，会解析出blade的config。
    blade不支持多进程编译，也就是说，
    一台机器上只允许有一个blade在同一个BLADE_ROOT下工作，
    blade采用了文件锁确保了这个机制。
  • 之后，blade_main初始化了一个blade的实例，调用它的blade.generate()的方法，
    在这一步骤中，blade的源代码中给这一句的注释是# Build the targets，
    我个人觉得这个注释不太对，事实上blade本身不会真的去build一些target，
    它只是去生成一个scons的SConstruct，而真正的build是在_build方法中，
    在这个方法中，blade会开启一个新的进程，在这个进程中打开scons，
    这时候，scons才会真正的去build源代码。
  • 最后，blade_main会删除生成的SConstruct。

那么接下来，我们就进入blade的generate方法，来看一看它干了什么？
blade的generate方法如下：

blade generate
1
2
3
4
5
def generate(self):
    """Generate the build script. """ 
    self.load_targets()
    self.analyze_targets()
    self.generate_build_rules()

可以看到，blade首先会加载所有的目标，这里就包括了去重，依赖展开等等，
然后，blade会去分析目标，得到一个层层依赖的顺序，
最后生成相应的build rule，写入SConstruct中。

到现在为止，关键路径已经出来了，我们来逐层深入，
在blade的load_target()函数中做了一大堆的判断，我们暂时不需要关心，
最后它调用了load_build_files模块的load_targets()函数，我们来看看它的实现：

load_build_files load_targets
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
def load_targets(target_ids, working_dir, blade_root_dir, blade):
    """load_targets.

    Parse and load targets, including those specified in command line
    and their direct and indirect dependencies, by loading related BUILD
    files.  Returns a map which contains all these targets.

    """
    target_database = blade.get_target_database()

    # targets specified in command line
    cited_targets = set()
    # cited_targets and all its dependencies
    related_targets = {}
    # source dirs mentioned in command line
    source_dirs = []
    # to prevent duplicated loading of BUILD files
    processed_source_dirs = set()

    direct_targets = []
    all_command_targets = []
    # Parse command line target_ids.  For those in the form of <path>:<target>,
    # record (<path>,<target>) in cited_targets; for the rest (with <path>
    # but without <target>), record <path> into paths.
    for target_id in target_ids:
        if target_id.find(':') == -1:
            source_dir, target_name = target_id, '*'
        else:
            source_dir, target_name = target_id.rsplit(':', 1)

        source_dir = relative_path(os.path.join(working_dir, source_dir),
                                    blade_root_dir)

        if target_name != '*' and target_name != '':
            cited_targets.add((source_dir, target_name))
        elif source_dir.endswith('...'):
            source_dir = source_dir[:-3]
            if not source_dir:
                source_dir = './'
            source_dirs.append((source_dir, WARN_IF_FAIL))
            for root, dirs, files in os.walk(source_dir):
                # Skip over subdirs starting with '.', e.g., .svn.
                dirs[:] = [d for d in dirs if not d.startswith('.')]
                for d in dirs:
                    source_dirs.append((os.path.join(root, d), IGNORE_IF_FAIL))
        else:
            source_dirs.append((source_dir, ABORT_IF_FAIL))

    direct_targets = list(cited_targets)

    # Load BUILD files in paths, and add all loaded targets into
    # cited_targets.  Together with above step, we can ensure that all
    # targets mentioned in the command line are now in cited_targets.
    for source_dir, action_if_fail in source_dirs:
        _load_build_file(source_dir,
                         action_if_fail,
                         processed_source_dirs,
                         blade)

    for key in target_database:
        cited_targets.add(key)
    all_command_targets = list(cited_targets)

    # Starting from targets specified in command line, breath-first
    # propagate to load BUILD files containing directly and indirectly
    # dependent targets.  All these targets form related_targets,
    # which is a subset of target_databased created by loading  BUILD files.
    while cited_targets:
        source_dir, target_name = cited_targets.pop()
        target_id = (source_dir, target_name)
        if target_id in related_targets:
            continue

        _load_build_file(source_dir,
                         ABORT_IF_FAIL,
                         processed_source_dirs,
                         blade)

        if target_id not in target_database:
            console.error_exit('%s: target //%s:%s does not exists' % (
                _find_depender(target_id, blade), source_dir, target_name))

        related_targets[target_id] = target_database[target_id]
        for key in related_targets[target_id].expanded_deps:
            if key not in related_targets:
                cited_targets.add(key)

    # Iterating to get svn root dirs
    for path, name in related_targets:
        root_dir = path.split('/')[0].strip()
        if root_dir not in blade.svn_root_dirs and '#' not in root_dir:
            blade.svn_root_dirs.append(root_dir)

    return direct_targets, all_command_targets, related_targets

这个函数很长，里面的变量名也晦涩难懂，我贴出来也没指望有人有人会把它真正的读完，
但是，不需要完全的去分析每个细节，我们基本上可以看出这个函数做了两件事情：

  1. 找到所有的target
  2. load相应的BUILD file

事实上仔细看这个函数的实现，
它无非是将target和它deps中所有target所在的路径解析出来，
然后调用_load_build_file这个函数，去加载相应的配置文件，
这个递归过程在这里采用了循环的方式，使得代码读起来有点不容易，
不过循环的方式可以减少栈的深度，有助于效率的提高。
现在一切矛头都指向了_load_build_file这个函数，我们来看看它的实现：

load_build_files _load_build_file
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
def _load_build_file(source_dir, action_if_fail, processed_source_dirs, blade):
    """_load_build_file to load the BUILD and place the targets into database.

    Invoked by _load_targets.  Load and execute the BUILD
    file, which is a Python script, in source_dir.  Statements in BUILD
    depends on global variable current_source_dir, and will register build
    target/rules into global variables target_database.  If path/BUILD
    does NOT exsit, take action corresponding to action_if_fail.  The
    parameters processed_source_dirs refers to a set defined in the
    caller and used to avoid duplicated execution of BUILD files.

    """

    # Initialize the build_target at first time, to be used for BUILD file
    # loaded by execfile
    global build_target
    if build_target is None:
        build_target = TargetAttributes(blade.get_options())
        build_rules.register_variable('build_target', build_target)

    source_dir = os.path.normpath(source_dir)
    # TODO(yiwang): the character '#' is a magic value.
    if source_dir in processed_source_dirs or source_dir == '#':
        return
    processed_source_dirs.add(source_dir)

    if not os.path.exists(source_dir):
        _report_not_exist(source_dir, source_dir, blade)

    old_current_source_path = blade.get_current_source_path()
    blade.set_current_source_path(source_dir)
    build_file = os.path.join(source_dir, 'BUILD')
    if os.path.exists(build_file):
        try:
            # The magic here is that a BUILD file is a Python script,
            # which can be loaded and executed by execfile().
            execfile(build_file, build_rules.get_all(), None)
        except SystemExit:
            console.error_exit('%s: fatal error, exit...' % build_file)
        except:
            console.error_exit('Parse error in %s, exit...\n%s' % (
                    build_file, traceback.format_exc()))
    else:
        if action_if_fail == ABORT_IF_FAIL:
            _report_not_exist(source_dir, build_file, blade)

    blade.set_current_source_path(old_current_source_path)

又是一大段的代码，对路径的各种操作，但是还好这些都是细节，如果不去实现，
不需要太过关心，事实上这一段内容的核心是一句代码两行注释：

1
2
3
# The magic here is that a BUILD file is a Python script,
# which can be loaded and executed by execfile().
execfile(build_file, build_rules.get_all(), None)

到这里，是不是有种茅塞顿开的感觉？
在这篇文章的早些时候我曾经花过一下篇幅介绍BUILD，现在我们来回头看一下，
以上面我举的那个BUILD文件为例，execfile函数将会执行BUILD文件中的cc_library函数。
我们来看一下cc_library函数的实现，这个函数在cc_targets模块中，我们可以看一下：

cc_targets cc_library
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
def cc_library(name,
               srcs=[],
               deps=[],
               warning='yes',
               defs=[],
               incs=[],
               export_incs=[],
               optimize=[],
               always_optimize=False,
               pre_build=False,
               prebuilt=False,
               link_all_symbols=False,
               deprecated=False,
               extra_cppflags=[],
               extra_linkflags=[],
               **kwargs):
    """cc_library target. """
    target = CcLibrary(name,
                       srcs,
                       deps,
                       warning,
                       defs,
                       incs,
                       export_incs,
                       optimize,
                       always_optimize,
                       prebuilt or pre_build,
                       link_all_symbols,
                       deprecated,
                       extra_cppflags,
                       extra_linkflags,
                       blade.blade,
                       kwargs)
    if pre_build:
        console.warning("//%s:%s: 'pre_build' has been deprecated, "
                        "please use 'prebuilt'" % (target.path,
                                                   target.name))
    blade.blade.register_target(target)

现在巧妙之处就真正出来了，这个函数其实就是创建一个target对象，
并且将它注册进blade，供后面使用，所以其实遍历一次BUILD文件，
所有的target都自动加载了，在读这段代码的时候，有一种感觉，
就是本来加载就如同收麦子一样，非常辛苦，需要blade一个个去收集，
而现在是走过每片田地，麦子自己就跳进来了。当然这个比喻并不是很准确，
但这个设计的确是相当的巧妙，让人觉得享受。

事实上到这里，后面的代码阅读起来已经没有难度了，现在所有的target已经加载，
接下来就是target的分析了，我们回到blade的主干，analyze_targets的实现比较简单，
我这里就不贴上来逐步分析了，
它最后追溯到dependency_analyzer模块的analyze_deps函数中，
我们来看一下这个函数的实现：

dependency_analyzer analyze_deps
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
def analyze_deps(related_targets):
    """analyze the dependency relationship between targets.

    Input: related targets after loading targets from BUILD files.
           {(target_path, target_name) : (target_data), ...}

    Output:the targets that are expanded and the keys sorted
           [all the targets keys] - sorted
           {(target_path, target_name) : (target_data with deps expanded), ...}

    """
    _expand_deps(related_targets)
    keys_list_sorted = _topological_sort(related_targets)

    return keys_list_sorted

可以看到，其实这个地方就是根据依赖关系，将所有的target做了一个拓扑排序，
这个拓扑排序的算法其实很有意思，当然不是我这篇文章的重点，
不过有兴趣的同学可以去看一下。

现在内存中的target都是完整而且有序的了，我们可以安心地生成SConstruct了，
在这一步中，之前target的设计优势就体现了，
每个target根据自己的属性生成自己的scons rule，最后汇总起来，加上文件头，
就是一个完整的SConstruct文件了。我们可以看一下我例子中用blade生成的SConstruct：

SConstructview raw
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
import sys
sys.path.insert(0, '/Users/Pine/Workspace/python/typhoon-blade/src/blade')


import os
import subprocess
import signal
import time
import socket
import glob

import blade_util
import console
import scons_helper

from build_environment import ScacheManager
from console import colors
from scons_helper import MakeAction
from scons_helper import create_fast_link_builders
from scons_helper import echospawn
from scons_helper import error_colorize
from scons_helper import generate_python_binary
from scons_helper import generate_resource_file
from scons_helper import generate_resource_header

if not os.path.exists('build64_release'):
    os.mkdir('build64_release')
os.environ["LC_ALL"] = "C"
top_env = Environment(ENV=os.environ)
top_env.Decider("MD5-timestamp")
console.color_enabled=True
top_env["SPAWN"] = echospawn

compile_proto_cc_message = '%sCompiling %s$SOURCE%s to cc source%s' %     (colors('cyan'), colors('purple'), colors('cyan'), colors('end'))

compile_proto_java_message = '%sCompiling %s$SOURCE%s to java source%s' %     (colors('cyan'), colors('purple'), colors('cyan'), colors('end'))

compile_proto_php_message = '%sCompiling %s$SOURCE%s to php source%s' %     (colors('cyan'), colors('purple'), colors('cyan'), colors('end'))

compile_proto_python_message = '%sCompiling %s$SOURCE%s to python source%s' %     (colors('cyan'), colors('purple'), colors('cyan'), colors('end'))

compile_thrift_cc_message = '%sCompiling %s$SOURCE%s to cc source%s' %     (colors('cyan'), colors('purple'), colors('cyan'), colors('end'))

compile_thrift_java_message = '%sCompiling %s$SOURCE%s to java source%s' %     (colors('cyan'), colors('purple'), colors('cyan'), colors('end'))

compile_thrift_python_message = '%sCompiling %s$SOURCE%s to python source%s' %     (colors('cyan'), colors('purple'), colors('cyan'), colors('end'))

compile_resource_header_message = '%sGenerating resource header %s$TARGET%s%s' %     (colors('cyan'), colors('purple'), colors('cyan'), colors('end'))

compile_resource_message = '%sCompiling %s$SOURCE%s as resource file%s' %     (colors('cyan'), colors('purple'), colors('cyan'), colors('end'))

compile_source_message = '%sCompiling %s$SOURCE%s%s' %     (colors('cyan'), colors('purple'), colors('cyan'), colors('end'))

link_program_message = '%sLinking Program %s$TARGET%s%s' %     (colors('green'), colors('purple'), colors('green'), colors('end'))

link_library_message = '%sCreating Static Library %s$TARGET%s%s' %     (colors('green'), colors('purple'), colors('green'), colors('end'))

ranlib_library_message = '%sRanlib Library %s$TARGET%s%s' %     (colors('green'), colors('purple'), colors('green'), colors('end')) 
link_shared_library_message = '%sLinking Shared Library %s$TARGET%s%s' %     (colors('green'), colors('purple'), colors('green'), colors('end'))

compile_java_jar_message = '%sGenerating java jar %s$TARGET%s%s' %     (colors('cyan'), colors('purple'), colors('cyan'), colors('end'))

compile_python_binary_message = '%sGenerating python binary %s$TARGET%s%s' %     (colors('cyan'), colors('purple'), colors('cyan'), colors('end'))

compile_yacc_message = '%sYacc %s$SOURCE%s to $TARGET%s' %     (colors('cyan'), colors('purple'), colors('cyan'), colors('end'))

compile_swig_python_message = '%sCompiling %s$SOURCE%s to python source%s' %     (colors('cyan'), colors('purple'), colors('cyan'), colors('end'))

compile_swig_java_message = '%sCompiling %s$SOURCE%s to java source%s' %     (colors('cyan'), colors('purple'), colors('cyan'), colors('end'))

compile_swig_php_message = '%sCompiling %s$SOURCE%s to php source%s' %     (colors('cyan'), colors('purple'), colors('cyan'), colors('end'))


top_env.Append(
    CXXCOMSTR = compile_source_message,
    CCCOMSTR = compile_source_message,
    SHCCCOMSTR = compile_source_message,
    SHCXXCOMSTR = compile_source_message,
    ARCOMSTR = link_library_message,
    RANLIBCOMSTR = ranlib_library_message,
    SHLINKCOMSTR = link_shared_library_message,
    LINKCOMSTR = link_program_message,
    JAVACCOMSTR = compile_source_message
)
VariantDir("build64_release", ".", duplicate=0)

env_version = Environment(ENV = os.environ)
env_version.Append(SHCXXCOMSTR = '%sUpdating version information%s' % (colors('cyan'), colors('end')))
env_version.Append(CPPFLAGS = '-m64')
version_obj = env_version.SharedObject('build64_release/version.cpp')

time_value = Value("Thu Nov  7 02:44:31 2013")
proto_bld = Builder(action = MakeAction("thirdparty/protobuf/bin/protoc --proto_path=. -I. -I thirdparty -I=`dirname $SOURCE` --cpp_out=build64_release $SOURCE", compile_proto_cc_message))
proto_java_bld = Builder(action = MakeAction("thirdparty/protobuf/bin/protoc --proto_path=. --proto_path=thirdparty --java_out=build64_release/`dirname $SOURCE` $SOURCE", compile_proto_java_message))
proto_php_bld = Builder(action = MakeAction("thirdparty/protobuf/bin/protoc --proto_path=. --plugin=protoc-gen-php=thirdparty/Protobuf-PHP/protoc-gen-php.php -I. -I thirdparty -Ithirdparty/Protobuf-PHP/library -I=`dirname $SOURCE` --php_out=build64_release/`dirname $SOURCE` $SOURCE", compile_proto_php_message))
proto_python_bld = Builder(action = MakeAction("thirdparty/protobuf/bin/protoc --proto_path=. -I. -I thirdparty -I=`dirname $SOURCE` --python_out=build64_release $SOURCE", compile_proto_python_message))
thrift_bld = Builder(action = MakeAction("/usr/local/bin/thrift --gen cpp:include_prefix -I .  -I `dirname $SOURCE` -out build64_release/`dirname $SOURCE` $SOURCE", compile_thrift_cc_message))
thrift_java_bld = Builder(action = MakeAction("/usr/local/bin/thrift --gen java -I .  -I `dirname $SOURCE` -out build64_release/`dirname $SOURCE` $SOURCE", compile_thrift_java_message))
thrift_python_bld = Builder(action = MakeAction("/usr/local/bin/thrift --gen py -I .  -I `dirname $SOURCE` -out build64_release/`dirname $SOURCE` $SOURCE", compile_thrift_python_message))

blade_jar_bld = Builder(action = MakeAction('jar cf $TARGET -C `dirname $SOURCE` .',
    compile_java_jar_message))

yacc_bld = Builder(action = MakeAction('bison $YACCFLAGS -d -o $TARGET $SOURCE',
    compile_yacc_message))

resource_header_bld = Builder(action = MakeAction(generate_resource_header,
    compile_resource_header_message))

resource_file_bld = Builder(action = MakeAction(generate_resource_file,
    compile_resource_message))

python_binary_bld = Builder(action = MakeAction(generate_python_binary,
    compile_python_binary_message))

top_env.Append(BUILDERS = {"Proto" : proto_bld})
top_env.Append(BUILDERS = {"ProtoJava" : proto_java_bld})
top_env.Append(BUILDERS = {"ProtoPhp" : proto_php_bld})
top_env.Append(BUILDERS = {"ProtoPython" : proto_python_bld})
top_env.Append(BUILDERS = {"Thrift" : thrift_bld})
top_env.Append(BUILDERS = {"ThriftJava" : thrift_java_bld})
top_env.Append(BUILDERS = {"ThriftPython" : thrift_python_bld})
top_env.Append(BUILDERS = {"BladeJar" : blade_jar_bld})
top_env.Append(BUILDERS = {"Yacc" : yacc_bld})
top_env.Append(BUILDERS = {"ResourceHeader" : resource_header_bld})
top_env.Append(BUILDERS = {"ResourceFile" : resource_file_bld})
top_env.Append(BUILDERS = {"PythonBinary" : python_binary_bld})
top_env.Replace(CC="gcc", CXX="g++", CPPPATH=["thirdparty", "build64_release", "/System/Library/Frameworks/Python.framework/Versions/2.7/include/python2.7"], CPPFLAGS=['-m64', '-mcx16', '-pipe', '-g', '-DNDEBUG', '-D_FILE_OFFSET_BITS=64', '-D__STDC_FORMAT_MACROS', '-D__STDC_LIMIT_MACROS'], CFLAGS=[], CXXFLAGS=[], LINK="g++", LINKFLAGS=['-m64'])
env_with_error = top_env.Clone()
env_no_warning = top_env.Clone()
env_with_error.Append(CPPFLAGS=['-Wall', '-Wextra', '-Wno-unused-but-set-variable', '-Wno-unused-parameter', '-Wno-unused-local-typedefs', '-Wno-missing-field-initializers', '-Wendif-labels', '-Wfloat-equal', '-Wformat=2', '-Wframe-larger-than=69632', '-Wmissing-include-dirs', '-Wpointer-arith', '-Wwrite-strings', '-Werror=char-subscripts', '-Werror=comments', '-Werror=conversion-null', '-Werror=empty-body', '-Werror=endif-labels', '-Werror=format', '-Werror=format-nonliteral', '-Werror=missing-include-dirs', '-Werror=overflow', '-Werror=parentheses', '-Werror=reorder', '-Werror=return-type', '-Werror=sequence-point', '-Werror=sign-compare', '-Werror=switch', '-Werror=type-limits', '-Werror=uninitialized', '-Werror=unused-label', '-Werror=unused-result', '-Werror=unused-value', '-Werror=unused-variable', '-Werror=write-strings'], CFLAGS=['-Werror-implicit-function-declaration'], CXXFLAGS=['-Wno-invalid-offsetof', '-Wnon-virtual-dtor', '-Woverloaded-virtual', '-Wvla', '-Werror=non-virtual-dtor', '-Werror=non-virtual-dtor', '-Werror=overloaded-virtual', '-Werror=vla'])
env_v_test_mAgIc_fool = env_with_error.Clone()
env_v_test_mAgIc_fool.Append(CPPFLAGS=['-O2', '-fno-omit-frame-pointer'])
v_test_mAgIc_fool_cc_fool_object = env_v_test_mAgIc_fool.SharedObject(target = "build64_release/test/fool.objs/fool.cc" + top_env["OBJSUFFIX"], source = "build64_release/test/fool.cc")
env_v_test_mAgIc_fool.Depends(v_test_mAgIc_fool_cc_fool_object, "build64_release/test/fool.cc")
objs_v_test_mAgIc_fool = [v_test_mAgIc_fool_cc_fool_object]
v_test_mAgIc_fool = env_v_test_mAgIc_fool.Library("build64_release/test/fool", objs_v_test_mAgIc_fool)
env_v_test_mAgIc_fool.Depends(v_test_mAgIc_fool, objs_v_test_mAgIc_fool)
env_v_test_mAgIc_me = env_with_error.Clone()
env_v_test_mAgIc_me.Append(CPPFLAGS=['-O2', '-fno-omit-frame-pointer'])
v_test_mAgIc_me_cc_me_object = env_v_test_mAgIc_me.SharedObject(target = "build64_release/test/me.objs/me.cc" + top_env["OBJSUFFIX"], source = "build64_release/test/me.cc")
env_v_test_mAgIc_me.Depends(v_test_mAgIc_me_cc_me_object, "build64_release/test/me.cc")
objs_v_test_mAgIc_me = [v_test_mAgIc_me_cc_me_object]
v_test_mAgIc_me = env_v_test_mAgIc_me.Library("build64_release/test/me", objs_v_test_mAgIc_me)
env_v_test_mAgIc_me.Depends(v_test_mAgIc_me, objs_v_test_mAgIc_me)

可以看到，上面有很多复杂的东西，这篇文章都没有提到，
事实上为了保证编译环境的干净，以及目录结构的清晰，blade还做了环境变量的Clone、
路径的变换等许多工作，希望了解细节的同学可以自己去读一下源代码。

最后，来提一下blade设计上的现有不足：

  • 首先，大家可以发现blade这个模块全局贯穿各大模块，
    而事实上很多模块是作为工具模块存在的，不需要了解blade的所有信息，
    直接将blade当做参数传递没有做到信息的隐蔽性。
  • 其次，现在的rule_generator在生成SConstruct文件头的时候，是固定生成一些Builder，
    这样就导致如果新增添一种target的类型，会需要修改现有代码，
    可以考虑将Builder的生成分散在各个target中，每个新的target只需要去注册就ok了。
  • blade中对Clean的考虑比较少，会有很多中间结果删不掉，
    可以通过在target中定义Clean操作来实现。

总体来说，blade是一款非常优秀的开源软件，它的理念很多都是超前的，
这种源码分发，统一环境的理念，事实上对一个公司是一个颠覆式的东西，
“万丈高楼起于基石”，一切创新都将变得事半功倍。

发表于 | 分类于

已经很晚了，之前一直没有下定决心来写一个blog，一来我有点洁癖，
所有的东西都要自己完全搞懂了才愿意动手，
所以曾经想尝试自己去写一个静态代码的生成器，当然最后不了了之了，
二来写一个自己的blog，就意味着额外的工作量，而我是一个很懒的人，
所以每每思及写作之苦，便又退缩了几分。

下周公司小组里面要做一个blade的分享，之前的分享大家都写了很漂亮的文档，
让我压力有点大，于是琢磨着是不是借此机会，干脆把这个blog搭建出来，
于是就有了这个《云烟记事录》。

这个小站将以技术分享学习为主，当然也同样会记录我生活的喜怒哀乐，
作为我小小人生的一个旁观者，也许若干年后回头看，会有别样的心情。