【给女朋友讲C++】C++的动态链接库

1 什么是动态链接库

C++的动态链接库（DLL）是运行时加载的可执行代码库，允许多个程序共享相同的代码，而静态库（LIB）在编译期间被直接包含到每个可执行文件中。

动态链接库的：

• 优点：
  • 共享内存：多个程序可共享相同的库，节省内存空间。
  • 更新方便：更新库文件后，所有依赖该库的程序无须重新编译即可使用新版本。
• 缺点：
  • 运行时依赖：程序在运行时需要找到相应的DLL，可能导致“缺少DLL”错误。
  • 性能开销：动态链接引入的开销可能导致稍微降低性能。

点对而言静态库的：

• 优点：
  • 自包含：编译后每个程序包含库的完整副本，运行时不依赖其他文件。
  • 性能优越：加载速度快，无运行时链接开销。
• 缺点：
  • 占用空间：每个可执行文件都包含库的副本，可能导致磁盘和内存浪费。
  • 更新困难：更新库需要重新编译依赖该库的所有程序。

2 如何创建动态链接库

假设动态链接库的源码如下：

// hello_dll.cpp
#include <iostream>  

extern "C" void fun() {  
    std::cout << "hello dll" << std::endl;  
}

2.1 命令行方式（linux）

这种方式比较适合小项目

g++ -shared -fPIC -o libhello_dll.so hello_dll.cpp

-shared：指示编译器生成动态链接库。
-fPIC：生成位置无关的代码，这是创建共享库的必要选项。
-o libhello_dll.so：指定输出文件名为 libhello_dll.so（约定在 Linux 上以 lib 开头）。

• -fPIC 是使用 GNU 编译器 (g++) 编译源代码时的一个选项，其全称为 “Position Independent Code”（位置无关代码）。这个选项主要用于在创建共享库（动态链接库）时，确保产生的代码可以在内存中的任何位置运行。
• 默认情况下，编译生成的代码可能包含绝对地址（如直接引用内存地址），这意味着它只能在特定的内存地址空间中运行。使用 -fPIC 可以让编译器生成一种不依赖于特定地址的代码，这样它就可以在加载时被放置在内存的任何位置。
• 位置无关代码通过使用相对地址，或者在运行时计算地址来访问数据和代码，这样没有必要在编译时确定最终的内存地址。正式因为这样，所以会使得某些代码的执行稍慢，然而，这种性能成本通常是可以接受的，在现代系统中已被优化到了最小。

2.2 cmake方式

这种方式比较适合大项目，向我们实际工作中，动不动源文件就100多个。如果直接使用命令行方式编译动态库，就太麻烦了，而且容易出错。使用cmake，不仅解决上上面问题，而且还支持跨平台。

// CMakeLists.txt

cmake_minimum_required(VERSION 3.0)  
project(HelloDLL)  
add_library(hello_dll SHARED hello_dll.cpp)  

然后执行cmake命令生成动态链接库

mkdir build  
cd build  
cmake ..
cmake --build .

3 使用动态链接库

要在C++程序中调用.so共享库，我们需要使用动态链接技术。Linux提供了dlopen和dlsym等函数来实现这一功能。

3.1 方式1

// main.cpp

#include <iostream>
#include <dlfcn.h>

int main() {
    void* handle = dlopen("./libhello_dll.so", RTLD_LAZY);
    if (!handle) {
        std::cerr << "Cannot open library: " << dlerror() << '\n';
        return -1;
    }

    // 清除之前存在的任何错误
    dlerror();

    // 加载符号
    typedef void (*funType)();
    funType fun = (funType) dlsym(handle, "fun");    // 如果上面库源码中不用extern "C"，这里dlsym中符号名就不是fun，会更加复杂一些。不过我们一般也不会这么使用动态库中的方法，下面是简单方式
    const char* dlsym_error = dlerror();
    if (dlsym_error) {
        std::cerr << "Cannot load symbol 'hello': " << dlsym_error << '\n';
        dlclose(handle);
        return 1;
    }

    // 使用函数
    fun();

    // 关闭库
    dlclose(handle);
    return 0;
}

3.2 方式2

// main.cpp

#include <iostream>  

extern "C" void fun();

int main() {  
    fun();  
    return 0;  
}

3.3 方式3

在实际工作中，一般会把声明和定义分开，声明在头文件，定义在源文件中。我们为上面的动态库增加一个头文件

// hello_dll.h
#pragma once
void fun()

// hello_dll.cpp
#include <iostream>  

void fun() {  
    std::cout << "hello dll" << std::endl;  
}

// main.cpp
#include "hello_dll.h"

int main() {
	fun();
	return 0;
}

4 编译链接动态库

4.1 命令行方式

g++ -o main main.cpp -I/path/to/include -L/path/to/lib -lhello_dll
# 如果头文件和库文件都在当前路径下
g++ -o main main.cpp -I. -L. -lhello_dll
# 如果想指定多个搜索路径
g++ -o main main.cpp -I. -I/path/to/include2 -L/path/to/lib2 -L. -lhello_dll

• -L 选项: 指定动态库的搜索路径
• -I 选项：指定头文件的搜索路径
• 如果动态库名字为libhello_dll.so，只需要写-lhello_dll，g++会自动前后加上lib和.so

4.2 cmake方式

cmake_minimum_required(VERSION 3.0)  
project(HelloDLL)  
include_directories(".")  
link_directories(".")  

add_executable(main main.cpp)  
target_link_libraries(main hello_dll)  

然后执行cmake命令生成动态链接库

mkdir build  
cd build  
cmake ..
cmake --build .

5 参考

C++中如何调用.so共享库？