最近接連有幾位使用 Qt 的朋友來問起 Qt for iOS 的相關問題。由於我在這方面的經驗實在有限,寫不出一篇系統性的文章,實在抱歉無法給出令人滿意的答覆。這裡推薦大家去看看 Jason's Home(我部落格左側邊欄的友情連結裡也有),他分享了不少關於 Qt for iOS 的實用文章,而且都是基於真實的開發實踐,他的 App 已經成功上架 App Store。
至於這篇文章,我想簡單介紹一下如何混合使用 Qt 與 Objective-C 進行開發。
其實我要談的內容,大部分在 Qt 官方說明文件裡都能找到。大家可以切換到索引模式,搜尋「Qt for iOS」,找到那篇文章來看。它已經非常詳盡地介紹了搭建開發環境、編譯應用,以及混合 OC 編程這三個方面。
如果你不想啃英文,那就接著往下看吧。
專案設置
既然要聊 Qt 混合 OC 編程,首先得簡單說說 Objective-C。關於它,我只有一句話:Go,去問搜索引擎吧——因為我所知實在有限,怕誤導了你。當然,如果你不介意,那就繼續往下看。
OC 原始檔介紹
先說說 Objective-C 的原始檔。它的副檔名是 .m 或 .mm,而在 .mm 檔案裡可以直接寫 C++ 程式碼。所以,要混合 Qt 與 OC 程式碼,我們就需要在 Qt 專案中加入 .mm 檔案。
pro 檔案配置
安裝好 Mac 版的 Qt SDK 之後,Qt Creator 會調用 Xcode 提供的編譯工具鏈來編譯程式碼,既能正確處理 .mm 檔案,也能連結 iOS 的函式庫。
而要混合 OC 程式碼,我們需要對 pro 檔案做一些調整:一是加入 .mm 檔案,二是連結對應的 iOS 函式庫。
加入原始檔時,使用 OBJECTIVE_SOURCES 這個變量,例如:
OBJECTIVE_SOURCES += ocview.mm
而連結 Xcode 提供的函式庫,則需要用 QMAKE_LFLAGS,寫法類似:
ios { QMAKE_LFLAGS += -framework OpenGLES QMAKE_LFLAGS += -framework GLKit QMAKE_LFLAGS += -framework QuartzCore QMAKE_LFLAGS += -framework CoreVideo QMAKE_LFLAGS += -framework CoreAudio QMAKE_LFLAGS += -framework CoreImage QMAKE_LFLAGS += -framework CoreMedia QMAKE_LFLAGS += -framework AVFoundation QMAKE_LFLAGS += -framework AudioToolbox QMAKE_LFLAGS += -framework CoreGraphics QMAKE_LFLAGS += -framework UIKit }以上是我針對 iOS 開發所做的配置。由於我用到不少 iOS 函式庫,所以加了這麼多 framework。
「-framework UIKit」這類參數,是透過 Makefile 傳遞給 Clang 的;其中 -framework 是用來指示要連結某個框架(也就是函式庫)的關鍵字,後面緊跟著框架的名稱。
需要注意的是,我們使用 iOS 函式庫時,並不是透過「LIBS +=」這種方式引入的。當然,如果是你自己用 Qt 實現的 .a 函式庫,仍然要用「LIBS +=」的方式來引入。
指定 plist 檔案
有時你需要為專案指定 plist 檔案。plist 全名是 Property List,副檔名為 .plist,用來定義 iOS 應用的屬性,例如 Bundle(iOS 上的一個應用被稱為一個 Bundle)的顯示名稱、可執行檔名稱、簽名、憑證等等,當然也能用來保存一些設定資料。更具體的說明可以參考 iOS 開發文件。
要在 pro 檔案中加入 plist,得使用 QMAKE_INFO_PLIST 關鍵字,例如:
QMAKE_INFO_PLIST += MultiWindow.plist
好了,關於 pro 檔案中與混合使用 OC 相關的配置項,大致就這些。接下來我們看看該怎麼寫 Objective-C 程式碼。
混合使用 Objective-C 程式碼
唉,這是我的弱項,實在惶恐——我沒寫過多少 OC 程式碼,所以請別問我有關 OC 的問題,我真的不太懂……
背景
我的範例,是在 QML 介面上疊加 iOS 原生的介面,也就是 UIView、UIWindow 之類的東西。因為 OC 是 C 的近親,跟 C++ 有著天然的淵源,混合起來特別方便,比在 Android 上用 JNI 編程要好用多了。
不過有一點要提醒:OC 都使用 [] 這種語法來呼叫函式。用 Xcode 時,語法提示與自動完成功能非常強大,幾乎不用思考就能找到你要的函式;而 Qt Creator 嘛,嘿嘿,就沒這麼友善了,一切全靠手寫。我當時都是開著 Xcode、翻著 API 文件慢慢找的,比較痛苦。
QQuickView 是什麼
我測試時用的是 Qt Quick App 專案模板,透過 QQuickView 來加載 QML 文件,這裡也以它為例來說明。
首先要釐清 QQuickView 到底是什麼。其實,QQuickView 就是一個 UIView。而 UIView 則是 iOS 開發框架裡眾多介面元素的根基,比如 UIWindow 就是 UIView 的子類。
Qt 的 QQuickView 是一個 UIView。建立 QQuickView 實例之後,就擁有了一個 UIView;接著 Qt 施展了一些「魔法」,取得了這個 UIView 的 OpenGL Context,啟動了 Qt 的事件循環,並在這個 OpenGL Context 上從零開始繪製出屬於自己的場景與 UI 系統。
就是這麼簡單,你可以查閱 Qt 原始碼來進一步了解。
需要留意的是,QML 介面元素的渲染,與 UIView 這類原生介面的渲染,並不在同一個執行緒裡。而且 iOS 對 OpenGL ES 的支援很好,你可以同時使用多個 OpenGL Context;更棒的是,還能以視窗模式來建立 OpenGL Context。這點不像 Android 版——Qt 在 Android 上使用 OpenGL 時一律是全屏模式,不支援局部更新,所以我們在 Android 上用 QML 的 Camera 和 VideoOutput 開發拍照應用時,VideoOutput 必須是全屏模式(必須 fill_parent)。而在 iOS 上就沒有這個限制,看來 iOS 還是相當美好的。
哎,扯得有點遠,最近技術文章寫得少,越來越囉嗦了,還是言歸正傳吧。
由於 QQuickView 本身就是一個 UIView,所以可以將它強制轉換為 UIView,再用 OC 的方法建立新的 UIView 或 UIWindow,這樣就擁有了原生的 UI 組件;你可以在這個原生組件上用 OpenGL 繪製內容,或加入其他原生控件,非常美好。
不過要說明的是,用這種方法建立的 iOS 原生介面元素,會始終浮在 QML 介面之上,把 QML 場景裡的元素給蓋住。
混合程式碼
要使用 OC 的類別庫,需要在 .mm 檔中引入相關的標頭檔,這裡有幾件事要做:一是在 pro 檔案裡加入 SDK 路徑,用 INCLUDEPATH 變量即可,不多贅述;二是在 .mm 檔中引入 OC 標頭檔,道理和 C++ 標頭檔一樣,只是要用 #import 而非 #include,寫法類似:
#import < UIKit/UIKit.h> #import < GLKit/GLKit.h>
引入標頭檔後,就能使用 OC 類別庫了。比如我要在 QQuickView 上建立一個新的 iOS 原生 UIView,.mm 檔裡可以這樣寫:
void addOCView(QQuickWindow *w) { UIView *view = reinterpret_cast(w->winId()); CGRect viewRect = CGRectMake(10, 10, 100, 100); UIView* myView = [[UIView alloc] initWithFrame:viewRect]; [myView setBackgroundColor:[UIColor colorWithRed:1.0 green:0.0 blue:0.0 alpha:1.0]]; [view addSubview: myView]; } 如你所見,我寫了一個 addOCView 方法,參數是 QQuickView。在方法裡,我把 QQuickView 強制轉換成 UIView 來使用:建立一個新的 UIView,設好背景顏色,再把它作為 QQuickView 的子視窗加入。瞧,就這麼簡單。
再來看看 main.cpp 是怎麼呼叫 addOCView() 的:
int main(int argc, char *argv[]) { QGuiApplication app(argc, argv); QQuickView viewer; viewer.setResizeMode(QQuickView::SizeRootObjectToView); viewer.setSource(QUrl("qrc:/main.qml")); viewer.show(); addOCView(&viewer); return app.exec(); }一點都不驚喜吧?就是直接呼叫 addOCView 而已。哈哈,確實如此。
iOS 原生介面與 QML 元素的位置映射
混合使用 iOS 原生介面時,也能做到原生介面與 QML 介面的無縫整合,關鍵在於計算 QML 元素的位置,再據此設定原生介面的位置。
QML 元素位置換算
QML 提供了換算元素位置的方法。Item 有個方法叫 mapToItem(),它能將一個相對於某個 Qt Quick Item 的區域映射到另一個 Item 上,從而得到座標。比如你的 QML 檔長這樣:
Rectangle { ... Rectangle { id: videoLayer; anchors.margins: 8; anchors.left: parent.left; anchors.right: parent.right; anchors.top: parent.top; anchors.bottom: actionBar.top; color: "green"; } ... }你想把原生的 UIView 定位到 id 為 videoLayer 的元素內部,就可以像下面這樣換算出座標並使用:
var coordinate = videoLayer.mapToItem(null, 8, 8, videoLayer.width - 16, videoLayer.height - 16); winUtil.addUIView(coordinate.x, coordinate.y, coordinate.width, coordinate.height);
換算出來的 coordinate 帶有 x、y、width、height 屬性。當 mapToItem 的第一個參數為 null 時,換算結果就是相對於 QQuickView 的。如此一來,我們在加入 UIView 時,就能用這個結果來構造一個 CGRect,再用它初始化 UIView 的位置。
設定 UIView 的位置
前面範例中的 winUtil,是我在 C++ 裡實作的一個輔助類,並導出到了 QML 環境中。它的 addUIView 方法會依據傳入的座標來設定原生 UIView 的位置,參考程式碼如下:
UIView *v = reinterpret_cast(view->winId()); uiw = [[UIWindow alloc] initWithFrame:CGRectMake(x, y, width, height)]; [v addSubview: uiw];
上面的程式碼中,view 是 QQuickView。這次建立 UIView 時用上了傳入的 x、y、width、height,於是新建的 UIView 就和 QML 元素整合在一起,看起來彷彿一體。
OK,以上就是全部內容了。
(本文作者:foruok)