Question

我有一个用C ++编写的项目，我正在使用cmake来构建它。该项目有许多子项目，其中一个是其他子项目所需的库。我可以使用编译并将.so移动到构建目录 add_library，和 INSTALL（TARGETS ...）

但是我还需要将lib的头文件安装在build dir的include目录下。我使用install（FILES ...）来做它，但它似乎根本就没有做。

为了演示它，我通过qtcreator创建了一个测试项目，

& ls test
CMakeLists.txt empty.hh main.cpp

$ cat test/CMakeLists.txt
project(test)
cmake_minimum_required(VERSION 2.8)
install(FILES empty.hh DESTINATION include)
aux_source_directory(. SRC_LIST)
add_executable(${PROJECT_NAME} ${SRC_LIST})

$ cat test/main.cpp
#include

using namespace std;

int main()
{
cout << "Hello World!" << endl;
return 0;
}

$ cat test/empty.hh
#ifndef EMPTY_HH
#define EMPTY_HH

#endif // EMPTY_HH

If the files under "test" qtcreator will compile (by default) the files to test-build.
$ ls test-build/
CMakeCache.txt CMakeFiles Makefile cmake_install.cmake test test.cbp
$ ./test-build/test
Hello World!

如您所见，没有包含目录或empty.hh文件。也尝试使用

install(FILES empty.hh DESTINATION ${CMAKE_CURRENT_BINARY_DIR})

但仍然看不到头文件。

$ cmake --help
cmake version 2.8.12

如果您有任何想法，请告诉我。

Answer 1

使用install命令在构建时移动文件通常是一种糟糕的方法。该命令用于设置将在用户执行make install或等效时安装的文件和目标。由于您未运行make install，我预计install(FILES ...)命令似乎不起作用的原因。

这里有一些稍微不同的方法来完成这项工作。

如果您不必，我建议不移动标题。假设您的库名为MyLib，那么您可以通过target_include_directories将这些标题作为MyLib目标的一部分提供：

target_include_directories(MyLib PUBLIC "${CMAKE_CURRENT_SOURCE_DIR}")

这意味着是否存在依赖目标，例如MyExe：

target_link_libraries(MyExe MyLib)

然后它会自动访问MyLib的源目录。

如果库的目录结构不适合将API标头与其他源和标头分开，则这可能不太理想。假设MyLib由以下文件组成：my_lib.cpp，my_lib_api.hh（API标头 - 包含在其他项目中）和my_lib_detail.hh（不包含在其他项目中）。理想的结构会使API标题与其他标题分开，例如

/my_lib
   - CMakeLists.txt
   - src/
       - my_lib.cpp
       - my_lib_detail.hh
   - include/
       - my_lib/
            - my_lib_api.hh

使用此结构，您只需指定

即可

target_include_directories(MyLib PUBLIC  "${CMAKE_CURRENT_SOURCE_DIR}/include"
                                 PRIVATE "${CMAKE_CURRENT_SOURCE_DIR}/src")

和MyLib来源将能够包含#include "my_lib_detail.hh"和#include "my_lib/my_lib_api.hh"，但是依赖目标＆＃39;来源只能包含#include "my_lib/my_lib_api.hh"。

因此，如果MyLib只有一个扁平结构，或者没有将内部标题与API标题分开，您可能需要将API标题复制到构建树中的某个位置并添加 < / em> target_include_directories来电的路径。在这种情况下，如果MyLib本身不需要访问复制的文件（只是源树中的原始文件），则可以在INTERFACE中使用PUBLIC而不是target_include_directories {1}}致电。

然而，这个问题的关键（并且回答我想到的实际问题）是将这些文件作为配置过程的一部分（当CMake运行时）或构建过程（当make运行时）复制 - 而不是作为安装过程。

所以，我们假设MyLib 没有具有上面显示的有用目录结构，而是平坦的（即CMakeLists.txt和三个源文件是所有在同一个目录）。我们可以使用post-build命令将API标头复制到构建树：

project(my_lib) cmake_minimum_required(VERSION 2.8.12.2) # for 'target_include_directories' add_library(MyLib SHARED my_lib.cpp my_lib_api.hh my_lib_detail.hh) target_include_directories(MyLib INTERFACE "${CMAKE_BINARY_DIR}/include" PRIVATE "${CMAKE_CURRENT_SOURCE_DIR}") file(MAKE_DIRECTORY "${CMAKE_BINARY_DIR}/include/my_lib") add_custom_command(TARGET MyLib POST_BUILD COMMAND ${CMAKE_COMMAND} -E copy_if_different "${CMAKE_CURRENT_SOURCE_DIR}/my_lib_api.hh" "${CMAKE_BINARY_DIR}/include/my_lib" COMMENT "Copying MyLib public headers to ${CMAKE_BINARY_DIR}/include/my_lib" VERBATIM)

然后对于MyExe的CMakeLists.txt，您可以这样做：

project(my_exe) cmake_minimum_required(VERSION 2.8.12.2) add_executable(MyExe main.cpp) target_link_libraries(MyExe MyLib) # Copy MyLib.so to this build dir to allow MyExe to find it at runtime add_custom_command(TARGET MyExe POST_BUILD COMMAND ${CMAKE_COMMAND} -E copy_if_different "$<TARGET_FILE:MyLib>" "$<TARGET_FILE_DIR:MyExe>" VERBATIM)

这对于MSVC来说不会起作用 - 您需要处理Windows导出库（有关详细信息，请参阅CMake wiki和GenerateExportHeader的文档），但是它只会涉及到将以下内容添加到MyLib的CMakeLists.txt：

include(GenerateExportHeader) generate_export_header(MyLib BASE_NAME MyLib EXPORT_MACRO_NAME MyLib_EXPORT EXPORT_FILE_NAME "${CMAKE_BINARY_DIR}/include/my_lib/my_lib_export.hh" STATIC_DEFINE MyLib_BUILT_AS_STATIC)

如果确实需要，您必须在INTERFACE中将PUBLIC更改为target_include_directories(MyLib ...)，因为MyLib本身需要访问生成的文件"${CMAKE_BINARY_DIR}/include/my_lib/my_lib_export.hh"。

cmake install（FILES ...）似乎无法正常工作

1 个答案: