bazel学习

bazel,学习 · 浏览次数 : 676

小编点评

**使用bazel构建工程** 1. **建立工作空间:**在构建项目之前,创建一个包含项目源文件和 Bazel 构建后文件输出的目录,并命名该目录为 `WORKSPACE`。 2. **理解 Build 文件:**每个 BUILD 文件包含一种构建规则,告诉 Bazel 如何构建所需的输出。目标定义了构建规则的每个实例,包括源文件和依赖项。 3. **构建工程:**通过运行 `bazel build` 命令启动构建过程。该命令将遍历 BUILD 文件,构建相应的输出文件。 4. **测试构建结果:**构建完成后,可以使用 `bazel test` 命令测试新构建的二进制文件。 **示例:** 假设您有一个名为 `hello-world` 的项目,其目录结构如下: ``` hello-world ├── BUILD ├── hello-world.cc ├── hello-world.h └── main.cc ``` 构建过程的详细步骤如下: 1. 创建工作空间 `WORKSPACE`。 2. 创建 `BUILD` 文件:`hello-world.BUILD`。 3. 在 `hello-world.BUILD` 中定义目标 `hello-world`: ``` hello-world: hello-world.cc ``` 4. 在 `hello-world.cc` 中定义依赖项 `hello-greet`。 5. 创建目标 `hello-greet`: ``` hello-greet: hello-greet.cc ``` 6. 创建目标 `main.out`: ``` main.out: main.cc ``` 7. 在 `main.cc` 中定义依赖项 `lib`。 8. 创建目标 `lib`: ``` lib: hello-time.cc ``` 9. 创建目标 `main.out`: ``` main.out: main.cc ``` 10. 运行 `bazel build hello-world` 命令。 这将构建一个名为 `hello-world` 的二进制文件,其中 `hello-world.cc`、`hello-greet.cc` 和 `main.cc` 是其源文件,`lib` 是 `hello-time.cc` 的输出。

正文

bazel学习

a fast, scalable, multi-language and extensible build system

bazel就是一个编译打包工具,类似于make、cmake等

安装

⚠️:Centos7系统安装bazel4

参考:https://docs.bazel.build/versions/5.0.0/install.html

image-20221121155314062

学习

如何使用bazel这个工具呢?

1、建立工作空间
在构建项目之前,您需要设置其工作空间,工作空间是一个包含项目源文件和 Bazel 构建后文件输出的目录, 它还包含 Bazel 认为特殊的文件:WORKSPACE 文件,它将目录及其中的内容标记为 Bazel 工作区,并位于项目目录结构的根目录中,可以使用一个或多个 BUILD 文件,它们告诉 Bazel 如何构建项目的不同部分。(工作空间中包含 BUILD 文件的目录称为一个包(package))

2、理解Build文件
一个 BUILD 文件包含几种不同类型的 Bazel 指令。 最重要的类型是构建规则,它告诉 Bazel 如何构建所需的输出,例如可执行的二进制文件或库。 BUILD 文件中构建规则的每个实例称为目标,一个目标可以指向一组特定的源文件和依赖项, 也可以指向其他目标。

看一下cpp-tutorial/stage1/main目录下的BUILD文件:

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

hello-world 目标实例化了 Bazel 的内置 cc_binary 规则,该规则告诉 Bazel 从 hello-world.cc 源文件构建一个独立的,没有依赖关系的可执行二进制文件。

目标中的属性明确声明其依赖项和选项,虽然 name 属性是强制性的,但许多是可选的。 例如,在 hello-world 目标中,name 是必需的且不言自明,而 srcs 是可选的,意味着指定 Bazel 从中构建目标的源文件。

3、构建工程

为了构建您的示例项目,请跳转到 cpp-tutorial/stage1 目录并运行:

cd examples/cpp-tutorial/stage1/
bazel build //main:hello-world

在目标标签中,//main: 是 BUILD 文件在工作空间根目录的位置,hello-world 是BUILD 文件中的目标名称(name)。

