Bazel 快速入门与核心知识

已于 2024-08-31 20:26:38 修改
阅读量1.3k 收藏 20
点赞数 7
文章标签： c++ 软件构建 bazel 编译 项目构建
于 2024-08-31 20:22:41 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/taomeechildren/article/details/141757617
版权

Bazel 快速入门与核心知识

Bazel 简介

Bazel 是一款与 Make、Maven 和 Gradle 类似的开源构建和测试工具。 它使用人类可读的高级构建语言。Bazel 支持多种语言的项目 (C/C++, Java, Python, …)，可为多个平台构建输出。Bazel 支持跨多个代码库和大量用户的大型代码库。

本文是作者结合 Bazel 官方文档以及一些其他博客总结的学习笔记，凝炼了个人认为最核心的一些 Bazel 知识。通过此文，希望能让大家不仅看懂并编译一个通过 Bazel 构建的项目，同时还能够使用 Bazel 对自己的项目完成构建。

使用 Bazel 的基本流程

如需使用 Bazel 构建或测试项目，您通常要执行以下操作：

  1. 设置 Bazel。下载并安装 Bazel。

  2. 设置项目工作区，这是 Bazel 在其中查找 build 输入和 BUILD 文件以及用于存储 build 输出的目录。

  3. 编写 BUILD 文件，告知 Bazel 要构建什么以及如何构建它。

    如需编写 BUILD 文件，您可以使用领域特定语言 Starlark 声明构建目标。（请查看此处的示例。）

    构建目标指定了一组 Bazel 将要构建的输入工件及其依赖项，Bazel 将用于构建它的构建规则，以及用于配置构建规则的选项。

    build 规则用于指定 Bazel 将使用的构建工具，例如编译器和链接器。Bazel 附带多条构建规则，这些规则涵盖受支持平台上以支持的语言显示的最常见工件类型。

  4. 通过命令行运行 Bazel。Bazel 会将您的输出内容放在工作区中。

Bazel 构建流程

运行构建或测试时，Bazel 会执行以下操作：

  1. 加载与目标相关的 BUILD 文件。
  2. 分析输入及其依赖项，应用指定的构建规则，并生成操作图表。
  3. 对输入执行构建操作，直到生成最终构建输出。

由于之前的所有构建工作都已缓存，因此 Bazel 可以识别并重复使用缓存的 artifacts，并且只会重新构建或重新测试发生更改的内容。为了进一步强制执行正确性，您可以设置 Bazel，以通过沙盒化的方式运行构建和测试，从而最大限度地减少偏差并最大限度地提高可重现性。

Bazel C++ demo

目录组织结构如下。下面尝试用 bazel 构建 stage3/main 中以 hello-world.cc 为入口的 hello-world 程序，该程序依赖于同路径下的 hello-greet 以及 stage3/lib 路径下的 hello-time。

examples
└── cpp-tutorial
    ├──stage1
    │  ├── main
    │  │   ├── BUILD
    │  │   └── hello-world.cc
    │  └── WORKSPACE
    ├──stage2
    │  ├── main
    │  │   ├── BUILD
    │  │   ├── hello-world.cc
    │  │   ├── hello-greet.cc
    │  │   └── hello-greet.h
    │  └── WORKSPACE
    └──stage3
       ├── main
       │   ├── BUILD
       │   ├── hello-world.cc
       │   ├── hello-greet.cc
       │   └── hello-greet.h
       ├── lib
       │   ├── BUILD
       │   ├── hello-time.cc
       │   └── hello-time.h
       └── WORKSPACE

  1. 在 stage3 目录下创建了名为 WORKSPACE 的空文件，标记了这是一个 bazel 的工作区

  2. 在 stage3/main 和 stage3/lib 目录下创建名为 BUILD 的文件，用于指示 bazel 构建工作，一个拥有 BUILD 文件的目录就是一个包 (软件包)

    # lib/BUILD 文件

