Golang项目Bazel指北

该文档主要介绍 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