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

กฎ

proto_lang_toolchain

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

เลิกใช้งานแล้ว โปรด https://github.com/bazelbuild/rules_protocol แทน

ระบุกฎ 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",
)

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

Attributes
name

Name; required

ชื่อที่ไม่ซ้ำกันสำหรับเป้าหมายนี้

blacklisted_protos

List of labels; optional

จะไม่มีการสร้างโค้ดสำหรับไฟล์ในแอตทริบิวต์ srcs ของ blacklisted_protos ใช้สำหรับไฟล์ .prof ที่ลิงก์กับรันไทม์ของ Pro แล้ว เช่น any.proto
command_line

String; required

ค่านี้จะส่งไปยังโปรโตคอมไพเลอร์เพื่อสร้างโค้ด ใส่เฉพาะส่วน เฉพาะสำหรับโปรแกรมสร้าง/ปลั๊กอินนี้ (เช่น อย่ารวมพารามิเตอร์ -I)
  • $(OUT) เป็น LANG_protocol_library โดยเฉพาะ กฎเหล่านี้เป็นสิ่งที่เป็นตัวกำหนด วิธีที่ตัวแปรนี้ตีความ ตัวอย่างเช่น สำหรับ Java $(OUT) จะถูกแทนที่ด้วย ชื่อไฟล์ src-jar ที่จะสร้าง
mnemonic

String; optional; default is "GenProto"

ค่านี้จะตั้งเป็นการช่วยจำในการทำงานของโปรโตค
plugin

Label; optional

ถ้ามี จะพร้อมใช้งานสำหรับการทำงานที่เรียกใช้ Proto-Compiler และจะ ที่ส่งไปยังคอมไพเลอร์ Proto: --plugin=protoc-gen-PLUGIN=.
plugin_format_flag

String; optional

หากระบุ ระบบจะส่งค่านี้ไปยัง Proto-compiler เพื่อใช้ปลั๊กอิน ค่าต้อง มี %s ไฟล์เดียวซึ่งแทนที่ด้วยไฟล์ปฏิบัติการของปลั๊กอิน --plugin=protoc-gen-PLUGIN=.
progress_message

String; optional; default is "Generating proto_library %{label}"

ค่านี้จะตั้งเป็นข้อความแสดงความคืบหน้าในการดำเนินการ Protoc
proto_compiler

Label; optional

ไฟล์ปฏิบัติการของคอมไพเลอร์ Pro หากมี ระบบจะใช้เป้าหมายนี้เป็นคอมไพเลอร์ Proto เพื่อสร้างโค้ด
runtime

Label; optional

ไลบรารีเฉพาะภาษาที่คอมไพล์โค้ดที่สร้างขึ้น การทำงานจะเหมือนกับ LANG_prod_library เช่น Java ควรคอมไพล์ตามรันไทม์

proto_library

proto_library(name, deps, srcs, data, 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_protocol แทน

ใช้ 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 ดูเอกสารประกอบใน ProtoInfo.java

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

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

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

Attributes
name

Name; required

ชื่อที่ไม่ซ้ำกันสำหรับเป้าหมายนี้

deps

List of labels; optional

รายการกฎ proto_library อื่นๆ ที่เป้าหมายอ้างอิง proto_library อาจขึ้นอยู่กับ เป้าหมาย proto_library โดยอาจไม่ขึ้นอยู่กับไลบรารีเฉพาะภาษา
srcs

List of labels; optional

รายชื่อไฟล์ .proto และ .protodevel ที่ ประมวลผลเพื่อสร้างเป้าหมาย ซึ่งโดยปกติเป็นรายการที่ไม่ว่างเปล่า หนึ่งกรณีการใช้งาน ค่าที่ srcs สามารถเว้นว่างได้คือ alias-library นี่คือ กฎ Proto_library ที่มี proto_library อื่นอย่างน้อย 1 รายการใน deps รูปแบบนี้สามารถใช้เพื่อทําสิ่งต่อไปนี้ได้ ส่งออก API สาธารณะภายใต้ชื่อถาวร
exports

List of labels; optional

รายการเป้าหมาย Proto_library ที่สามารถอ้างอิงผ่าน "นำเข้าสาธารณะ" ได้ ใน Proto แหล่งที่มา
import_prefix

String; optional

คำนำหน้าที่จะเพิ่มลงในเส้นทางของไฟล์ .prof ในกฎนี้

เมื่อตั้งค่าแล้ว ไฟล์ต้นฉบับ .protocol ในแอตทริบิวต์ srcs ของกฎนี้จะเป็น "เข้าถึงได้ที่" คือค่าของแอตทริบิวต์นี้ที่เพิ่มไว้ข้างหน้าเส้นทางที่สัมพันธ์กับที่เก็บ

ระบบนำคำนำหน้าในแอตทริบิวต์ strip_import_prefix ออกก่อนหน้านั้น เพิ่มคำนำหน้าแล้ว

strip_import_prefix

String; optional

คำนำหน้าที่จะตัดออกจากเส้นทางของไฟล์ .prof ในกฎนี้

เมื่อตั้งค่าแล้ว ไฟล์ต้นฉบับ .protocol ในแอตทริบิวต์ srcs ของกฎนี้จะเป็น เข้าถึงได้ตามเส้นทางของตนโดยตัดคำนำหน้านี้

หากเป็นเส้นทางแบบสัมพัทธ์ (ไม่ได้เริ่มต้นด้วยเครื่องหมายทับ) ระบบจะใช้เป็นเส้นทางซึ่งสัมพันธ์กับแพ็กเกจ ข้อแรก หากเป็นเส้นทางสัมบูรณ์ ระบบเข้าใจว่าเป็นเส้นทางที่สัมพันธ์กับที่เก็บ

ระบบจะเพิ่มคำนำหน้าในแอตทริบิวต์ import_prefix หลังคำนำหน้านี้คือ ถูกตัดออก