# 定义了名为"hello-time"的一个目标(target)，这个目标是cc_library规则(rule)的一个实例，cc_library规则定义的是构建C/C++库(library)的规则
cc_library(
    name = "hello-time",
    # 构建此库目标所需的C/C++文件列表，路径相对于BUILD文件所处目录
    srcs = ["hello-time.cc"],
    # 描述此库目标的C/C++头文件列表，路径相对于BUILD文件所处目录
    hdrs = ["hello-time.h"],
    # 使用可见性属性让 lib/BUILD 中的 //lib:hello-time 目标对 main/BUILD 中的目标显式可见。这是因为，默认情况下，只有同一 BUILD 文件中的其他目标才会看到这些目标。
    visibility = ["//main:__pkg__"],
)

    # main/BUILD 文件

# 定义了名为"hello-greet"的一个目标(target)，这个目标是cc_library规则(rule)的一个实例，cc_library规则定义的是构建C/C++库(library)的规则
cc_library(
    name = "hello-greet",
    # 构建此库目标所需的C/C++文件列表，路径相对于BUILD文件所处目录
    srcs = ["hello-greet.cc"],
    # 描述此库目标的C/C++头文件列表，路径相对于BUILD文件所处目录
    hdrs = ["hello-greet.h"],
)

# 定义了名为"hello-world"的一个目标(target)，这个目标是cc_binary规则(rule)的一个实例，cc_binary规则定义的是构建C/C++二进制程序(binary)的规则
cc_binary(
    name = "hello-world",
    # 构建此二进制目标所需的C/C++文件列表，路径相对于BUILD文件所处目录
    srcs = ["hello-world.cc"],
    # 要链接到二进制目标的其他库的列表
    deps = [
        ":hello-greet",  # 同一包下可省略包路径和//
        "//lib:hello-time",  # 不同包下必须严格按照 //包路径:目标名 的标签写法
    ],
)

    目标间的依赖关系如下：

    “hello-world”的依赖关系图显示了文件修改后依赖关系的变化。

  3. 执行构建：在 stage3 目录下，执行：

    bazel build //main:hello-world

    Bazel 会生成如下内容：

    INFO: Found 1 target...
Target //main:hello-world up-to-date:
  bazel-bin/main/hello-world
INFO: Elapsed time: 0.167s, Critical Path: 0.00s

    现在已经构建完成了，继续执行 bazel-bin/main/hello-world 即可运行 hello-world 程序

Bazel 核心知识

工作区 (workspace)

  • 一个 Workspace 就可以认为就是一个独立的 C/C++ Project。譬如上面 cpp-tutorial 目录下分别由 stage1、stage2 和 stage3 三个项目，每个项目的根目录下有一个 WORKSPACE 文件（空的就行）。
  • Bazel 会将包含一个 WORKSPACE 或 WORKSPACE.bazel 文件的目录识别为一个项目，每个项目之间互不干扰是完全独立的。
    • 可以同时包含 WORKSPACE 和 WORKSPACE.bazel，此时 .bazel 那个优先级更高。
  • 一个 Workspace 里可以包含多个 Packages (包)，每个 Package 中包含一组相关的源文件和一个 BUILD 文件。BUILD 文件指定可以从源代码构建哪些输出。例如，stage3 下就包含了两个 Package：main 和 lib。
  • 工作区有时也叫代码库。

BUILD & 包

  • 软件包 (包) 指的是包含名为 BUILD 或 BUILD.bazel 的 BUILD 文件的目录。

    • 可以同时包含 BUILD 和 BUILD.bazel，此时 .bazel 那个优先级更高。

  • 软件包包含其目录中的所有文件，以及其下的所有子目录，但那些本身包含 BUILD 文件的子目录除外。根据此定义，任何文件或目录都不能包含在两个不同的软件包中。

    例如，以下目录树中有两个软件包：my/app 和子软件包 my/app/tests。请注意，my/app/data 不是软件包，而是属于软件包 my/app 的目录。

    src/
