Bazel 构建 protobuf

2022-11-25 16:58:29 浏览数 (1)

为了将proto文件转成编程语言代码,需要安装编译工具protoc。本篇验证使用 Bazel 构建 是否能和手动执行 protoc 和插件 的编译一样的结果。

本篇的代码放在: https://github.com/backendcloud/example/tree/master/bazel-sample/protobuf

三个proto源码:

代码语言:javascript复制
 ⚡ root@localhost  ~/bazel-sample/protobuf   main ±  more proto/*.proto
::::::::::::::
proto/address.proto
::::::::::::::
syntax = "proto3";option go_package = "github.com/jun06t/bazel-sample/protobuf/proto;user";package user;import "proto/zipcode.proto";message Address {
  string  city     = 1;
  ZipCode zip_code = 2;}::::::::::::::
proto/user.proto
::::::::::::::
syntax = "proto3";option go_package = "github.com/jun06t/bazel-sample/protobuf/proto;user";package user;import "proto/address.proto";import "google/protobuf/any.proto";message User {
  string              id      = 1;
  string              name    = 2;
  Address             address = 3;
  google.protobuf.Any tags    = 4;}::::::::::::::
proto/zipcode.proto
::::::::::::::
syntax = "proto3";option go_package = "github.com/jun06t/bazel-sample/protobuf/proto;user";package user;message ZipCode {
  string code = 1;}

Bazel 构建

执行gazelle:

代码语言:javascript复制
⚡ root@localhost  ~/bazel-sample/protobuf   main ±  bazelisk run //:gazelle
Starting local Bazel server and connecting to it...
INFO: SHA256 (https://golang.org/dl/?mode=json&include=all) = 5d539711d20290d769b21f137348eea164d5fd408cfc6483c9937d9e1a2a6d98
INFO: Analyzed target //:gazelle (63 packages loaded, 7894 targets configured).
INFO: Found 1 target...
Target //:gazelle up-to-date:
  bazel-bin/gazelle-runner.bash
  bazel-bin/gazelle
INFO: Elapsed time: 25.913s, Critical Path: 0.15s
INFO: 1 process: 1 internal.
INFO: Build completed successfully, 1 total action
INFO: Build completed successfully, 1 total action

执行完 bazelisk run //:gazelle 命令后会自动生成下面的BUILD文件:

代码语言:javascript复制
 ⚡ root@localhost  ~/bazel-sample/protobuf   main ±  cat proto/BUILD.bazel 
load("@rules_proto//proto:defs.bzl", "proto_library")load("@io_bazel_rules_go//go:def.bzl", "go_library")load("@io_bazel_rules_go//proto:def.bzl", "go_proto_library")proto_library(
    name = "user_proto",
    srcs = [
        "address.proto",        "user.proto",        "zipcode.proto",    ],
    visibility = ["//visibility:public"],
    deps = ["@com_google_protobuf//:any_proto"],)go_proto_library(
    name = "user_go_proto",
    importpath = "github.com/jun06t/bazel-sample/protobuf/proto",
    proto = ":user_proto",
    visibility = ["//visibility:public"],)go_library(
    name = "proto",
    embed = [":user_go_proto"],
    importpath = "github.com/jun06t/bazel-sample/protobuf/proto",
    visibility = ["//visibility:public"],)

执行 bazelisk build //proto 命令:

代码语言:javascript复制
 ⚡ root@localhost  ~/bazel-sample/protobuf   main ±  bazelisk build //proto                                                                                                    
Starting local Bazel server and connecting to it...
INFO: SHA256 (https://golang.org/dl/?mode=json&include=all) = 5d539711d20290d769b21f137348eea164d5fd408cfc6483c9937d9e1a2a6d98
INFO: Analyzed target //proto:proto (78 packages loaded, 8783 targets configured).
INFO: Found 1 target...
INFO: From Compiling src/google/protobuf/message_lite.cc:
In file included from /usr/include/string.h:519,
                 from external/com_google_protobuf/src/google/protobuf/stubs/port.h:39,
                 from external/com_google_protobuf/src/google/protobuf/stubs/macros.h:34,
                 from external/com_google_protobuf/src/google/protobuf/stubs/common.h:46,
                 from external/com_google_protobuf/src/google/protobuf/message_lite.h:45,
                 from external/com_google_protobuf/src/google/protobuf/message_lite.cc:36:
In function 'void* memcpy(void*, const void*, size_t)',
    inlined from 'google::protobuf::uint8* google::protobuf::io::EpsCopyOutputStream::WriteRaw(const void*, int, google::protobuf::uint8*)' at external/com_google_protobuf/src/google/protobuf/io/coded_stream.h:699:16,
    inlined from 'virtual google::protobuf::uint8* google::protobuf::internal::ImplicitWeakMessage::_InternalSerialize(google::protobuf::uint8*, google::protobuf::io::EpsCopyOutputStream*) const' at external/com_google_protobuf/src/google/protobuf/implicit_weak_message.h:85:28,
    inlined from 'bool google::protobuf::MessageLite::SerializePartialToZeroCopyStream(google::protobuf::io::ZeroCopyOutputStream*) const' at external/com_google_protobuf/src/google/protobuf/message_lite.cc:419:30:
/usr/include/bits/string_fortified.h:29:33: warning: 'void* __builtin___memcpy_chk(void*, const void*, long unsigned int, long unsigned int)' specified size between 18446744071562067968 and 18446744073709551615 exceeds maximum object size 9223372036854775807 [-Wstringop-overflow=]
   29 |   return __builtin___memcpy_chk (__dest, __src, __len,      |          ~~~~~~~~~~~~~~~~~~~~~~~^~~~~~~~~~~~~~~~~~~~~~   30 |                                  __glibc_objsize0 (__dest));
      |                                  ~~~~~~~~~~~~~~~~~~~~~~~~~~
Target //proto:proto up-to-date:
  bazel-bin/proto/proto.a
INFO: Elapsed time: 134.893s, Critical Path: 9.33s
INFO: 267 processes: 7 internal, 260 linux-sandbox.
INFO: Build completed successfully, 267 total actions

bazel构建完成后生成下面的3个 .pb.go 文件:

代码语言:javascript复制
 ⚡ root@localhost  ~/bazel-sample/protobuf   main ±  tree bazel-bin/proto 
bazel-bin/proto
├── proto.a
├── proto.x
├── user_go_proto_
│   └── github.com
│       └── jun06t
│           └── bazel-sample
│               └── protobuf
│                   └── proto
│                       ├── address.pb.go
│                       ├── user.pb.go
│                       └── zipcode.pb.go
└── user_proto-descriptor-set.proto.bin6 directories, 6 files

手动执行 protoc 编译

代码语言:javascript复制
 ⚡ root@localhost  ~/bazel-sample/protobuf   main  protoc --go_out=. --go_opt=paths=source_relative     --go-grpc_out=. --go-grpc_opt=paths=source_relative     proto/*.proto 
google/protobuf/any.proto: File not found.
proto/user.proto:8:1: Import "google/protobuf/any.proto" was not found or had errors.
proto/user.proto:14:3: "google.protobuf.Any" is not defined.

报错,因为安装protoc只装了可执行文件protoc,少装了文件:

代码语言:javascript复制
wget https://github.com/protocolbuffers/protobuf/releases/download/vxx.xx.xx/protoc-xx.xx.xx-linux-x86_64.zipunzip protoc-xx.xx.xx-linux-x86_64.zipcp bin/protoc /usr/bin/cp -r include/google /usr/include/
注:最后一行是为了将proto的一些库复制到系统,例如google/protobuf/any.proto,如果不复制,编译如果用了里面的库例如Any,会提示:protobuf google.protobuf.Any not found 。

补复制了下 include/ 文件夹,编译后,生成了下面的3个 .pb.go 文件:

代码语言:javascript复制
 ⚡ root@localhost  ~/bazel-sample/protobuf   main ±  ls proto/*      
proto/address.proto  proto/BUILD.bazel  proto/user.proto  proto/zipcode.proto
 ⚡ root@localhost  ~/bazel-sample/protobuf   main ±  protoc --go_out=. --go_opt=paths=source_relative     --go-grpc_out=. --go-grpc_opt=paths=source_relative     proto/*.proto
 ⚡ root@localhost  ~/bazel-sample/protobuf   main ±  ls proto/*                                                          
proto/address.pb.go  proto/address.proto  proto/BUILD.bazel  proto/user.pb.go  proto/user.proto  proto/zipcode.pb.go  proto/zipcode.proto

对比生成的3个 .pb.go 文件

代码语言:javascript复制
 ⚡ root@localhost  ~/bazel-sample/protobuf   main ±  diff bazel-bin/proto/user_go_proto_/github.com/jun06t/bazel-sample/protobuf/proto/address.pb.go proto/address.pb.go 
3,4c3,4< //    protoc-gen-go v1.27.1< //    protoc        v3.14.0
---> //    protoc-gen-go v1.28.0> //    protoc        v3.21.4
 ✘ ⚡ root@localhost  ~/bazel-sample/protobuf   main ±  diff bazel-bin/proto/user_go_proto_/github.com/jun06t/bazel-sample/protobuf/proto/zipcode.pb.go proto/zipcode.pb.go 
3,4c3,4< //    protoc-gen-go v1.27.1< //    protoc        v3.14.0
---> //    protoc-gen-go v1.28.0> //    protoc        v3.21.4
 ✘ ⚡ root@localhost  ~/bazel-sample/protobuf   main ±  diff bazel-bin/proto/user_go_proto_/github.com/jun06t/bazel-sample/protobuf/proto/user.pb.go proto/user.pb.go      
3,4c3,4< //    protoc-gen-go v1.27.1< //    protoc        v3.14.0
---> //    protoc-gen-go v1.28.0> //    protoc        v3.21.4

发现两种方式编译结果除了Bazel构建选用的两个工具的版本和手动编译的不一致,其他内容完全一致。手动的版本较新是因为是去Github手动下载的最新发布的版本。

0 人点赞