Windows/Linux下的动态库制作与使用

Windows/Linux下的静态库制作与使用

1 动态库是什么

静态库，容易使用和理解，也达到了代码复用的目的，那为什么还需要动态库呢？

• 静态库存在空间浪费的问题。
  
• 静态库对程序的更新、部署和发布页会带来麻烦。如果静态库更新了，所有使用它的应用程序都需要重新编译、发布给用户（对于玩家来说，可能是一个很小的改动，却导致整个程序重新下载，全量更新）。

动态库：
在程序编译时并不会被连接到目标代码中，而是在程序运行时才被载入。
不同的应用程序如果调用相同的库，那么在内存里只需要有一份该共享库的实例，规避了空间浪费问题。
动态库在程序运行时才被载入，也解决了静态库对程序的更新、部署和发布页会带来麻烦。用户只需要更新动态库即可，增量更新。

2 动态库特点

• 动态库把对一些库函数的链接载入推迟到程序运行的时期。

• 可以实现进程之间的资源共享。（因此动态库也称为共享库）

• 将一些程序升级变得简单。

• 做到链接载入完全由程序员在程序代码中控制（显示调用）。

3 动态库的制作与使用

Window与Linux执行文件格式不同，在创建动态库的时候有一些差异。

• 在Windows系统下的执行文件格式是PE格式，动态库需要一个DllMain函数做出初始化的入口，通常在导出函数的声明时需要有_declspec(dllexport)关键字。

• Linux下gcc编译的执行文件默认是ELF格式，不需要初始化入口，亦不需要函数做特别的声明，编写比较方便。

与创建静态库不同的是，不需要打包工具（ar、lib.exe），直接使用编译器即可创建动态库。

3.2 动态库的制作与使用

Linux下的动态库制作与使用

3.2.1 创建

1. 编译目标文件

g++ -c -fPIC test.cpp -o test.o

2. 生成动态库

g++ -shared test.o -o libtest.so

可以合并为

g++ -shared -fPIC -o libtest.so test.cpp

• 选项说明

命令选项	作用
shared	创建动态库
fPIC	代码都是与位置无关的

每个共享函数库都有个特殊的名字，称作soname。soname名字命名必须以lib作为前缀，然后是函数库的名字，然后是.so，最后是版本号信息。不过有个特例，就是非常底层的C库函数都不是以lib开头这样命名的。

3.2.2 使用

1. 生成可执行文件

g++ -o main main.cpp -L. -ltest

或者

g++ -o main main.cpp ./libtest.so

注意：库一定要放在命令行的末尾

2. 测试
   指定动态链接库位置

export LD_LIBRARY_PATH=动态链接库位置

3. 执行

./main

4. 结果

Func(100)

关于动态链接库的安装路径

• 如果安装在/lib或者/usr/lib下，那么ld默认能够找到，无需其他操作。
• 如果安装在其他目录，需要将其添加到/etc/ld.so.cache文件中，步骤如下：
  编辑/etc/ld.so.conf文件，加入库文件所在目录的路径 运行ldconfig ，该命令会重建/etc/ld.so.cache文件

当静态库和动态库同名时， gcc命令将优先使用动态库。

• 查看执行文件链接的动态链接库

ldd 可执行文件

也可以查看动态链接库所链接的其它动态库。

3.2.3. 显示调用

3.2.3.1 创建

1. 修改test.h

#ifndef __TEST_H_
#define __TEST_H_

#ifdef __cpluscplus 
extern "C"  //C++
{  
#endif 

void Func(int i);

#ifdef __cpluscplus  
}
#endif 

#endif // __TEST_H_

extern关键字：在一个项目中必须保证函数、变量、枚举等在所有的源文件中保持一致，除非你指定定义为局部的。
extern"C"指令中的C，表示的一种编译和连接规约，而不是一种语言。C表示符合C语言的编译和连接规约的任何语言 。
extern "C"的真实目的是实现类C和C++的混合编程。在C++源文件中的语句前面加上extern "C"，表明它按照类C的编译和连接规约来编译和连接，而不是C++的编译的连接规约。
__cplusplus的值是为了表示C++的版本，目前不应该依赖该宏的值。

2. 修改main.cpp

#include <iostream>
#include <cstdlib>
#include <dlfcn.h>
using namespace std;
int main(){
    void *so_handle = dlopen("./libtest.so", RTLD_LAZY); // 加载.so文件
    if (!so_handle) {
        cerr << "Error: load so failed" << endl;
        exit(-1);
    }
    typedef void func_t(int);
    func_t *pFunc = (func_t *)dlsym(so_handle,"Func");
    char *err = dlerror();
    if (NULL != err) {
        cerr << "load Func err:" << err << endl;
        exit(-1);
    }
    pFunc(100);
    dlclose(so_handle); // 关闭so句柄
    return 0;
}

3. 重新编译.so

g++ -shared -fPIC test.cpp -o libtest.so

3.2.3.2 使用

1. 重新编译main.cpp

g++ -o main main.cpp -ldl

2. 执行

.\main

3. 结果

Func(100)

3.2.4. 补充

使用动态库的方法还有如下几种

