Spec-Zone.ru › CMake 3.24

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API