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–2022 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/v3.23/module/FindProtobuf.html