Qt中的动态链接库编程(Q_DECL_IMPORT、Q_DECL_EXPORT)

一：Qt中的动态链接库编程

二、QT共享库和插件范例

    1> 编写共享库——Bil 项目的实现
该项目定义一个抽象的 IAnimal 类作为导出接口，供客户项目和插件项目使用。项目类型为共享库，将生成Bil.lib和Bil.dll两个文件，Bil.lib供Plugin项目和Test 项目引用，而Bil.dll将给Test.exe运行时动态加载。

新建一个头文件Bil.h，输入如下代码：

#ifndef BIL_H         #define BIL_H         #include  
  
             // 定义BIL_SHARE，使用者可以不用再处理符号的导入和导出细节         #ifdef BIL_LIB         # define BIL_SHARE Q_DECL_EXPORT         #else         # define BIL_SHARE Q_DECL_IMPORT         #endif         #endif // BIL_H       
  

• 你现在可能不知道BIL_SHARE宏有何用处。没关系，请继续看下面的IAnimal接口定义代码

#ifndef IANIMAL_H         #define IANIMAL_H         #include "Bil.h"         class BIL_SHARE IAnimal         {         public:             IAnimal();             virtual ~IAnimal();         public:             virtual void Eat() = 0;             virtual void Run() = 0;             virtual void Sleep() = 0;         };                 #endif // IANIMAL_H       

• 现在知道BIL_SHARE宏的妙用了吧。BIL_SHARE宏会根据项目编译选项 BIL_LIB有没有定义，自动声明IAnimal是导出类，还是导入类。所以，使用BIL_SHARE宏，我们只需要向IAnimal插件的开发者提供 同一份IAnimal定义文件（IAnimal.h）即可。

当然，我们得先在Bil项目的编译选项中定义BIL_LIB宏，使得在Bil项目内，BIL_SHARE就是导出符号的声明。插件项目就不要定义BIL_LIB了，因为在Animal插件项目中，IAnimal是导入符号。

编译选项如何定义宏？如果使用Visual Studio工程文件，依次展开：项目属性->配置属性->C/C++->预处理器，在预处理器定义中添加宏BIL_LIB即可；如果是QT工程文件，请在QT工程文件Bil.pro中加入如下定义：

        DEFINES += BIL_LIB    

在IAnimal接口中，我们定义了三个纯虚函数Eat()、Run()和 Sleep()，表示吃、跑和睡眠的动作，这是抽象的，因为不同的动物有不同的吃相和睡眠姿态，而世间的动物何止千千万——无所谓，让这些具体动物的不同 表现交给IAnimal插件的编写者发挥吧——这就是接口的魅力，加上插件的思想，整个应用程序就变成开放的，可扩展的了！

继续编写Anima类的实现文件Anima.cpp：

 #include "IAnimal.h"      IAnimal::IAnimal()      {      }      IAnimal::~IAnimal()      {      }      

虽然只实现了构造和析构函数，并且什么工作也不做，但这是必要的，我们暂时不要使用内联的构造和析构函数，否则在插件项目实现IAnimal时可能会出现链接错误。

好了，我们开始编译吧，生成整个Bil项目。最终我们得到两个输出文件：Bil.lib 和 Bil.dll。
我们向Animal插件开发者提供：
两个头文件：Bil.h 和 IAnimal.h
两个库文件：Bil.lib 和 Bil.dll
下面的插件类项目和客户项目就是依赖这些文件实现的，也许你更愿意把Bil看作是一个通用的DLL类库，就像QT或MFC一样——事实上也是如此，Bil就是这样一个动态的共享类库。

    2>. 编写Animal插件——BilDog和BilPanda项目的实现
现在，让我们来实现两个小插件。BilDog插件很简单，只是汇报下“我是Dog，我正在啃骨头”；BilPanda也是如此——这里仅仅是测试而已，实现的项目中，你可以尽情的发挥——没错，是在遵循IAnimal接口的前提下。
创建BilDog项目，把Bil项目输出的Bil.h、IAnimal.h和Bil.lib加入到工程。

创建Dog类的头文件Dog.h：

#ifndef CLASS_DOG_H #define CLASS_DOG_H #include "IAnimal.h" class Dog : public IAnimal { public: Dog(void); virtual ~Dog(void); public: virtual void Eat(); virtual void Run(); virtual void Sleep(); }; #endif // CLASS_DOG_H 

