Locate and configure the Google Protocol Buffers library.
The following variables can be set and are optional:
Protobuf_SRC_ROOT_FOLDER
When compiling with MSVC, if this cache variable is set the protobuf-default VS project build locations (vsprojects/Debug and vsprojects/Release or vsprojects/x64/Debug and vsprojects/x64/Release) will be searched for libraries and binaries.
Protobuf_IMPORT_DIRS
List of additional directories to be searched for imported .proto files.
Protobuf_DEBUG
Show debug messages.
Protobuf_USE_STATIC_LIBS
Set to ON to force the use of the static libraries. Default is OFF.
Defines the following variables:
Protobuf_FOUND
Found the Google Protocol Buffers library (libprotobuf & header files)
Protobuf_VERSION
Version of package found.
Protobuf_INCLUDE_DIRS
Include directories for Google Protocol Buffers
Protobuf_LIBRARIES
The protobuf libraries
Protobuf_PROTOC_LIBRARIES
The protoc libraries
Protobuf_LITE_LIBRARIES
The protobuf-lite libraries
The following IMPORTED
targets are also defined:
protobuf::libprotobuf
The protobuf library.
protobuf::libprotobuf-lite
The protobuf lite library.
protobuf::libprotoc
The protoc library.
protobuf::protoc
The protoc compiler.
The following cache variables are also available to set or use:
Protobuf_LIBRARY
The protobuf library
Protobuf_PROTOC_LIBRARY
The protoc library
Protobuf_INCLUDE_DIR
The include directory for protocol buffers
Protobuf_PROTOC_EXECUTABLE
The protoc compiler
Protobuf_LIBRARY_DEBUG
The protobuf library (debug)
Protobuf_PROTOC_LIBRARY_DEBUG
The protoc library (debug)
Protobuf_LITE_LIBRARY
The protobuf lite library
Protobuf_LITE_LIBRARY_DEBUG
The protobuf lite library (debug)
Example:
find_package(Protobuf REQUIRED) include_directories(${Protobuf_INCLUDE_DIRS}) include_directories(${CMAKE_CURRENT_BINARY_DIR}) protobuf_generate_cpp(PROTO_SRCS PROTO_HDRS foo.proto) protobuf_generate_cpp(PROTO_SRCS PROTO_HDRS EXPORT_MACRO DLL_EXPORT foo.proto) protobuf_generate_cpp(PROTO_SRCS PROTO_HDRS DESCRIPTORS PROTO_DESCS foo.proto) protobuf_generate_python(PROTO_PY foo.proto) add_executable(bar bar.cc ${PROTO_SRCS} ${PROTO_HDRS}) target_link_libraries(bar ${Protobuf_LIBRARIES})
Note
The protobuf_generate_cpp
and protobuf_generate_python
functions and add_executable()
or add_library()
calls only work properly within the same directory.
protobuf_generate_cpp
Add custom commands to process .proto
files to C++:
protobuf_generate_cpp (<SRCS> <HDRS> [DESCRIPTORS <DESC>] [EXPORT_MACRO <MACRO>] [<ARGN>...])
SRCS
Variable to define with autogenerated source files
HDRS
Variable to define with autogenerated header files
DESCRIPTORS
Variable to define with autogenerated descriptor files, if requested.
EXPORT_MACRO
is a macro which should expand to __declspec(dllexport)
or __declspec(dllimport)
depending on what is being compiled.
ARGN
.proto
files
protobuf_generate_python
Add custom commands to process .proto
files to Python:
protobuf_generate_python (<PY> [<ARGN>...])
PY
Variable to define with autogenerated Python files
ARGN
.proto
files
© 2000–2020 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/v3.19/module/FindProtobuf.html