用一个非常简单的Qt程序作为例子,通过pro文件的合理编写,使得我们的程序在使用动态库的时候,几乎可以忽略掉动态库的存在。它包括3部分:
@H_502_12@ 测试环境:- ubuntu 11.04 + Qt 4.7.2
- windows vista + Qt 4.7.0(MSVC2008)
- windows vista + Qt 4.6.3(MinGW)
例子的源码:http://code.google.com/p/h-qt-exercise/downloads/detail?name=QtAppWithDll.zip&can=2&q=(你可以先看代码,再决定是不是继续向下看)
引子
@H_502_12@ 一个非常非常简单的Qt的小程序,是吧?- widget.h
#ifndef WIDGET_H #define WIDGET_H #include <QtGui/QWidget> class Widget:public QWidget { Q_OBJECT public: Widget(QWidget * parent=0); }; #endif // WIDGET_H
#include "widget.h" Widget::Widget(QWidget *parent) :QWidget(parent) { }
#include <QtGui/QApplication> #include "widget.h" int main(int argc,char **argv) { QApplication app(argc,argv); Widget w; w.show(); app.exec(); }@H_502_12@ 这个程序是如此的简单,我们都能很轻易地写出需要的pro文件
HEADERS += widget.h SOURCES += main.cpp widget.cpp@H_502_12@ 然后qmake,make即可得到结果。 @H_502_12@ 可是,你想过么:如果不想让我们的程序铁板一块,分成几个动态库(共享库)会怎么样呢,pro文件又该如何写?
如何做?(一)源码分开放置
@H_502_12@ 既然要准备用动态库了,库的源码和程序的源码还是分开放置吧?- 将源文件放到不同的路径下
- src/main.cpp
- libwidget/widget.h
- libwidget/widget.cpp
- 我们需要3个xxx.pro文件
- project.pro
- src/src.pro
- libwidget/libwidet.pro
TEMPLATE=subdirs CONFIG += ordered SUBDIRS += libwidget src
如何做?(二)生成动态库
@H_502_12@ 使用动态库,当务之急是生成动态库。- 如果我们不在windows下使用,一切都会比较简单,源代码也不需要改动。
-
在windows下,动态库导出的东西需要使用__declspec(dllexport)。
#ifndef WIDGET_H #define WIDGET_H #include <QtGui/QWidget> #if defined(LIBWIDGET_BUILD) # define WIDGET_API Q_DECL_EXPORT #else # define WIDGET_API Q_DECL_IMPORT #endif class WIDGET_API Widget:public QWidget { Q_OBJECT public: Widget(QWidget * parent=0); }; #endif // WIDGET_H@H_502_12@ 然后写写 libwidget.pro 文件:
TEMPLATE = lib TARGET = widget DEFINES += LIBWIDGET_BUILD SOURCES += widget.cpp HEADERS += widget.h@H_502_12@ 这样一来,确实可以生成动态库了。可是总觉得不太好: @H_502_12@ 暂且存疑,我们先看看其他
如何做?(三)使用动态库
@H_502_12@ 看看可执行程序的生成,它要使用我们前面的库,那么:src/src.pro 文件可以就写成这个样子了:
TEMPLATE=app INCLUDEPATH += ../libwidget LIBS += -LThePathWePutLib -lwidget SOURCES += main.cpp@H_502_12@ 先不考虑运行时的情况。头文件和库文件都和前面的libwidget直接相关,怎么构建自动化呢?比如:库文件的名字改动了?库文件的存放目录变了?...
如何做?(四)构建自动化
@H_502_12@ 我们构建动态库的时候,可以控制动态库的名字,可以控制存放目录,那么,我在讲动态库的这部分设置独立出来不就行了:恩,使用一个 libwidget/libwidget.pri 文件。l由于src/src.pro和libwidget/libwidget.pro共用这个文件,还需要一个开关来进行区分(这就是widget-buildlib):INCLUDEPATH += $$PWD TEMPLATE += fakelib LIBWIDGET_NAME = $$qtLibraryTarget(widget) TEMPLATE -= fakelib !widget-buildlib{ LIBS += -L$$PROJECT_LIBDIR -l$$LIBWIDGET_NAME }else{ SOURCES += widget.cpp HEADERS += widget.h }@H_502_12@ 注意:这儿库目录用一个变量PROJECT_LIBDIR表示(你这儿可以直接换成存放库的目录),具体稍后解释。这儿的库的名字使用qtLibraryTarget进行生成(这样可以确保windows下debug模式生成的动态库可以自动加个d),fakelib是用来哄骗qtibraryarget的,不然它只在TEMPLATE为lib是生效。 @H_502_12@ @H_502_12@ 这样,可执行程序的生成时,它要使用我们前面的库,只需要包括进来libwidget.pri,于是:
- src/src.pro 文件可以就写成这个样子了:
TEMPLATE=app include(../libwidget/libwidget.pri) SOURCES += main.cpp
- 相应地,libwidget/libwidget.pro 可以修改如下:
TEMPLATE = lib CONFIG += widget-buildlib include(libwidget.pri) TARGET = $$LIBWIDGET_NAME CONFIG += debug_and_release build_all DEFINES += LIBWIDGET_BUILD
如何做?(五)运行自动化
@H_502_12@ 现在似乎一切都比较正常了,可是有一点,我们要将生成的库文件放到什么地方呢?才能使得运行时都能被找到(就像没使用动态库一样,点击IDE中的run或者去目录下双击即可运行) @H_502_12@ 我们需要: @H_502_12@ 恩,这两个目录对整个工程比较通用,我们可以考虑建立一个 common.pri 文件:PROJECT_BINDIR = $$PWD/bin PROJECT_LIBDIR = $$PWD/lib@H_502_12@ 然后libwidget/libwidget.pri 包含该common.pri 文件
INCLUDEPATH += $$PWD DEPENDPATH += $$PWD TEMPLATE += fakelib LIBWIDGET_NAME = $$qtLibraryTarget(widget) TEMPLATE -= fakelib include(../common.pri) !widget-buildlib{ LIBS += -L$$PROJECT_LIBDIR -l$$LIBWIDGET_NAME }else{ SOURCES += widget.cpp HEADERS += widget.h }
TEMPLATE = lib CONFIG += widget-buildlib include(libwidget.pri) TARGET = $$LIBWIDGET_NAME DESTDIR = $$PROJECT_LIBDIR win32{ DLLDESTDIR = $$PROJECT_BINDIR QMAKE_DISTCLEAN += $$PROJECT_BINDIR/$${LIBWIDGET_NAME}.dll } CONFIG += debug_and_release build_all DEFINES += LIBWIDGET_BUILD@H_502_12@ 注意:这儿我们指定了库文件的目录,并会将dll拷贝到了PROJECT_BINDIR目录
TEMPLATE=app include(../libwidget/libwidget.pri) DESTDIR = $$PROJECT_BINDIR unix:QMAKE_RPATHDIR+=$$PROJECT_LIBDIR SOURCES += main.cpp@H_502_12@ 注意:这儿我们对unix下,指定了rpath,使得程序运行时不许设置可以即可找到动态库