我试图得到一个跨平台的构建系统工作使用CMake。现在软件有了一些依赖项。我自己编译并安装在我的系统上。
一些已经安装的文件示例:
-- Installing: /usr/local/share/SomeLib/SomeDir/somefile
-- Installing: /usr/local/share/SomeLib/SomeDir/someotherfile
-- Installing: /usr/local/lib/SomeLib/somesharedlibrary
-- Installing: /usr/local/lib/SomeLib/cmake/FindSomeLib.cmake
-- Installing: /usr/local/lib/SomeLib/cmake/HelperFile.cmake
现在CMake有一个find_package(),它打开一个Find*。在系统中搜索库,并定义一些变量,如SomeLib_FOUND等。
我的CMakeLists.txt包含如下内容:
set(CMAKE_MODULE_PATH "/usr/local/lib/SomeLib/cmake/;${CMAKE_MODULE_PATH}")
find_package(SomeLib REQUIRED)
第一个命令定义了Find*之后CMake搜索的位置。cmake和我添加了FindSomeLib的SomeLib目录。可以找到Cmake,因此find_package()工作
像预期的那样。
但这有点奇怪,因为find_package()存在的原因之一是为了避免使用非跨平台的硬编码路径。
这通常是如何做到的?我是否应该将SomeLib的cmake/目录复制到我的项目中,并相对地设置CMAKE_MODULE_PATH ?
find_package命令有两种模式:Module模式和Config模式。你在试图
当你需要Config模式时,使用Module模式。
模块模式
找到<包>。Cmake文件位于您的项目。就像这样:
CMakeLists.txt
cmake/FindFoo.cmake
cmake/FindBoo.cmake
CMakeLists.txt内容:
list(APPEND CMAKE_MODULE_PATH "${CMAKE_CURRENT_LIST_DIR}/cmake")
find_package(Foo REQUIRED) # FOO_INCLUDE_DIR, FOO_LIBRARIES
find_package(Boo REQUIRED) # BOO_INCLUDE_DIR, BOO_LIBRARIES
include_directories("${FOO_INCLUDE_DIR}")
include_directories("${BOO_INCLUDE_DIR}")
add_executable(Bar Bar.hpp Bar.cpp)
target_link_libraries(Bar ${FOO_LIBRARIES} ${BOO_LIBRARIES})
注意,CMAKE_MODULE_PATH具有高优先级,在需要重写标准Find<package>时可能有用。cmake文件。
配置模式(安装)
<包>配置。Cmake文件位于外部,由install生成
其他项目的命令(例如Foo)。
foo库:
> cat CMakeLists.txt
cmake_minimum_required(VERSION 2.8)
project(Foo)
add_library(foo Foo.hpp Foo.cpp)
install(FILES Foo.hpp DESTINATION include)
install(TARGETS foo DESTINATION lib)
install(FILES FooConfig.cmake DESTINATION lib/cmake/Foo)
配置文件的简化版本:
> cat FooConfig.cmake
add_library(foo STATIC IMPORTED)
find_library(FOO_LIBRARY_PATH foo HINTS "${CMAKE_CURRENT_LIST_DIR}/../../")
set_target_properties(foo PROPERTIES IMPORTED_LOCATION "${FOO_LIBRARY_PATH}")
默认项目安装在CMAKE_INSTALL_PREFIX目录下:
> cmake -H. -B_builds
> cmake --build _builds --target install
-- Install configuration: ""
-- Installing: /usr/local/include/Foo.hpp
-- Installing: /usr/local/lib/libfoo.a
-- Installing: /usr/local/lib/cmake/Foo/FooConfig.cmake
配置模式(使用)
使用find_package(…包括FooConfig。导入目标foo的Cmake:
> cat CMakeLists.txt
cmake_minimum_required(VERSION 2.8)
project(Boo)
# import library target `foo`
find_package(Foo CONFIG REQUIRED)
add_executable(boo Boo.cpp Boo.hpp)
target_link_libraries(boo foo)
> cmake -H. -B_builds -DCMAKE_VERBOSE_MAKEFILE=ON
> cmake --build _builds
Linking CXX executable Boo
/usr/bin/c++ ... -o Boo /usr/local/lib/libfoo.a
注意,导入的目标是高度可配置的。请看我的回答。
更新
例子
如果您正在运行cmake来自己生成SomeLib(比如作为超级构建的一部分),请考虑使用用户包注册表。这不需要硬编码路径,并且是跨平台的。在Windows(包括mingw64)上,它通过注册表工作。如果您检查如何通过find_packages()命令的CONFIG模式构造安装前缀列表,您将看到User Package Registry是元素之一。
简短的指南
通过将它们添加到创建它们的CMakeLists.txt文件中的导出集,将你在外部项目之外需要的SomeLib的目标关联起来:
add_library(thingInSomeLib ...)
install(TARGETS thingInSomeLib Export SomeLib-export DESTINATION lib)
创建XXXConfig。在${CMAKE_CURRENT_BUILD_DIR}中为SomeLib添加cmake文件,并通过添加两个调用export()到与SomeLib相关的CMakeLists.txt,将该位置存储在用户包注册表中:
export(EXPORT SomeLib-export NAMESPACE SomeLib:: FILE SomeLibConfig.cmake) # Create SomeLibConfig.cmake
export(PACKAGE SomeLib) # Store location of SomeLibConfig.cmake
在依赖于SomeLib的项目的CMakeLists.txt文件中发出find_package(SomeLib REQUIRED)命令,而不需要对CMAKE_MODULE_PATH进行“非跨平台硬编码路径”的修改。
当这可能是正确的方法时
这种方法可能最适合于您永远不会使用build目录下的软件的情况(例如,您正在交叉编译,并且从未在您的机器上安装任何东西,或者您构建软件只是为了在build目录中运行测试),因为它在“build”输出中创建了到.cmake文件的链接,这可能是临时的。
但是,如果您从未在工作流中实际安装SomeLib,则调用EXPORT(PACKAGE <name>)可以避免硬编码路径。当然,如果您正在安装SomeLib,您可能知道您的平台、CMAKE_MODULE_PATH等,因此@user2288008的出色回答将满足您的要求。