Большинство библиотек для C++
имеют интеграцию с CMake
, и их можно подключить просто через find_package()
.
В таком случае вместо include_directories()
используйте find_package()
с target_link_libraries()
:
find_package(<Library> REQUIRED)
target_link_libraries(${PACKAGE_NAME} PRIVATE <Library>)
У find_package()
есть 3 режима:
Module mode, который ищет Find<PackageName>.cmake
файлы по путям, которые хранятся в CMAKE_MODULE_PATH
. По умолчанию он ищет в дефолтном каталоге, где установлен сам CMake, например:
/opt/Qt/Tools/CMake/share/cmake-3.25/Modules/
.
Config mode, который ищет <PackageName>Config.cmake
файлы по путям, которые хранятся в CMAKE_PREFIX_PATH
. В этом случае тоже есть дефолтные пути, которые зависят от платформы. Так же от платформы зависят правила, по которым конфиг-файл должен располагаться в иерархии каталогов библиотеки:
<prefix>/ W
<prefix>/(cmake|CMake)/ W
<prefix>/<name>*/ W
<prefix>/<name>*/(cmake|CMake)/ W
<prefix>/<name>*/(cmake|CMake)/<name>*/ W
<prefix>/(lib/<arch>|lib*|share)/cmake/<name>*/ U
<prefix>/(lib/<arch>|lib*|share)/<name>*/ U
<prefix>/(lib/<arch>|lib*|share)/<name>*/(cmake|CMake)/ U
<prefix>/<name>*/(lib/<arch>|lib*|share)/cmake/<name>*/ W/U
<prefix>/<name>*/(lib/<arch>|lib*|share)/<name>*/ W/U
<prefix>/<name>*/(lib/<arch>|lib*|share)/<name>*/(cmake|CMake)/ W/U
<prefix>/<name>.framework/Resources/ A
<prefix>/<name>.framework/Resources/CMake/ A
<prefix>/<name>.framework/Versions/*/Resources/ A
<prefix>/<name>.framework/Versions/*/Resources/CMake/ A
<prefix>/<name>.app/Contents/Resources/ A
<prefix>/<name>.app/Contents/Resources/CMake/ A
W
- Windows; U
- UNIX (Linux); A
- macOS, iOS
<prefix>
- это как раз один из путей, который лежит в CMAKE_PREFIX_PATH
FetchContent redirection mode, который качает git-репу в configure time. А также его аналог - ExternalProject, который делает это в build time.
Если нет, бывает библиотеки поддерживают pkg-config
(в этом случает у них должны быть pc
-файлы), для которого у CMake
уже есть модуль FindPkgConfig.cmake
.
Если нет и интеграции с pkg-config
, вот тут уже придётся вручную подключать все необходимые части сбилженой либы через: find_library()
, target_include_directories()
, target_link_libraries()
, ...