Change log
目录
[bazel]-导读
[bazel]-概念和术语
[bazel]-bazel的使用
[bazel]-tulsi的使用
[bazel]-如何编译
[bazel]-缓存
[bazel]-影响缓存命中的因素
[bazel]-优化
项目地址
一.bazelrc
Bazel可以接收很多参数和命令.为了避免去指定一些固定的.不会改变的参数和命令.
Bazel允许你在一个配置文件里指定这些参数.
这个配置文件就是.bazelrc文件
二.where are the .bazelrc files?
.bazelrc会存在4个路径.
如果两个路径下的.bazelrc指定了相同的参数.
相对后面路径的.bazelrc文件会覆盖相对前面路径的值.
在.bazelrc里指定的参数大多为启动项.
这意味着.bazelrc里指定的参数会在build命令执行之前生效.
1.除非存在--nosystem_rc. Bazel会去系统路径寻找.在Unix系统中.路径为'/etc/bazel.bazelrc'
2.除非存在--noworkspace_rc. Bazel会去workspace路径寻找.路径为 工程根目录下的.bazelrc
3.除非存在--nohome_rc. Bazel会去home路径寻找.路径为'~/.bazelrc'
4.可以通过--bazelrc = file 启动选项指定其他.rc文件.如果此选项不存在.则不会加载其他文件.
经过实验后的结论:
1.只有在工程根目录下没有.bazelrc文件时.才会去读'~/.bazelrc'文件
2.工程跟录下有.bazelrc文件时.还是会去读'/etc/bazel.bazelrc'文件.但是如果有重复的定义.会覆盖'/etc/bazel.bazelrc'里的定义.
三.import
.bazelrc文件里使用import语句可以引用其他文件的内容.
import文件中指定的选项优先于import语句之前的选项
import语句后指定的选项优先于import文件中的选项
如下这样书写.就是引入 工程根目录下的warnings.bazelrc和cutomize-provision/custom.bazelrc文件
import %workspace%/customized-provision/custom.bazelrc
import %workspace%/warnings.bazelrc
4.Option defaults
bazelrc文件里的大多数行是定义默认值的.
每行的第一个单词指定何时应用这些默认值.
startup：启动选项，它位于命令之前，并在bazel help startup_options中描述。
common：适用于所有Bazel命令的选项。
command：给bazel的命令添加参数.如下.就是给build命令添加三个参数.
// 1.取消上传本地缓存
build --remote_upload_local_results=false
// 2.取消模拟器签名 (如:bili-universal:bili-universal[action 'Processing and signing iOS application: bili-universal'])
build --define=apple.codesign_simulator_bundles=no
5.bazelignore
您可以在工作区中指定希望Bazel忽略的目录，例如使用其他构建系统的相关项目。
在工作区的根目录下放置一个名为.bazelignore的文件，并添加您希望Bazel忽略的目录，每行一个.
6.Building programs with Bazel
% bazel build //foo
____Loading package: foo
____Loading package: bar
____Loading package: baz
____Loading complete. Analyzing...
____Building 1 target...
____[0 / 3] Executing Genrule //bar:helper_rule
____[1 / 3] Executing Genrule //baz:another_helper_rule
____[2 / 3] Building foo/foo.bin
Target //foo:foo up-to-date:
bazel-bin/foo/foo.bin
bazel-bin/foo/foo
____Elapsed time: 9.905s
Bazel打印进度，因为它在所请求目标的依赖关系的传递闭包中加载所有包，然后分析它们的正确性并创建构建操作，最后执行编译器和构建的其他工具。
Bazel在构建的执行阶段打印进度消息，显示正在启动的当前构建步骤（编译器，链接器等），以及在构建操作总数上完成的数量。 随着构建开始，总行动的数量通常会随着Bazel发现整个行动图而增加，但数量通常会在几秒钟内稳定下来。
在构建结束时，Bazel打印请求的目标，无论它们是否成功构建，如果是，可以找到输出文件的位置。 运行构建的脚本可以可靠地解析此输出; 有关详细信息，请参阅--show_result。
7.Correct incremental rebuilds
Bazel避免了这些假设，以及其他假设。 Bazel维护一个以前完成的所有工作的数据库，如果它发现该构建步骤的输入文件集（及其时间戳）以及该构建步骤的编译命令与该构建步骤中的一个完全匹配，则只会省略构建步骤。数据库，以及数据库条目的输出文件集（及其时间戳）与磁盘上文件的时间戳完全匹配。对输入文件或输出文件或命令本身的任何更改都将导致重新执行构建步骤。
正确增量构建对用户的好处是：由于混乱而浪费的时间更少。 （此外，使用make clean导致等待重建所花费的时间更少，无论是必要还是先发制人。）
8.分析每次构建的耗时
在每次构建成功后.
我们可以通过 analyze-profile 命令查看此次构建具体每个步骤的耗时.
$ cd <workspace_dir>
$ bazel analyze-profile bazel-profile --html
关于 'bazel-profile' 文件:
当你在运行 $ bazel build 命令式.
增加一个'--profile=bazel-profile' 参数时.
每次build后会在根目录生成一个bazel-profile文件.
这个文件就是 analyze-profile 命令所需的输入文件.
为了方便.我们可以将此参数加入到.bazelrc里.如下:
build --profile=bazel-profile
参数:
--html
可以将输出日志写入一个html文件.方便查看.
输入日志如下:
Total time (across all threads) spent on:
Type Total Count Average
ACTION 0.01% 7 1.47 ms
ACTION_EXECUTE 25.36% 7 6.794 s
ACTION_UPDATE 0.00% 1 0.00 ms
INFO 0.00% 4 0.88 ms
VFS_STAT 0.19% 194 1.87 ms
VFS_DIR 0.00% 10 0.05 ms
VFS_READLINK 0.00% 4 0.01 ms
VFS_MD5 7.79% 8 1.827 s
VFS_DELETE 0.01% 18 1.29 ms
VFS_OPEN 0.00% 20 0.07 ms
VFS_READ 0.94% 165700 0.01 ms
VFS_WRITE 0.00% 2 0.22 ms
SKYFRAME_EVAL 33.23% 1 62.323 s
SKYFUNCTION 33.21% 18 3.460 s
Critical path (62.233 s):
Id Time Percentage Description
87 16.002 s 25.71% action 'Processing and signing iOS application universal'
86 14.305 s 22.99% action 'Bundling iOS application universal'
85 1.958 s 3.15% action 'Symlinking single-architecture binary'
84 25.411 s 40.83% action 'Linking universal/universal.apple_binary_bin'
83 2.390 s 3.84% action 'Linking srcs/app/libphone_library.a'
82 2.168 s 3.48% action 'Compiling srcs/app/iPhone/VideoInfoM3/VC/PlayerVideoInfoViewControllerM3.m'
