表格樹控制元件QtTreePropertyBrowser編譯成動態庫(設計師外掛)

朝十晚八發表於2019-07-03

一、回顧

上一篇文章超級實用的表格樹控制元件--QtTreePropertyBrowser講了怎麼去編譯QtTreePropertyBrowser庫，並且可以簡單實用。由於我下載的庫是基於Qt4的版本，所以編譯起來也費勁巴拉的，改了好久的原始碼才編譯通過。

本篇文章我們核心講解的是怎麼把這個庫編譯成動態庫，讓別的模組去動態呼叫。

這裡引入Qt官方維護的模組QtSolutions，裡邊就包含了QtTreePropertyBrowser這個專案，最關鍵是Qt5可以直接編譯通過。

QtSolutions裡邊不僅僅有QtTreePropertyBrowser這個專案，而且包含了多個有用模組，文章最後會簡單做以介紹。

下面我們主要還是圍繞QtTreePropertyBrowser這個庫來進行講解。。

二、動態庫編譯

編譯成動態庫的方式有2種，一種是命令列，另一種是vs工具，其實本質上都是一樣的，都是使用了msvc編譯器。

如果想要使用其他編譯器編譯，本篇文章可以作為參考，可能有些地方不太實用。

編譯這種長期維護的專案，我們首先就是去看程式碼中的文件說明，一般都會有編譯步驟。

表格樹控制元件QtTreePropertyBrowser編譯成動態庫(設計師外掛)

這個庫也不例外，看上圖中紅色款圈出來的部分，就是我們編譯的步驟，簡單吧。

configure.bat，如果需要生成動態庫則需要新增-library引數

1、命令列編譯動態庫和測試程式

命令列cd到原始碼根目錄，執行以下步驟即可

confiture.bat -library
qmake
nmake

沒有什麼懸念，程式碼應該可以正常編譯通過，這裡就不做過多解釋。

重點看下怎麼使用vs工具進行編譯

2、vs工具編譯動態庫和測試程式

首先在網上隨便搜尋下pro轉sln工程的文章，總結一下就是下面兩句話

qmake xxx.pro
qmake -tp vc -r

對於我們的qtpropertybrowser程式碼可能就像下面這樣

qmake qtpropertybrowser.pro
qmake -tp vc -r

如果不使用這種方式，也可以使用vs-addin外掛直接開啟pro檔案

執行完上述兩句話之後，會發現我們的根目錄下多了一個qtpropertybrowser.sln工程檔案。每一個專案資料夾下也多了一個simple.vcxproj專案檔案。

接下來就是用vs開啟qtpropertybrowser.sln工程檔案，然後進行編譯了。

通過命令列生成的QtSolutions_PropertyBrowser-head.vcxproj這個工程檔案有一些小問題，需要修改下工程配置，否則編譯會失敗。

開啟工程屬性 -> C/C++ -> 前處理器 -> 前處理器定義項。

修改QT_QTPROPERTYBROWSER_IMPORT巨集為QT_QTPROPERTYBROWSER_EXPORT

然後編譯，動態庫的編譯結果如下圖，其他測試程式這裡沒有放出來。

3、安裝文件

根據INSTALL.txt說明檔案，嘗試如下兩種操作均失敗

新增qch檔案，發現沒有這個檔案
使用新增命令assustant -addContentFile xxx.dcf新增，報錯。

後來無意中看到了一片文章建立文件和自定義的qt assistant，講怎麼生成Qt幫助文件的，發現其中有根據qhp檔案生成qch檔案的方式，嘗試了下，居然可以。

操作步驟如下：

qhelpgenerator xxx.qhp -o xxx.qch
assistant -register xxx.qch

對於我們的qtpropertybrowser程式碼，可能會像下面這樣。首先進入doc\html目錄下，然後執行如下操作

qhelpgenerator qtpropertybrowser.qhp -o qtpropertybrowser.qch
assistant -register qtpropertybrowser.qch

第二步也可以通過工具來新增，如上圖所示。編輯選單 -> 首選項，選中文件頁籤，新增自己的qch檔案即可。

4、測試文件

搜尋頁簽下輸入"QtPro"，搜尋到結果QtProperty，如下圖所示，表示我們的文件整合成功。

三、設計師外掛編譯

動態庫都有了，設計師外掛還會遠嗎？

自己寫一個Qt外掛，把需要匯入到desinger中的控制元件都註冊進來即可。

大致流程如下

1、重寫QDesignerCustomWidgetInterface

WidgetInterface類繼承自QDesignerCustomWidgetInterface，WidgetInterface類包含了一些預設行為，這裡就不貼出來了。

class TreeBrowserInterface : public WidgetInterface
{
    Q_OBJECT
    Q_INTERFACES( QDesignerCustomWidgetInterface )

public:
    TreeBrowserInterface(QObject * parent);
    virtual QWidget * createWidget( QWidget * parent ) override;
};

2、新增到外掛列表

WidgetCollectionInterface::WidgetCollectionInterface( QObject * parent /*= nullptr */ )
    : QObject(parent)
{
    d_plugins.append(new QPB::TreeBrowserInterface(this));
    d_plugins.append(new QPB::ButtonBrowserInterface(this));
    d_plugins.append(new QPB::GroupBoxBrowserInterface(this));
}