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.22/module/FindProtobuf.html