创建Dog类的实现文件Dog.cpp：

#include  
  
             #include "Dog.h"         Dog::Dog(void)         {         }         Dog::~Dog(void)         {         }         void Dog::Eat()         {             QMessageBox::information(NULL, "Hello", "Dog eating ...");         }         void Dog::Run()         {             QMessageBox::information(NULL, "Hello", "Dog running ...");         }         void Dog::Sleep()         {             QMessageBox::information(NULL, "Hello", "Dog sleeping ...");         }       
  

#ifndef BILDOG_H      #define BILDOG_H      #include "Dog.h"           // extern "C" 生成的导出符号没有任何修饰，方便主程序找到它      extern "C"     {       Q_DECL_EXPORT IAnimal * CreateAnimal();       Q_DECL_EXPORT void ReleaseAnimal(IAnimal * animal);      }      #endif // BILDOG_H      

调用QT的QMessageBox::information()函数弹出一个信息提示框。

还有一个非常重要的工作，我们得提供一个能够创建（释放）Animal具体对象（这里是Dog）的接口，并且把这些函
数导出，让主程序（Test.exe）能够解析这个接口函数，动态创建Animal对象，并访问其功能。

新建BilDog.h文件，输入下面的代码：

这两个函数的工作很简单，直接创建和释放对象即可。

下面是BilDog.cpp的代码：

#include "bildog.h"         IAnimal * CreateAnimal()         {             return new Dog();         }         void ReleaseAnimal(IAnimal * animal)         {             delete animal;         }       

至此，一个Animal插件总算完成了。编译，生成BilDog项目，输出BilDog.dll插件文件，以供主程序Test.exe动态调用。

BilPanda项目和BilDog项目类似，在这里就不把代码贴出来了。以后开发Animal插件（即使是第三方）的过程都是如此。
我们不打算输出该项目的.lib文件和那些头文件，因为我们打算让主程序在运行时刻根据需要装载dll插件和调用插件的功能，而不是让主程序项目在编译时就指定具体的插件。

    3> 编写客户程序——Test项目的实现

Test项目是一个测试程序项目，但它的角色是主程序，是能使用Animal插件的客户程序。

同样，这个项目用到了Bil共享库，所以得先把Bil项目的几个输出文件导入到Test项目。

我们假设Test主程序是一个对话框，上面有一个编辑框和一个“加载并调用”按钮，终端用户在编辑框中输入Animal插件的文件名（比如BilDog， 后缀名可省略，Qt会根据平台判断该查找.dll还是.so），点击“加载并调用”进行共享库的加载，并调用动态创建的IAnimal对象的Eat()函 数（当然你可以调用Run()函数或Sleep()，这里仅仅是一个示例）。

下面的函数将被“加载并调用”按钮的触发事件调用：

// ...         #include  
  
             #include  
   
              #include  
    
               // ...                 // strPluginName为插件的名称，可省略后缀         void MainDlg::LoadAndAction(QString strPluginName)         {             // 加载插件dll             QLibrary lib(strPluginName);             if (lib.load())             {                 // 定义插件中的两个导出函数的原型                 typedef IAnimal* (*CreateAnimalFunction)();                 typedef void (*ReleaseAnimalFunction)(IAnimal* animal);                 // 解析导出函数                 CreateAnimalFunction createAnimal =                          (CreateAnimalFunction) lib.resolve("CreateAnimal");                 ReleaseAnimalFunction releaseAnimal =                          (ReleaseAnimalFunction) lib.resolve("ReleaseAnimal");                   if (createAnimal && releaseAnimal)                 {                     // 创建Animal对象                     IAnimal * animal = createAnimal();                     if (animal)                     {                         // 使用插件功能                         animal->Eat();                         animal->Sleep();                         // 插件使用完毕，删除对象                         releaseAnimal(animal);                     }                 }                 // 卸载插件                 lib.unload();             }         }        // ...     
     
    
  

生成Test项目，输出Test.exe。我们把Test.exe、 Bil.dll、BilDog.dll、BilPanda.dll放在同一目录，双击运行Test.exe，赶快试下效果吧！注意BilDog.dll或 BilPanda.dll依赖于基础接口库Bil.dll，如果系统找不到Bil.dll，将不能加载BilDog.dll或BilPanda.dll， 所以请把它们放在同一目录。

三、一些遗憾