Bazel入门

怎么使用Bazel？
https://docs.bazel.build/versions/master/bazel-overview.html#how-do-i-use-bazel
1、安装Bazel
2、构建项目的workspace
这个文件告诉bazel到哪去找build的输入以及BUILD文件，还有配置了build的输出位置。
3、手写BUILD文件
在Build文件中声明build目标通过使用一个抽象的Python-like语言。（接下来会有一个example介绍）
一个build目标规定了一个输入集合，也就是bazel编译时需要的依赖；build规则；配置build规则的选项
build规则指示了Bazel在build时使用的工具，比如编译器和连接器以及相关的配置。Bazel提供了许多构建规则，涵盖了受支持平台上支持语言中最常见的工件类型。
4、Run Bazel。通过Bazel命令来运行。Bazel会将输出放到workspace的指定位置。

在接下来继续讲具体的workspace、BUILD文件、以及Bazel命令之前，先从整体上看下Bazel是如何work的。

Bazel如何work？
https://docs.bazel.build/versions/master/bazel-overview.html#how-does-bazel-work
running一个build或者test，Bazel需要做下面的事情：
1、加载与目标target相关的BUILD文件
2、分析输入及其依赖，应用所指示的build规则，产生一个action graph
3、执行build actions到输入上，直到产生最终的输出
因为Bazel可以缓存build工作过程，所以可以识别出哪些可以重复使用，不用再次build，也可以明确知道哪些改变需要重新build。换句话说就是Bazel实现了增量编译在保证效率的前提下，还保证了正确性。

突然不想写了，把内容链接发下。
workspace：这是一个目录，这个目录下面有我们要build的软件源码，还有一些软链接（符号链接）到build输出。每个workspace目录都拥有一个名为WORKSPACE的文件，这个文件可以为空，或者包含外部的依赖。具体的Workspace规则见Build的百科（https://docs.bazel.build/versions/master/be/workspace.html）
BUILD文件：有一个参考sample（https://github.com/bazelbuild/bazel/blob/master/examples/cpp/BUILD）
Bazel命令行：https://docs.bazel.build/versions/master/command-line-reference.html


另外非常重要的一个，Bazel BUILD函数的百科全书了解一下！



评论

发表评论

此博客中的热门博文

Bazel WORKSPACE文件编写

WORKSPACE文件主要就是命名workspace以及声明外部的依赖，这就包括外部依赖的获取方式及获取方法。 外部依赖 https://docs.bazel.build/versions/master/external.html WORKSPACE文件告诉Bazel如何去得到其他的工程源，然后package中的BUILD文件就可以根据WORKSPACE中的外部target名字写依赖关系。 先举个例子来看下在本地的两个工程如何实现依赖关系： / home/ user/ project1/ WORKSPACE BUILD srcs/ ... project2/ WORKSPACE BUILD my-libs/ project1希望能依赖project2/BUILD下的target :foo，需要指明project2可以在 /home/user/project2 中被找到，而且接下来project1的BUILD就可以写依赖关系： @project2//:foo WORKSPACE文件允许用户的目标依赖其他文件系统的目标或者从网上下载的目标。 WORKSPACE文件的语法和BUILD文件一致，不过会用到一些特定的内置rule，细节参考下一个章节的内容。 一共有三种外部依赖的主要类型： 依赖于其他Bazel工程 根据这个Bazel工程所处的位置不同，调用不同的内置rule来获得： local_repository ：本地 git_repository ：git仓库 http_archive ：网络下载 假如现在有个工程 my-project/ ，需要依赖与另一个工程 coworkers-project/ 。这两个都是Bazel工程，那么需要在 my_project/WORKSPACE 下添加： local_repository ( name = "coworkers_project" , path = "/path/to/coworkers-project" , ) 然后对于coworke...
阅读全文

Bazel BUILD文件的编写

除了公共部分BUILD文件可以使用的规则外，还有一些与语言相关的build rule https://docs.bazel.build/versions/master/be/overview.html 这里根据不同的语言，来写整理。 Java Bin rules java_binary java_binary( name ,  deps ,  srcs ,  data ,  resources ,  args ,  classpath_resources ,  compatible_with ,  create_executable ,  deploy_manifest_lines ,  deprecation ,  distribs ,  features ,  javacopts ,  jvm_flags ,  launcher ,  licenses ,  main_class ,  output_licenses ,  plugins ,  resource_jars ,  resource_strip_prefix ,  restricted_to ,  runtime_deps ,  stamp ,  tags ,  testonly ,  toolchains ,  use_testrunner ,  visibility ) build一个java的jar文件，并且套上一个shell的脚本来辅助运行。 隐式的输出target： name.jar name-src.jar name_deploy.jar：这个比较特殊，必须显式的build才会生成，比如 bazel build //package:target_deploy.jar name_deploy-src.jar Lib rules java_import java_import( name ,  deps ,  dat...
阅读全文

Bazel生成Python的部署文件

https://groups.google.com/forum/#!topic/bazel-discuss/42QRn8qU0eo 我们已经知道，对于：  Java/Scala/Groovy 在Bazel中可以使用target_name_deploy.jar来生成部署文件 C++/D/Rust/Go 在Bazel中可以生成静态的二进制文件 Python 那么对于Python语言，bazel可以使用下面这个工程来支持生成par文件(see github.com/google/subpar ) Subpar 这个是用来在Bazel中协助生成python可执行文件的一个项目。不过并不是Google的一个官方产品。 由于这个项目也是由Bazel来维护的，所以可以直接使用git_repository()来添加到本地WORKSPACE中索引使用： git_repository( name = " subpar " , remote = " https://github.com/google/subpar " , tag = " 1.0.0 " , ) 然后可以在BUILD文件中添加load()以及调用par_binary()来完成target的定义： load( " @subpar//:subpar.bzl " , " par_binary " ) par_binary( name = ' foo ' , srcs = [ ' foo.py ' , ' bar.py ' ], deps = [ ' //baz:some_py_lib ' ], data = [ ' quux.dat ' ], ) 不过如果在已有的BUILD中已有，py_binary()而且不想注释掉的话。需要做如下修改： py_binary( name = ' foo ' , # 已有py_binary()的定义和命名 src...
阅读全文