协议缓冲区规则

规则

• proto_lang_toolchain
• proto_library

proto_lang_toolchain

proto_lang_toolchain(name, blacklisted_protos, command_line, compatible_with, deprecation, distribs, exec_compatible_with, exec_properties, features, licenses, mnemonic, output_files, plugin, plugin_format_flag, progress_message, proto_compiler, restricted_to, runtime, tags, target_compatible_with, testonly, visibility)

如果使用 Bazel，请从 https://github.com/bazelbuild/rules_proto 加载规则。

指定 LANG_proto_library 规则（例如 java_proto_library) 应调用 proto 编译器。 某些 LANG_proto_library 规则允许使用命令行标志指定要使用的工具链；请参阅其文档。

通常情况下，您不应编写此类规则，除非您想调整 Java 编译器。

没有编译器。proto-compiler 取自我们附加到的 proto_library 规则。它作为命令行标志传递给 Blaze。有几项功能要求在 proto_library 规则本身上调用 proto-compiler。强制执行 LANG_proto_library 使用的编译器与 proto_library 使用的编译器相同，这很有好处。

示例

一个简单的示例：

proto_lang_toolchain(
    name = "javalite_toolchain",
    command_line = "--javalite_out=shared,immutable:$(OUT)",
    plugin = ":javalite_plugin",
    runtime = ":protobuf_lite",
)

参数

proto_library

proto_library(name, deps, srcs, data, allow_exports, compatible_with, deprecation, distribs, exec_compatible_with, exec_properties, exports, features, import_prefix, licenses, restricted_to, strip_import_prefix, tags, target_compatible_with, testonly, visibility)

已弃用。请改为使用 https://github.com/bazelbuild/rules_proto。

使用 proto_library 定义可从多种语言使用的 Protocol Buffers 库。proto_library 可以列在受支持规则（例如 java_proto_library）的 deps 子句中。

在命令行中编译时，proto_library 会创建一个名为 foo-descriptor-set.proto.bin 的文件，该文件是规则 src 的消息的描述符集。该文件是序列化的 FileDescriptorSet，如需了解详情，请参阅 https://developers.google.com/protocol-buffers/docs/techniques#self-description。

它仅包含 proto_library 规则直接提及的 .proto 文件的相关信息；传递性描述符集的集合可通过 [ProtoInfo].transitive_descriptor_sets Starlark 提供程序获取。如需查看相关文档，请访问 ProtoInfo.java。

建议的代码组织方式：

• 每个 .proto 文件中只能有一条 proto_library 规则。
• 名为 foo.proto 的文件将位于名为 foo_proto 的规则中，该规则位于同一软件包中。
• 封装名为 foo_proto 的 proto_library 的 [language]_proto_library 应命名为 foo_[language]_proto，并位于同一软件包中。

参数