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şaretçileri kullanılarak hangi araç zincirinin kullanılacağını belirtmeye olanak tanır. Bu kuralların belgelerine bakın.

Java derleyicinizi ayarlamak istemiyorsanız genellikle bu tür kurallar yazmamalısınız.

Derleyici yoktur. Proto derleyici, eklediğimiz proto_library kuralından alınır. Bu parametre, Blaze'a komut satırı işareti olarak iletilir. Bazı özellikler, proto_library kuralının kendisinde bir proto-derleyicinin çağrılmasını gerektirir. LANG_proto_library tarafından kullanılan derleyicinin, proto_library tarafından kullanılan derleyiciyle aynı olmasını zorunlu kılmak faydalıdır.

Örnekler

Basit bir örnek verelim:

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ı. Bunun yerine lütfen https://github.com/bazelbuild/rules_proto adresini kullanın.

Birden fazla dilde kullanılabilecek protokol arabellek kitaplıklarını tanımlamak için proto_library kullanın. proto_library, desteklenen kuralların deps yan tümcesinde java_proto_library gibi bir değer olarak listelenebilir.

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

Yalnızca bir proto_library kuralı tarafından doğrudan bahsedilen .proto dosyalarıyla ilgili bilgileri içerir; geçişli tanımlayıcı kümesi koleksiyonu [ProtoInfo].transitive_descriptor_sets Starlark sağlayıcısı aracılığıyla kullanılabilir. ProtoInfo.java adresindeki dokümanlara göz atın.

Önerilen kod düzenlemesi:

• .proto dosyası başına bir proto_library kuralı.
• foo.proto adlı bir dosya, aynı pakette bulunan foo_proto adlı bir kuralda yer alır.
• foo_proto adlı bir proto_library'yi sarmalayan [language]_proto_library, foo_[language]_proto olarak adlandırılmalı ve aynı pakette bulunmalıdır.

Bağımsız değişkenler