1 QObject *obj = new QTimer;  
 2 QTimer *timer = qobject_cast<QTimer *>(obj);

下面的代碼聲明了一個(gè)接口類：

 1 class FilterInterface
 2 {
 3 public:
 4       virtual ~FilterInterface() {}
 5       virtual QStringList filters() const = 0;
 6       virtual QImage filterImage(const QString &filter, const QImage &image, QWidget* parent)=0;
 7 };
 8 
 9 Q_DECLARE_INTERFACE(FilterInterface, "com.trolltech.PlugAndPaint.FilterInterface/1.0")

這里是實(shí)現(xiàn)該接口的插件類的定義：

 1 #include <QObject>
 2 #include <QStringList>
 3 #include <QImage>
 4 
 5 #include <plugandpaint/interfaces.h>
 6 
 7 class ExtraFiltersPlugin : public QObject, public FilterInterface
 8 {
 9  Q_OBJECT
10 Q_INTERFACES(FilterInterface)
11 
12 public:
13     QStringList filters() const;
14     QImage filterImage(const QString &filter, const QImage &image,
15     QWidget *parent);
16 };

示例 Plug & Paint 的文檔詳細(xì)解釋了這一過程。與Qt Designer有關(guān)的問題請看Creating Custom Widgets for Qt Designer 。 Echo Plugin Example 是一個(gè)關(guān)于如何實(shí)現(xiàn)擴(kuò)展Qt應(yīng)用程序的詳細(xì)示例。

Loading and Verifying Plugins Dynamically

裝載插件時(shí)。Qt庫有一些健全檢查來確定插件能否被裝載和使用。這就可以同時(shí)安裝多個(gè)版本和Qt庫配置。

• 與較高主版本和(或)次版本號的Qt庫鏈接的插件不能被主版本和(或)次版本號較低的庫裝載。

  原理： 一個(gè)使用新版Qt庫的插件可能用了老版本沒有的新特征。Trolltech有一個(gè)只在次版本號升級時(shí)添加新功能和API的政策，這就是為什么該測試只看主次版本號，而不看補(bǔ)丁號。

• Qt庫和所有插件用一個(gè)聯(lián)編關(guān)鍵字來聯(lián)編。Qt庫中的聯(lián)編關(guān)鍵字被與插件中的聯(lián)編關(guān)鍵字對照，如果相符，插件就被裝載。如果聯(lián)編關(guān)鍵字不符，Qt庫就拒絕裝載該插件。 

  原理： 見下文對聯(lián)編關(guān)鍵字的解釋。

編譯插件來擴(kuò)展應(yīng)用程序時(shí)，確保插件和應(yīng)用程序用同樣的配置這一點(diǎn)很重要。這意味著如果應(yīng)用程序是release模式編譯的，那么插件也要是release模式。

若將Qt配置為debug和release模式都編譯，但只在release模式下編譯應(yīng)用程序，就要確保你的插件也是在release模式下編譯的。缺省的，若Qt的debug編譯可用，插件就只在debug模式下編譯。要強(qiáng)制插件用release模式編譯，要在工程中添加：

 CONFIG += release

這能確保插件兼容應(yīng)用程序中所用的庫版本。

The Build Key

裝載插件時(shí)，Qt核對每一個(gè)插件的聯(lián)編關(guān)鍵字要和自己的匹配，以保證所裝載的是兼容的插件；任何不匹配的插件不會被裝載。

聯(lián)編關(guān)鍵字包含一下信息：

• Architecture, operating system and compiler.

  原理： 在同一編譯器的不同版本并不產(chǎn)生二進(jìn)制兼容代碼的場合，編譯器的版本也體現(xiàn)在聯(lián)編關(guān)鍵字里。

• Qt庫的配置。這個(gè)配置是庫中所缺少特性的列表，因?yàn)檫@些功能對應(yīng)的API在該庫中不可用。

  原理： 兩個(gè)同一版本的Qt庫的不同配置不是二進(jìn)制兼容的。裝載插件的Qt庫使用這個(gè)(缺少的)特性列表來判斷插件是不是二進(jìn)制兼容的。

  注意： 也存在這種情況，插件可以使用在兩個(gè)不同配置里可用到的特性。但是，編寫插件的開發(fā)者需要知道，哪些特性在他們的插件和Qt的公用工具類中都在被使用。Qt庫在裝載插件時(shí)會需要復(fù)雜的特性與依賴性的查詢確認(rèn)。這些需求給開發(fā)者添了一個(gè)不必要的負(fù)擔(dān)，也增加了裝載插件的系統(tǒng)開銷。為了減少開發(fā)時(shí)間，降低應(yīng)用的運(yùn)行時(shí)消耗，可以使用對聯(lián)編關(guān)鍵字的簡單字符串比較。

