用自動(dòng)化測(cè)試實(shí)戰(zhàn)：從環(huán)境搭建到Jenkins持續(xù)集成)
1. 項(xiàng)目概述為什么要在麒麟OS上搞QT自動(dòng)化測(cè)試最近幾年國(guó)產(chǎn)化替代的浪潮席卷了各行各業(yè)尤其是在一些對(duì)自主可控要求極高的領(lǐng)域。作為國(guó)產(chǎn)操作系統(tǒng)的代表之一麒麟操作系統(tǒng)包括桌面版和服務(wù)器版的裝機(jī)量和使用場(chǎng)景正在快速增長(zhǎng)。隨之而來(lái)的是大量基于QT框架開發(fā)的圖形界面應(yīng)用需要適配和遷移到麒麟平臺(tái)上。我手頭就接手了好幾個(gè)這樣的項(xiàng)目從工業(yè)控制軟件到數(shù)據(jù)可視化大屏核心邏輯用C界面用QT最終都要在麒麟V10上穩(wěn)定運(yùn)行。這就引出了一個(gè)非常實(shí)際的問(wèn)題如何保證這些移植或新開發(fā)的QT應(yīng)用在麒麟系統(tǒng)上的質(zhì)量靠人工點(diǎn)點(diǎn)點(diǎn)效率低、覆蓋不全、回歸測(cè)試更是噩夢(mèng)。自動(dòng)化測(cè)試是必由之路。但你會(huì)發(fā)現(xiàn)市面上關(guān)于Windows或Ubuntu下QT自動(dòng)化測(cè)試的資料不少可一旦切換到麒麟尤其是ARM架構(gòu)的版本坑就多了起來(lái)。環(huán)境依賴、庫(kù)版本、驅(qū)動(dòng)兼容性每一步都可能讓你掉進(jìn)坑里。這個(gè)項(xiàng)目就是我在多個(gè)實(shí)際項(xiàng)目中趟平了這些坑之后總結(jié)出的一套從環(huán)境搭建、工具選型到腳本編寫、持續(xù)集成的完整解決方案。它不是什么高深的理論而是一份能直接“抄作業(yè)”的實(shí)戰(zhàn)指南目標(biāo)是讓你能在麒麟OS上快速構(gòu)建起可靠、可維護(hù)的QT應(yīng)用自動(dòng)化測(cè)試能力。2. 整體方案設(shè)計(jì)與核心思路拆解面對(duì)“麒麟OS QT應(yīng)用”這個(gè)組合自動(dòng)化測(cè)試方案的設(shè)計(jì)需要同時(shí)考慮操作系統(tǒng)的特性和QT框架的特點(diǎn)。我的核心思路是分層解耦工具鏈適配持續(xù)集成驅(qū)動(dòng)。2.1 分層測(cè)試策略不能指望用一個(gè)工具解決所有問(wèn)題。我將測(cè)試分為三個(gè)層次單元測(cè)試針對(duì)QT應(yīng)用中的核心C業(yè)務(wù)邏輯。這部分通常不涉及GUI目標(biāo)是驗(yàn)證函數(shù)、類的正確性。在麒麟OS上我們繼續(xù)使用經(jīng)典的Google Test (gtest) 或 Catch2 框架。關(guān)鍵在于編譯環(huán)境的配置需要確保測(cè)試代碼和被測(cè)代碼使用相同的麒麟OS原生編譯工具鏈如g和QT庫(kù)進(jìn)行編譯鏈接避免因庫(kù)版本不一致導(dǎo)致測(cè)試結(jié)果失真。GUI功能測(cè)試這是自動(dòng)化測(cè)試的核心模擬用戶對(duì)圖形界面的操作點(diǎn)擊、輸入、拖拽等并驗(yàn)證界面反饋。這是挑戰(zhàn)最大的部分因?yàn)樾枰c麒麟OS的桌面環(huán)境可能是UKUI或KDE和QT的窗口系統(tǒng)深度交互。集成與端到端測(cè)試驗(yàn)證整個(gè)應(yīng)用在麒麟OS環(huán)境下的啟動(dòng)、運(yùn)行、與其他系統(tǒng)服務(wù)如文件系統(tǒng)、網(wǎng)絡(luò)、數(shù)據(jù)庫(kù)的交互是否正常。這部分常結(jié)合一些系統(tǒng)級(jí)腳本和監(jiān)控工具。2.2 工具鏈選型與考量工具選型直接決定了方案的可行性和效率。以下是針對(duì)各層的工具選擇及背后的原因GUI測(cè)試工具Squish 與 AutoIt 的取舍Squish這是功能測(cè)試的“專業(yè)選手”對(duì)QT的支持是原生級(jí)的。它能識(shí)別QT的內(nèi)部控件類型如QPushButton、QLineEdit錄制回放穩(wěn)定對(duì)象識(shí)別能力強(qiáng)支持多種腳本語(yǔ)言Python、JavaScript等。為什么首選它因?yàn)樵邝梓隣S上我們需要工具能穿透桌面環(huán)境直接與QT應(yīng)用通信。Squish的“hook”機(jī)制在這方面做得相對(duì)成熟社區(qū)和商業(yè)支持中也逐漸有了對(duì)Linux ARM架構(gòu)的適配案例。雖然商業(yè)軟件有成本但對(duì)于復(fù)雜、長(zhǎng)期的QT項(xiàng)目其穩(wěn)定性和維護(hù)成本優(yōu)勢(shì)明顯。AutoIt在Windows上是神器但在Linux包括麒麟上它依賴于xdotool等模擬鍵盤鼠標(biāo)的工具屬于“圖像識(shí)別”或“坐標(biāo)點(diǎn)擊”的層面。為什么不作為核心這種方式極其脆弱界面布局一變、分辨率一調(diào)、甚至窗口位置挪動(dòng)腳本就失效了。維護(hù)成本極高僅適合作為非常簡(jiǎn)單的輔助或臨時(shí)方案?；?accessibility (AT-SPI) 的工具如Linux下的pyatspi。理論上QT應(yīng)用可以通過(guò)Qt Accessibility模塊暴露控件信息。實(shí)操難點(diǎn)麒麟OS的桌面環(huán)境對(duì)AT-SPI的支持完整度需要實(shí)測(cè)且控件樹的獲取和操作不如Squish直接和穩(wěn)定開發(fā)調(diào)試復(fù)雜度高。持續(xù)集成/持續(xù)部署CI/CD工具Jenkins為什么是Jenkins成熟、穩(wěn)定、插件生態(tài)豐富。在信創(chuàng)環(huán)境下Jenkins的Java技術(shù)棧兼容性好易于在麒麟服務(wù)器版上通過(guò)Docker或直接安裝部署。我們可以用它來(lái)調(diào)度自動(dòng)化測(cè)試任務(wù)定時(shí)觸發(fā)、代碼提交后觸發(fā)、自動(dòng)獲取測(cè)試報(bào)告并通知。關(guān)鍵集成點(diǎn)在Jenkins任務(wù)中需要調(diào)用在麒麟OS上編譯好的測(cè)試套件gtest單元測(cè)試可執(zhí)行文件和Squish的測(cè)試腳本執(zhí)行器squishrunner。同時(shí)配置好測(cè)試結(jié)果報(bào)告如JUnit格式的收集和展示。輔助工具鏈版本控制Git。無(wú)需多言代碼和測(cè)試腳本的管理基礎(chǔ)。依賴管理對(duì)于項(xiàng)目自身的庫(kù)依賴在麒麟OS上要特別注意。優(yōu)先使用系統(tǒng)包管理器yum或apt取決于麒麟版本安裝的QT和開發(fā)庫(kù)。對(duì)于第三方C庫(kù)盡量采用源碼編譯確保與系統(tǒng)架構(gòu)x86_64或aarch64兼容。虛擬化/容器化VMware或KVM用于創(chuàng)建標(biāo)準(zhǔn)化的麒麟OS測(cè)試鏡像。這是保證測(cè)試環(huán)境一致性的黃金法則。所有測(cè)試都在一個(gè)干凈的、配置好的虛擬機(jī)快照中執(zhí)行避免因宿主機(jī)環(huán)境差異導(dǎo)致的問(wèn)題。3. 環(huán)境搭建與核心配置實(shí)戰(zhàn)理論說(shuō)再多不如動(dòng)手搭一遍。這里以麒麟桌面操作系統(tǒng)V10SP1x86_64版本為例搭建一個(gè)基礎(chǔ)的QT5應(yīng)用自動(dòng)化測(cè)試環(huán)境。3.1 基礎(chǔ)開發(fā)與測(cè)試環(huán)境部署首先需要一個(gè)安裝了麒麟OS的實(shí)體機(jī)或虛擬機(jī)作為測(cè)試機(jī)。確保網(wǎng)絡(luò)通暢并更新系統(tǒng)。# 1. 更新系統(tǒng)包列表和已安裝的包 sudo yum update -y # 2. 安裝必要的開發(fā)工具和庫(kù) # 包括GCC/G編譯工具鏈、CMake、Git等 sudo yum groupinstall -y Development Tools sudo yum install -y cmake git make gcc-c # 3. 安裝QT5開發(fā)環(huán)境 # 麒麟軟件倉(cāng)庫(kù)通常提供了QT5的包 sudo yum install -y qt5-qtbase-devel qt5-qttools-devel qt5-qtmultimedia-devel qt5-qtscript-devel # 根據(jù)你的應(yīng)用需要可能還需要安裝其他qt5模塊如qt5-qtcharts-devel, qt5-qtsvg-devel等 # 可以通過(guò) yum search qt5- 來(lái)查找可用的包 # 4. 驗(yàn)證QT安裝 qmake -v # 應(yīng)輸出QT版本信息例如QMake version 3.1 # Using Qt version 5.12.5 in /usr/lib64/qt5/lib注意麒麟OS不同版本、不同架構(gòu)ARM vs x86的軟件源和包名可能有細(xì)微差異。如果yum找不到某些QT5包可能需要檢查是否已正確配置官方的軟件源或者考慮從QT官網(wǎng)下載在線安裝器進(jìn)行安裝但要注意處理可能的依賴問(wèn)題。3.2 Squish for QT 在麒麟OS上的安裝與配置Squish的安裝是重中之重也是坑最多的地方。獲取安裝包從Squish官網(wǎng)下載對(duì)應(yīng)Linux版本注意區(qū)分x86-64和ARM64的安裝包。通常是一個(gè).run文件。如果你有商業(yè)許可確保下載的版本與許可證匹配。安裝前置依賴Squish運(yùn)行可能需要一些額外的庫(kù)。# 安裝X11、OpenGL等相關(guān)庫(kù)這些是GUI測(cè)試的基礎(chǔ) sudo yum install -y libX11-devel libXext-devel libXrender-devel libXtst-devel mesa-libGL-devel # 安裝字體庫(kù)避免測(cè)試時(shí)因字體缺失導(dǎo)致界面識(shí)別問(wèn)題 sudo yum install -y dejavu-sans-fonts執(zhí)行安裝# 賦予執(zhí)行權(quán)限并運(yùn)行安裝程序 chmod x squish-7.1.0-qt57x-linux64.run ./squish-7.1.0-qt57x-linux64.run跟隨圖形化安裝向?qū)нM(jìn)行操作。建議安裝到用戶目錄下如/home/username/squish避免權(quán)限問(wèn)題。關(guān)鍵配置 - 設(shè)置QT_PLUGIN_PATH這是解決“This application failed to start because no Qt platform plugin could be initialized”錯(cuò)誤的核心。問(wèn)題根源Squish的runner或server在啟動(dòng)時(shí)需要加載QT的平臺(tái)插件如libqxcb.so來(lái)創(chuàng)建GUI環(huán)境。如果它找不到插件就會(huì)報(bào)此錯(cuò)。解決方案明確告訴Squish QT插件在哪里。你需要找到麒麟系統(tǒng)上QT的插件目錄。# 查找qxcb平臺(tái)插件的位置 find /usr -name \*qxcb*\ 2/dev/null # 典型路徑可能是/usr/lib64/qt5/plugins/platforms/libqxcb.so # 或者 /usr/lib/qt5/plugins/platforms/libqxcb.so在啟動(dòng)Squish IDE或Squishserver之前設(shè)置環(huán)境變量export QT_PLUGIN_PATH/usr/lib64/qt5/plugins # 然后啟動(dòng)Squish IDE /home/username/squish/bin/squish 更穩(wěn)妥的做法將這條export命令添加到你的用戶shell配置文件如~/.bashrc中并source ~/.bashrc使其生效。配置被測(cè)應(yīng)用AUT在Squish IDE中創(chuàng)建新的測(cè)試套件。在“被測(cè)應(yīng)用AUT”配置頁(yè)“Wrapper”選項(xiàng)至關(guān)重要。你需要?jiǎng)?chuàng)建一個(gè)簡(jiǎn)單的啟動(dòng)腳本wrapper在這個(gè)腳本里設(shè)置好所有必要的環(huán)境變量然后再啟動(dòng)你的QT應(yīng)用。例如創(chuàng)建一個(gè)myapp_wrapper.sh#!/bin/bash # 設(shè)置QT插件路徑 export QT_PLUGIN_PATH/usr/lib64/qt5/plugins # 設(shè)置QT庫(kù)路徑如果需要 export LD_LIBRARY_PATH/usr/lib64/qt5/lib:$LD_LIBRARY_PATH # 啟動(dòng)你的QT應(yīng)用 /path/to/your/qt/application/myapp在Squish IDE的AUT配置中“可執(zhí)行文件”就指向這個(gè)myapp_wrapper.sh。3.3 單元測(cè)試框架集成Google Test對(duì)于C業(yè)務(wù)邏輯的單元測(cè)試我們集成Google Test。下載與編譯Google Testgit clone https://github.com/google/googletest.git cd googletest mkdir build cd build # 使用麒麟系統(tǒng)自帶的CMake和GCC cmake .. make -j$(nproc) sudo make install # 將gtest庫(kù)安裝到系統(tǒng)目錄通常是/usr/local/lib在CMakeLists.txt中集成gtestcmake_minimum_required(VERSION 3.10) project(MyQtAppTest) # 查找QT5庫(kù) find_package(Qt5 COMPONENTS Core Widgets REQUIRED) # 根據(jù)你的需求添加組件 # 查找GTest find_package(GTest REQUIRED) # 你的主應(yīng)用程序 add_executable(myapp main.cpp mywidget.cpp) target_link_libraries(myapp Qt5::Core Qt5::Widgets) # 你的單元測(cè)試可執(zhí)行文件 add_executable(myapp_test test_business_logic.cpp) target_link_libraries(myapp_test GTest::gtest GTest::gtest_main) # 鏈接你的業(yè)務(wù)邏輯庫(kù)如果有的話 target_link_libraries(myapp_test my_business_logic)編譯與運(yùn)行在麒麟OS上使用上述CMake配置在項(xiàng)目目錄中mkdir build cd build cmake -DCMAKE_PREFIX_PATH/usr/lib64/qt5/lib/cmake .. # 確保CMake能找到麒麟系統(tǒng)的QT make ./myapp_test # 運(yùn)行單元測(cè)試4. 自動(dòng)化測(cè)試腳本開發(fā)與Squish實(shí)戰(zhàn)環(huán)境搭好了接下來(lái)就是編寫真正的自動(dòng)化測(cè)試腳本。這里以使用Squish的Python API為例。4.1 錄制與對(duì)象識(shí)別對(duì)于初學(xué)者或快速創(chuàng)建測(cè)試用例可以使用Squish IDE的錄制功能。啟動(dòng)錄制在Squish IDE中連接到你的測(cè)試機(jī)如果Squish server運(yùn)行在遠(yuǎn)程選擇好測(cè)試套件和用例點(diǎn)擊錄制。操作應(yīng)用在啟動(dòng)的被測(cè)應(yīng)用上執(zhí)行一系列操作如點(diǎn)擊按鈕、在輸入框輸入文字、選擇菜單項(xiàng)等。Squish會(huì)將這些操作轉(zhuǎn)換為腳本語(yǔ)句并捕獲操作對(duì)象的真實(shí)名稱Real Name。理解對(duì)象映射錄制結(jié)束后查看“對(duì)象映射Object Map”。Squish并不是通過(guò)易變的文本或坐標(biāo)來(lái)識(shí)別按鈕而是通過(guò)QT控件的底層屬性如objectName、type、windowTitle等生成一個(gè)唯一的標(biāo)識(shí)符。最佳實(shí)踐是為你需要操作的QT控件設(shè)置唯一的objectName這樣對(duì)象識(shí)別最穩(wěn)定。在QT設(shè)計(jì)師或代碼中pushButton-setObjectName(\loginButton\);在Squish腳本中你就可以用waitForObject(\:loginButton\)來(lái)獲取這個(gè)按鈕對(duì)象。4.2 編寫健壯的測(cè)試腳本錄制生成的腳本往往比較脆弱需要人工優(yōu)化和增強(qiáng)。# 示例一個(gè)登錄功能的自動(dòng)化測(cè)試腳本 (test_login.py) import names def main(): # 1. 啟動(dòng)應(yīng)用已在Squish IDE的AUT中配置 startApplication(\myapp_wrapper\) # 2. 使用對(duì)象真實(shí)名稱等待并獲取控件比直接使用文本更穩(wěn)定 try: username_field waitForObject(names.login_username_Edit) password_field waitForObject(names.login_password_Edit) login_button waitForObject(names.login_login_Button) except LookupError as e: test.fatal(\Failed to find login UI elements\, str(e)) return # 3. 執(zhí)行操作 mouseClick(username_field) # 點(diǎn)擊獲得焦點(diǎn) type(username_field, \testuser\) # 輸入用戶名 type(password_field, \password123\) mouseClick(login_button) # 點(diǎn)擊登錄 # 4. 驗(yàn)證結(jié)果 - 等待登錄后窗口出現(xiàn)或某個(gè)元素狀態(tài)變化 try: # 假設(shè)登錄成功后會(huì)顯示一個(gè)主窗口其objectName為\mainWindow\ main_window waitForObjectExists(names.main_MainWindow, 5000) # 等待5秒 test.passes(\Login successful. Main window appeared.\) # 或者驗(yàn)證某個(gè)歡迎文本 welcome_label waitForObject(names.main_welcome_Label) test.compare(welcome_label.text, \Welcome, testuser!\, \Verify welcome message\) except Exception as e: test.fail(\Login failed or main window did not appear in time\, str(e)) # 可以在這里截圖便于后續(xù)分析 screenshot captureScreenshot() test.attach(screenshot, \Screenshot on login failure\)關(guān)鍵技巧與注意事項(xiàng)使用waitForObject和waitForObjectExists不要使用findObject。waitForObject會(huì)等待對(duì)象出現(xiàn)默認(rèn)最多20秒避免了因界面加載慢導(dǎo)致的腳本失敗。waitForObjectExists同理。善用objectName這是最可靠的識(shí)別屬性。在開發(fā)QT應(yīng)用時(shí)就與開發(fā)人員約定好為關(guān)鍵測(cè)試控件設(shè)置有意義的objectName。處理異步與等待QT應(yīng)用常有異步操作如網(wǎng)絡(luò)請(qǐng)求、文件加載。在關(guān)鍵操作后一定要有明確的等待和驗(yàn)證邏輯而不是簡(jiǎn)單的snooze(幾秒)。錯(cuò)誤處理與日志使用try...except捕獲異常并用test.fatal(),test.fail(),test.passes()等函數(shù)記錄詳細(xì)的測(cè)試結(jié)果。captureScreenshot()在失敗時(shí)截圖是極其寶貴的調(diào)試工具。數(shù)據(jù)驅(qū)動(dòng)將測(cè)試數(shù)據(jù)如用戶名、密碼組合外置到CSV文件或數(shù)據(jù)庫(kù)使用Squish的數(shù)據(jù)驅(qū)動(dòng)測(cè)試功能讓一個(gè)腳本覆蓋多組數(shù)據(jù)。5. 集成到Jenkins實(shí)現(xiàn)持續(xù)測(cè)試單次運(yùn)行測(cè)試不是終點(diǎn)我們的目標(biāo)是讓測(cè)試自動(dòng)化地、持續(xù)地運(yùn)行。這里將Squish測(cè)試集成到Jenkins流水線中。5.1 Jenkins環(huán)境準(zhǔn)備在麒麟服務(wù)器或另一臺(tái)Linux服務(wù)器上安裝Jenkins。建議使用Docker方式最為簡(jiǎn)單。# 拉取Jenkins LTS鏡像 docker pull jenkins/jenkins:lts # 運(yùn)行Jenkins容器映射端口和數(shù)據(jù)卷 docker run -d --name jenkins -p 8080:8080 -p 50000:50000 -v jenkins_home:/var/jenkins_home jenkins/jenkins:lts訪問(wèn)http://your-server-ip:8080完成初始設(shè)置。5.2 配置Jenkins節(jié)點(diǎn)關(guān)鍵我們的測(cè)試需要在麒麟OS測(cè)試機(jī)上執(zhí)行因此需要將該測(cè)試機(jī)配置為Jenkins的代理節(jié)點(diǎn)Agent。在Jenkins管理后臺(tái)“節(jié)點(diǎn)管理” - “新建節(jié)點(diǎn)”。選擇“Permanent Agent”命名如“kylin-qt-test-agent”。配置遠(yuǎn)程工作目錄例如/home/tester/jenkins_workspace。啟動(dòng)方式選擇“Launch agent via SSH”。這是最常用的方式。主機(jī)填寫麒麟測(cè)試機(jī)的IP地址。Credentials添加一個(gè)SSH用戶名/密碼或密鑰憑據(jù)用于Jenkins Master連接到該Agent。主機(jī)密鑰驗(yàn)證策略選擇“Non verifying Verification Strategy”以簡(jiǎn)化生產(chǎn)環(huán)境建議配置已知主機(jī)密鑰。保存后Jenkins會(huì)嘗試通過(guò)SSH連接到麒麟測(cè)試機(jī)并自動(dòng)部署agent程序。確保麒麟測(cè)試機(jī)的sshd服務(wù)已開啟且防火墻允許Jenkins Master的SSH連接。5.3 創(chuàng)建Jenkins Pipeline任務(wù)我們使用Pipeline流水線任務(wù)因?yàn)樗`活可以用代碼Jenkinsfile定義整個(gè)構(gòu)建測(cè)試流程。在Jenkins中新建一個(gè)“Pipeline”類型的任務(wù)。在“Pipeline”配置部分選擇“Pipeline script from SCM”關(guān)聯(lián)到你的代碼倉(cāng)庫(kù)包含QT應(yīng)用代碼和Squish測(cè)試腳本。在項(xiàng)目根目錄創(chuàng)建Jenkinsfilepipeline { agent { label kylin-qt-test-agent // 指定在麒麟測(cè)試節(jié)點(diǎn)上運(yùn)行 } environment { // 定義環(huán)境變量指向測(cè)試機(jī)上的Squish安裝目錄 SQUISH_PREFIX /home/tester/squish AUT_PATH /home/tester/jenkins_workspace/build/myapp // 被測(cè)應(yīng)用路徑 TEST_SUITE_PATH /home/tester/jenkins_workspace/squish_tests/suite_myapp } stages { stage(Checkout) { steps { checkout scm // 拉取代碼 } } stage(Build QT Application) { steps { sh cd ${WORKSPACE} mkdir -p build cd build # 使用麒麟系統(tǒng)的QT進(jìn)行編譯 /usr/lib64/qt5/bin/qmake ../MyApp.pro make -j4 # 將編譯好的應(yīng)用和wrapper腳本復(fù)制到指定位置 cp myapp ${AUT_PATH} cp ../scripts/myapp_wrapper.sh ${AUT_PATH}/ chmod x ${AUT_PATH}/myapp_wrapper.sh } } stage(Run Unit Tests) { steps { sh cd ${WORKSPACE}/build # 運(yùn)行之前集成的gtest單元測(cè)試 ./myapp_test --gtest_output\xml:unit_test_results.xml\ // 收集單元測(cè)試報(bào)告 junit build/unit_test_results.xml } } stage(Run GUI Tests with Squish) { steps { sh # 1. 確保Squish server已啟動(dòng)如果未作為服務(wù)運(yùn)行 # ${SQUISH_PREFIX}/bin/squishserver --daemon # 2. 設(shè)置必要的環(huán)境變量特別是QT_PLUGIN_PATH export QT_PLUGIN_PATH/usr/lib64/qt5/plugins export LD_LIBRARY_PATH${SQUISH_PREFIX}/lib:${LD_LIBRARY_PATH} # 3. 使用squishrunner執(zhí)行測(cè)試套件 # --testsuite 指定測(cè)試套件路徑 # --reportgen 指定報(bào)告格式和路徑 ${SQUISH_PREFIX}/bin/squishrunner \ --testsuite ${TEST_SUITE_PATH} \ --reportgen junit,${WORKSPACE}/squish_results.xml \ --reportgen html,${WORKSPACE}/squish_report // 收集Squish生成的JUnit格式報(bào)告 junit squish_results.xml // 歸檔HTML報(bào)告便于在Jenkins中直接瀏覽 publishHTML(target: [ reportName: Squish GUI Test Report, reportDir: squish_report, reportFiles: index.html, keepAll: true ]) } } } post { always { // 無(wú)論成功失敗都清理可能殘留的進(jìn)程 sh pkill -f myapp || true # ${SQUISH_PREFIX}/bin/squishserver --stop // 可以在這里添加郵件通知等 } } }這個(gè)流水線定義了完整的流程在麒麟測(cè)試節(jié)點(diǎn)上拉取代碼 - 編譯QT應(yīng)用 - 運(yùn)行單元測(cè)試 - 運(yùn)行Squish GUI測(cè)試 - 收集并發(fā)布測(cè)試報(bào)告。6. 常見(jiàn)問(wèn)題排查與實(shí)戰(zhàn)心得在實(shí)際部署和運(yùn)行過(guò)程中我遇到了無(wú)數(shù)問(wèn)題。這里把最典型、最棘手的幾個(gè)列出來(lái)并附上排查思路和解決方案。6.1 環(huán)境與依賴問(wèn)題問(wèn)題1Squish啟動(dòng)被測(cè)應(yīng)用時(shí)報(bào)錯(cuò) “This application failed to start because no Qt platform plugin could be initialized.”排查這是最經(jīng)典的錯(cuò)誤。根本原因是Squish或啟動(dòng)環(huán)境找不到QT的平臺(tái)插件如libqxcb.so。解決確認(rèn)插件路徑在麒麟終端執(zhí)行find /usr -name \*qxcb*\找到確切路徑。設(shè)置環(huán)境變量在啟動(dòng)Squish IDE、squishserver或squishrunner的shell中必須設(shè)置export QT_PLUGIN_PATH/path/to/your/qt/plugins。使用Wrapper腳本對(duì)于被測(cè)應(yīng)用AUT務(wù)必使用一個(gè)wrapper腳本在其中設(shè)置好QT_PLUGIN_PATH和可能的LD_LIBRARY_PATH指向QT庫(kù)目錄再啟動(dòng)你的應(yīng)用。檢查架構(gòu)確保Squish版本、QT庫(kù)、平臺(tái)插件的架構(gòu)x86_64 vs aarch64一致。問(wèn)題2Squish可以啟動(dòng)應(yīng)用但錄制/回放時(shí)無(wú)法識(shí)別任何控件對(duì)象探查器里一片空白。排查Squish的“注入”injection可能失敗了。Squish需要向被測(cè)進(jìn)程注入代碼以獲取控件信息。解決檢查Squish版本兼容性確保你使用的Squish版本支持你QT應(yīng)用所使用的QT版本如Squish for Qt 5.7-5.15。檢查應(yīng)用啟動(dòng)參數(shù)有些應(yīng)用在啟動(dòng)時(shí)帶有-platform參數(shù)如-platform xcb需要確保Squish的AUT配置中包含了這些參數(shù)。以非root用戶運(yùn)行盡量避免使用root權(quán)限運(yùn)行Squish和被測(cè)應(yīng)用某些系統(tǒng)安全策略如AppArmor, SELinux可能會(huì)阻止注入。在麒麟OS上檢查SELinux狀態(tài)getenforce如果是Enforcing模式嘗試設(shè)置為Permissivesetenforce 0測(cè)試是否是它的問(wèn)題。查看Squish日志Squish的server和runner會(huì)生成日志通常在~/.squish/目錄下。查看這些日志里面常有詳細(xì)的錯(cuò)誤信息。6.2 測(cè)試腳本穩(wěn)定性問(wèn)題問(wèn)題3腳本回放時(shí)有時(shí)成功有時(shí)失敗錯(cuò)誤是找不到對(duì)象ObjectNotFound。排查界面加載時(shí)間不穩(wěn)定或者對(duì)象屬性動(dòng)態(tài)變化。解決強(qiáng)化等待邏輯將所有的findObject()替換為waitForObject()或waitForObjectExists()并合理設(shè)置超時(shí)時(shí)間。使用更穩(wěn)定的對(duì)象屬性優(yōu)先使用開發(fā)人員設(shè)置的objectName。如果只能用文本考慮使用正則表達(dá)式或子字符串匹配來(lái)應(yīng)對(duì)微小的文本變化。同步點(diǎn)Sync Point在關(guān)鍵操作后如點(diǎn)擊一個(gè)會(huì)觸發(fā)長(zhǎng)時(shí)間計(jì)算的按鈕插入一個(gè)同步點(diǎn)等待某個(gè)特定條件滿足如進(jìn)度條消失、某個(gè)狀態(tài)文本出現(xiàn)后再繼續(xù)。避免絕對(duì)坐標(biāo)絕對(duì)不要依賴mouseClick(x, y)這種基于坐標(biāo)的操作。問(wèn)題4測(cè)試過(guò)程中應(yīng)用彈出意外對(duì)話框如錯(cuò)誤提示、確認(rèn)框?qū)е潞罄m(xù)腳本失敗。解決異常處理在可能出錯(cuò)的操作周圍使用try...except捕獲ObjectNotFound等異常。對(duì)話框處理函數(shù)編寫一個(gè)通用的函數(shù)在腳本開始時(shí)設(shè)置setPopupHandler用于處理預(yù)期外的彈出框。例如自動(dòng)點(diǎn)擊“確定”或“取消”并記錄日志。前置條件清理在測(cè)試用例開始前確保應(yīng)用處于一個(gè)干凈的狀態(tài)。可以編寫一個(gè)setUp函數(shù)強(qiáng)制關(guān)閉可能殘留的應(yīng)用進(jìn)程清理臨時(shí)文件等。6.3 性能與架構(gòu)問(wèn)題問(wèn)題5GUI自動(dòng)化測(cè)試執(zhí)行速度慢尤其是大量用例時(shí)。解決測(cè)試用例設(shè)計(jì)保持用例獨(dú)立但也要設(shè)計(jì)一些更長(zhǎng)的“流程用例”減少不必要的應(yīng)用重啟啟動(dòng)耗時(shí)最長(zhǎng)。使用無(wú)頭模式Headless或虛擬幀緩沖如果應(yīng)用不需要真正的圖形顯示僅做功能驗(yàn)證可以考慮在無(wú)圖形界面的服務(wù)器上使用Xvfb虛擬X服務(wù)器來(lái)運(yùn)行測(cè)試。這可以節(jié)省大量GUI渲染資源并允許在無(wú)顯示器的環(huán)境下執(zhí)行。# 安裝Xvfb sudo yum install -y xorg-x11-server-Xvfb # 在啟動(dòng)測(cè)試前先啟動(dòng)Xvfb Xvfb :99 -screen 0 1024x768x24 export DISPLAY:99 # 然后在此環(huán)境中啟動(dòng)Squish runner和你的應(yīng)用并行測(cè)試如果測(cè)試套件支持可以利用Squish的分布式測(cè)試功能或Jenkins的并行階段在多臺(tái)測(cè)試機(jī)上同時(shí)運(yùn)行不同的測(cè)試集。問(wèn)題6ARM架構(gòu)如飛騰處理器的麒麟OS與x86環(huán)境有何不同核心差異指令集不同所有二進(jìn)制軟件包包括QT庫(kù)、Squish、你的應(yīng)用都必須使用ARM64aarch64版本重新編譯。實(shí)操要點(diǎn)Squish安裝包必須下載Linux ARM64版本的Squish。QT庫(kù)在ARM版麒麟OS上通過(guò)系統(tǒng)包管理器安裝的QT庫(kù)自然是ARM版本。如果你需要自定義QT版本必須從源碼在ARM機(jī)器上編譯。第三方庫(kù)項(xiàng)目依賴的所有第三方C/C庫(kù)都必須在ARM環(huán)境下重新編譯。編譯工具鏈?zhǔn)褂孟到y(tǒng)自帶的g/gcc即可它們會(huì)生成ARM原生代碼。性能初期可能遇到一些庫(kù)的ARM優(yōu)化不如x86導(dǎo)致應(yīng)用或測(cè)試工具性能稍差需要關(guān)注。這套方案不是一成不變的需要根據(jù)具體的項(xiàng)目需求、團(tuán)隊(duì)技能和基礎(chǔ)設(shè)施進(jìn)行調(diào)整。但它的核心價(jià)值在于提供了一條經(jīng)過(guò)驗(yàn)證的、從零到一在麒麟操作系統(tǒng)上建立QT應(yīng)用自動(dòng)化測(cè)試能力的路徑。記住自動(dòng)化測(cè)試是一個(gè)持續(xù)投入和優(yōu)化的過(guò)程早期的環(huán)境搭建和腳本編寫投入會(huì)在后續(xù)無(wú)數(shù)次的回歸測(cè)試中帶來(lái)巨大的回報(bào)。尤其是在國(guó)產(chǎn)化替代這個(gè)長(zhǎng)期而堅(jiān)定的趨勢(shì)下?lián)碛羞@樣一套穩(wěn)定的質(zhì)量保障體系無(wú)疑會(huì)讓你和你的團(tuán)隊(duì)更加從容。 麒麟OS上QT應(yīng)用自動(dòng)化測(cè)試實(shí)戰(zhàn)：從環(huán)境搭建到Jenkins持續(xù)集成
1. 項(xiàng)目概述為什么要在麒麟OS上搞QT自動(dòng)化測(cè)試最近幾年國(guó)產(chǎn)化替代的浪潮席卷了各行各業(yè)尤其是在一些對(duì)自主可控要求極高的領(lǐng)域。作為國(guó)產(chǎn)操作系統(tǒng)的代表之一麒麟操作系統(tǒng)包括桌面版和服務(wù)器版的裝機(jī)量和使用場(chǎng)景正在快速增長(zhǎng)。隨之而來(lái)的是大量基于QT框架開發(fā)的圖形界面應(yīng)用需要適配和遷移到麒麟平臺(tái)上。我手頭就接手了好幾個(gè)這樣的項(xiàng)目從工業(yè)控制軟件到數(shù)據(jù)可視化大屏核心邏輯用C界面用QT最終都要在麒麟V10上穩(wěn)定運(yùn)行。這就引出了一個(gè)非常實(shí)際的問(wèn)題如何保證這些移植或新開發(fā)的QT應(yīng)用在麒麟系統(tǒng)上的質(zhì)量靠人工點(diǎn)點(diǎn)點(diǎn)效率低、覆蓋不全、回歸測(cè)試更是噩夢(mèng)。自動(dòng)化測(cè)試是必由之路。但你會(huì)發(fā)現(xiàn)市面上關(guān)于Windows或Ubuntu下QT自動(dòng)化測(cè)試的資料不少可一旦切換到麒麟尤其是ARM架構(gòu)的版本坑就多了起來(lái)。環(huán)境依賴、庫(kù)版本、驅(qū)動(dòng)兼容性每一步都可能讓你掉進(jìn)坑里。這個(gè)項(xiàng)目就是我在多個(gè)實(shí)際項(xiàng)目中趟平了這些坑之后總結(jié)出的一套從環(huán)境搭建、工具選型到腳本編寫、持續(xù)集成的完整解決方案。它不是什么高深的理論而是一份能直接“抄作業(yè)”的實(shí)戰(zhàn)指南目標(biāo)是讓你能在麒麟OS上快速構(gòu)建起可靠、可維護(hù)的QT應(yīng)用自動(dòng)化測(cè)試能力。2. 整體方案設(shè)計(jì)與核心思路拆解面對(duì)“麒麟OS QT應(yīng)用”這個(gè)組合自動(dòng)化測(cè)試方案的設(shè)計(jì)需要同時(shí)考慮操作系統(tǒng)的特性和QT框架的特點(diǎn)。我的核心思路是分層解耦工具鏈適配持續(xù)集成驅(qū)動(dòng)。2.1 分層測(cè)試策略不能指望用一個(gè)工具解決所有問(wèn)題。我將測(cè)試分為三個(gè)層次單元測(cè)試針對(duì)QT應(yīng)用中的核心C業(yè)務(wù)邏輯。這部分通常不涉及GUI目標(biāo)是驗(yàn)證函數(shù)、類的正確性。在麒麟OS上我們繼續(xù)使用經(jīng)典的Google Test (gtest) 或 Catch2 框架。關(guān)鍵在于編譯環(huán)境的配置需要確保測(cè)試代碼和被測(cè)代碼使用相同的麒麟OS原生編譯工具鏈如g和QT庫(kù)進(jìn)行編譯鏈接避免因庫(kù)版本不一致導(dǎo)致測(cè)試結(jié)果失真。GUI功能測(cè)試這是自動(dòng)化測(cè)試的核心模擬用戶對(duì)圖形界面的操作點(diǎn)擊、輸入、拖拽等并驗(yàn)證界面反饋。這是挑戰(zhàn)最大的部分因?yàn)樾枰c麒麟OS的桌面環(huán)境可能是UKUI或KDE和QT的窗口系統(tǒng)深度交互。集成與端到端測(cè)試驗(yàn)證整個(gè)應(yīng)用在麒麟OS環(huán)境下的啟動(dòng)、運(yùn)行、與其他系統(tǒng)服務(wù)如文件系統(tǒng)、網(wǎng)絡(luò)、數(shù)據(jù)庫(kù)的交互是否正常。這部分常結(jié)合一些系統(tǒng)級(jí)腳本和監(jiān)控工具。2.2 工具鏈選型與考量工具選型直接決定了方案的可行性和效率。以下是針對(duì)各層的工具選擇及背后的原因GUI測(cè)試工具Squish 與 AutoIt 的取舍Squish這是功能測(cè)試的“專業(yè)選手”對(duì)QT的支持是原生級(jí)的。它能識(shí)別QT的內(nèi)部控件類型如QPushButton、QLineEdit錄制回放穩(wěn)定對(duì)象識(shí)別能力強(qiáng)支持多種腳本語(yǔ)言Python、JavaScript等。為什么首選它因?yàn)樵邝梓隣S上我們需要工具能穿透桌面環(huán)境直接與QT應(yīng)用通信。Squish的“hook”機(jī)制在這方面做得相對(duì)成熟社區(qū)和商業(yè)支持中也逐漸有了對(duì)Linux ARM架構(gòu)的適配案例。雖然商業(yè)軟件有成本但對(duì)于復(fù)雜、長(zhǎng)期的QT項(xiàng)目其穩(wěn)定性和維護(hù)成本優(yōu)勢(shì)明顯。AutoIt在Windows上是神器但在Linux包括麒麟上它依賴于xdotool等模擬鍵盤鼠標(biāo)的工具屬于“圖像識(shí)別”或“坐標(biāo)點(diǎn)擊”的層面。為什么不作為核心這種方式極其脆弱界面布局一變、分辨率一調(diào)、甚至窗口位置挪動(dòng)腳本就失效了。維護(hù)成本極高僅適合作為非常簡(jiǎn)單的輔助或臨時(shí)方案?；?accessibility (AT-SPI) 的工具如Linux下的pyatspi。理論上QT應(yīng)用可以通過(guò)Qt Accessibility模塊暴露控件信息。實(shí)操難點(diǎn)麒麟OS的桌面環(huán)境對(duì)AT-SPI的支持完整度需要實(shí)測(cè)且控件樹的獲取和操作不如Squish直接和穩(wěn)定開發(fā)調(diào)試復(fù)雜度高。持續(xù)集成/持續(xù)部署CI/CD工具Jenkins為什么是Jenkins成熟、穩(wěn)定、插件生態(tài)豐富。在信創(chuàng)環(huán)境下Jenkins的Java技術(shù)棧兼容性好易于在麒麟服務(wù)器版上通過(guò)Docker或直接安裝部署。我們可以用它來(lái)調(diào)度自動(dòng)化測(cè)試任務(wù)定時(shí)觸發(fā)、代碼提交后觸發(fā)、自動(dòng)獲取測(cè)試報(bào)告并通知。關(guān)鍵集成點(diǎn)在Jenkins任務(wù)中需要調(diào)用在麒麟OS上編譯好的測(cè)試套件gtest單元測(cè)試可執(zhí)行文件和Squish的測(cè)試腳本執(zhí)行器squishrunner。同時(shí)配置好測(cè)試結(jié)果報(bào)告如JUnit格式的收集和展示。輔助工具鏈版本控制Git。無(wú)需多言代碼和測(cè)試腳本的管理基礎(chǔ)。依賴管理對(duì)于項(xiàng)目自身的庫(kù)依賴在麒麟OS上要特別注意。優(yōu)先使用系統(tǒng)包管理器yum或apt取決于麒麟版本安裝的QT和開發(fā)庫(kù)。對(duì)于第三方C庫(kù)盡量采用源碼編譯確保與系統(tǒng)架構(gòu)x86_64或aarch64兼容。虛擬化/容器化VMware或KVM用于創(chuàng)建標(biāo)準(zhǔn)化的麒麟OS測(cè)試鏡像。這是保證測(cè)試環(huán)境一致性的黃金法則。所有測(cè)試都在一個(gè)干凈的、配置好的虛擬機(jī)快照中執(zhí)行避免因宿主機(jī)環(huán)境差異導(dǎo)致的問(wèn)題。3. 環(huán)境搭建與核心配置實(shí)戰(zhàn)理論說(shuō)再多不如動(dòng)手搭一遍。這里以麒麟桌面操作系統(tǒng)V10SP1x86_64版本為例搭建一個(gè)基礎(chǔ)的QT5應(yīng)用自動(dòng)化測(cè)試環(huán)境。3.1 基礎(chǔ)開發(fā)與測(cè)試環(huán)境部署首先需要一個(gè)安裝了麒麟OS的實(shí)體機(jī)或虛擬機(jī)作為測(cè)試機(jī)。確保網(wǎng)絡(luò)通暢并更新系統(tǒng)。# 1. 更新系統(tǒng)包列表和已安裝的包 sudo yum update -y # 2. 安裝必要的開發(fā)工具和庫(kù) # 包括GCC/G編譯工具鏈、CMake、Git等 sudo yum groupinstall -y Development Tools sudo yum install -y cmake git make gcc-c # 3. 安裝QT5開發(fā)環(huán)境 # 麒麟軟件倉(cāng)庫(kù)通常提供了QT5的包 sudo yum install -y qt5-qtbase-devel qt5-qttools-devel qt5-qtmultimedia-devel qt5-qtscript-devel # 根據(jù)你的應(yīng)用需要可能還需要安裝其他qt5模塊如qt5-qtcharts-devel, qt5-qtsvg-devel等 # 可以通過(guò) yum search qt5- 來(lái)查找可用的包 # 4. 驗(yàn)證QT安裝 qmake -v # 應(yīng)輸出QT版本信息例如QMake version 3.1 # Using Qt version 5.12.5 in /usr/lib64/qt5/lib注意麒麟OS不同版本、不同架構(gòu)ARM vs x86的軟件源和包名可能有細(xì)微差異。如果yum找不到某些QT5包可能需要檢查是否已正確配置官方的軟件源或者考慮從QT官網(wǎng)下載在線安裝器進(jìn)行安裝但要注意處理可能的依賴問(wèn)題。3.2 Squish for QT 在麒麟OS上的安裝與配置Squish的安裝是重中之重也是坑最多的地方。獲取安裝包從Squish官網(wǎng)下載對(duì)應(yīng)Linux版本注意區(qū)分x86-64和ARM64的安裝包。通常是一個(gè).run文件。如果你有商業(yè)許可確保下載的版本與許可證匹配。安裝前置依賴Squish運(yùn)行可能需要一些額外的庫(kù)。# 安裝X11、OpenGL等相關(guān)庫(kù)這些是GUI測(cè)試的基礎(chǔ) sudo yum install -y libX11-devel libXext-devel libXrender-devel libXtst-devel mesa-libGL-devel # 安裝字體庫(kù)避免測(cè)試時(shí)因字體缺失導(dǎo)致界面識(shí)別問(wèn)題 sudo yum install -y dejavu-sans-fonts執(zhí)行安裝# 賦予執(zhí)行權(quán)限并運(yùn)行安裝程序 chmod x squish-7.1.0-qt57x-linux64.run ./squish-7.1.0-qt57x-linux64.run跟隨圖形化安裝向?qū)нM(jìn)行操作。建議安裝到用戶目錄下如/home/username/squish避免權(quán)限問(wèn)題。關(guān)鍵配置 - 設(shè)置QT_PLUGIN_PATH這是解決“This application failed to start because no Qt platform plugin could be initialized”錯(cuò)誤的核心。問(wèn)題根源Squish的runner或server在啟動(dòng)時(shí)需要加載QT的平臺(tái)插件如libqxcb.so來(lái)創(chuàng)建GUI環(huán)境。如果它找不到插件就會(huì)報(bào)此錯(cuò)。解決方案明確告訴Squish QT插件在哪里。你需要找到麒麟系統(tǒng)上QT的插件目錄。# 查找qxcb平臺(tái)插件的位置 find /usr -name \*qxcb*\ 2/dev/null # 典型路徑可能是/usr/lib64/qt5/plugins/platforms/libqxcb.so # 或者 /usr/lib/qt5/plugins/platforms/libqxcb.so在啟動(dòng)Squish IDE或Squishserver之前設(shè)置環(huán)境變量export QT_PLUGIN_PATH/usr/lib64/qt5/plugins # 然后啟動(dòng)Squish IDE /home/username/squish/bin/squish 更穩(wěn)妥的做法將這條export命令添加到你的用戶shell配置文件如~/.bashrc中并source ~/.bashrc使其生效。配置被測(cè)應(yīng)用AUT在Squish IDE中創(chuàng)建新的測(cè)試套件。在“被測(cè)應(yīng)用AUT”配置頁(yè)“Wrapper”選項(xiàng)至關(guān)重要。你需要?jiǎng)?chuàng)建一個(gè)簡(jiǎn)單的啟動(dòng)腳本wrapper在這個(gè)腳本里設(shè)置好所有必要的環(huán)境變量然后再啟動(dòng)你的QT應(yīng)用。例如創(chuàng)建一個(gè)myapp_wrapper.sh#!/bin/bash # 設(shè)置QT插件路徑 export QT_PLUGIN_PATH/usr/lib64/qt5/plugins # 設(shè)置QT庫(kù)路徑如果需要 export LD_LIBRARY_PATH/usr/lib64/qt5/lib:$LD_LIBRARY_PATH # 啟動(dòng)你的QT應(yīng)用 /path/to/your/qt/application/myapp在Squish IDE的AUT配置中“可執(zhí)行文件”就指向這個(gè)myapp_wrapper.sh。3.3 單元測(cè)試框架集成Google Test對(duì)于C業(yè)務(wù)邏輯的單元測(cè)試我們集成Google Test。下載與編譯Google Testgit clone https://github.com/google/googletest.git cd googletest mkdir build cd build # 使用麒麟系統(tǒng)自帶的CMake和GCC cmake .. make -j$(nproc) sudo make install # 將gtest庫(kù)安裝到系統(tǒng)目錄通常是/usr/local/lib在CMakeLists.txt中集成gtestcmake_minimum_required(VERSION 3.10) project(MyQtAppTest) # 查找QT5庫(kù) find_package(Qt5 COMPONENTS Core Widgets REQUIRED) # 根據(jù)你的需求添加組件 # 查找GTest find_package(GTest REQUIRED) # 你的主應(yīng)用程序 add_executable(myapp main.cpp mywidget.cpp) target_link_libraries(myapp Qt5::Core Qt5::Widgets) # 你的單元測(cè)試可執(zhí)行文件 add_executable(myapp_test test_business_logic.cpp) target_link_libraries(myapp_test GTest::gtest GTest::gtest_main) # 鏈接你的業(yè)務(wù)邏輯庫(kù)如果有的話 target_link_libraries(myapp_test my_business_logic)編譯與運(yùn)行在麒麟OS上使用上述CMake配置在項(xiàng)目目錄中mkdir build cd build cmake -DCMAKE_PREFIX_PATH/usr/lib64/qt5/lib/cmake .. # 確保CMake能找到麒麟系統(tǒng)的QT make ./myapp_test # 運(yùn)行單元測(cè)試4. 自動(dòng)化測(cè)試腳本開發(fā)與Squish實(shí)戰(zhàn)環(huán)境搭好了接下來(lái)就是編寫真正的自動(dòng)化測(cè)試腳本。這里以使用Squish的Python API為例。4.1 錄制與對(duì)象識(shí)別對(duì)于初學(xué)者或快速創(chuàng)建測(cè)試用例可以使用Squish IDE的錄制功能。啟動(dòng)錄制在Squish IDE中連接到你的測(cè)試機(jī)如果Squish server運(yùn)行在遠(yuǎn)程選擇好測(cè)試套件和用例點(diǎn)擊錄制。操作應(yīng)用在啟動(dòng)的被測(cè)應(yīng)用上執(zhí)行一系列操作如點(diǎn)擊按鈕、在輸入框輸入文字、選擇菜單項(xiàng)等。Squish會(huì)將這些操作轉(zhuǎn)換為腳本語(yǔ)句并捕獲操作對(duì)象的真實(shí)名稱Real Name。理解對(duì)象映射錄制結(jié)束后查看“對(duì)象映射Object Map”。Squish并不是通過(guò)易變的文本或坐標(biāo)來(lái)識(shí)別按鈕而是通過(guò)QT控件的底層屬性如objectName、type、windowTitle等生成一個(gè)唯一的標(biāo)識(shí)符。最佳實(shí)踐是為你需要操作的QT控件設(shè)置唯一的objectName這樣對(duì)象識(shí)別最穩(wěn)定。在QT設(shè)計(jì)師或代碼中pushButton-setObjectName(\loginButton\);在Squish腳本中你就可以用waitForObject(\:loginButton\)來(lái)獲取這個(gè)按鈕對(duì)象。4.2 編寫健壯的測(cè)試腳本錄制生成的腳本往往比較脆弱需要人工優(yōu)化和增強(qiáng)。# 示例一個(gè)登錄功能的自動(dòng)化測(cè)試腳本 (test_login.py) import names def main(): # 1. 啟動(dòng)應(yīng)用已在Squish IDE的AUT中配置 startApplication(\myapp_wrapper\) # 2. 使用對(duì)象真實(shí)名稱等待并獲取控件比直接使用文本更穩(wěn)定 try: username_field waitForObject(names.login_username_Edit) password_field waitForObject(names.login_password_Edit) login_button waitForObject(names.login_login_Button) except LookupError as e: test.fatal(\Failed to find login UI elements\, str(e)) return # 3. 執(zhí)行操作 mouseClick(username_field) # 點(diǎn)擊獲得焦點(diǎn) type(username_field, \testuser\) # 輸入用戶名 type(password_field, \password123\) mouseClick(login_button) # 點(diǎn)擊登錄 # 4. 驗(yàn)證結(jié)果 - 等待登錄后窗口出現(xiàn)或某個(gè)元素狀態(tài)變化 try: # 假設(shè)登錄成功后會(huì)顯示一個(gè)主窗口其objectName為\mainWindow\ main_window waitForObjectExists(names.main_MainWindow, 5000) # 等待5秒 test.passes(\Login successful. Main window appeared.\) # 或者驗(yàn)證某個(gè)歡迎文本 welcome_label waitForObject(names.main_welcome_Label) test.compare(welcome_label.text, \Welcome, testuser!\, \Verify welcome message\) except Exception as e: test.fail(\Login failed or main window did not appear in time\, str(e)) # 可以在這里截圖便于后續(xù)分析 screenshot captureScreenshot() test.attach(screenshot, \Screenshot on login failure\)關(guān)鍵技巧與注意事項(xiàng)使用waitForObject和waitForObjectExists不要使用findObject。waitForObject會(huì)等待對(duì)象出現(xiàn)默認(rèn)最多20秒避免了因界面加載慢導(dǎo)致的腳本失敗。waitForObjectExists同理。善用objectName這是最可靠的識(shí)別屬性。在開發(fā)QT應(yīng)用時(shí)就與開發(fā)人員約定好為關(guān)鍵測(cè)試控件設(shè)置有意義的objectName。處理異步與等待QT應(yīng)用常有異步操作如網(wǎng)絡(luò)請(qǐng)求、文件加載。在關(guān)鍵操作后一定要有明確的等待和驗(yàn)證邏輯而不是簡(jiǎn)單的snooze(幾秒)。錯(cuò)誤處理與日志使用try...except捕獲異常并用test.fatal(),test.fail(),test.passes()等函數(shù)記錄詳細(xì)的測(cè)試結(jié)果。captureScreenshot()在失敗時(shí)截圖是極其寶貴的調(diào)試工具。數(shù)據(jù)驅(qū)動(dòng)將測(cè)試數(shù)據(jù)如用戶名、密碼組合外置到CSV文件或數(shù)據(jù)庫(kù)使用Squish的數(shù)據(jù)驅(qū)動(dòng)測(cè)試功能讓一個(gè)腳本覆蓋多組數(shù)據(jù)。5. 集成到Jenkins實(shí)現(xiàn)持續(xù)測(cè)試單次運(yùn)行測(cè)試不是終點(diǎn)我們的目標(biāo)是讓測(cè)試自動(dòng)化地、持續(xù)地運(yùn)行。這里將Squish測(cè)試集成到Jenkins流水線中。5.1 Jenkins環(huán)境準(zhǔn)備在麒麟服務(wù)器或另一臺(tái)Linux服務(wù)器上安裝Jenkins。建議使用Docker方式最為簡(jiǎn)單。# 拉取Jenkins LTS鏡像 docker pull jenkins/jenkins:lts # 運(yùn)行Jenkins容器映射端口和數(shù)據(jù)卷 docker run -d --name jenkins -p 8080:8080 -p 50000:50000 -v jenkins_home:/var/jenkins_home jenkins/jenkins:lts訪問(wèn)http://your-server-ip:8080完成初始設(shè)置。5.2 配置Jenkins節(jié)點(diǎn)關(guān)鍵我們的測(cè)試需要在麒麟OS測(cè)試機(jī)上執(zhí)行因此需要將該測(cè)試機(jī)配置為Jenkins的代理節(jié)點(diǎn)Agent。在Jenkins管理后臺(tái)“節(jié)點(diǎn)管理” - “新建節(jié)點(diǎn)”。選擇“Permanent Agent”命名如“kylin-qt-test-agent”。配置遠(yuǎn)程工作目錄例如/home/tester/jenkins_workspace。啟動(dòng)方式選擇“Launch agent via SSH”。這是最常用的方式。主機(jī)填寫麒麟測(cè)試機(jī)的IP地址。Credentials添加一個(gè)SSH用戶名/密碼或密鑰憑據(jù)用于Jenkins Master連接到該Agent。主機(jī)密鑰驗(yàn)證策略選擇“Non verifying Verification Strategy”以簡(jiǎn)化生產(chǎn)環(huán)境建議配置已知主機(jī)密鑰。保存后Jenkins會(huì)嘗試通過(guò)SSH連接到麒麟測(cè)試機(jī)并自動(dòng)部署agent程序。確保麒麟測(cè)試機(jī)的sshd服務(wù)已開啟且防火墻允許Jenkins Master的SSH連接。5.3 創(chuàng)建Jenkins Pipeline任務(wù)我們使用Pipeline流水線任務(wù)因?yàn)樗`活可以用代碼Jenkinsfile定義整個(gè)構(gòu)建測(cè)試流程。在Jenkins中新建一個(gè)“Pipeline”類型的任務(wù)。在“Pipeline”配置部分選擇“Pipeline script from SCM”關(guān)聯(lián)到你的代碼倉(cāng)庫(kù)包含QT應(yīng)用代碼和Squish測(cè)試腳本。在項(xiàng)目根目錄創(chuàng)建Jenkinsfilepipeline { agent { label kylin-qt-test-agent // 指定在麒麟測(cè)試節(jié)點(diǎn)上運(yùn)行 } environment { // 定義環(huán)境變量指向測(cè)試機(jī)上的Squish安裝目錄 SQUISH_PREFIX /home/tester/squish AUT_PATH /home/tester/jenkins_workspace/build/myapp // 被測(cè)應(yīng)用路徑 TEST_SUITE_PATH /home/tester/jenkins_workspace/squish_tests/suite_myapp } stages { stage(Checkout) { steps { checkout scm // 拉取代碼 } } stage(Build QT Application) { steps { sh cd ${WORKSPACE} mkdir -p build cd build # 使用麒麟系統(tǒng)的QT進(jìn)行編譯 /usr/lib64/qt5/bin/qmake ../MyApp.pro make -j4 # 將編譯好的應(yīng)用和wrapper腳本復(fù)制到指定位置 cp myapp ${AUT_PATH} cp ../scripts/myapp_wrapper.sh ${AUT_PATH}/ chmod x ${AUT_PATH}/myapp_wrapper.sh } } stage(Run Unit Tests) { steps { sh cd ${WORKSPACE}/build # 運(yùn)行之前集成的gtest單元測(cè)試 ./myapp_test --gtest_output\xml:unit_test_results.xml\ // 收集單元測(cè)試報(bào)告 junit build/unit_test_results.xml } } stage(Run GUI Tests with Squish) { steps { sh # 1. 確保Squish server已啟動(dòng)如果未作為服務(wù)運(yùn)行 # ${SQUISH_PREFIX}/bin/squishserver --daemon # 2. 設(shè)置必要的環(huán)境變量特別是QT_PLUGIN_PATH export QT_PLUGIN_PATH/usr/lib64/qt5/plugins export LD_LIBRARY_PATH${SQUISH_PREFIX}/lib:${LD_LIBRARY_PATH} # 3. 使用squishrunner執(zhí)行測(cè)試套件 # --testsuite 指定測(cè)試套件路徑 # --reportgen 指定報(bào)告格式和路徑 ${SQUISH_PREFIX}/bin/squishrunner \ --testsuite ${TEST_SUITE_PATH} \ --reportgen junit,${WORKSPACE}/squish_results.xml \ --reportgen html,${WORKSPACE}/squish_report // 收集Squish生成的JUnit格式報(bào)告 junit squish_results.xml // 歸檔HTML報(bào)告便于在Jenkins中直接瀏覽 publishHTML(target: [ reportName: Squish GUI Test Report, reportDir: squish_report, reportFiles: index.html, keepAll: true ]) } } } post { always { // 無(wú)論成功失敗都清理可能殘留的進(jìn)程 sh pkill -f myapp || true # ${SQUISH_PREFIX}/bin/squishserver --stop // 可以在這里添加郵件通知等 } } }這個(gè)流水線定義了完整的流程在麒麟測(cè)試節(jié)點(diǎn)上拉取代碼 - 編譯QT應(yīng)用 - 運(yùn)行單元測(cè)試 - 運(yùn)行Squish GUI測(cè)試 - 收集并發(fā)布測(cè)試報(bào)告。6. 常見(jiàn)問(wèn)題排查與實(shí)戰(zhàn)心得在實(shí)際部署和運(yùn)行過(guò)程中我遇到了無(wú)數(shù)問(wèn)題。這里把最典型、最棘手的幾個(gè)列出來(lái)并附上排查思路和解決方案。6.1 環(huán)境與依賴問(wèn)題問(wèn)題1Squish啟動(dòng)被測(cè)應(yīng)用時(shí)報(bào)錯(cuò) “This application failed to start because no Qt platform plugin could be initialized.”排查這是最經(jīng)典的錯(cuò)誤。根本原因是Squish或啟動(dòng)環(huán)境找不到QT的平臺(tái)插件如libqxcb.so。解決確認(rèn)插件路徑在麒麟終端執(zhí)行find /usr -name \*qxcb*\找到確切路徑。設(shè)置環(huán)境變量在啟動(dòng)Squish IDE、squishserver或squishrunner的shell中必須設(shè)置export QT_PLUGIN_PATH/path/to/your/qt/plugins。使用Wrapper腳本對(duì)于被測(cè)應(yīng)用AUT務(wù)必使用一個(gè)wrapper腳本在其中設(shè)置好QT_PLUGIN_PATH和可能的LD_LIBRARY_PATH指向QT庫(kù)目錄再啟動(dòng)你的應(yīng)用。檢查架構(gòu)確保Squish版本、QT庫(kù)、平臺(tái)插件的架構(gòu)x86_64 vs aarch64一致。問(wèn)題2Squish可以啟動(dòng)應(yīng)用但錄制/回放時(shí)無(wú)法識(shí)別任何控件對(duì)象探查器里一片空白。排查Squish的“注入”injection可能失敗了。Squish需要向被測(cè)進(jìn)程注入代碼以獲取控件信息。解決檢查Squish版本兼容性確保你使用的Squish版本支持你QT應(yīng)用所使用的QT版本如Squish for Qt 5.7-5.15。檢查應(yīng)用啟動(dòng)參數(shù)有些應(yīng)用在啟動(dòng)時(shí)帶有-platform參數(shù)如-platform xcb需要確保Squish的AUT配置中包含了這些參數(shù)。以非root用戶運(yùn)行盡量避免使用root權(quán)限運(yùn)行Squish和被測(cè)應(yīng)用某些系統(tǒng)安全策略如AppArmor, SELinux可能會(huì)阻止注入。在麒麟OS上檢查SELinux狀態(tài)getenforce如果是Enforcing模式嘗試設(shè)置為Permissivesetenforce 0測(cè)試是否是它的問(wèn)題。查看Squish日志Squish的server和runner會(huì)生成日志通常在~/.squish/目錄下。查看這些日志里面常有詳細(xì)的錯(cuò)誤信息。6.2 測(cè)試腳本穩(wěn)定性問(wèn)題問(wèn)題3腳本回放時(shí)有時(shí)成功有時(shí)失敗錯(cuò)誤是找不到對(duì)象ObjectNotFound。排查界面加載時(shí)間不穩(wěn)定或者對(duì)象屬性動(dòng)態(tài)變化。解決強(qiáng)化等待邏輯將所有的findObject()替換為waitForObject()或waitForObjectExists()并合理設(shè)置超時(shí)時(shí)間。使用更穩(wěn)定的對(duì)象屬性優(yōu)先使用開發(fā)人員設(shè)置的objectName。如果只能用文本考慮使用正則表達(dá)式或子字符串匹配來(lái)應(yīng)對(duì)微小的文本變化。同步點(diǎn)Sync Point在關(guān)鍵操作后如點(diǎn)擊一個(gè)會(huì)觸發(fā)長(zhǎng)時(shí)間計(jì)算的按鈕插入一個(gè)同步點(diǎn)等待某個(gè)特定條件滿足如進(jìn)度條消失、某個(gè)狀態(tài)文本出現(xiàn)后再繼續(xù)。避免絕對(duì)坐標(biāo)絕對(duì)不要依賴mouseClick(x, y)這種基于坐標(biāo)的操作。問(wèn)題4測(cè)試過(guò)程中應(yīng)用彈出意外對(duì)話框如錯(cuò)誤提示、確認(rèn)框?qū)е潞罄m(xù)腳本失敗。解決異常處理在可能出錯(cuò)的操作周圍使用try...except捕獲ObjectNotFound等異常。對(duì)話框處理函數(shù)編寫一個(gè)通用的函數(shù)在腳本開始時(shí)設(shè)置setPopupHandler用于處理預(yù)期外的彈出框。例如自動(dòng)點(diǎn)擊“確定”或“取消”并記錄日志。前置條件清理在測(cè)試用例開始前確保應(yīng)用處于一個(gè)干凈的狀態(tài)。可以編寫一個(gè)setUp函數(shù)強(qiáng)制關(guān)閉可能殘留的應(yīng)用進(jìn)程清理臨時(shí)文件等。6.3 性能與架構(gòu)問(wèn)題問(wèn)題5GUI自動(dòng)化測(cè)試執(zhí)行速度慢尤其是大量用例時(shí)。解決測(cè)試用例設(shè)計(jì)保持用例獨(dú)立但也要設(shè)計(jì)一些更長(zhǎng)的“流程用例”減少不必要的應(yīng)用重啟啟動(dòng)耗時(shí)最長(zhǎng)。使用無(wú)頭模式Headless或虛擬幀緩沖如果應(yīng)用不需要真正的圖形顯示僅做功能驗(yàn)證可以考慮在無(wú)圖形界面的服務(wù)器上使用Xvfb虛擬X服務(wù)器來(lái)運(yùn)行測(cè)試。這可以節(jié)省大量GUI渲染資源并允許在無(wú)顯示器的環(huán)境下執(zhí)行。# 安裝Xvfb sudo yum install -y xorg-x11-server-Xvfb # 在啟動(dòng)測(cè)試前先啟動(dòng)Xvfb Xvfb :99 -screen 0 1024x768x24 export DISPLAY:99 # 然后在此環(huán)境中啟動(dòng)Squish runner和你的應(yīng)用并行測(cè)試如果測(cè)試套件支持可以利用Squish的分布式測(cè)試功能或Jenkins的并行階段在多臺(tái)測(cè)試機(jī)上同時(shí)運(yùn)行不同的測(cè)試集。問(wèn)題6ARM架構(gòu)如飛騰處理器的麒麟OS與x86環(huán)境有何不同核心差異指令集不同所有二進(jìn)制軟件包包括QT庫(kù)、Squish、你的應(yīng)用都必須使用ARM64aarch64版本重新編譯。實(shí)操要點(diǎn)Squish安裝包必須下載Linux ARM64版本的Squish。QT庫(kù)在ARM版麒麟OS上通過(guò)系統(tǒng)包管理器安裝的QT庫(kù)自然是ARM版本。如果你需要自定義QT版本必須從源碼在ARM機(jī)器上編譯。第三方庫(kù)項(xiàng)目依賴的所有第三方C/C庫(kù)都必須在ARM環(huán)境下重新編譯。編譯工具鏈?zhǔn)褂孟到y(tǒng)自帶的g/gcc即可它們會(huì)生成ARM原生代碼。性能初期可能遇到一些庫(kù)的ARM優(yōu)化不如x86導(dǎo)致應(yīng)用或測(cè)試工具性能稍差需要關(guān)注。這套方案不是一成不變的需要根據(jù)具體的項(xiàng)目需求、團(tuán)隊(duì)技能和基礎(chǔ)設(shè)施進(jìn)行調(diào)整。但它的核心價(jià)值在于提供了一條經(jīng)過(guò)驗(yàn)證的、從零到一在麒麟操作系統(tǒng)上建立QT應(yīng)用自動(dòng)化測(cè)試能力的路徑。記住自動(dòng)化測(cè)試是一個(gè)持續(xù)投入和優(yōu)化的過(guò)程早期的環(huán)境搭建和腳本編寫投入會(huì)在后續(xù)無(wú)數(shù)次的回歸測(cè)試中帶來(lái)巨大的回報(bào)。尤其是在國(guó)產(chǎn)化替代這個(gè)長(zhǎng)期而堅(jiān)定的趨勢(shì)下?lián)碛羞@樣一套穩(wěn)定的質(zhì)量保障體系無(wú)疑會(huì)讓你和你的團(tuán)隊(duì)更加從容。