Bazel - 2(几个术语)

好了,现在正式开始吧。


1 workspace

那怎样才可以说这个是一个Bazel项目或者源码库呢?Bazel的文件组织方式就是目录,只要在某个文件夹里放上一个WORKSPACE文件(或者WORKSPACE.bazel,如果目录中两个文件都存在,后者优先),这个目录就是一个workspace。除了根目录中的WORKSPACE文件,其子目录中的WORKSPACE文件都会被忽略,不能在某个workspace里面再创建另一个workspace。

WORKSPACE文件有了,那它里面放什么呢?它的主要功能是引入外部依赖,比如说你的这个workspace里面用到了一个函数,它定义在另一个workspace里面,你又不想复制粘贴,就可以在WORKSPACE文件里面来从那个workspace引入到当前的workspace中。当然如果你没有用到任何外部库或第三方库,它应该是空的。

2 repository

现在workspace有了,万一将来其他的workspace需要引用它的某个部分,或者它的里面有多个部分,需要相互引用。那引用的时候应该如何称呼啊?Bazel称呼这种代码的组织方式为repository,放置WORKSPACE文件的根目录称为main repository,代号为@。在WORKSPACE文件里面可以给这个repository起个名字,这样别人就很方便来引用它了。

3 package

如果项目很小,源文件数量很少,也许一个WORKSPACE文件就够用了。不过,Bazel可是能够支持10万+输入文件的超大规模项目的构建工具,所以合理化的分块管理也是必要的。一个repository的基本代码组织单元是package,一般我们都是把关系紧密的模块放在一起,组成一个package。

在repository的根目录下的某个目录,只要它有一个BUILD或BUILD.bazel文件,这个目录及其子目录,那它就是一个package。不过,如果子目录的某个目录中也有一个BUILD文件,那这个子目录及其包含的子目录就是另一个package,这两个package都是各个独立的package,没有从属或包含关系。

如果在repository的根目录下也放上一个BUILD文件,根目录也可以是一个package。

4 Target

假如我们正在着手开发一个网络通信库,Net-Comm repository,新建一个目录net-comm,里面放上一个空的WORKSPACE文件。库的功能包含网络传输和数据加密,我们再新建两个子目录net和crypt,在里面先各放上一个空的BUILD文件。好了,repository和packages都规划好了。

下面开始进攻package了。我们需要支持多种网络通信协议来完成数据传输,将来其他的项目可能只会用到其中某一种协议,将每种协议的实现单独组织、独立引用,应该是一个不错的选择。好了,引用路径的终点终于来了,target!package是个容器,里面的元素就是一个一个的target。target的主要类型是rule(还有file和package groups,这些不常用,我也不太明白)。rule主要有三种,它们是binary,library,test,从名字上很容易猜出来:执行程序,库和测试,没错。binary可以运行,library通常都是提供给其他target、package、repository来引用的,test是单元测试。

比如net这个package,我们规划为tcp协议和udp协议,这样net的BUILD文件中会定义两个library,分别是tcp和udp,还会定义两个test,tcp-test和udp-test,一共是4个target。实现之后,我们可以通过Bazel命令来构建它们,还可以运行测试来检查实现是否正确。

今天先到这里,下期是个简单的hello world,来消化一下上面的几个术语,你会发现非常简单、方便,我这个make菜鸟一开始也是这样的感觉。

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 219,427评论 6 508
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 93,551评论 3 395
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 165,747评论 0 356
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,939评论 1 295
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,955评论 6 392
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,737评论 1 305
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,448评论 3 420
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 39,352评论 0 276
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,834评论 1 317
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,992评论 3 338
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 40,133评论 1 351
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,815评论 5 346
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,477评论 3 331
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 32,022评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 33,147评论 1 272
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 48,398评论 3 373
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 45,077评论 2 355

推荐阅读更多精彩内容

  • Bazel Build:基本概念 Bazel的核心领域模型非常简单,如下图所示。Workspace包含零个或多个P...
    刘光聪阅读 15,649评论 0 5
  • 简介 Bazel是一个类似于Make,Maven和Gradle的开源构建和测试工具。Bazel支持多种语言混编的项...
    小村医阅读 34,880评论 0 10
  • 官网:https://www.bazel.build[https://www.bazel.build/]Githu...
    贰爷阅读 837评论 0 0
  • 概念和术语 说明 本文档概述了Bazel构建源代码树形结构和Bazel中使用的术语。翻译来源:https://do...
    YottaYuan阅读 2,649评论 0 2
  • Change log 目录 [bazel]-导读[bazel]-概念和术语[bazel]-bazel的使用[baz...
    Sunxxxxx丶阅读 4,760评论 0 1