Bazel 产生类似于以下内容的输出:

Starting local Bazel server and connecting to it...
INFO: Analyzed target //main:hello-world (37 packages loaded, 161 targets configured).
INFO: Found 1 target...
Target //main:hello-world up-to-date:
  bazel-bin/main/hello-world
INFO: Elapsed time: 7.820s, Critical Path: 0.59s
INFO: 6 processes: 4 internal, 2 linux-sandbox.
INFO: Build completed successfully, 6 total actions

Bazel 将构建的输出文件放在工作空间根目录的 bazel-bin 目录中。

现在测试新构建的二进制文件:

bazel-bin/main/hello-world

学习bazel_test/examples/cpp-tutorial下的三个项目:参考

共有三组文件,每组代表本教程中的一个阶段.:

  • 在第一阶段,将构建单个包中的单个目标。
  • 在第二阶段,将项目拆分为多个目标,但将其保存在一个包中。
  • 在第三个阶段,将项目拆分为多个包并使用多个目标构建它。

stage1

image-20221121161753275

load("@rules_cc//cc:defs.bzl", "cc_binary")

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

第一阶段,只有一个单一的目标,它构建一个没有额外依赖项的单一源文件:

图片

stage2

image-20221121164005430

如果希望将较大的项目拆分为多个目标和包,以允许快速增量构建(即仅重建已更改的内容)并通过构建项目的多个部分来加速构建。

load("@rules_cc//cc:defs.bzl", "cc_binary", "cc_library")

cc_library(
    name = "hello-greet",
    srcs = ["hello-greet.cc"],
    hdrs = ["hello-greet.h"],
)

cc_binary(
    name = "hello-world",
    srcs = ["hello-world.cc"],
    deps = [
        ":hello-greet",
    ],
)

使用这个 BUILD 文件,Bazel 首先构建 hello-greet 库(使用 Bazel 的内置 cc_library 规则),然后是 hello-world 二进制文件。 hello-world 目标中的 deps 属性告诉 Bazel,构建 hello-world 二进制文件需要 hello-greet 库。

图片

该阶段使用两个目标构建了项目。 hello-world 目标构建一个源文件并依赖于另一个目标 (//main:hello-greet),该库是由两个额外的源文件构建的。

stage3

image-20221121164342218

这里将其中一个功能放在另外一个文件夹//lib下:

//main:
load("@rules_cc//cc:defs.bzl", "cc_binary", "cc_library")

cc_library(
    name = "hello-greet",
    srcs = ["hello-greet.cc"],
    hdrs = ["hello-greet.h"],
)

cc_binary(
    name = "hello-world",
    srcs = ["hello-world.cc"],
    deps = [
        ":hello-greet",
        "//lib:hello-time",
    ],
)

//lib:
load("@rules_cc//cc:defs.bzl", "cc_library")

cc_library(
    name = "hello-time",
    srcs = ["hello-time.cc"],
    hdrs = ["hello-time.h"],
    visibility = ["//main:__pkg__"],
)

可以看出主包中的 hello-world 目标依赖于 lib 包中的 hello-time 目标(因此目标标签为 //lib:hello-time) - Bazel 通过 deps 属性知道这一点。

图片

第三阶段师将项目构建为具有三个目标的两个包,并了解它们之间的依赖关系。

使用

bazel_test

cc_library(
    name = "lib",
    srcs = ["lib/lib.cc"],
    hdrs = ["lib/lib.h"],
)

cc_binary(
    name = "main.out",
    srcs = ["main.cc"],
    deps = [
        ":lib",
    ],
)

编译

bazel build //main:main.out

运行

./bazel-bin/main/main.out

更多

1、https://bazel.build/tutorials/cpp-use-cases

2、程序见Github

参考

1、https://blog.csdn.net/weixin_36354875/article/details/124822985

2、https://blog.csdn.net/butterfly5211314/article/details/125349431

与bazel学习相似的内容: