Bazel

简介：
Bazel 是 google 研发的一款开源构建和测试工具,也是一种简单、易读的构建工具。
Bazel 支持多种编程语言的项目，并针对多个平台构建输出。

高级构建语言：Bazel 使用一种抽象的、人类可读的语言在高语义级别上描述项目的构建属性。与其他工具不同，Bazel 在库、二进制文件、脚本和数据集的概念上运行，免于编写对编译器和链接器等工具的单独调用的复杂性。
Bazel 既快速又可靠：Bazel 会缓存之前完成的所有工作，并跟踪对文件内容和构建命令所做的更改。这样，Bazel就能知道何时需要重新构建某些内容，并且仅重新构建。如需进一步加快构建速度，可以将项目设置为以高度并行且增量的方式进行构建。
Bazel 是多平台应用：Bazel可在 Linux、macOS 和 Windows 上运行。Bazel 可以在同一个项目中为多个平台（包括桌面设备、服务器和移动设备）构建二进制文件和可部署软件包。
Bazel 可以扩缩。在处理具有 10 万多个源文件的 build 时，Bazel 能够保持敏捷性。它可与数以万计的代码库和用户群进行协作。
Bazel 是可扩展的。支持许多语言，您、可以扩展 Bazel 以支持任何其他语言或框架。

Bazel 基本使用流程

在 Aoollo 的 docker 容器中已经安装了 Bazel，所以直接使用即可，Bazel的使用比较简单，大致流程下:
1.新建project目录，project 目录下新建文件 WORKSPACE；
2.新建包，在包下新建 BUILD 文件；
3.包中编写源文件；
4.编辑BUILD文件；
5.编译；
6.执行。
准备工作:在 /apollo/cyber 目录下新建 demo_base_bazel 目录，后续关于 bazel 实现都存储在该目录中。

C++实现

１.新建project目录
在demo_base_bazel 目录下新建目录 pro1_helloworld，再在 pro1_helloworld 目录下新建 WORKSPACE 文件。
2.新建包目录
在 pro1_helloworld 目录下新建 demo_pkg 目录，该目录下新建 BUILD 文件。
3.新建源文件
在 demo_pkg 目录下新建 C++ 源文件 hello_world.cc，编写内容如下：

/*
    输出 hello bazel
*/
# include<iostream>

using namespace  std;

int main(int argc, char const *argv[])
{
    /* code */
    cout<<"hello bazel"<<endl;
    return 0;
}

在 demo_pkg 目录下新建文件 BUILD，编写内容如下：

cc_binary(
    name="hello",
    srcs=["hello_world.cc"],
)

name：可执行文件；
srcs：源文件
4.保存后，到达 pro01_helloworld 目录下，执行：

bazel build demo_pkg/...

如果在 pro01_helloworld 下有多个文件，可以使用下面的指令指定编译文件：

bazel build demo_pkg：指定文件名（为BUILD文件中的name）

5.在 pro01_helloworld 目录下的 bazel-bin/demo_pkg 下找到 hello 文件，执行：

./bazel-bin/demo_pkg/hello

也可以使用：

bazel run demo_pkg:hello

这条指令同时进行编译和执行，可以不先编译直接进行使用。

python 实现与C++步骤相同，唯一不同就是这里是 py_binary，且name与src一致：

// BUILD
py_binary(
    name="hello_world_py",
    srcs=["hello_world_py.py"],
)

#hello_world_py.py
#!usr/bin/env python3
if __name__ == "__main__":
    print("hello bazel(python)")

Bazel 使用的库依赖

编写被依赖库实现

首先需要实现被依赖的库的相关文件。
1.新建project目录
在demo_base_bazel目录下新建目录pro2_lib，再在pro2_lib目录下新建WORKSPACE文件。
⒉新建包目录
在pro2_lib目录下新建demo_lib目录，该目录下新建BUILD文件。
3.新建头文件与源文件
在demo_lib目录下新建c++头文件 hello_great.h，编写内容如下：

#ifndef LIB_HELLO_GREAT_H
#define LIB_HELLO_FREAT_H
#include <string>
std :: string get_great(const std :: string& name);
#endif

在 demo_lib 目录下新建C++ 头文件hello_great.cc，编写内容如下：

#include "hello_great.h"

std :: string get_great( const std :: string&  name){
    return "hello " + name;
}

4.编辑BUILD文件
内容如下：

cc_library(
    name="hello_great_lib",
    srcs=["hello_great.cc"],
    hdrs=["hello_great.h"],
)

name 库文件
srcs 源文件
hdrs 头文件
5.进行编译

bazel build demo_lib/...
//或
bazel build demo_lib:hello_world_great

同包下的库依赖

1.编写C++源文件
承上，在 demo_lib 目录中新建 hello_world.cc，需要包含 hello_great.h 并调用头文件中的 get_great 函数，内容如下:

#include <iostream>
#include "hello_great.h"
using namespace std;
int main(int argc,char const *argv[]){
	cout<<get_great("bazel lib")<<endl;
	return 0;
}

2.编辑BUILD文件

cc_binary(
	name="hello_world",
	srcs=["hello_world.cc"],
	deps=[":hello_great_lib"]
)

deps：依赖项

3.编译

4.执行

跨包库依赖

1.新建包
基于上面的，在pro2_lib下新建包: demo_main，包下新建BUILD文件。
⒉.新建C++源文件
在包 demo_main 中新建hello_world.cc 文件，需要包含 hello_great.h 并调用头文件中的 get_great 函数，内容如下:

#include <iostream>
#include "demo_lib/hello_great.h"
using namespace std;
int main(int argc，char const *argv[])
	cout << get_great( "bazel lib") << endl;
	return 0;
}

3.编辑BUILD文件
BUILD文件内容如下:

cc_binary(
	name = "hello_world",
	srcs = ["hello_world.cc"],
	deps = ["//demo_lib:hello_great_lib"],

另外，还需要为 demo_lib 包添加可访问权限，否则会导致编译失败，修改 demo_lib/BUILD 文件。

方式1:在demo_lib/BUILD文件中添加函数:

package(default_visibility = [" //visibility : public"])

方式2:修改cc_library函数内容如下:

cc_library(
	name = "hello_great_lib",
	srcs = ["hello_great.cc"],
	hdrs = [ "hello_great.h"],
	visibility = ["//demo_main:__pkg__"]
)

visibility 设置可见度(权限）

4.编译和运行

…