Golang项目Bazel指北

Yodark · · 1388 次点击 · · 开始浏览    
这是一个创建于 的文章,其中的信息可能已经有所发展或是发生改变。

该文档主要介绍 Bazel 构建基本 golang 项目的案例, 主要了解在golang项目中如何使用bazel.

概览

关键文件

1. WORKSPACE 在项目根目录,主要用来设置加载bazel环境(包括rules等)以及其依赖。

2. BUILD.bazel 存在于根目录以及源文件所在目录,用来标记源文件编译以及依赖情况,一般是自动生成。

工具

1. rules_go golang的官方rules,定义golang编译逻辑。

2. gazelle 用于生成golang build文件的工具。

项目构建

1. 编辑WORKSPACE

# 加载bazel标准库中的函数http_archive

load("@bazel_tools//tools/build_defs/repo:http.bzl", "http_archive")

# 调用http_archive下载rules_go

http_archive(

    name = "io_bazel_rules_go",

    # 下面两项需要根据官方的最近版本来修改

    urls = ["https://github.com/bazelbuild/rules_go/releases/download/0.16.1/rules_go-0.16.1.tar.gz"],

    sha256 = "f87fa87475ea107b3c69196f39c82b7bbf58fe27c62a338684c20ca17d1d8613",

)

# 获取gazelle

http_archive(

    name = "bazel_gazelle",

    # 同样需要根据官方最新版本修改

    urls = ["https://github.com/bazelbuild/bazel-gazelle/releases/download/0.15.0/bazel-gazelle-0.15.0.tar.gz"],

    sha256 = "6e875ab4b6bf64a38c352887760f21203ab054676d9c1b274963907e0768740d",

)

# 从rules_go中加载go_rules_dependencies,go_register_toolchains

load("@io_bazel_rules_go//go:def.bzl", "go_rules_dependencies", "go_register_toolchains")

# 加载rules_go依赖

go_rules_dependencies()

# 加载rules_go工具

go_register_toolchains()

# 从gazelle中加载gazelle_dependencies

load("@bazel_gazelle//:deps.bzl", "gazelle_dependencies")

# 加载gazelle依赖

gazelle_dependencies()

2. 编辑根目录下的BUILD.bazel

# 加载gazelle

load("@bazel_gazelle//:def.bzl", "gazelle")

# gazelle:prefix [注意这句注释并非没有意义,中括号替换为该项目Name]

gazelle(name = "gazelle")

构建

1. 使用gazelle生成build文件

2. 使用生成的build文件构建项目代码

# 使用gazelle自动生成build文件

bazel run //:gazelle

# 使用生成的build文件构建

# 构建根目录下所有target

bazel build //...

# 构建特定taget

bazel build //path/of/target:target_name

Demo项目

Demo

本文来自:简书

感谢作者:Yodark

查看原文:Golang项目Bazel指北

入群交流(和以上内容无关):Go中文网 QQ 交流群:798786647 或加微信入微信群:274768166 备注:入群;关注公众号:Go语言中文网

1388 次点击  
加入收藏 微博
暂无回复
添加一条新回复 (您需要 登录 后才能回复 没有账号 ?)
  • 请尽量让自己的回复能够对别人有帮助
  • 支持 Markdown 格式, **粗体**、~~删除线~~、`单行代码`
  • 支持 @ 本站用户;支持表情(输入 : 提示),见 Emoji cheat sheet
  • 图片支持拖拽、截图粘贴等方式上传