PyQt/PySide6快速入門 - 3 QML簡介與Qt Creator開發環境

上一篇: PyQt/PySide6快速入門 - 2 使用QWidget設計GUI

QML簡介

QML(Qt Meta-Object Language,Qt元對象語言),Qt推出的Qt Quick技術的一部分,是一種用于描述應用程序用戶界面的聲明式編程語言。 它使用一些可視組件以及這些組件之間的交互來描述用戶界面。QML是一種高可讀性的語言,可以使組件以動態方式進行交互,并且允許組件在用戶界面中很容易地實現復用和自定義。

image.png

QML是Qt Quick (Qt4.7.0+的新特性)核心組件之一:Qt Quick是一組旨在幫助開發者創建在手機、媒體播放器、機頂盒和其他便攜設備上使用越來越多的直觀、現代、流暢UI的工具集合。

如果學過前端開發,會發現QML的思想跟Vue.js、Angula等非常相似。語法格式非常像HTML+CSS,也支持JavaScript形式的編程控制。Qt Designer可以設計出.ui界面文件,但是不支持和Qt原生C++代碼的交互。而Qt Creator可以設計出.qml文件,QML可以和Qt原生代碼進行交互,作為MVC模型中的“View”。

國內Vue.js很普及,后續會出一個完整的QML與Vue的功能對照表,如:生命周期、Component、信號與Slot、計算屬性、Transition動畫、Repeater/V-for等。

MVC開發框架

MVC模式(Model–view–controller)是軟件工程中的一種軟件架構模式,把軟件系統分為三個基本部分:模型(Model)、視圖(View)和控制器(Controller)。

image.png

MVC模式最早由Trygve Reenskaug在1978年提出,是施樂帕羅奧多研究中心(Xerox PARC)在20世紀80年代為程序語言Smalltalk發明的一種軟件架構。MVC模式的目的是實現一種動態的程式設計,使后續對程序的修改和擴展簡化,并且使程序某一部分的重復利用成為可能。除此之外,此模式透過對復雜度的簡化,使程序結構更加直觀及容易擴展和維護。軟件系統透過對自身基本部分分離的同時也賦予了各個基本部分應有的功能。專業人員可以依據自身的專長分組:

  • 模型(Model) - 程序員編寫程序應有的功能(實現算法等等)、數據庫專家進行數據管理和數據庫設計(可以實現具體的功能)。
  • 視圖(View) - 界面設計人員進行圖形界面設計。
  • 控制器(Controller)- 負責轉發請求,對請求進行處理。

在Qt開發中,QML就是作為View(+部分簡單的Model)模塊。而Python/C++則實現Controller+Model功能。

QML開發環境

在安裝完Python(> 3.6)、PySide6之后,其實就可以直接開發簡單的app了。

pip install pyside6

當然,有可視化開發環境會事半功倍,界面開發可使用Qt Creator(注意跟Qt Designer不同,Designer只能設計.ui文件),Python調試則使用PyCharm。

Qt Creator有社區版本,Windows下安裝步驟:

  1. 下載Qt在線安裝程序: qt official_releases/online_installers (qt.io)

  2. 注冊一個Qt賬號

  3. 運行qt-unified-windows-x86-4.3.0-1-online.exe

  4. 選擇自定義安裝Custom installation

image.png
  1. 組件選擇:(這里選擇錯了也沒關系,安裝后可以在程序里找“Qt Maintenance Tool”重新增減組件)
  • Qt 6.3.0 MinGW,用于直接調試C++和 .qml文件
  • 如果你用MS VS的話,可選擇MSVC 2019
  • Qt Creator 7.0.2和相應debug模塊


    image.png

耐心等待安裝完成,大概下載700MB,安裝后占用約4GB空間。

在開始菜單里找到Qt Creator,運行:


image.png

注意:Qt現在推廣Qt Design Studio,所以把Qt Creator里可視化編輯QML的工具給隱藏了,要自行打開:菜單Help --> About Plugins... --> 勾選Designer,重啟程序。

image.png

第一個Py QML程序

Qt Creator: File --> New Project...

  1. 這里有很多模板,第一種“Application (Qt)”,適合C++開發。第二種"Application (Qt for Python)"就是適合Python(PySide6/PyQt)開發的。
  2. 第二列,選擇“Qt Quick Application",使用QML開發,點下一步
  3. 選擇最新的PySide6,點完成

