官方地址:https://docs.bazel.build/versions/master/tutorial/cpp.html#specify-multiple-build-targets
在本教程中,您将学习使用Bazel构建C ++应用程序的基础知识。您将设置工作区并构建一个简单的C ++项目,该项目演示了关键的Bazel概念,例如目标和BUILD
文件。完成本教程后,请查看 Common C ++ Build Use Cases,了解更高级概念的信息,例如编写和运行C ++测试。
预计完成时间:30分钟。
你会学到什么
在本教程中,您将学习如何:
- 建立目标
- 可视化项目的依赖项
- 将项目拆分为多个目标和包
- 跨包控制目标可见性
- 通过标签引用目标
内容
- 你会学到什么
- 在你开始之前
- 用Bazel构建
- 设置工作区
- 理解BUILD文件
- 建立项目
- 查看依赖关系图
- 优化您的Bazel构建
- 使用标签来引用目标
- 进一步阅读
在你开始之前
要准备本教程,请先安装Bazel,如果尚未安装它。然后,从Bazel的GitHub存储库中检索示例项目:
git clone https://github.com/bazelbuild/examples/
本教程的示例项目位于examples/cpp-tutorial
目录中,结构如下:
└── 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
如您所见,有三组文件,每组代表本教程中的一个阶段。
在第一阶段,您将构建一个驻留在单个包中的目标。
在第二阶段,您将项目拆分为多个目标,但将其保存在单个包中。
在第三个也是最后一个阶段,您将项目拆分为多个包,并使用多个目标构建它。
用Bazel构建
设置工作区
在构建项目之前,需要设置其工作区。工作空间是保存项目源文件 和 Bazel构建输出的目录。它还包含Bazel认为特殊的文件:
要将目录指定为Bazel工作空间,请创建WORKSPACE
在该目录中命名的空文件 。
当Bazel构建项目时,所有输入和依赖项必须位于同一工作区中。除非链接,否则驻留在不同工作空间中的文件彼此独立,这超出了本教程的范围。
理解BUILD文件
一个BUILD
文件包含Bazel的几种不同类型的指令。最重要的类型是构建规则,它告诉Bazel如何构建所需的输出,例如可执行的二进制文件或库。
文件中的每个构建规则实例BUILD
都称为目标,并指向一组特定的源文件和依赖项。目标也可以指向其他目标。
看一下目录BUILD
中的cpp-tutorial/stage1/main
文件:
cc_binary(name = "hello-world",srcs = ["hello-world.cc"],
)
在我们的示例中,hello-world
目标实例化Bazel的内置 cc_binary
规则。该规则告诉Bazel从hello-world.cc
源文件构建一个自包含的可执行二进制文件,没有依赖项。
目标中的属性显式声明其依赖项和选项。虽然该name
属性是必需的,但许多属性是可选的。例如,在 hello-world
目标中,name
是不言自明的,并srcs
指定Bazel构建目标的源文件。
建立项目
让我们构建您的示例项目。切换到cpp-tutorial/stage1
目录并运行以下命令:
bazel build //main:hello-world
注意目标标签 - 该//main:
部分是我们BUILD
文件相对于工作空间根的位置,
hello-world
是我们在BUILD
文件中命名该目标的位置。(您将在本教程末尾更详细地了解目标标签。)
Bazel产生的输出类似于以下内容:
INFO: Found 1 target...
Target //main:hello-world up-to-date:bazel-bin/main/hello-world
INFO: Elapsed time: 2.267s, Critical Path: 0.25s
恭喜,您刚刚建立了第一个Bazel目标!Bazel将构建输出放在bazel-bin
工作区根目录的目录中。浏览其内容以了解Bazel的输出结构。
现在测试新构建的二进制文件:
bazel-bin/main/hello-world
查看依赖关系图
成功构建的所有依赖项都在BUILD
文件中明确说明。Bazel使用这些语句来创建项目的依赖图,从而实现准确的增量构建。
让我们可视化我们的示例项目的依赖项。首先,生成依赖图的文本表示(在工作区根目录下运行命令):
bazel query --nohost_deps --noimplicit_deps 'deps(//main:hello-world)' \--output graph
上面的命令告诉Bazel查找目标的所有依赖项 //main:hello-world
(不包括主机和隐式依赖项),并将输出格式化为图形。
然后,将文本粘贴到GraphViz中。
在Ubuntu上,您可以通过安装GraphViz和xdot Dot Viewer在本地查看图形:
sudo apt update && sudo apt install graphviz xdot
然后,您可以通过将上面的文本输出直接管道到xdot来生成和查看图形:
xdot <(bazel query --nohost_deps --noimplicit_deps &#39;deps(//main:hello-world)&#39; \--output graph)
如您所见&#xff0c;示例项目的第一个阶段有一个目标&#xff0c;它构建一个没有其他依赖项的源文件&#xff1a;
现在您已经设置了工作区&#xff0c;构建了项目并检查了它的依赖项&#xff0c;让我们添加一些复杂性。
优化您的Bazel构建
虽然单个目标足以满足小型项目的需要&#xff0c;但您可能希望将较大的项目拆分为多个目标和程序包以允许快速增量构建&#xff08;即&#xff0c;仅重建已更改的内容&#xff09;并通过构建项目的多个部分来加速构建立刻。
指定多个构建目标
让我们将示例项目构建拆分为两个目标。看一下 目录BUILD
中的cpp-tutorial/stage2/main
文件&#xff1a;
cc_library(name &#61; "hello-greet",srcs &#61; ["hello-greet.cc"],hdrs &#61; ["hello-greet.h"],
)cc_binary(name &#61; "hello-world",srcs &#61; ["hello-world.cc"],deps &#61; [":hello-greet",],
)
使用此BUILD
文件&#xff0c;Bazel首先构建hello-greet
库&#xff08;使用Bazel的内置cc_library
规则&#xff0c;然后是hello-world
二进制文件。目标中的deps
属性hello-world
告诉Bazel hello-greet
需要库来构建hello-world
二进制文件。
让我们构建这个项目的新版本。切换到 cpp-tutorial/stage2
目录并运行以下命令&#xff1a;
bazel build //main:hello-world
Bazel产生的输出类似于以下内容&#xff1a;
INFO: Found 1 target...
Target //main:hello-world up-to-date:bazel-bin/main/hello-world
INFO: Elapsed time: 2.399s, Critical Path: 0.30s
现在测试新构建的二进制文件&#xff1a;
bazel-bin/main/hello-world
如果您现在修改hello-greet.cc
并重建项目&#xff0c;Bazel将只重新编译该文件。
查看依赖关系图&#xff0c;您可以看到它hello-world
依赖于之前相同的输入&#xff0c;但构建的结构是不同的&#xff1a;
您现在已经使用两个目标构建了项目。的hello-world
目标建立一个源文件&#xff0c;并取决于一个其他目标&#xff08;//main:hello-greet
&#xff09;&#xff0c;它建立两个附加的源文件。
使用多个包
现在让我们将项目拆分为多个包。看一下cpp-tutorial/stage3
目录的内容&#xff1a;
├── main│ ├── BUILD│ ├── hello-world.cc│ ├── hello-greet.cc│ └── hello-greet.h├── lib│ ├── BUILD│ ├── hello-time.cc│ └── hello-time.h└── WORKSPACE
请注意&#xff0c;我们现在有两个子目录&#xff0c;每个子目录都包含一个BUILD
文件。因此&#xff0c;对于Bazel&#xff0c;工作区现在包含两个包&#xff0c;lib
并且main
。
看看lib/BUILD
文件&#xff1a;
cc_library(name &#61; "hello-time",srcs &#61; ["hello-time.cc"],hdrs &#61; ["hello-time.h"],visibility &#61; ["//main:__pkg__"],
)
并在main/BUILD
文件中&#xff1a;
cc_library(name &#61; "hello-greet",srcs &#61; ["hello-greet.cc"],hdrs &#61; ["hello-greet.h"],
)cc_binary(name &#61; "hello-world",srcs &#61; ["hello-world.cc"],deps &#61; [":hello-greet","//lib:hello-time",],
)
正如你所看到的&#xff0c;hello-world
在目标main
包依赖于 hello-time
目标lib
包&#xff08;因此目标标签 //lib:hello-time
&#xff09; -巴泽尔通过知道这个deps
属性。看一下依赖图&#xff1a;
请注意&#xff0c;为了使构建成功&#xff0c;我们使用该 属性使//lib:hello-time
目标 lib/BUILD
明确显示给目标。这是因为默认目标仅对同一文件中的其他目标可见。&#xff08;Bazel使用目标可见性来防止诸如包含实现细节的库泄漏到公共API中的问题。&#xff09;main/BUILD
visibility
BUILD
让我们构建我们项目的最终版本。切换到 cpp-tutorial/stage3
目录并运行以下命令&#xff1a;
bazel build //main:hello-world
Bazel产生的输出类似于以下内容&#xff1a;
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
现在测试新构建的二进制文件&#xff1a;
bazel-bin/main/hello-world
您现在已经将项目构建为具有三个目标的两个包&#xff0c;并了解它们之间的依赖关系。
使用标签来引用目标
在BUILD
文件和命令行中&#xff0c;Bazel使用标签来引用目标 - 例如&#xff0c;//main:hello-world
或//lib:hello-time
。他们的语法是&#xff1a;
//path/to/package:target-name
如果目标是规则目标&#xff0c;那么path/to/package
是包含该BUILD
文件的目录的路径&#xff0c;并且target-name
是您在BUILD
文件中命名目标的&#xff08;name
属性&#xff09;。如果目标是文件目标&#xff0c;则path/to/package
是包的根目录的路径&#xff0c;并且 target-name
是目标文件的名称&#xff0c;包括其完整路径。
在同一个包中引用目标时&#xff0c;可以跳过包路径并使用//:target-name
。在同一BUILD
文件中引用目标时&#xff0c;您甚至可以跳过//
工作区根标识符并使用 :target-name
。
进一步阅读
恭喜&#xff01;您现在已经了解了使用Bazel构建C &#43;&#43;项目的基础知识。接下来&#xff0c;阅读最常见的C &#43;&#43;构建用例。然后&#xff0c;查看以下内容&#xff1a;
-
外部依赖关系&#xff0c;以了解有关使用本地和远程存储库的更多信息。
-
在构建百科全书了解更多关于巴泽尔。
-
在Java构建教程上手与巴泽尔构建Java应用程序。
-
该Android应用教程上手构建移动应用程序为Android与巴泽尔。
-
在iOS版应用教程上手构建移动应用程序与巴泽尔的iOS。
快乐的建筑&#xff01;
希望对你有帮助。