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