C++中的DLL动态链接库，如何编译并使用DLL

目录

如何工作

使用场景

环境设置

Visual Studio中添加头文件的目录:

Visual Studio中添加库文件的目录:

Visual Studio中链接库文件:

Visual Studio中复制DLL到输出目录:

创建DLL项目

编写代码

1. 创建头文件（例如：MathLibrary.h）

2. 创建源文件（例如：MathLibrary.cpp）

编译DLL

使用DLL举例: 调用DLL中名为 add 的函数：

1. 包含DLL的头文件

2. 链接DLL

3. 调用DLL中的函数

---

DLL（动态链接库）是一种在Microsoft Windows操作系统中常用的文件格式，用于实现共享函数库。DLL的内容在程序运行时被加载和链接，而不是在程序编译时。这被称为动态链接，与静态链接库（如静态库 .lib 文件）形成对比。DLL文件包含可以被多个程序同时使用的代码和数据。这种机制有几个重要的特点和好处：

1. 代码重用和内存节省：多个程序可以共享同一个DLL文件中的代码和资源，这比每个程序单独拷贝这些代码更有效率，从而节省内存。

2. 模块化和维护：DLL允许开发人员创建模块化的程序。你可以在DLL中放置一组功能，并且在需要时由多个程序或其他DLL调用。这种分离使得程序更易于管理和更新。

3. 更新和部署的便利：更新DLL不需要重新编译或重新安装使用它的应用程序。只需替换DLL文件，使用它的所有程序就可以自动获得更新。

4. 动态链接：DLL的内容在程序运行时被加载和链接，而不是在程序编译时。这被称为动态链接，与静态链接库（如静态库 .lib 文件）形成对比。

5. 节省磁盘空间：由于代码被共享，DLL有助于减少所需的磁盘空间。

如何工作

• 当一个程序需要在DLL中定义的函数或资源时，操作系统会加载该DLL（如果尚未加载）并提供对其内容的访问。
• 这允许程序使用DLL中的函数和资源，就像它们是程序本身的一部分一样。

使用场景

• 标准库和API：操作系统提供的许多标准功能（如Windows API）都封装在DLL中。
• 第三方库：开发者可以使用第三方提供的DLL来扩展程序的功能，无需从头开始编写复杂的代码。
• 插件和扩展：软件可以设计成使用DLL作为插件或扩展，允许第三方开发者增加额外的功能。

使用C++编写DLL（动态链接库）涉及几个关键步骤。以下是一个简单的示例，展示如何创建一个基本的DLL，它包含一个函数，用于计算两个整数的和。

环境设置

首先，确保开发环境已经设置好。例如，如果使用的是Windows，可能需要安装Visual Studio，这是一个常用的开发环境，用于C++开发和DLL的编译。

这通常涉及添加库文件的路径到链接器的配置中：

1. Visual Studio中添加头文件的目录:

   • 打开项目属性。
   • 转到“配置属性” -> “C/C++” -> “常规”。
   • 在“附加包含目录”中添加头文件所在的目录。

2. Visual Studio中添加库文件的目录:

   • 在项目属性中。
   • 转到“配置属性” -> “链接器” -> “常规”。
   • 在“附加库目录”中添加库文件（.lib）所在的目录。

3. Visual Studio中链接库文件:

   • 在项目属性中。
   • 转到“配置属性” -> “链接器” -> “输入”。
   • 在“附加依赖项”中添加库文件的名称（例如 YourLibrary.lib）。

4. Visual Studio中复制DLL到输出目录:

   • 将DLL文件手动复制到输出目录（通常是项目的 Debug 或 Release 文件夹），或者设置一个构建事件来自动执行此操作。

创建DLL项目

在Visual Studio中，可以按照以下步骤创建一个新的DLL项目：

1. 打开Visual Studio。
2. 选择“创建新项目”。
3. 在搜索栏中输入“DLL”，然后选择“动态链接库（DLL）”项目模板。
4. 命名项目并选择一个位置，然后点击“创建”。

编写代码

在项目中，将需要编写至少两个文件：一个头文件（.h）和一个源文件（.cpp）。

1. 创建头文件（例如：MathLibrary.h）

#pragma once

#ifdef MATHLIBRARY_EXPORTS
#define MATHLIBRARY_API __declspec(dllexport)
#else
#define MATHLIBRARY_API __declspec(dllimport)
#endif

extern "C" MATHLIBRARY_API int add(int a, int b);

在这个头文件中，__declspec(dllexport)和__declspec(dllimport)是特殊的宏，用于指定哪些函数是从DLL导出的，哪些是导入的。

2. 创建源文件（例如：MathLibrary.cpp）

#include "MathLibrary.h"

extern "C" MATHLIBRARY_API int add(int a, int b) {
    return a + b;
}

这个源文件包含了函数add的实现。

编译DLL

在Visual Studio中，编译项目以生成DLL文件。

1. 在Visual Studio的菜单栏中，选择“生成” -> “生成解决方案”（或使用快捷键F7）。
2. 检查“输出”窗口，确保没有编译错误。

完成这些步骤后，DLL文件将在项目的输出目录（通常是“Debug”或“Release”文件夹）中生成。

使用DLL举例: 调用DLL中名为 add 的函数：

1. 1. 包含DLL的头文件

   首先，需要包含定义了 add 函数的头文件。这个头文件应该在创建DLL时一并提供。声明 add 函数，使你能在你的代码中引用它。

   #include "MathLibrary.h"  // 假设 add 函数在此头文件中声明
   

   2. 链接DLL

   确保你的应用程序在编译时链接到DLL。这通常通过在项目设置中添加DLL的.lib文件（即导入库）来实现，或者直接在源代码中使用特定的编译器指令。

   对于静态链接（在编译时链接）：

   #pragma comment(lib, "MathLibraryDll.lib")  // 指定.lib文件
   

   对于动态链接（在运行时链接），将使用Windows API来加载DLL，并获取函数地址。

   3. 调用DLL中的函数

   一旦包含了头文件并设置了链接，就可以像调用任何其他函数一样调用 add 函数。

   int main() {
       int a = 5;
       int b = 10;
       int sum = add(a, b);  // 调用DLL中的add函数
       std::cout << "Sum: " << sum << std::endl;
       return 0;
   }
   

   如果选择在运行时动态加载DLL，需要使用 LoadLibrary 和 GetProcAddress 函数：

   #include 
   #include 
   
   typedef int (*ADD_FUNC)(int, int);  // 定义函数指针类型
   
   int main() {
       HMODULE hDll = LoadLibrary(L"MathLibraryDll.dll");  // 加载DLL
       if (hDll == NULL) {
           std::cerr << "Failed to load DLL!" << std::endl;
           return -1;
       }
   
       // 获取函数指针
       ADD_FUNC add = (ADD_FUNC)GetProcAddress(hDll, "add");
       if (add == NULL) {
           std::cerr << "Failed to get the function!" << std::endl;
           FreeLibrary(hDll);
           return -1;
       }
   
       // 调用函数
       int result = add(5, 10);
       std::cout << "Result: " << result << std::endl;
   
       // 卸载DLL
       FreeLibrary(hDll);
       return 0;
   }