└─ my
    └─ app
        ├─ BUILD
        ├─ app.cc
        ├─ data
        │   └─ input.txt
        └─ tests
            ├─ BUILD
            └─ test.cc

  • BUILD 文件采用 Starlark 语言对模块构建进行描述，语法类似于 Python

    • 每个 BUILD 文件都需要至少一条规则 (rule) 作为一组指令，告诉 Bazel 如何构建所需的输出，例如可执行文件或库。
    • BUILD 文件中定义的规则 (rule) 的实例都称为一个目标 (target)，并指向一组特定的源文件和依赖项。 目标还可以指向其他目标。从逻辑上来说即每个 package 可以包含多个 targets，而具体的 target 则采用 Starlark 语法定义在一个 BUILD 文件中。

BUILD 文件核心语法

规则 (rule)

  • 规则用于在 BUILD 文件（例如 cc_library）中定义如何生成一个目标 (target)。从 BUILD 文件作者的角度来看，规则由一组属性和黑盒逻辑组成。

  • 在简单的 BUILD 文件中，规则声明可以随意重新排序，而不改变行为。

  • bazel 定义了很多原生规则，可以直接在 BUILD 文件中使用，而无需 load 语句引入

    • 可以在 .bzl 文件中自定义规则，并在 BUILD 中用 load 语句引入。

    • 原生规则可以在 .bzl 文件中需要使用 native 模块来引用（如 native.cc_binary），但在 BUILD 文件中原生规则可以直接使用。

    • 详细的各项原生规则及其API见文档：Bazel 构建函数百科全书 (google.cn)。

      在这里插入图片描述

    • 我们常用的原生规则包括 cc_binary 和 cc_library 等，分别用来构建二进制可执行程序和库(静态库/动态库)。

      # 例子：在BUILD中使用bazel内置的原生规则: cc_binary
cc_binary(
    name = "hello-world",
    srcs = ["hello-world.cc"],
    deps = [
        ":hello-greet",
        "//lib:hello-time",
    ],
)

  • 大多数规则都具有类似的命名方案。例如，cc_binary、cc_library 和 cc_test 分别是 C++ 二进制文件、库和测试的构建规则。其他语言会采用相同的命名方案，但采用不同的前缀，例如适用于 Java 的 java_*。

    • *_binary 规则可用于构建给定语言的可执行程序。
    • *_test 规则是 *_binary 规则的专用规则，用于自动测试。测试只是在成功时返回零的程序。
    • *_library 规则以指定给定的编程语言指定单独编译的模块。库可以依赖于其他库，二进制文件和测试可以依赖于库，并且具有预期的单独编译行为。

  • 一个规则一般具有很多属性（见后面的小节）。

目标 (target)

  • 规则和目标是定义和实现的关系。也就是说，目标是规则的一个实例。

    • 一个 Rule 由很多 attribute 构成，这点采用面向对象的概念来看，Rule 就好比是 class，而 attribute 就好比是 class 的 member。

    • 下面这段代码实际上就是定义了一个 target，每个实例必须要有一个名字在同一个 package 中和其他 target 实例进行区分。所以 name 这个 attribute 是必须有的，其他 attribute 是可选的，不写则按默认值定义。

      # 例子：定义一个name为"hello-world"的target，它是cc_binary规则的一个实例 
cc_binary(
    name = "hello-world",
    srcs = ["hello-world.cc"],
    deps = [
        ":hello-greet",
        "//lib:hello-time",
    ],
)

  • 可以使用标签来唯一标识一个目标（详下节）。

标签 (label)

  • 标签是目标的标识符。简单来说，标签就是唯一标识一个 target 的 ID。

  • 大部分情况下，我们引用的都是同一个 workspace 中的 target，此时标签的语法如下：

    //path/to/package:target-name

    • 以 // 开始，接下来的 path/to/package 也就是这个 target 所在 package 在 workspace 中的相对路径。然后是一个 : 后面跟着一个 target-name 即上面说的一个 target 中的 name 那个属性的字符串值。

    • 如果要引用不同 workspace 中的 target，就必须使用标签的完整语法，见：标签 | Bazel (google.cn)

    • 如果是引用同一个包中的 target，那么标签语法可进一步简化，以下两种方式均可：

      //:target-name