會自動按模板創建3個文件:

pyqml.pyproject

{
    "files": ["main.py", "main.qml"]
}

main.py

import os
from pathlib import Path
import sys

from PySide6.QtGui import QGuiApplication
from PySide6.QtQml import QQmlApplicationEngine

if __name__ == "__main__":
    app = QGuiApplication(sys.argv)
    engine = QQmlApplicationEngine()
    engine.load(os.fspath(Path(__file__).resolve().parent / "main.qml"))
    if not engine.rootObjects():
        sys.exit(-1)
    sys.exit(app.exec_())

這個Python主程序非常簡潔:

  • 引用PySide6。如果是使用PyQt,則直接修改為PyQt6就行
  • 創建Qt主程序:app = QGuiApplication(sys.argv)
  • 創建解析QML的引擎: engine = QQmlApplicationEngine()
  • engine加載QML文件: engine.load("main.qml")
  • app就可以直接運行了

main.qml

import QtQuick
import QtQuick.Window

Window {
    width: 640
    height: 480
    visible: true
    title: qsTr("Hello World")
}

這個QML主界面,內容也非常一目了然:

  • 創建一個Window組件
  • 設置它的屬性:width, height, visible, title。相比.ui文件,是不是簡潔方便多了?
  • 用鼠標點擊.qml里字段,如Window,按"F1",可以直接查詢對應的幫助文檔

如何運行

左邊一列工具欄里,先點擊“Project",選擇Python解釋器(注意確保PySide6已安裝)

image.png

點工具欄左下角綠色運行鍵,第一個Py QML程序就順利運行了:

  • 注意Applicationi Output里,可以查看調試信息
image.png

如果是復雜的Python程序,可以在PyCharm中打開這個目錄,方便調試 .py文件。

點工具欄"Edit",可以編輯源文件,雙擊“main.qml“,這時工具欄 "Design" 就變亮了。

點工具欄"Design",右上角可選顯示方式,一般使用"Essentials" 或 "UX-Design"。

image.png

可視化編輯UI (.qml文件)

左邊"Components"點 "+",添加"QtQuick.Controls,Layouts"等顯示到常用組件


image.png

我們來隨便試試吧:

拖一個"Text"、一個"Button"組件到中間"Form Editor",app主界面上。右邊的"Text Editor"上會自動更新.qml文件。同理,你在外部改動 .qml文件后,預覽也會自動更新。語法跟CSS類似。

給"Button"添加一個onClicked事件,可以看到就是JavaScript語法,實際上,你可以在QML文件里直接寫任意js代碼并調用。當然,Controller控制功能還是建議與View分開。

image.png

保存.qml,再次運行,可以看到界面已經能響應Button點擊了,同時console.log信息也輸出“Application Output”了。

是不是有回到Vue.js寫前端的熟悉感覺了哈?

小貼士:

QML程序在PyCharm里調試,看不到console.log輸出怎么辦?

  • Pycharm打開app目錄
  • 運行main.py
  • 右上角點箭頭:Edit Configurations...
  • Execution: 勾選Emulate terminal in output console
image.png
  • 這樣,python輸出和QML輸出的信息就能同時看到了:
C:\Users\kevinqq\AppData\Local\Programs\Python\Python38\python.exe C:/Users/kevinqq/git/qtProject/pyqml/main.py
<PySide6.QtGui.QWindow(0x22fe7329) at 0x0000022F>
qml: button clicked
qml: button clicked

Process finished with exit code 0

下一篇,使用QML來改寫第2篇的天氣預報程序,涉及信號、動畫

?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 228,546評論 6 533
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 98,570評論 3 418
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 176,505評論 0 376
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 63,017評論 1 313
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 71,786評論 6 410
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 55,219評論 1 324
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,287評論 3 441
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 42,438評論 0 288
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 48,971評論 1 335
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 40,796評論 3 354
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 42,995評論 1 369
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,540評論 5 359
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,230評論 3 347
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 34,662評論 0 26
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 35,918評論 1 286
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 51,697評論 3 392
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 47,991評論 2 374

推薦閱讀更多精彩內容