กฎบัฟเฟอร์ของโปรโตคอล

กฎ

• proto_library
• proto_lang_toolchain

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, toolchains, visibility)

หากใช้ Bazel โปรดโหลดกฎจาก https://github.com/bazelbuild/rules_proto.

ใช้ proto_library เพื่อกำหนดไลบรารีของบัฟเฟอร์โปรโตคอลที่ จากหลายภาษา proto_library อาจอยู่ในรายการ ในวรรค deps ของกฎที่รองรับ เช่น java_proto_library

เมื่อคอมไพล์ในบรรทัดคำสั่ง proto_library จะสร้างไฟล์ ชื่อ foo-descriptor-set.proto.bin ซึ่งเป็นตัวบ่งชี้สำหรับ ข้อความว่ากฎ srcs ไฟล์นี้เป็นแบบต่อเนื่อง 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 และอยู่ในแพ็กเกจเดียวกัน

อาร์กิวเมนต์

proto_lang_toolchain

proto_lang_toolchain(name, allowlist_different_package, blacklisted_protos, command_line, compatible_with, deprecation, distribs, exec_compatible_with, exec_properties, features, mnemonic, output_files, 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_protocol_library (เช่น java_proto_library) ควรเรียกใช้เมธอด Proto-compiler กฎ LANG_Pro_library บางกฎอนุญาตให้ระบุ Toolchain ที่จะใช้โดยใช้แฟล็กบรรทัดคำสั่งได้ โปรดอ่านเอกสารประกอบ

โดยปกติ คุณไม่ควรเขียนกฎเหล่านั้นเว้นแต่คุณต้องการที่จะ ปรับคอมไพเลอร์ Java

ไม่มีคอมไพเลอร์ ซึ่งได้มาจากกฎ protocol_library ที่เราแนบไปด้วย ใช่เลย ส่งเป็นแฟล็กบรรทัดคำสั่งไปยัง Blaze มีฟีเจอร์หลายอย่างที่ต้องมีการเรียกใช้ Pro-Compiler ในตัวกฎ Proto_library การบังคับใช้คอมไพเลอร์ที่ LANG_prof_library ใช้เหมือนกับคอมโพเนนต์ proto_library มี

ตัวอย่าง

ตัวอย่างง่ายๆ ได้แก่

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

อาร์กิวเมนต์