:target-name

  • 特别地，可以使用 //path/to/package:__pkg__ 来表示一个包下地所有 target。

属性 (attribute) 及依赖

  • 属性是规则的参数，用于表示每个目标的 build 信息。如果在 BUILD 中实例化规则时没有显式指定某个属性的值，则该属性会使用默认值。

  • 大多数规则常见的属性包括 names (必需)、srcs、deps、data、visibility 、includes和 copts等，它们分别声明目标的源文件、依赖项和自定义编译器选项。给定目标可用的特定属性取决于其规则类型。

  • 原生规则的具体属性需要参见文档：Bazel 构建函数百科全书 (google.cn)。以 cc_library 规则为例，说明它的一些常用属性：

    • names: 目标的唯一名称。
    • deps: 此库所依赖的其他库的列表（可以通过标签来引用）。
    • srcs: 为创建库目标而处理的 C 和 C++ 文件的列表，包括源文件和头文件。
    • data: 此库在运行时所需的文件列表。
    • hdrs: 伴随此库发布的头文件，并且可以被其他依赖这个库的目标（如其他 cc_library 或 cc_binary）使用，Bazel 在构建过程中会确保这些头文件能够被正确找到和使用。cc_binary等规则是没有此属性的。
    • visibility: 指定此库在其他库中的可见性（可以通过标签来引用）。默认情况下，一个目标只对相同库中的其他目标显式可见。
    • includes: 要添加到编译行的 include 目录列表。
    • copts: 将这些选项添加到 C++ 编译命令中。比如这里可以写 -Imy_libpath 来将 my_libpath 加入编译时的头文件搜索路径，可以写 -pthread 来表明使用了多线程库。
      • includes 和 copts 中设置 -I 都可以指定头文件位置。但是，前者会为该规则即依赖该规则的所有规则都设置头文件位置，而后者只会为该规则设置头文件位置（因为本身只是一次编译命令的选项）。

    注意到这里并没有指定生成 .a 静态库还是 .so 动态库，实际上静态库还是动态库由引用此库的 cc_binary 规则决定，具体来说，cc_binary 可以指定 linkshared 或 linkstatic 为 True 还是 False 来决定链接时使用动态库还是静态库。默认情况下，linkshared 是 False，linkstatic 是 True。

    此外需要说明的是，srcs、data、hdrs 、includes 等属性中设置的地址都是相对于当前包路径而言的，即相对于当前 BUILD 文件所处的目录。

    以下给出一个示例：最终目标是构建可执行程序 foo，它依赖于源文件 foo.cc 和头文件 foo.h，同时还依赖于库 bar。库 bar 则依赖于源文件 bar.cc 和头文件 bar-impl.h，它同时还依赖于另一个库 baz，库 bar 中的接口由 bar.h 这个头文件所定义。另一个库 baz 依赖于源文件 baz.cc 和 baz-impl.h，库 baz 中的接口由 baz.h 这个头文件所定义。

    cc_binary(
    name = "foo",
    srcs = [
        "foo.cc",
        "foo.h",
    ],
    deps = [":bar"],
)

cc_library(
    name = "bar",
    srcs = [
        "bar.cc",
        "bar-impl.h",
    ],
    hdrs = ["bar.h"],
    deps = [":baz"],
)

cc_library(
    name = "baz",
    srcs = [
        "baz.cc",
        "baz-impl.h",
    ],
    hdrs = ["baz.h"],
)

  • 在 srcs, deps 等依赖属性中，可以使用 bazel 提供的 glob 函数来查找与特定路径模式匹配的所有文件，详细语法见：glob

构建命令

详细的各项参数见：使用 Bazel 构建程序 (google.cn)

使用 bazel build 来完成对目标的构建：

