关于Qt编译库（1）：在子项目中编译动态库并且使用

本文演示了将一个自己编写的类（SalesData）编译为动态库或者静态库，并且新建的项目中使用该库。
对于小白用户，自己查了网上一些资料，进行了摸索，并将过程记录下来，供他人参考。

1、本文主要说明了linux下的使用，windows亦可参考。
2、注意本文中使用的是子项目。普通项目的使用方法与本文相同。
项目名字为sub，包含两个子项目，window为app，datafile为lib。在window中要使用生成的lib库文件。

1.编译为库

1.1利用Qt库模板

在Qt Creator中新建子项目，在其他项目——子目录项目。

添加子项目，项目名字为window。这个是我们的界面的项目。
添加子项目，选择Library——C++库
选择共享库。如果生成静态库，则选择静态链接库。

后续需要输入类名，例如类名为SalesData，这个是《C++ primer》这本书中经常使用的类。。。一直点下一步，最后会生成一个cpp和h文件。
在cpp文件和h文件中进行编写，完毕后点击“构建”按钮，会生成库文件。

1.2 自己修改pro文件生成

上述这种方法，是生成cpp和h文件，然后在里边修改。如果我们已经有了库源文件，可以把之前默认生成的cpp和h删掉，把我们自己的库文件添加进去。当然有些繁琐，实际上我们可以自己动手来配置库项目。
我们选择建立一个空的项目。选择Empty qmake Project。

输入子项目的名字datafile。会产生一个名为datafile的文件夹以及一个同名的pro文件。
一直点下一步，最后会出来一个提示，说打开项目失败。本来到目前为止项目就是空的，不必理会。

1、建立一个空的Empty qmake Project。名字为datafile，生成一个项目文件夹以及项目pro文件。会在我们的sub.pro中自动在SUBDIRS中加上内容。

注意linux上边似乎SUBDIRS中的顺序有要求。所以最好先写库项目，再写app项目。
或者加上如下：

window.depends = datafile

2、加入已有的cpp和h文件。pro文件会自动增加SOURCES和HEADERS内容。
3、在pro文件中加入我们自己的东西。重要的是TEMPLATE设置。

在pro文件中将TEMPLATE = app改为lib。表明我们这个是生成库的项目。
使用lib模板时，可以将以下选项添加到CONFIG变量中，以确定所构建的库的类型。
dll： 该库是一个共享库（dll）。
staticlib或者static： 该库是一个静态库。
plugin： 该库是一个插件。
我试了一下，如果没不设置CONFIG中的库类型时，自动生成的为动态库。

4、其他设置。我们修改DESTDIR，就是设置生成的文件的位置，表明我们生成到lib这个目录下。另外还可以修改库文件名字等。

5、添加库的头文件和源文件。

点击构建，即可生成库文件。

1.3 生成结果

以下是对生成生成文件后缀名的说明。这只是泛泛而谈，实际发现跟编译器有关。比如我在windows系统上用MinGW，可能静态库还是a后缀。

在windowd+MinGW编译
这个SalesData.dll就是生成的动态链接库。

在linux下生成结果
以so结尾的就是动态链接库。生成了一个动态链接库文件和3个软链接。（不知为什么会这样，但我试过把软连接删掉后是找不到库文件的。）

2.使用库

2.1 如何使用库

调用动态库必要条件：定义动态库的头文件 和 动态库文件

我们以linux系统为例说明。

在另一个子项目window中，调用第一节中我们生成的动态库。

1、指定库文件路径和库文件名字。

注意大写的-L后接库所在的路径，小写的-l后接库名，库名不需加lib前缀和so后缀。

设置LIBS其实说穿了很简单，然后告诉工程，你的库文件放到哪里了，叫什么名字。

2、设置库头文件搜索路径。如上图的INCLUDEPATH。就是说头文件在什么地方。就会到这个地方搜索头文件。当然也可以不设该变量，而在用到的文件中用#include包含所在路径以及头文件名字，但是路径太长时，#include这句话就会很长。

3、在使用该库的文件中用#include包含头文件，由于上边已经设置过了INCLUDEPATH变量，所以直接写头文件名字就能搜索到。

#include "salesdata.h"

2.2 库文件修改

如果静态库和动态库进行了修改，库都会重新编译。但使用上有所不同。

对于动态库，使用库的代码生成程序后，能够正确链接到修改之后的库。

对于静态库，由于使用库的代码没有变化，所以使用库的代码不会重新编译，因此该代码生成的程序中仍然包含的是修改之前的静态库。要使用修改之后的静态库，就必须让使用静态库的代码重新编译。例如在使用库的代码中随便插入一个空白行等。

3.在运行目录下运行

在生成的运行目录下，执行./window可执行程序，会提示错误，找不到库文件。

因为linux会默认在几个路径中搜索库文件，动态库的搜索路径搜索的先后顺序是：

1.编译目标代码时指定的动态库搜索路径；通过gcc 的参数”-Wl,-rpath,”指定；
2.环境变量LD_LIBRARY_PATH指定的动态库搜索路径；
3.配置文件/etc/ld.so.conf中指定的动态库搜索路径；
4.默认的动态库搜索路径/lib；
5.默认的动态库搜索路径/usr/lib。

我们使用方法2，如下：
1、我们将datafile下的lib文件夹拷贝到此处，然后执行如下，就是将该目录添加到环境变量中。然后再执行./window就可以执行了。注意每次开机都需要执行该export命令。

export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:./lib/

2、为了以后使用方便，可以编写脚本，以后执行该脚本，就不用每次开机都执行export了。

#!/bin/bash
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:./lib/
./window

4.注意事项

4.1 子项目时的编译顺序

在linux上，似乎会按照SUBDIRS指定的顺序编译，可能编译window项目时，datafile库还没有生成所以会报错。所以最好把库项目放在前边，或者加上如下：

window.depends = datafile

但是在windows系统+minGW编译时，顺序打乱时也能正常编译。

4.2 关于install操作

在编译或者运行时，可以指定make install用来安装文件。
但是注意如果用本文1.1章节中的动态库模板，会生成如下指令：

unix {target.path = /usr/libINSTALLS += target
}

企图把生成的库文件拷到/usr/lib/目录下。但是这是需要权限的，所以在install时总是会出现拷贝时没有权限错误。

本来我是用install安装其他东西，结果总是提示拷贝lib没有权限，我寻思我也没考到/usr/lib目录啊，找了好久才发现是使用动态库模板自动加上类的这几行。所以删掉之后就正常了。
但是如何设置才能修改权限？尚不清楚。

另外我们也可以利用install来自动把datafile/lib库文件拷到可执行程序所在的目录，便于打包发布等。

4.3 异常

使用我在qmake中将目录保存为变量，后来修改了目录结构，但是变量没有对应修改，后来编译的时候没有错误，但是运行的时候程序直接退出了。这个地方要注意一下。