プロトコル バッファ ルール

ルール

• cc_proto_library
• java_lite_proto_library
• java_proto_library
• proto_library
• py_proto_library
• proto_lang_toolchain
• proto_toolchain

cc_proto_library

cc_proto_library(name, deps, aspect_hints, compatible_with, deprecation, exec_compatible_with, exec_group_compatible_with, exec_properties, features, package_metadata, restricted_to, tags, target_compatible_with, testonly, toolchains, visibility)

cc_proto_library は、.proto ファイルから C++ コードを生成します。

deps は proto_library ルールを指している必要があります。

例:

cc_library(
    name = "lib",
    deps = [":foo_cc_proto"],
)

cc_proto_library(
    name = "foo_cc_proto",
    deps = [":foo_proto"],
)

proto_library(
    name = "foo_proto",
)

引数

java_lite_proto_library

java_lite_proto_library(name, deps, aspect_hints, compatible_with, deprecation, exec_compatible_with, exec_group_compatible_with, exec_properties, features, package_metadata, restricted_to, tags, target_compatible_with, testonly, toolchains, visibility)

java_lite_proto_library は、.proto ファイルから Java コードを生成します。

deps は proto_library ルールを指している必要があります。

例:

java_library(
    name = "lib",
    runtime_deps = [":foo"],
)

java_lite_proto_library(
    name = "foo",
    deps = [":bar"],
)

proto_library(
    name = "bar",
)

引数

java_proto_library

java_proto_library(name, deps, aspect_hints, compatible_with, deprecation, exec_compatible_with, exec_group_compatible_with, exec_properties, features, licenses, package_metadata, restricted_to, tags, target_compatible_with, testonly, toolchains, visibility)

java_proto_library は、.proto ファイルから Java コードを生成します。

deps は proto_library ルールを指している必要があります。

例:

java_library(
    name = "lib",
    runtime_deps = [":foo_java_proto"],
)

java_proto_library(
    name = "foo_java_proto",
    deps = [":foo_proto"],
)

proto_library(
    name = "foo_proto",
)

引数

proto_library

proto_library(name, deps, srcs, data, allow_exports, aspect_hints, compatible_with, deprecation, exec_compatible_with, exec_group_compatible_with, exec_properties, exports, extension_declarations, features, import_prefix, licenses, option_deps, package_metadata, restricted_to, strip_import_prefix, tags, target_compatible_with, testonly, toolchains, visibility)

proto_library を使用して、複数の言語で使用できるプロトコル バッファのライブラリを定義します。proto_library は、サポートされているルールの deps 句にリストできます。たとえば、java_proto_library などです。

コマンドラインでコンパイルすると、proto_library は foo-descriptor-set.proto.bin という名前のファイルを作成します。これは、ルールのソースのメッセージの記述子セットです。このファイルは、 FileDescriptorSet で説明されているシリアル化された https://developers.google.com/protocol-buffers/docs/techniques#self-descriptionです。

`.proto` ファイルに関する情報のみが含まれます。これは、`proto_library` ルールで直接言及されています。推移的な記述子セットのコレクションは、`[ProtoInfo].transitive_descriptor_sets` Starlark プロバイダから取得できます。proto_info.bzl のドキュメントをご覧ください。

推奨されるコード構成:

• proto_library ファイルごとに 1 つの .proto ルール。
• foo.proto という名前のファイルは、同じパッケージにある foo_proto という名前のルールにあります。
• [language]_proto_library という名前の proto_library をラップする foo_proto は foo_[language]_proto という名前で、同じパッケージに配置する必要があります。

引数

py_proto_library

py_proto_library(name, deps, aspect_hints, compatible_with, deprecation, exec_compatible_with, exec_group_compatible_with, exec_properties, features, package_metadata, restricted_to, tags, target_compatible_with, testonly, toolchains, visibility)

引数

proto_lang_toolchain

proto_lang_toolchain(name, allowlist_different_package, aspect_hints, blacklisted_protos, command_line, compatible_with, denylisted_protos, deprecation, exec_compatible_with, exec_group_compatible_with, exec_properties, features, mnemonic, output_files, package_metadata, plugin, plugin_format_flag, progress_message, protoc_minimal_do_not_use, restricted_to, runtime, tags, target_compatible_with, testonly, toolchain_type, toolchains, visibility)

Bazel を使用している場合は、 https://github.com/bazelbuild/rules_proto. からルールを読み込んでください。

LANG_proto_library ルール（java_proto_library) が proto コンパイラを呼び出す方法を指定します。 LANG_proto_library ルールの中には、コマンドライン フラグを使用して使用するツールチェーンを指定できるものがあります。 ドキュメントをご覧ください。

通常、Java コンパイラを調整する場合を除き、このようなルールを作成する必要はありません。

コンパイラはありません。proto コンパイラは、アタッチする proto_library ルールから取得されます。Blaze にコマンドライン フラグとして渡されます。一部の機能では、proto_library ルール自体で proto コンパイラを呼び出す必要があります。 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_toolchain

proto_toolchain(name, aspect_hints, command_line, compatible_with, deprecation, exec_compatible_with, exec_group_compatible_with, exec_properties, features, mnemonic, output_files, package_metadata, progress_message, proto_compiler, restricted_to, tags, target_compatible_with, testonly, toolchains, visibility)

引数