# 以 // 开头的所有目标模式都是相对于当前工作区而言的。
bazel build //path/to/package:target-name

# 以 // 开头的目标模式会根据当前的工作目录进行解析。
bazel build path/to/package:target-name

案例：

# 构建workspace下的foo/bar包中的wiz目标
bazel build //foo/bar:wiz

# 构建workspace下的foo/bar包中的bar目标，等同于 //foo/bar:bar
bazel build //foo/bar

# 构建workspace下的foo/bar包中的全部目标
bazel build //foo/bar:all

# 构建当前目录下定义的foo目标
bazel build :foo

# 构建当前目录下的bar子目录下定义的foo目标
bazel build bar:wiz

参考文献

Bazel入门：编译C++项目
elaine_bao的专栏
11-29 9万+
官网：https://www.bazel.build Github: https://github.com/bazelbuild/bazel最近用到tensorflow的时候遇到了个新的编译工具Bazel，踩了无数坑之后终于决定还是系统地学习一下这货。Bazel是一个类似于Make的编译工具，是Google为其内部软件开发的特点量身定制的工具，如今Google使用它来构建内部大多数的软件。Goog
cuda编码入门学习笔记
xiaomu_347的博客
06-27 892
首先，确保你对CUDA编程的基本概念有所了解：- CUDA是NVIDIA提供的用于并行计算的平台和编程模型。- CUDA允许你利用NVIDIA GPU的并行处理能力来加速计算任务。
Bazel教程
热门推荐
YongqiangGao的专栏
08-20 1万+
Bazel的入门上一篇博文讲解了在Ubuntu14.04下Bazel的安装，接下来讲解一下Bazel的简单入门。 *使用工作区* Bazel builds应该在一个工作区内运行，这个工作区应该包括源代码和build输出目录的符号链接（eg: bazel-bin、bazel-out）。工作区目录的位置是可以随意，但工作区的根目录必须包含一个名为WORKSPACE的工作区配置文件，工作区配置文件可以
bazel工具入门（二）
qq_46111138的博客
07-16 1178
会类似于Make，会将所有配置的输出目录都清除。并且，每个bazel实例都与一个workspace工作区相关联，因此clean命令将删除对该工作区中使用该bazel实例进行的所有构建的所有输出。选项则会仅移除整个输出基树，该树除了包含build输出之外，还包含bazel创建的所有临时文件（例如，bazel实例的所有磁盘和内存跟踪记录）。上面指的是“显示构建PEBL树中所有测试所需的所有genrule的定义（在BUILD文件中）的位置。解释为bazel选项，而是将其视为运行二进制文件的命令行的一部分。
bazel入门
10-02 157
project Workspace 包含WORKSPACE文件的文件夹，称为一个bazel projectworkspace。 WORKSPACE文件标识当前文件夹为workspace，可以为空。 BUILD file 包含BUILD文件的文件夹称为一个package。所有的package都在workspace下。 包含很多不同类型的指令。主要的指令为build rule。 ...
Bazel入门
s1120080286的专栏
06-17 5763
1 Bazel简介： bazel是Google开源的一套编译构建工具，广泛应用于Google内部，包括TensorFlow项目。修改TensorFlow内部源码，需要使用bazel来编译， 故有必要了解下bazel。bazel优点很多，主要有 1 构建快。支持增量编译。对依赖关系进行了优化，从而支持并发执行。 2 可构建多种语言。bazel可用来构建Java C++ Android ios等很多语...
bazel工具入门（一）
qq_46111138的博客
07-16 1024
bazel工具是Google内部构建工具Blaze的开源实现，属于编译打包工具，和maven、ant等类似。构建系统时，程序员一般写一个buildfile文件来描述系统，通常buildfile命名为BUILD。在Bazel中，BUILD文件定义了targets。上面的两个targets分别是cc_library和cc_test。每个target对应着Bazel能够创建的一种制品（artifact）。
史上最强Android，NDK入门项目实战.zip
05-15
本项目“史上最强Android，NDK入门项目实战”旨在帮助开发者掌握NDK的基础知识，并通过实际操作提升技能。 一、NDK简介 NDK是Google提供的一套开发工具，它允许Android应用包含本地代码（C/C++），用于提升运行效率...
TensorFlow基础入门指南
# 1. 介绍TensorFlow TensorFlow是一个由Google开发的开源机器学习框架，被广泛用于深度学习领域。它提供了丰富的工具和库，可以用于构建各种机器学习模型。 ## 1.1 什么是TensorFlow TensorFlow基于数据流编程...
香港科技大学Tensorflow三天速成课件（1）
11-14
本课程由香港科技大学主办，旨在通过三天的时间帮助初学者快速入门人工智能（AI）与机器学习（ML）领域，并掌握Google的TensorFlow框架的基本使用方法。课程不仅覆盖了理论基础，还提供了大量的实践操作，让学员能够...
智者
02-23
考虑到标签为"Python"，我们可以推断这是一个与Python编程相关的知识主题。"branthebuilder-master"作为压缩包的文件名，通常在开源软件或项目中，这种命名方式表示这是项目的主分支或者是最主要的代码库。 Python...
要成为一个 Java 架构师得学习哪些知识？
m0_57290404的博客
11-30 878
数组与链表、栈和队列、Hash和递归、树和堆、图、递归、分治、回溯、搜索、贪心、二分查找、动态规划、字典树和并查集、高级搜索、AVL树和红黑树、红黑树高级和位运算、布隆过滤器、LRU。Git、Arthas、Ant、Maven、Jenkins、Groovy、Zabbix、定时任务。设计模式、系统建模、软件架构设计、代码规范、算法思想、敏捷开发。线程、锁、 Disruptor、MySQL、JVM。
bazel基础知识
最新发布
07-09 1364
构建系统，而不是构建生成器（直接调用编译器）【A build system, not a build generator (invokes directly the compiler)】具有完整的测试功能（测试报告、片状测试处理等）【With full of functionality for testing (test reports, flaky tests handling, etc.)】Bazel核心是用Java编写的，规则和宏是用Starlark编写的【Bazel core is written
Bazel入门教程：编译C++项目
weixin_44493841的博客
04-29 1219
文章目录Bazel 教程Bazel 安装使用二进制安装程序安装第1步：安装所需的软件包第2步：下载Bazel第3步：运行安装程序第4步：设置您的环境使用Bazel自定义APT存储库第1步：安装JDK第2步：添加Bazel分发URI作为包源第3步：安装并更新BazelBazel入门：编译C++项目建立工作区（workspace）理解BUILD文件使用Bazel编译项目1. 编译你的第一个Bazel项...
Bazel官方教程 -- 构建C++工程基础知识
Darchan的博客
05-17 4092
Bazel官翻教程：涵盖了使用 Bazel 构建 C++ 应用程序的基础知识
Bazel项目构建
bleedingfight的博客
08-06 592
Bazel构建简单的C++程序 目录结构如下 实现简单的两个数相加，主函数输出两个数的和 ├── libs │ ├── add.cc │ ├── add.h │ └── BUILD ├── main │ ├── BUILD │ └── main.cc └── WORKSPACE 文件说明 WORKSPACE ：表明此文件所在的路径为项目的根，其它项目均可以以此根节点访问 main/BUILD：主函数的构建规则 main/main.cc：主函数源代码 libs/add.cc：库函数
Bazel 使用指南 (User’s Guide)
既然选择了远方 便只顾风雨兼程 - 永强
11-14 1129
Bazel 使用指南 (User’s Guide) Bazel https://bazel.build/ Bazel Docs https://docs.bazel.build/versions/4.2.1/bazel-overview.html A User’s Guide to Bazel https://docs.bazel.build/versions/main/guide.html Bazel 是一款快速、可靠地构建和测试任何规模的软件。 1. Bazel The most commonly us
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值