FindProtobuf

Поиск и настройка библиотеки Google Protocol Buffers.

Новое в версии 3.6: Поддержка проверок версии find_package().

Изменено в версии 3.6: Все входные и выходные переменные используют префикс Protobuf_. Переменные с префиксом PROTOBUF_ всё ещё поддерживаются для совместимости.

Следующие переменные можно задать, они необязательны:

Protobuf_SRC_ROOT_FOLDER: При компиляции с MSVC, если эта переменная кэша задана, будут просматриваться места расположения проектов protobuf-default VS (vsprojects/Debug и vsprojects/Release или vsprojects/x64/Debug и vsprojects/x64/Release) для поиска библиотек и бинарных файлов.
Protobuf_IMPORT_DIRS: Список дополнительных каталогов, которые будут просматриваться для импортированных файлов .proto.
Protobuf_DEBUG: Новое в версии 3.6.

Показать отладочные сообщения.
Protobuf_USE_STATIC_LIBS: Новое в версии 3.9.

Установите в ON, чтобы принудительно использовать статические библиотеки. По умолчанию OFF.

Определяет следующие переменные:

Protobuf_FOUND: Найдена библиотека Google Protocol Buffers (libprotobuf и заголовочные файлы)
Protobuf_VERSION: Новое в версии 3.6.

Найденная версия пакета.
Protobuf_INCLUDE_DIRS: Директории заголовков для Google Protocol Buffers
Protobuf_LIBRARIES: Библиотеки protobuf
Protobuf_PROTOC_LIBRARIES: Библиотеки protoc
Protobuf_LITE_LIBRARIES: Библиотеки protobuf-lite

Новое в версии 3.9: Также определены следующие целевые объекты IMPORTED:

protobuf::libprotobuf: Библиотека protobuf.
protobuf::libprotobuf-lite: Библиотека protobuf lite.
protobuf::libprotoc: Библиотека protoc.
protobuf::protoc: Новое в версии 3.10: Компилятор protoc.

Также доступны следующие переменные кэша для задания или использования:

Protobuf_LIBRARY: Библиотека protobuf
Protobuf_PROTOC_LIBRARY: Библиотека protoc
Protobuf_INCLUDE_DIR: Директория заголовков для протоколов
Protobuf_PROTOC_EXECUTABLE: Компилятор protoc
Protobuf_LIBRARY_DEBUG: Библиотека protobuf (отладка)
Protobuf_PROTOC_LIBRARY_DEBUG: Библиотека protoc (отладка)
Protobuf_LITE_LIBRARY: Библиотека protobuf-lite
Protobuf_LITE_LIBRARY_DEBUG: Библиотека protobuf-lite (отладка)

Пример:

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

Примечание

Функции protobuf_generate_cpp и protobuf_generate_python и вызовы add_executable() или add_library() работают корректно только в пределах одной директории.

protobuf_generate_cpp

Добавление пользовательских команд для обработки файлов .proto в C++:

protobuf_generate_cpp (<SRCS> <HDRS>
    [DESCRIPTORS <DESC>] [EXPORT_MACRO <MACRO>] [<ARGN>...])

SRCS: Переменная для определения сгенерированных исходных файлов
HDRS: Переменная для определения сгенерированных заголовочных файлов
DESCRIPTORS: Новое в версии 3.10: Переменная для определения сгенерированных файлов дескриптора, если необходимо.
EXPORT_MACRO: это макрос, который должен развертываться в __declspec(dllexport) или __declspec(dllimport) в зависимости от того, что компилируется.
ARGN: файлы .proto

protobuf_generate_python

Новое в версии 3.4.

Добавление пользовательских команд для обработки файлов .proto в Python:

protobuf_generate_python (<PY> [<ARGN>...])

PY: Переменная для определения сгенерированных Python файлов
ARGN: файлы .proto

© 2000–2021 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/v3.20/module/FindProtobuf.html