Правила Protocol Buffer

Правила

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

Устарело. Пожалуйста, используйте https://github.com/bazelbuild/rules_proto вместо этого.

Определяет, как правило LANG_proto_library (например, java_proto_library) должно вызывать прото-компилятор. Некоторые правила LANG_proto_library позволяют указать, какую использовать цепочку инструментов, используя флаги командной строки; ознакомьтесь с их документацией.

Обычно вам не нужно писать такие правила, если вы не хотите настроить Java-компилятор.

Компилятора нет. Прото-компилятор берется из правила proto_library, которое мы прикрепляем. Он передается как флаг командной строки в Blaze. Несколько функций требуют вызова прото-компилятора для самого правила proto_library. Выгодно обеспечить, чтобы компилятор, используемый правилом LANG_proto_library, был таким же, как тот, proto_library использует.

Примеры

Простой пример:

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

Аргументы

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_proto вместо этого.

Используйте proto_library для определения библиотек protocol buffers, которые могут использоваться из нескольких языков. 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; коллекция транзитивных наборов описателей доступна через провайдер Starlark [ProtoInfo].transitive_descriptor_sets. Смотрите документацию в ProtoInfo.java.

Рекомендуемая организация кода:

• Одно правило proto_library на один файл .proto.
• Файл с именем foo.proto будет в правиле с именем foo_proto, расположенном в том же пакете.
• Правило [language]_proto_library обертывающее правило proto_library с именем foo_proto должно называться foo_[language]_proto, и быть расположенным в том же пакете.

Аргументы