演講嘉賓 | 蔡萬蒼

回顧整理 | 廖 濤

排版校對 | 李萍萍

嘉賓簡介

蔡萬蒼，13年C++/Qt開發相關工作經驗，曾任職Qt公司，擔任技術支持、Qt咨詢師，協助國內多家Qt企業版用戶完成基于Qt的軟件框架搭建，參與Qt開源社區Bug維護及修改，在基于Qt框架的軟件架構設計、Qt跨平臺適配上有多年的技術積累和經驗，開源書籍QmlBook-in-Chinese在github上star數達到1000+，現任職于軟通動力信息技術（集團）股份有限公司，擔任成都圖形框架研究院軟件開發專家角色，負責圖形框架研究院的技術管理工作。

內容來源

第一屆開放原子開源基金會OpenHarmony技術峰會——生態與互聯分論壇

視頻回顧

? ?打開 嗶哩嗶哩APP 搜索 OpenHarmony-TSC 視頻更清晰

正 文 內 容

在全球超過70個行業，8000家公司，100萬的開發者都在使用Qt，通過Qt適配OpenHarmony，能夠豐富OpenHarmony的開發生態、應用生態，加速OpenHarmony在各行業的推廣使用。如何推進和完成Qt在OpenHarmony上的適配呢？軟通動力成都圖形框架研究院軟件開發專家蔡萬蒼在第一屆OpenHarmony技術峰會上分享了精彩觀點。

01?

Qt 適配 OpenHarmony 意義

Qt是一個C++跨平臺開發框架，主要用于開發圖形用戶界面（Graphical User Interface，GUI）程序，具有跨平臺類庫（支持目前所有主流軟硬件平臺組合）、集成開發工具（縮短軟件產品上市時間）以及跨平臺集成開發環境（高生產力開發環境）等。全球超過100萬研發者使用過Qt，Qt的跨平臺開發能力覆蓋70多個行業，是從1994年至今得到廣泛的認同和驗證的主流技術。

Qt適配OpenHarmony有什么意義？

一、擴大OpenHarmony開發者陣營：基于Qt跨平臺特性及Qt For OpenHarmony的適配，吸引數量龐大的Qt開發人員在OpenHarmony上進行跨平臺應用遷移及應用開發，能夠實現開發人員業務目標與個人能力和OpenHarmony開源生態與技術發展的雙贏。

二、豐富OpenHarmony應用生態：Qt支持目前主流的所有操作系統，如UBuntu、CentOS、OpenEuler、Android、OS X、iOS、Windows、VxWorks、QNX等，涵蓋從嵌入式平臺、移動平臺及PC桌面，基于Qt框架典型的桌面應用，從娛樂到工業軟件都有所涉及，如暴雪的戰網客戶端、WPS、VirtualBox等等，大部分應用程序都可以使用Qt實現。通過Qt適配OpenHarmony，能夠加速OpenHarmony的行業應用推廣。

02?

計劃貢獻內容

2.1??

適配計劃

Qt按使用及部署劃分，包含了設計工具、開發工具、框架必要模塊、框架附加模塊4個部分，基于OpenHarmony跨平臺開發考慮，總體計劃如下：

針對OpenHarmony的開發工具進行補充

對Qt必要模塊進行適配支持

對部分Qt附加模塊適配支持

具體工作如下：

成立 OH_QT sig，完成Qt Core（Qt核心模塊）、Qt GUI（顯示相關代碼）以及Qt QML適配

完成Qt工程部署，適配Qt相關的開發工具，實現Qt應用程序北向開發封裝；適配Qt附加庫部分，如Qt Multimedia，QtRemoteObjects

完成Qt示例及DEMO適配驗證、Qt單元測試適配驗證；向Qt社區申請立項OpenHarmony支持，申請OH_QT sig畢業

開發Qt工程轉換DevEco工程工具實現快速的應用遷移配置

2.2??

Qt 配套開發工具

Qt開發者通常使用Qt配套的集成開發環境Qt Creator，采用qmake或cmake進行軟件工程管理配置，為方便開發者對已有軟件進行移植適配，我們會開發對應的工程轉換工具，將Qt的應用工程轉換為DevEco Application工程，幫助開發者快速實現應用的遷移配置。

03?

技術難點分享

Qt本身是跨平臺的框架，我們要把它跟OpenHarmony做移植，無非考慮幾個問題：一是Qt應用程序的界面如何在OpenHarmony上進行顯示；OpenHarmony本身觸屏的輸入、鼠標/鍵盤的輸入怎么能夠把它映射到Qt本身的應用程序框架里去。需要了解Qt的QPA實現及系統接口調用的相關邏輯，就能實現Qt應用程序在OpenHarmony上的運行。