• 可選地，可以在配置腳本命令行指定一個(gè)附加的字符串Optionally, an extra string may be specified on the configure script command line.

  原理： 在發(fā)布帶有應(yīng)用程序的Qt庫的二進(jìn)制時(shí)，這給開發(fā)者提供了一個(gè)編寫插件的辦法，這樣寫出來的插件只能被插件鏈接的那個(gè)庫所裝載。

為了調(diào)試可能需要關(guān)閉聯(lián)編關(guān)鍵字校驗(yàn)功能，這可以通過將你運(yùn)行應(yīng)用程序的環(huán)境的環(huán)境變量QT_NO_PLUGIN_CHECK設(shè)置為非零來實(shí)現(xiàn)。

Static Plugins

插件能被靜態(tài)地鏈接到應(yīng)用程序。如果你創(chuàng)建了Qt的靜態(tài)版本，這僅僅是用來包含Qt的預(yù)定義插件的一個(gè)選項(xiàng)。

當(dāng)被作為靜態(tài)庫編譯時(shí)，Qt提供下面這些靜態(tài)插件：

要靜態(tài)鏈接這些插件，你的應(yīng)用程序中要用到宏Q_IMPORT_PLUGIN() 并且要用QTPLUGIN將需要的插件添加到你的編譯中。例如，在main.cpp中：

 #include <QApplication>
 #include <QtPlugin>

 Q_IMPORT_PLUGIN(qjpeg)
 Q_IMPORT_PLUGIN(qgif)
 Q_IMPORT_PLUGIN(qkrcodecs)

 int main(int argc, char *argv[])
 {
     QApplication app(argc, argv);
     ...
     return app.exec();
 }

應(yīng)用程序的.pro 文件中要用下列條目：

 QTPLUGIN     += qjpeg \
                 qgif \
                 qkrcodecs

也可以創(chuàng)建自己的靜態(tài)庫，步驟如下：

1. 在插件的 .pro 文件中添加 CONFIG += static 。
2. 應(yīng)用程序中用宏 Q_IMPORT_PLUGIN() 。
3. 應(yīng)用程序的.pro 文件中用 LIBS 將靜態(tài)庫鏈接進(jìn)來。

參見示例 Plug & Paint 和相關(guān)的插件 Basic Tools 來獲得詳情。

The Plugin Cache

為了加速插件的裝載和確認(rèn)，裝載插件時(shí)收集的信息被緩存到QSettings中。這包括插件是否被成功裝載的信息，以使后面的裝載操作不用再嘗試裝載無效的插件。但是，若一個(gè)插件的 last modified 時(shí)間戳被修改，插件的緩存條目是無效的并且插件會不管緩存條目中的值而被重新裝載，同時(shí)緩存條目本身也會被新的值替代。

這也意味著每一次插件或任何依賴資源(如共享庫)被更新之后時(shí)間戳也必須被更新，因?yàn)橐蕾囐Y源可能影響一個(gè)插件裝載的結(jié)果。

有時(shí)，開發(fā)插件時(shí)，需要從插件緩存中移除條目。因?yàn)镼t用QSettings來管理插件緩存，插件的位置是依賴于平臺的；更多關(guān)于每一個(gè)平臺的信息請參看the QSettings documentation。

例如，Windows中這些條目存儲在注冊表中，每個(gè)插件的路徑是以下面兩個(gè)字串中的一個(gè)開始的：

 HKEY_CURRENT_USER\Software\Trolltech\OrganizationDefaults\Qt Plugin Cache 4.2.debug
 HKEY_CURRENT_USER\Software\Trolltech\OrganizationDefaults\Qt Plugin Cache 4.2.false

Debugging Plugins

有許多問題可能影響到插件在應(yīng)用程序中的正常運(yùn)轉(zhuǎn)。  許多與插件和應(yīng)用程序的創(chuàng)建方法不同有關(guān)， 通常發(fā)生在不同的創(chuàng)建系統(tǒng)和過程中。

下表描述的是開發(fā)者創(chuàng)建插件時(shí)遇到的問題的常見原因：

也可以用QT_DEBUG_PLUGINS環(huán)境變量來從Qt中獲得嘗試去裝載的每一個(gè)插件的診斷信息。在應(yīng)用程序的運(yùn)行環(huán)境中把該變量的值設(shè)置為非零。

See also QPluginLoader, QLibrary, and Plug & Paint Example.

北京精神病醫(yī)院http://www.120ask-00.com/精神病醫(yī)院