• 方法一：连接前，添加动态库目录到环境变量LD_RUN_PATH。

export LD_RUN_PATH=动态库目录

• 方法二：编译链接时，添加链接选项-Wl,-rpath -Wl,动态库目录

• 方法三：执行前，添加动态库目录到环境变量LD_LIBRARY_PATH。

export LD_LIBRARY_PATH=动态库目录

• 方法四：添加共享库目录/usr/local/lib到共享库配置文件

echo 动态库目录 >> /etc/ld.so.conf
ldconfig

Windows下的动态库制作与使用

制作动态库（.dll）

与Linux相比，在Windows系统下创建动态库要稍微麻烦一些。首先，需要一个DllMain函数做出初始化的入口（创建win32控制台程序时，勾选DLL类型会自动生成这个文件）：

dllmain.cpp入口文件

// dllmain.cpp : Defines the entry point for the DLL application.
#include "stdafx.h"
BOOL APIENTRY DllMain( HMODULE hModule,
                       DWORD  ul_reason_for_call,
                       LPVOID lpReserved
                     )
{
    switch (ul_reason_for_call)
    {
    case DLL_PROCESS_ATTACH:
    case DLL_THREAD_ATTACH:
    case DLL_THREAD_DETACH:
    case DLL_PROCESS_DETACH:
        break;
    }
    return TRUE;
}

通常在导出函数的声明时需要有_declspec(dllexport)关键字：

DynamicMath.h头文件
#pragma once
class DynamicMath
{
public:
    __declspec(dllexport) DynamicMath(void);
    __declspec(dllexport) ~DynamicMath(void);
    static __declspec(dllexport) double add(double a, double b);//加法
    static __declspec(dllexport) double sub(double a, double b);//减法
    static __declspec(dllexport) double mul(double a, double b);//乘法
    static __declspec(dllexport) double div(double a, double b);//除法
    __declspec(dllexport) void print();
};

生成动态库需要设置工程属性，打开工程“属性面板”->”配置属性”->”常规”，配置类型选择动态库。

Build项目即可生成动态库。

使用动态库

• 创建win32控制台测试程序：

TestDynamicLibrary.cpp测试程序
#include "stdafx.h"
#include "DynamicMath.h"
#include <iostream>
using namespace std;
int _tmain(int argc, _TCHAR* argv[])
{
    double a = 10;
    double b = 2;
    cout << "a + b = " << DynamicMath::add(a, b) << endl;
    cout << "a - b = " << DynamicMath::sub(a, b) << endl;
    cout << "a * b = " << DynamicMath::mul(a, b) << endl;
    cout << "a / b = " << DynamicMath::div(a, b) << endl;
    DynamicMath dyn;
    dyn.print();
    system("pause");
    return 0;
}

方法一：

• 工程“属性面板”->“通用属性”-> “框架和引用”->”添加引用”，将显示“添加引用”对话框。“项目”选项卡列出了当前解决方案中的各个项目以及可以引用的所有库。 在“项目”选项卡中，选择要用的动态库。 单击“确定”。

• 添加.h 头文件目录，必须修改包含目录路径。打开工程“属性面板”->”配置属性”-> “C/C++”->” 常规”，在“附加包含目录”属性值中，键入.h 头文件所在目录的路径或浏览至该目录。

编译运行OK。

方法二：

• “属性面板”->”配置属性”-> “链接器”->”常规”，附加依赖库目录中输入，动态库所在目录；

• “属性面板”->”配置属性”-> “链接器”->”输入”，附加依赖库中输入动态库编译出来的动态库.lib。

这里可能大家有个疑问，动态库怎么还有一个DynamicLibrary.lib文件？即无论是静态链接库还是动态链接库，最后都有lib文件，那么两者区别是什么呢？其实，两个是完全不一样的东西。

StaticLibrary.lib的大小为190KB，DynamicLibrary.lib的大小为3KB，静态库对应的lib文件叫静态库，动态库对应的lib文件叫【导入库】。
实际上静态库本身就包含了实际执行代码、符号表等等，而对于导入库而言，其实际的执行代码位于动态库中，导入库只包含了地址符号表等，确保程序找到对应函数的一些基本地址信息。

4 动态库与静态库的区别

• 静态库在程序编译时会被连接到目标代码中，程序运行时将不再需要该静态库，因此体积较大。
• 动态库在程序编译时并不会被连接到目标代码中，而是在程序运行是才被载入，因此在程序运行时还需要动态库存在，因此代码体积较小。

4.1 动态加载与静态加载的区别

• 动态加载
  1. 灵活，可以在需要的时候进行加载，在不需要的时候进行卸载，这样可以不必占用内存。
  2. 可以在没有动态库时候发现，而不致程序报错。
  3. 加载程序中有条件才运行的库。
  4. 热更新，在不停止程序的前提下进行更新。
  5. 复杂一些，需要显示获得函数地址。
• 静态加载
  1. 简单方便
  2. 没有找到动态库时，系统报错
  3. 加载运行很久的库

4.2 总结

静态库、共享库与动态库编译链接使用比较

静态库与动态库Make file比较

参考

C++动态库和静态库