c++ - CMake如何使用动态链接库？

Question

我有一个简单的程序如下:

CMakeLists.txt:

cmake_minimum_required(VERSION 3.5)

project(test LANGUAGES CXX)

set(CMAKE_CXX_STANDARD 11)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

LINK_DIRECTORIES(${PROJECT_SOURCE_DIR})

add_executable(test main.cpp)
target_include_directories(test PRIVATE ${PROJECT_SOURCE_DIR})    
target_link_libraries(test PRIVATE power.dll)

主要.cpp:

#include <iostream>
#include "power.h"

using namespace std;

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

电源.h:

#ifndef POWER_H
#define POWER_H

double power(double number) noexcept;

#endif // POWER_H

power.h 的实现在名为 power.dll 的 .dll 中。如果我用 MinGW 7.3.0 X64 编译这个项目说:

error: undefined reference to `power(double)'

如果我用 MSVC 2017 X64 编译它说:

error: LNK1104: cannot open file 'power.lib'

这两个错误都表明 power.dll 无法被链接器检测到。我做了很多搜索，但没有一个解决方案适合我!任何人都可以帮忙吗？提前致谢!

Answer 1

您对动态库的建模在 CMake 和源代码级别都是不正确的。

作为起点，尝试将 dll 构建为与消费可执行文件相同的 CMake 项目的一部分:

cmake_minimum_required(VERSION 3.5)

project(test LANGUAGES CXX)

set(CMAKE_CXX_STANDARD 11)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

include(GenerateExportHeader)
add_library(power SHARED power_sources.cpp power.h)
generate_export_header(power)
target_include_directories(power PUBLIC ${PROJECT_BINARY_DIR} ${PROJECT_SOURCE_DIR})

add_executable(test main.cpp)
target_link_libraries(test PRIVATE power)

注意 generate_export_header 的使用函数，它指示 CMake 以可移植的方式生成用于在共享库接口(interface)上导出函数的宏。由于生成的文件进入二进制目录树，我们必须相应地调整库的包含目录。

为确保函数正确导出，请按如下方式更改 header :

#ifndef POWER_H
#define POWER_H

#include <power_export.h>

POWER_EXPORT double power(double number) noexcept;

#endif // POWER_H

请注意，generare_export_header 允许您广泛自定义生成的导出 header 。

确保您让项目根据此基线构建和运行。

如果你想在外部构建 dll(这不是绝对必要的，但因为这就是你的问题......)，我们必须将 CMake 文件修改为如下内容:

cmake_minimum_required(VERSION 3.5)

project(test LANGUAGES CXX)

set(CMAKE_CXX_STANDARD 11)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

find_package(power)

add_executable(test main.cpp)
target_link_libraries(test PRIVATE power)

所有的魔法都发生在 find_package 调用中。该调用现在负责提供以前由构建库的行处理的所有信息:

• 提供导入的目标 power 供 target_link_libraries 调用使用
• 通过该导入目标关联导入库(power.lib 文件)的库名
• 通过导入的目标向公众公开的目录包括两者 power.h 和power_export.h

您可以在查找脚本中手动构建这样一个导入的目标，也可以让 CMake 为您完成。在第一种情况下，创建一个 FindPower.cmake 脚本文件，确保它的位置是 CMAKE_MODULE_PATH 的一部分，并编写用于查找库和头文件以及构建进口目标在那里。请注意，以可移植的方式做到这一点可能非常棘手，并且远远超出了 StackOverflow 问题的范围。在第二种情况下，让构建 power 库的 CMake 脚本执行安装步骤，在此期间 a config file package将生成，然后可以由您的 test 项目使用。请注意，如果 power 库本身不是使用 CMake 构建的，则此方法不可行，因此在这种情况下，您将不得不坚持使用第一个选项。