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

รายงานปัญหา ดูแหล่งที่มา รุ่น Nightly · 7.4

กฎ

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_protocol_library (เช่น java_proto_library) ควรเรียกใช้ Proto-Compiler กฎ LANG_proto_library บางข้ออนุญาตให้ระบุเครื่องมือทางเทคนิคที่จะใช้โดยใช้ Flag บรรทัดคำสั่ง โปรดดูเอกสารประกอบ

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

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

ตัวอย่าง

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

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

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

Attributes
name

ชื่อ ต้องระบุ

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

blacklisted_protos

รายการป้ายกํากับ ค่าเริ่มต้นคือ []

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

สตริง ต้องระบุ

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

สตริง ค่าเริ่มต้นคือ "GenProto"

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

สตริง ค่าเริ่มต้นคือ "legacy"

ควบคุมการจัดรูปแบบ $(OUT) ใน command_line โดยระบุเส้นทางไปยังไฟล์เดียวหรือไดเรกทอรีเอาต์พุตในกรณีที่มีไฟล์หลายไฟล์ ค่าที่เป็นไปได้คือ "single", "multiple"
plugin

ป้ายกํากับ ค่าเริ่มต้นคือ None

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

สตริง ค่าเริ่มต้นคือ ""

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

สตริง ค่าเริ่มต้นคือ "Generating proto_library %{label}"

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

ป้ายกำกับ ค่าเริ่มต้นคือ None

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

ป้ายกํากับ ค่าเริ่มต้นคือ None

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

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 เพื่อกำหนดไลบรารีของบัฟเฟอร์โปรโตคอลซึ่งอาจมีการใช้งานจากหลายภาษา 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 ดูเอกสารประกอบใน ProtoInfo.java

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

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

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

Attributes
name

ชื่อ ต้องระบุ

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

deps

รายการป้ายกํากับ ค่าเริ่มต้นคือ []

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

รายการป้ายกํากับ ค่าเริ่มต้นคือ []

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

ป้ายกำกับ ค่าเริ่มต้นคือ None

รายการที่อนุญาตซึ่งไม่บังคับซึ่งป้องกันไม่ให้ส่งออกไลบรารีโปรโตอีกครั้งหรือใช้ใน lang_proto_library ที่ไม่ได้อยู่ในแพ็กเกจที่ระบุ
exports

รายการป้ายกํากับ ค่าเริ่มต้นคือ []

รายการเป้าหมาย proto_library ที่อ้างอิงได้ผ่าน "import public" ในแหล่งที่มาของ proto
import_prefix

สตริง ค่าเริ่มต้นคือ ""

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

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

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

strip_import_prefix

สตริง ค่าเริ่มต้นคือ ""

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

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

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

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