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

กฎ

• 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) ควรเรียกใช้ โปรโตคอมไพเลอร์ กฎ LANG_proto_library บางอย่างอนุญาตให้ระบุ Toolchain ที่จะใช้โดยใช้แฟล็กบรรทัดคำสั่ง โปรดดูเอกสารประกอบ

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

ไม่มีคอมไพเลอร์ คอมไพเลอร์โปรโตมาจากกฎ proto_library ที่เราแนบมา โดยจะ ส่งเป็น Flag บรรทัดคำสั่งไปยัง Blaze ฟีเจอร์หลายอย่างต้องเรียกใช้โปรแกรมคอมไพเลอร์ Proto ในกฎ proto_library เอง การบังคับให้คอมไพเลอร์ที่ 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 Buffer ซึ่งอาจใช้ได้จากหลายภาษา 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

โดยจะมีเฉพาะข้อมูลเกี่ยวกับไฟล์ที่กฎ .protoproto_library กล่าวถึงโดยตรงเท่านั้น ส่วนการรวบรวมชุดตัวอธิบายแบบทรานซิทีฟจะใช้ได้ผ่านผู้ให้บริการ [ProtoInfo].transitive_descriptor_sets Starlark ดูเอกสารประกอบใน ProtoInfo.java

การจัดระเบียบโค้ดที่แนะนำ

• กฎ proto_library หนึ่งข้อต่อไฟล์ .proto หนึ่งไฟล์
• ไฟล์ชื่อ foo.proto จะอยู่ในกฎชื่อ foo_proto ซึ่ง อยู่ในแพ็กเกจเดียวกัน
• [language]_proto_library ที่ครอบ proto_library ชื่อ foo_proto ควรเรียกว่า foo_[language]_proto และอยู่ในแพ็กเกจเดียวกัน

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