3.1??

QPA 實現及系統接口調用

Qt平臺抽象（QPA）是Qt的平臺抽象層，QPA插件是通過子類化各種QPlatform*類來實現系統接口的接入，例如用于窗口系統集成的QPlatformIntegration和QPlatformWindow以及用于更深層次的平臺主題化和集成的QPlatformTheme。

QPA核心對象及作用：通過QPlatfromIntegration實現對QPA插件的對象聲明周期管理，Qt GUI等模塊通過Qt已完成的平臺抽象層相關類實現對系統底層的調用，其中比較重要的實現類包括：EventDispatcher（實現系統底層事件接入）、BackingStore（系統圖形繪制雙緩存實現）、Screen（系統屏幕對象，用于管理Window顯示）、Window（系統窗口對象）、InputContext（系統輸入處理，包括鼠標、輸入法等）、OpenGLContext（系統窗口OpenGL渲染上下文）以及Clipboard（系統剪切板）。

Qt Widget For OpenHarmony渲染流程：基于Qt框架自成體系的圖形框架和事件系統，在OpenHarmony上基于XComponent生成的EGLSurface，采用圖像二維繪制的方式在OpenGL Surface上實現雙緩存渲染機制，完成Qt Widget的窗口內容渲染。

Qt Quick For OpenHarmony渲染流程：Qt Quick采用自成體系的Scene Graph基于OpenGL標準接口實現，QPA OpenHarmony插件基于XCompent生成EGL Surface，并通過QPA標準實現類重載實現PlatformIntegration實現與Scene Graph的OpenGLContext綁定，Qt Quick基于標準OpenGL接口在XComponent上實現圖形渲染。

OpenHarmony Touch事件接入：基于XComponent的事件監控回調，在QPA的InputContext實現中實現對XComponent的輸入監控，將監控的輸入轉換為Qt Event發送到Qt Event隊列中，由Qt框架實現對輸入的處理，完成對觸屏操作和鼠標操作的處理。

基于NAPI的應用框架接口調用：基于OpenHarmony的應用接口規范，部分接口未提供NDK接口，需要通過Node.JS的C++插件NAPI調用ETS SDK的接口進行實現，QPA For OpenHarmony部分系統接口采用該種方式完成對系統接口的調用，例如系統剪切板。

基于TS腳本自定義符合Qt標準的對話框：Qt上層接口的QMessageBox支持系統默認樣式對話框彈出，該接口在OpenHarmony的SDK中有提供，由于參數差異，無法通過NAPI直接調用，我們采用ETS語言實現后導入到DialogHelpers中進行使用。目前系統輸入法采用NAPI接口進行調用，通過Custom ETS實現對系統輸入法的調用進行監控，再傳入Qt Input Context轉換為Qt Key Event輸入到Qt框架，由于輸入法的高性能要求，后續會與OpenHarmony團隊進行溝通，考慮開放系統底層輸入法NDK接口。

3.2??

Qt For OpenHarmony 應用管理

符合OpenHarmony標準的應用管理：

啟動流程：（1）Qt框架按照Stage模型開發符合Stage-Ability，應用程序通過EntryAbility調用啟動；（2）在QtAbilityStage的onCreate中，使用NAPI機制初始化Qt的Native模塊，并調用App自己的main入口函數，拉起應用邏輯。

退出流程：在EntryAbility的onDestory中，使用NAPI機制通知Qt的QPA模塊，退出Qt Framework的主循環及業務邏輯。

與傳統的C++應用程序不同，遵循Openharmony的北向開發應用管理，需要通過eTS框架完成應用程序C/C++應用程序main函數入口調用啟動。

由于XComponent的動態創建問題，目前QPA的NAPI函數調用放在index.ets中進行調用，該問題還需要與OpenHarmony團隊進行溝通，討論基于OpenHarmony的最優解：（1）基于ETS框架自定義ETS腳本，實現XComponent的動態創建,在ETS框架下實現應用程序窗口管理；（2）基于NDK開發的XComponent的新增接口，在Qt App側實現應用程序的窗口管理。

04?

總結與展望

基于Qt跨平臺特性及Qt For OpenHarmony的適配，能夠促進OpenHarmony跨平臺應用遷移及應用開發，對OpenHarmony技術生態有一定的積極作用，期待大家一塊參與到Qt適配OpenHarmony的相關工作中來。

E N D

審核編輯 黃宇