Skip to content

Latest commit

 

History

History
82 lines (64 loc) · 2.64 KB

idl.md

File metadata and controls

82 lines (64 loc) · 2.64 KB

Build Protobuf and Thrift

proto_library

Build protobuf targets

proto_library(
    name = 'rpc_meta_info_proto',
    srcs = 'rpc_meta_info.proto',
    deps = ':rpc_option_proto',
)

deps are other proto_library which are imported. protobuf runtime library will be depended automatically, needn't to be specified explicitly.

proto_library support generate targets for multiple target languages.

When generate for C++ code, it generate a c++ library with corresponding header files. To include the generated header file of a proto file, you should include it with the full path from the root of the workspace, replace the proto suffix into pb.h. For example, the header file of //common/base/string_test.proto is "common/base/string_test.pb.h".

When a java targets depends on a proto_library, the java relatived code will be generated automatically, it is also similar to other target languages，such as python. so we only need one proto_library for multiple target languages.

If you want to generate code for specified languages unconditionly, you can use the target_languages argument:

proto_library(
    name = 'rpc_meta_info_proto',
    srcs = 'rpc_meta_info.proto',
    deps = ':rpc_option_proto',
    target_languages = ['java', 'python'],
)

The cpp target code is always generated.

If you want to generate some cpp code with other suffix names, you can use cpp_outs attributes. The default value is ['.pb']. For example, if you want to use grpc plugin to generate rpc_meta_info.pb.cc/h and rpc_meta_info.grpc.pb.cc/h, set cpp_outs = [".pb', '.grpc.pb']

Besides, use plugin_opts to pass some options to plugins, like plugin_opts={"plugin_name":["option1", "option2.."]},. Blade will pass --plugin_name_opt=option1 --plugin_name_opt=option2 to grpc plugin.

proto_library(
    name = 'rpc_meta_info_proto',
    srcs = 'rpc_meta_info.proto',
    deps = ':rpc_option_proto',
    target_languages = ['java', 'python'],
    plugins = ['grpc'],
    cpp_outs = ['.pb', '.grpc.pb'],
    plugin_opts = {
        'grpc': ["option1", "option2"],
    },
)

thrift_library

Can be used to generate thrift C++ library deps is the other thrift_library which are imported. thrift runtime will be depended automatically, needn't to be specified explicitly. The generated result is a c++ linrary with with corresponding header files.

thrift_library(
    name = 'shared_thrift',
    srcs = 'shared.thrift',
)

thrift_library(
    name = 'tutorial_thrift',
    srcs = 'tutorial.thrift',
    deps = ':shared_thrift'
)

Similay to proto_library, to include generated header files, the full path is also required.