Linux下Qt创建共享库与链接共享库详解

随着程序写的逐渐变多，或多或少的我们都会使用别人写好的库；或者我们不想让别人看到我们的一些核心程序，可以将核心程序封装成库。本次和大家分享的是在Ubuntu下使用Qt生成共享库以及在Qt中链接共享库的方法。

共享库是在Linux下的称呼，在Windows下被称为动态库。这块大家需要了解的是程序在编译时使用的库和程序在运行时使用的库需要一致，不然程序可能会闪退。而且运行时库的路径如果没有设置，那么系统就会在默认的路径下进行搜索，如果没找到程序直接就挂了。之后的文章会进行总结说明的。

程序平台：Ubuntu14.04、 Qt5.5.1

一、Qt 创建共享库

1. 创建类型为库的Qt工程

① 新建工程-> Library -> C++ 库：

②类型选择默认的共享库，填写名称并选择工程路径。简单说下库的类型分别是动态库、静态库和Qt的插件

③选择默认的套件即可

④选择所需模块，这里我没有勾选任何模块

⑤设置类的基本信息

⑥完成向导

2. 工程文件

①工程创建完成后，删掉了Qt生成的一些文件，文件目录如下

② .pro 文件的修改，添加版本号的设置等

QT       -= core gui

TARGET = TestLib
TEMPLATE = lib

VERSION += 1.1.0

CONFIG += debug_and_release
CONFIG(debug, debug|release) {
    unix: TARGET = $$join(TARGET,,,_debug)
    else: TARGET = $$join(TARGET,,,d)
}

DEFINES += TESTLIB_LIBRARY

SOURCES += addlib.cpp

HEADERS += addlib.h

unix {
    target.path = /usr/lib
    INSTALLS += target
}

TARGET ：库的名称

TEMPLATE ：模板类型，类型为lib ，即生成的是一个库文件

VERSION(新增部分) ：库的版本号设置

CONFIG (新增部分) ：控制编译的Debug与Release库的版本名称

1. 生成共享库

该共享库实现了计算两个整型数和的功能，过于简单，莫要介意~

① .h文件内容

#ifndef ADDLIB_H
#define ADDLIB_H

class AddLib
{

public:
    AddLib();

    int myAdd(int x, int y);
};

② .cpp内容

#include "addlib.h"

AddLib::AddLib()
{
}

int AddLib::myAdd(int x, int y)
{
    return x + y;
}

③构建与运行

只构建的话就会直接生成共享库，如果运行的话就是下面这个样子。

④生成动态库效果

到这里我们就已经生成好了动态库，可以看下我们添加的动态库的版本号。

注意，我这里没有区分Debug与Release版本。

二、链接动态库

1. 创建工程添加文件

创建一个继承QWidget的应用程序后，在与.pro文件同级目录下添加一个如下目录组织的文件：

main.cpp

***.pro

Lib/

test/

linux_x32/

Include/

addlib.h

lib/

libTestLib.so**

2. 借助Qt添加库

①右键项目->添加库

②选择链接库的类型，选择【外部库】

③选择链接库的路径与平台等信息

④ .pro中新增文件

unix:!macx: LIBS += -L$$PWD/Lib/test/linux_x32/lib/ -lTestLib

INCLUDEPATH += $$PWD/Lib/test/linux_x32/include

DEPENDPATH += $$PWD/Lib/test/linux_x32/include

$$PWD ：用于指定包含.pro文件目录的完整路径

INCLUDEPATH ：指定了编译项目时被搜索到的 #include 目录

LIBS ：指定了链接到项目中库的列表

⑤修改后的.pro文件

实际项目中我们的库可能会用到多个平台，所以一般创建如下

unix{
    contains(QT_ARCH, i386){

        INCLUDEPATH += $$PWD/Lib/test/linux_x32/include
        LIBS +=      -L$$PWD/Lib/test/linux_x32/lib -lTestLib

    }
    contains(QT_ARCH, x86_64){

    }

}else{
    contains(QT_ARCH, i386){


    }

    contains(QT_ARCH, x86_64){
        #64bit

    }
}

3. 测试程序的编写

① .h

#ifndef WIDGET_H
#define WIDGET_H

#include <QWidget>

#include "addlib.h"

namespace Ui {
class Widget;
}

class Widget : public QWidget
{
    Q_OBJECT

public:
    explicit Widget(QWidget *parent = 0);
    ~Widget();

private slots:
    void on_pbn_testAddLib_clicked();

private:
    Ui::Widget *ui;

    AddLib m_addLib;
};

#endif // WIDGET_H

②.cpp

#include "widget.h"
#include "ui_widget.h"



#include <QDebug>

Widget::Widget(QWidget *parent) :
    QWidget(parent),
    ui(new Ui::Widget)
{
    ui->setupUi(this);


}

Widget::~Widget()
{
    delete ui;
}

void Widget::on_pbn_testAddLib_clicked()
{
    int x = ui->le_x->text().toInt();
    int y = ui->le_y->text().toInt();

    int ret = m_addLib.myAdd(x,y);

    ui->le_ret->setText(QString::number(ret));

    qDebug() << "add ret is :" << ret;
}

③程序功能及运行效果

UI输入两个数字，点击按钮后通过共享库计算，如下：

三．后记总结

1. 使用共享库问题与解决方法

以前在使用共享时，报了一个这样的错误：

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

加载共享库时失败，没找到。那会儿的解决办法是把共享库拷贝到 usr/local/lib下，这样问题就没有了，拷贝后要使用ldconfig命令。

上面的错误是在运行时没有找到共享库，在Linux下，可以使用 ldd命令查看一个可执行程序所需的库，效果如下：

2. 为什么在Qt中运行没有报上面的错误？

由于以前使用共享库遇到过上面的问题，但是在刚刚测试共享库的时候，为什么没有报错呢？是Qt将生成的共享库放到Linux默认的搜索路径下了么？

于是我使用了locate +库名命令进行搜索，但是并没有在其他路径下发现刚刚生成的共享库；于是我又去找配置Linux环境变量的文件，发现也没有。root下，在/etc/ld.so.conf.d文件下查看。

然鹅我并没有放弃，于是借助谷歌，搜索了下相关问题【Qt 编译工程的过程】，虽然没有找到答案，但是发现了一些线索：

在Projects中的Run Environment 下的LD_LIBRARY_PATH对应的Value里面，我看到了在程序中链接库的目录。至此，我觉得我找到了原因。

3. 小结中的小结

通过对一个问题的求解，我们顺藤摸瓜的会学习到很多其他知识。像本次就知道几个Linux命令的使用场景。

Linux下Qt创建共享库与链接共享库详解

测试

测试

继续阅读