一、目录构造样式
. └── workspace ├── BLADE_ROOT ├── build64_release ├── client │ ├── BUILD │ └── client.cpp ├── idl │ └── student │ ├── BUILD │ └── student.thrift ├── proj │ ├── BUILD │ └── src │ ├── main.cpp_bak │ └── student_funcs_server.skeleton.cpp ├── README └── SConstruct
二、blade 各个文件的意义
一般会先建立一个workspace,在里面touch BLADE_ROOT。包含BLADE_ROOT的文件夹是blade的根目录,比如如果要引用其他项目的头文件,路径是需要相对于BLADE_ROOT这一级目录来写的
三、BUILD 文件
cc_binary( name='client', srcs='client.cpp', deps=[ '//idl/student:student_thrift', ] )
cc_library(
name='abs_lib', srcs='abs.cpp',
allow_undefined=True,
)
name值得是这个binary的名字
srcs是要编译这个binary需要的源文件
deps是编译这个binary所需要的依赖。比如说workspace/proj/src/main.cpp里面调用了 workspace/abs/abs.cpp里面的abs()方法来取绝对值,那么就需要添加deps = ['//abs:abs_lib']这个依赖,注意,//abs:abs_lib里面的abs是相对于workspace的一个路径,后面的abs_lib是abs这个项目里面BUILD文件的name。
cc_library,这是说明,要讲目标编译成库文件,默认编译成"libabs_lib.a"这个静态库文件,可以通过添加编译选项,这样,blade build --generate-dynamic,这个参数来生成动态库,生成动态库的时候可能会报未定义的符号,可以加上 allow_undefined=True,这个选项
如果A library被B依赖,并且B的BUILD文件里面有dynamic_link=1这个选项,那么A库也会生成动态so库
四、编译
blade build
选项
--update-deps 自动从git上拉取依赖
五、用blade来自动编译thrift项目
需要用到 thrift_library
thrift_library( name="student_thrift", srcs="student.thrift", export_incs=[""], deps = [ "cpp3rdlib/thrift:0.9.1@//cpp3rdlib/thrift:thrift", #"//idl/base:base_thrift", ], )
thrift_library就会生成相应的thrift文件,相当于帮你手动执行了 thrift -gen cpp workspace/idl/student.thrift这个命令
如果我的 workspace/proj/src/main.cpp 是一个thrift server,那应该怎样写BUILD呢? 很简单,直接在deps里面写入 '//idl/student:student_thrift' 即可。这样,我的main.cpp里面就可以直接包含thrift的相关头文件了,然后最终将main.cpp编译成一个 thrift 的 server