प्रोटोकॉल बफ़र के नियम

नियम

• 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)

यदि Basel का उपयोग किया जा रहा है, तो कृपया से नियम लोड करें 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 कंपनी. proto_info.bzl में दस्तावेज़ देखें.

सुझाया गया कोड संगठन:

• हर .proto फ़ाइल के लिए एक proto_library नियम.
• foo.proto नाम की फ़ाइल, foo_proto नाम के नियम में होगी, जो उसी पैकेज में मौजूद हो.
• proto_library को रैप करने वाला [language]_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)

यदि Basel का उपयोग किया जा रहा है, तो कृपया से नियम लोड करें https://github.com/bazelbuild/rules_proto.

बताता है कि lang_proto_library नियम कैसे सेट करता है (उदाहरण के लिए, java_proto_library) को प्रोटो-कंपाइलर. कुछ lang_proto_library नियम यह तय करने की अनुमति देते हैं कि कमांड लाइन फ़्लैग का इस्तेमाल करके किस टूलचेन का इस्तेमाल किया जाए; उनके दस्तावेज़ देखें.

आम तौर पर, आपको ऐसे नियम तब तक नहीं लिखने चाहिए, जब तक कि आप अपने Java कंपाइलर को ट्यून करें.

कोई कंपाइलर नहीं है. प्रोटो-कंपाइलर, उस proto_library नियम से लिया जाता है जिससे हम जुड़े हुए होते हैं. हां Blaze को कमांड-लाइन फ़्लैग के तौर पर भेजा गया था. कई सुविधाओं का इस्तेमाल करने के लिए, Proto_library नियम पर ही किसी प्रोटो-कंपाइलर को शुरू करना ज़रूरी है. कंपाइलर को लागू करना फ़ायदेमंद होता है, क्योंकि प्रोग्राम_proto_library उसी तरह से इस्तेमाल करता है जैसा पहले इस्तेमाल किया जाता है proto_library करता है.

उदाहरण

इसका एक सरल उदाहरण यह होगा:

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

तर्क