Protokol Arabelleği Kuralları

Kurallar

• 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 kullanıyorsanız lütfen kuralı https://github.com/bazelbuild/rules_proto adresinden yükleyin.

Bir LANG_proto_library kuralının (ör. java_proto_library) proto derleyiciyi çağırmalıdır. Bazı LANG_proto_library kuralları, komut satırı işaretlerini kullanarak hangi araç zincirinin kullanılacağını belirtmeye olanak tanır. Bu kurallar için dokümanlarına bakın.

Java derleyicinizi ayarlamak istemediğiniz sürece normalde bu tür kurallar yazmamalısınız.

Derleyici yoktur. Proto derleyici, bağladığımız proto_library kuralından alınır. Blaze'e komut satırı işareti olarak iletilir. Bazı özellikler için proto_library kuralında proto derleyicinin çağrılması gerekir. LANG_proto_library'nin kullandığı derleyicinin proto_library ile aynı olmasını zorunlu kılmak faydalıdır.

Örnekler

Basit bir örnek:

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

Bağımsız değişkenler

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)

Kullanımdan kaldırıldı. Lütfen bunun yerine https://github.com/bazelbuild/rules_proto adresini kullanın.

Birden fazla dilde kullanılabilecek protokol arabellekleri kitaplıklarını tanımlamak için proto_library kullanın. proto_library, java_proto_library gibi desteklenen kuralların deps maddesinde listelenebilir.

Komut satırında derlendiğinde proto_library, foo-descriptor-set.proto.bin adlı bir dosya oluşturur. Bu dosya, kural kaynaklarının iletileri için tanımlayıcı kümesidir. Dosya, FileDescriptorSet olarak serileştirilmiştir. Bu, https://developers.google.com/protocol-buffers/docs/techniques#self-description adresinde açıklanmıştır.

Yalnızca bir .proto kuralı tarafından doğrudan belirtilen proto_library dosyalarıyla ilgili bilgileri içerir. Geçişli tanımlayıcı kümelerinin toplanması [ProtoInfo].transitive_descriptor_sets Starlark sağlayıcısı aracılığıyla kullanılabilir. ProtoInfo.java adresindeki belgelere göz atın.

Önerilen kod düzeni:

• .proto dosyası başına bir proto_library kuralı.
• foo.proto adlı bir dosya, aynı pakette bulunan foo_proto adlı bir kuralda yer alacak.
• foo_proto adlı bir proto_library öğesini sarmalayan bir [language]_proto_library öğesine foo_[language]_proto adı verilmelidir ve aynı pakette bulunmalıdır.

Bağımsız değişkenler