RTY 實(shí)踐出真知

 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ì)解釋了這一過(guò)程。與Qt Designer有關(guān)的問(wèn)題請(qǐng)看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庫(kù)有一些健全檢查來(lái)確定插件能否被裝載和使用。這就可以同時(shí)安裝多個(gè)版本和Qt庫(kù)配置。

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

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

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

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

編譯插件來(lái)擴(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)用程序中所用的庫(kù)版本。

The Build Key

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

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

• Architecture, operating system and compiler.

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

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

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

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

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

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

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

Static Plugins

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

當(dāng)被作為靜態(tài)庫(kù)編譯時(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)庫(kù)，步驟如下：

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

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

The Plugin Cache

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

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

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

例如，Windows中這些條目存儲(chǔ)在注冊(cè)表中，每個(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

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

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

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

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

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