Qt编译静态链接库和动态链接库（Windows&Linux）

最近需要在Linux中编译相关程序动态库，对相关经验总结。

使用到的工具为Qt5.13.2

QT编译

[1. WINDOWS](#1. WINDOWS)
- [1.1 静态库制作](#1.1 静态库制作)
- [1.2 静态库的使用](#1.2 静态库的使用)
- [1.3 动态库制作](#1.3 动态库制作)
- [1.4 动态库使用](#1.4 动态库使用)
[2. LINUX](#2. LINUX)
- [2.1 静态链接库](#2.1 静态链接库)
- 2.2动态库
附录
- [gcc 编译程序查找顺序：](#gcc 编译程序查找顺序：)
- [Linux 程序运行时查找顺序：](#Linux 程序运行时查找顺序：)

1. WINDOWS

1.1 静态库制作

Windows下编译成的静态库为XXX.lib文件，而不会生成可执行文件

1.1.1 创建文件时选择模板为Library(库)，选择C++ Library。选择相应的项目路径。

1.1.2在定义工程详情界面选择类型为Statically Linked Library(静态库),选择相应用到的Qt模块。

1.1.3选择相应的编译器并完成工程创建

1.1.4在创建的工程中完成类的创建

1.2 静态库的使用

1.2.1新建Qt Widgets Application工程

1.2.2在.pro所在文件夹中创建include文件夹，将静态库生成时生成的debug版本(StaticLibd.lib)和release版本(StaticLib.lib)以及头文件(staticlib.h)复制进来

1.2.3右键项目，选择添加库，

1.2.4选择外部库

1.2.5选择库文件为include文件夹下的release版本，包含路径自动填成include

1.2.6至此静态库配置完成，在需要使用的地方包含相应头文件，实例化相关对象，通过对象使用相关函数。

1.3 动态库制作

1.3.1动态库选择创建工程时选择类型为共享库(Shard Library)

1.3.2工程创建后，头文件处自动生成XXX_global文件定义如下，其中define TESTDLL_EXPORT Q_DECL_EXPORT为导出dll的宏定义

复制代码

#ifndef TESTDLL_GLOBAL_H
#define TESTDLL_GLOBAL_H

#include <QtCore/qglobal.h>

#if defined(TESTDLL_LIBRARY)
#  define TESTDLL_EXPORT Q_DECL_EXPORT
#else
#  define TESTDLL_EXPORT Q_DECL_IMPORT
#endif

#endif // TESTDLL_GLOBAL_H

1.3.3在testdll.h中 class TESTDLL_EXPORT TestDll声明了导出类

复制代码

class TESTDLL_EXPORT TestDll
{
public:
    TestDll();
};

1.3.4编写相关类，编译运行生成相应dll文件。主要用到的是dll和lib文件。

1.4 动态库使用

1.4.1新建Qt Widgets Application工程，在.pro文件所在文件夹中创建include和lib文件夹，将生成的.h文件放入include文件夹中，生成的lib和dll文件放入lib文件夹中

1.4.2在.pro文件中添加以下代码

复制代码

INCLUDEPATH += : 头文件(包含)目录。

LIBS += :-L用来指定引入的lib文件的路径， -l 用于指定需要链接库的名称

1.4.3 在工程中包含相应头文件，实例化相关对象，并使用相关函数。

2. LINUX

2.1 静态链接库

2.1.1静态库创建

使用和Windows类似只不过生成文件为libXXX.a

2.1.2 静态库使用

在新建Qt Widgets Application工程后添加库，这里界面和Windows有所区别，类型默认为Linux。选择相应的libXXX.a文件，完成库的添加。

最后生成的工程文件夹如下，其中StaticLIbUser为运行文件，Linux系统无法直接双击运行，需要打开终端，通过命令行执行程序。

2.2动态库

2.2.1动态库创建

创建过程与Windows类似，使用过程有所区别。创建的生成文件如下

生成的libmyDll.so.1.0.0为Linux下的动态库。

2.2.2动态库使用

新建Qt Widgets Application工程，同Windows类似，新建include和lib文件夹，在.pro文件添加如下

复制代码

INCLUDEPATH += $$PWD/include/

LIBS += -L $$PWD/lib -l $$PWD/lib/libmyDll.so.1.0.0

在QtCreator中可以正常运行

但在终端使用命令行出现问题

复制代码

./DllUser: error while loading shared libraries: libmyDll.so.1: cannot open shared object file: No such file or directory

原因是在运行时找不到相应的链接库，所以需要把libmyDll.so.1添加到Linux系统运行环境/lib中去。

即可正常运行

附录

gcc 编译程序查找顺序：

gcc 编译时参数-L指定的路径
环境变量 LIBRARY_PATH
系统默认库位置 /lib /usr/lib

Linux 程序运行时查找顺序：

gcc 编译时指定的运行时库路径 -Wl,-rpath
环境变量 LD_LIBRARY_PATH
ldconfig 缓存 /etc/ld.so.cache

在终端中执行如下命令后可以正常运行程序。相当于Windows中给终端添加相应的环境变量

复制代码

export LD_LIBRARY_PATH=/XXX/lib:$LD_LIBRARY_PATH

也可以写入启动脚本，每次启动终端都会加载路径。

复制代码

vi ~/.bashrc
#在文件最后添加如下内容
export LD_LIBRARY_PATH=/root/lib:$LD_LIBRARY_PATH

开发动态库.pro文件中

复制代码

TARGET = testDll    // 生成动态库的名字
CONFIG += plugin // 避免出现后面的版本号libtestDll.so.1.0.0