做鴻蒙開發(fā)的人應(yīng)該都經(jīng)歷過(guò)這種狀態(tài)功能改完了要驗(yàn)證流程結(jié)果同一套點(diǎn)擊、滑動(dòng)、輸入在真機(jī)上手動(dòng)點(diǎn)了一遍又一遍。后來(lái)我把這套重復(fù)工作交給HDC命令行工具的模擬操作一句命令代替一個(gè)手指動(dòng)作配合腳本能跑完整條鏈路。這篇就是我在鴻蒙設(shè)備上折騰HDC模擬操作的完整記錄包括每條指令的用法、連設(shè)備時(shí)踩過(guò)的坑以及常見的失效排查方法適合剛接觸鴻蒙開發(fā)或者想把手動(dòng)測(cè)試自動(dòng)化的人參考。1. HDC模擬操作是什么解決了什么真實(shí)問(wèn)題1.1 從ADB時(shí)代過(guò)來(lái)的聯(lián)想早年做安卓開發(fā)時(shí)我已經(jīng)習(xí)慣用ADB調(diào)試設(shè)備。第一次接觸鴻蒙的HDC我第一反應(yīng)是翻命令清單發(fā)現(xiàn)它和ADB的很多思路是共通的。HDC全稱是HarmonyOS Device Connector本質(zhì)是電腦與鴻蒙設(shè)備之間的調(diào)試橋。它負(fù)責(zé)把電腦上的命令送到設(shè)備執(zhí)行也能把設(shè)備日志、狀態(tài)回傳回來(lái)。對(duì)開發(fā)者來(lái)說(shuō)最常用的功能無(wú)非是安裝HAP、列出設(shè)備、進(jìn)入Shell、模擬輸入操作等。我特別想強(qiáng)調(diào)一點(diǎn)HDC不是ADB的簡(jiǎn)單改名。鴻蒙的設(shè)備協(xié)議、權(quán)限模型和應(yīng)用安裝機(jī)制都有自己的一套邏輯。比如安裝包是HAP拉起Ability用aa start很多命令參數(shù)跟Android不完全一樣。所以你不能想當(dāng)然地把ADB命令直接套過(guò)來(lái)最好的方式是先看一遍HDC支持的完整命令列表再針對(duì)性使用。模擬操作就是其中讓我覺得價(jià)值最大的一塊。它的本質(zhì)很簡(jiǎn)單讓設(shè)備系統(tǒng)接收一個(gè)輸入事件比如坐標(biāo)點(diǎn)擊、滑動(dòng)手勢(shì)、物理按鍵、文本輸入。對(duì)App來(lái)說(shuō)這些事件跟在屏幕上用手指操作沒(méi)有本質(zhì)區(qū)別。應(yīng)用并不感知是誰(shuí)在點(diǎn)只感知到觸摸事件流。這也就意味著你可以在不侵入應(yīng)用代碼的前提下用一個(gè)外部命令行工具驅(qū)動(dòng)整個(gè)界面流程非常適合回歸測(cè)試、演示錄屏、批量驗(yàn)證。1.2 HDC能模擬哪些操作我在實(shí)際項(xiàng)目里最常用的模擬能力包括這幾類點(diǎn)擊指定屏幕坐標(biāo)模擬一次手指按下和抬起?；瑒?dòng)從起點(diǎn)滑到終點(diǎn)支持設(shè)置時(shí)長(zhǎng)也能模擬長(zhǎng)按。按鍵模擬返回鍵、Home鍵、音量鍵、電源鍵等物理按鍵。文本輸入向當(dāng)前焦點(diǎn)輸入框發(fā)送ASCII文本。屏幕相關(guān)亮屏、息屏、鎖屏狀態(tài)切換。配合輔助截圖、查看當(dāng)前窗口、獲取布局信息等。這些能力單獨(dú)看都不復(fù)雜但組合起來(lái)能完成很多事。比如我剛接手一個(gè)鴻蒙應(yīng)用時(shí)需要在不同賬號(hào)下跑一遍完整的用戶路徑。手動(dòng)操作一次大概三分鐘十幾個(gè)賬號(hào)就是快一個(gè)小時(shí)而且人很容易點(diǎn)錯(cuò)。用HDC模擬操作之后我把賬號(hào)信息放進(jìn)循環(huán)跑一組大約十分鐘就能完事中途還能去做別的事。1.3 它和你手動(dòng)操作有什么區(qū)別最大的區(qū)別是“狀態(tài)感知能力”。人手點(diǎn)界面時(shí)眼睛能看到界面變化知道該等頁(yè)面加載完再點(diǎn)下一步。HDC模擬操作沒(méi)有眼睛它只管發(fā)指令不管界面是否已經(jīng)響應(yīng)。所以你用HDC做模擬操作時(shí)必須自己負(fù)責(zé)節(jié)奏控制等待、延時(shí)、校驗(yàn)頁(yè)面狀態(tài)。這也是新手最常翻車的地方。另一個(gè)區(qū)別是“坐標(biāo)系”。人眼看到的是一個(gè)控件手指點(diǎn)的是控件中間。HDC不知道控件在哪只認(rèn)識(shí)屏幕上的像素坐標(biāo)。所以你要先把“我想點(diǎn)那個(gè)按鈕”翻譯成“屏幕橫向第540像素、縱向第1200像素的位置”。這就引出后續(xù)坐標(biāo)獲取和動(dòng)態(tài)計(jì)算的問(wèn)題。我的結(jié)論是HDC模擬操作是一個(gè)極其好用的“假手指”但它不是“智能大腦”。它勝在輕量、穩(wěn)定、不受應(yīng)用代碼限制適合做流程性、重復(fù)性的操作模擬。如果你需要智能斷言、元素識(shí)別、復(fù)雜邏輯應(yīng)該上自動(dòng)化測(cè)試框架但那套體系要維護(hù)的東西也多得多。兩者不是替代關(guān)系是互補(bǔ)關(guān)系。2. 搭建環(huán)境HDC下載、連接設(shè)備與版本血淚坑2.1 HDC從哪里來(lái)HDC不是系統(tǒng)自帶的命令行工具需要單獨(dú)準(zhǔn)備。最常見的來(lái)源有兩個(gè)一個(gè)是安裝DevEco Studio時(shí)隨IDE一起提供的一般在SDK目錄下另一個(gè)是華為開發(fā)者官網(wǎng)提供的Command Line Tools包。我建議開發(fā)機(jī)直接把 hdc 所在路徑加進(jìn)系統(tǒng)環(huán)境變量否則每次都得帶著全路徑敲命令時(shí)間長(zhǎng)了非常煩躁。Windows下我記得默認(rèn)路徑類似C:\Program Files\Huawei\DevEco Studio\sdk\default\openharmony\toolchains\hdc.exemacOS下一般是*/sdk/default/openharmony/toolchains/hdc。裝好后在終端里敲hdc -v能看到版本號(hào)就說(shuō)明路徑?jīng)]問(wèn)題。這里有個(gè)小提醒命令行工具包分不同平臺(tái)Windows、macOS、Linux各有對(duì)應(yīng)版本別下錯(cuò)。Linux環(huán)境如果提示權(quán)限不足記得先chmod x hdc。2.2 USB連接和設(shè)備發(fā)現(xiàn)有線連接仍然是最可靠的連接方式。首先在鴻蒙手機(jī)上開啟開發(fā)者模式打開“設(shè)置”應(yīng)用進(jìn)入“關(guān)于本機(jī)”或者“關(guān)于手機(jī)”找到HarmonyOS版本號(hào)連續(xù)點(diǎn)擊多次直到系統(tǒng)提示“已進(jìn)入開發(fā)者模式”。然后進(jìn)入“開發(fā)者選項(xiàng)”打開“USB調(diào)試”。用數(shù)據(jù)線把設(shè)備和電腦連起來(lái)在終端執(zhí)行hdc list targets如果輸出里出現(xiàn)了一串設(shè)備序列號(hào)說(shuō)明連接成功。如果列表為空我一般按這個(gè)順序排查先確認(rèn)數(shù)據(jù)線是不是只能充電不能傳數(shù)據(jù)盡早換一根原裝線或品牌線再檢查開發(fā)者選項(xiàng)里的“USB調(diào)試”是否確實(shí)打開最后看電腦的驅(qū)動(dòng)有沒(méi)有識(shí)別到設(shè)備。Windows下如果系統(tǒng)提示“未知設(shè)備”需要安裝設(shè)備驅(qū)動(dòng)很多第三方助手工具也能順手裝驅(qū)動(dòng)但注意別裝捆綁軟件。我實(shí)測(cè)下來(lái)USB連接最隱蔽的坑其實(shí)是鎖屏。設(shè)備息屏鎖著HDC雖然能識(shí)別設(shè)備但部分操作會(huì)不響應(yīng)最好在調(diào)試期間把鎖屏方式改為“無(wú)”或者“滑動(dòng)解鎖”或者至少在跑模擬操作前手動(dòng)亮屏解鎖一次。2.3 無(wú)線連接的兩種姿勢(shì)調(diào)試自動(dòng)化時(shí)我不能一直插著線所以無(wú)線連接用得越來(lái)越多。鴻蒙的HDC無(wú)線連接有個(gè)讓我一開始繞暈的地方它有兩種路徑。第一種是先用USB連接電腦在設(shè)備上確認(rèn)無(wú)線調(diào)試端口后執(zhí)行hdc tconn 192.168.1.100:5555執(zhí)行成功后可以拔掉USB線后續(xù)命令都走局域網(wǎng)。第二種是設(shè)備已經(jīng)開啟了“無(wú)線調(diào)試”選項(xiàng)界面會(huì)顯示一個(gè)IP和端口直接在電腦上執(zhí)行hdc tconn 設(shè)備IP:端口。只要電腦和設(shè)備在同一個(gè)局域網(wǎng)一般都能連上。無(wú)線連接有個(gè)前提防火墻別攔著端口。Windows電腦偶爾會(huì)出現(xiàn)connect failed的報(bào)錯(cuò)關(guān)掉第三方防火墻或者加白名單就能解決。另外無(wú)線環(huán)境不如USB穩(wěn)定跑長(zhǎng)時(shí)間自動(dòng)化時(shí)如果出現(xiàn)掉線可以寫一個(gè)簡(jiǎn)單的重連邏輯發(fā)現(xiàn)hdc list targets結(jié)果為空就再執(zhí)行一次hdc tconn。2.4 版本不匹配的坑版本問(wèn)題是我這次要重點(diǎn)說(shuō)的。HDC和鴻蒙系統(tǒng)之間有嚴(yán)格的版本適配關(guān)系舊版HDC連新版系統(tǒng)經(jīng)常出現(xiàn)莫名其妙的怪問(wèn)題。最典型的表現(xiàn)有設(shè)備能識(shí)別但hdc shell input tap執(zhí)行后無(wú)響應(yīng)。部分命令提示unknown command或者invalid parameter。安裝HAP時(shí)報(bào)錯(cuò)但應(yīng)用在設(shè)備上明明能正常安裝。我之前踩過(guò)一次很典型的坑電腦里裝過(guò)一個(gè)較老版本的HDC連上一臺(tái)新版本的鴻蒙設(shè)備tap命令一直沒(méi)反應(yīng)但list targets和shell都正常。折騰很久才意識(shí)到是版本問(wèn)題換成與設(shè)備匹配的新版HDC后立刻恢復(fù)。所以我的建議是盡量從官方渠道下載和鴻蒙系統(tǒng)版本配套的HDC別為了圖方便用歷史遺留的舊版本也別從第三方渠道隨意拿。命令行工具這種基礎(chǔ)組件踩坑成本遠(yuǎn)高于下載成本。3. 模擬操作四大金剛tap、swipe、keyevent、text3.1 tap點(diǎn)坐標(biāo)而不是點(diǎn)控件最基本的模擬點(diǎn)擊命令是這樣hdc shell input tap 540 1200這條命令的含義是在屏幕橫坐標(biāo)540、縱坐標(biāo)1200的位置執(zhí)行一次點(diǎn)擊。坐標(biāo)系以屏幕左上角為原點(diǎn)單位是物理像素。你需要知道目標(biāo)控件在屏幕上的大概位置而不是它的控件ID。獲取坐標(biāo)的方法有很多。最原始但在調(diào)試階段最有效的一種是先用HDC截一張圖然后在圖片工具里查看目標(biāo)位置坐標(biāo)。HDC截圖命令是hdc shell snapshot_display -f /data/local/tmp/screen.png hdc file recv /data/local/tmp/screen.png ./screen.png截圖之后用系統(tǒng)自帶畫圖工具打開鼠標(biāo)放在想點(diǎn)的位置就能看到像素坐標(biāo)。這個(gè)辦法笨但管用。鴻蒙的開發(fā)者選項(xiàng)里也有“指針位置”功能開啟后屏幕上會(huì)實(shí)時(shí)顯示手指觸摸的坐標(biāo)這也是一種輔助獲取坐標(biāo)的方式。值得注意的是tap 命令發(fā)出去之后沒(méi)有任何回顯。它不會(huì)告訴你“點(diǎn)擊成功”或“點(diǎn)擊失敗”所以你必須在點(diǎn)擊之后自己驗(yàn)證界面變化。我一般會(huì)在關(guān)鍵操作后用hdc shell snapshot_display再截一張圖對(duì)比前后差異。3.2 swipe滑動(dòng)和長(zhǎng)按都靠它滑動(dòng)手勢(shì)用這條命令hdc shell input swipe x1 y1 x2 y2 duration前四個(gè)參數(shù)是起始點(diǎn)和結(jié)束點(diǎn)的坐標(biāo)最后一個(gè)可選參數(shù)是滑動(dòng)持續(xù)時(shí)間單位毫秒。它不只是用來(lái)翻頁(yè)拖動(dòng)進(jìn)度條、下拉刷新、長(zhǎng)按圖標(biāo)這些手勢(shì)都能靠它模擬。舉幾個(gè)我實(shí)際用過(guò)的場(chǎng)景模擬下拉刷新從屏幕中間偏上位置滑到偏下位置例如hdc shell input swipe 540 800 540 1800 200。拖動(dòng)滑塊亮度條或者視頻播放進(jìn)度條可以從起點(diǎn)滑塊位置滑到目標(biāo)位置時(shí)間放長(zhǎng)到500毫秒以上動(dòng)作更接近真人。長(zhǎng)按操作比如長(zhǎng)按桌面圖標(biāo)進(jìn)入編輯模式用同一坐標(biāo)作為起點(diǎn)和終點(diǎn)把duration設(shè)置為1000毫秒以上。長(zhǎng)按其實(shí)就是swipe的一個(gè)特殊情況這點(diǎn)容易被人忽略。我最早還以為長(zhǎng)按需要單獨(dú)的命令后來(lái)才發(fā)現(xiàn)只要把起點(diǎn)和終點(diǎn)設(shè)成同一個(gè)點(diǎn)再拉長(zhǎng)執(zhí)行時(shí)間即可。3.3 keyevent按鍵也能模擬按鍵模擬的命令格式hdc shell input keyevent 4數(shù)字4代表返回鍵。除了數(shù)字編碼有些HDC版本也支持直接傳按鍵名稱比如hdc shell input keyevent BACK。我用過(guò)一段時(shí)間的常用KeyCode整理成表格方便查閱KeyCode含義說(shuō)明3HOME鍵回到桌面4BACK鍵返回上一級(jí)26電源鍵亮屏/息屏切換82菜單鍵打開上下文菜單85播放/暫停多媒體控制87下一曲多媒體控制111ESC鍵退出當(dāng)前操作220亮度調(diào)低部分設(shè)備支持221亮度調(diào)高部分設(shè)備支持keyevent 的用法和真實(shí)按鍵幾乎等價(jià)。比如我想回到桌面再重新進(jìn)入應(yīng)用就可以先hdc shell input keyevent 3再執(zhí)行hdc shell aa start -b 包名 -a Ability名。這種方式比模擬滑動(dòng)手勢(shì)更穩(wěn)定因?yàn)椴灰蕾囎鴺?biāo)任何時(shí)候執(zhí)行都會(huì)觸發(fā)系統(tǒng)返回行為。這里提一個(gè)容易踩的坑不同鴻蒙版本對(duì)某些按鍵的映射可能存在差異。比如菜單鍵在部分版本上不響應(yīng)音量鍵的KeyCode在不同設(shè)備上也可能不一樣。建議在真機(jī)上先手動(dòng)執(zhí)行一遍確認(rèn)行為符合預(yù)期再寫進(jìn)腳本。3.4 text輸入中文的特殊處理文本輸入命令是這樣的hdc shell input text hello這條命令的核心限制是默認(rèn)只支持ASCII字符不支持中文、日文、韓文等多字節(jié)語(yǔ)言。如果你直接往命令里塞中文大概率會(huì)失敗或者輸入亂碼。另外空格也不能直接傳需要用%s代替比如hdc shell input text hello%sWorld如果確實(shí)需要輸入中文怎么辦我實(shí)踐下來(lái)的可行方案有兩個(gè)方向。方向一把要輸入的內(nèi)容放到系統(tǒng)剪貼板然后在輸入框里長(zhǎng)按點(diǎn)擊“粘貼”。但HDC本身沒(méi)有標(biāo)準(zhǔn)的剪貼板寫入命令所以這個(gè)方案依賴額外工具不是開箱即用。方向二換用支持ADB/HDC輸入中文的第三方輸入法或測(cè)試輸入法這類輸入法一般自帶監(jiān)聽通道能把文本通過(guò)特殊協(xié)議塞進(jìn)輸入框。文本輸入還有一個(gè)細(xì)節(jié)焦點(diǎn)問(wèn)題。input text只往當(dāng)前獲得焦點(diǎn)的輸入框發(fā)送內(nèi)容如果界面上沒(méi)有輸入框獲得焦點(diǎn)命令執(zhí)行了也白執(zhí)行。所以我在一套操作里會(huì)先點(diǎn)一下目標(biāo)輸入框等一秒再發(fā) text 命令。3.5 獲取真實(shí)坐標(biāo)的輔助手段模擬操作的坐標(biāo)是最容易出問(wèn)題的地方所以我單獨(dú)說(shuō)一塊。除了截圖看坐標(biāo)還有兩個(gè)命令很有用hdc shell wm size hdc shell wm density第一條輸出當(dāng)前屏幕的物理分辨率比如Physical size: 1080x2340第二條輸出像素密度比如Physical density: 480。這兩個(gè)值能幫我做坐標(biāo)比例換算。假設(shè)我寫腳本時(shí)用的基準(zhǔn)設(shè)備是1080x2340點(diǎn)擊位置是540x1200現(xiàn)在換到一臺(tái)720x1600的設(shè)備簡(jiǎn)單按比例縮放就能得到新設(shè)備的點(diǎn)擊坐標(biāo)新x 540 * 720 / 1080 360新y 1200 * 1600 / 2340 ≈ 821這個(gè)比例換算不是絕對(duì)精確因?yàn)椴煌钠聊槐壤拖到y(tǒng)欄高度會(huì)影響最終點(diǎn)中的位置但至少能把“完全點(diǎn)歪”變成“大概正確”后續(xù)微調(diào)就快很多。如果有條件還可以嘗試hdc shell uiautomator dump導(dǎo)出當(dāng)前界面的控件樹然后解析XML里每個(gè)控件的bounds屬性從而拿到目標(biāo)控件的中心點(diǎn)坐標(biāo)。不過(guò)這類命令在鴻蒙不同版本上的支持程度不一樣有些版本路徑和格式有差異。我一般在開發(fā)調(diào)試階段用截圖和指針位置在寫腳本階段用wm size做動(dòng)態(tài)換算控件樹只在有空的時(shí)候用。4. 組合起來(lái)才是真本事還原一個(gè)真實(shí)業(yè)務(wù)場(chǎng)景4.1 場(chǎng)景設(shè)計(jì)與前置準(zhǔn)備前面全是單條命令的拆解但實(shí)際工作里沒(méi)人會(huì)只敲一條。我拿一個(gè)真實(shí)場(chǎng)景來(lái)說(shuō)驗(yàn)證一個(gè)鴻蒙應(yīng)用的“登錄-首頁(yè)-退出”流程。前置條件有幾個(gè)一是應(yīng)用已經(jīng)安裝到設(shè)備上我一般用hdc install xxx.hap安裝二是有一個(gè)測(cè)試賬號(hào)注意不要用真實(shí)敏感賬號(hào)因?yàn)樽詣?dòng)化腳本里可能會(huì)明文記錄密碼三是設(shè)備保持解鎖狀態(tài)最好關(guān)閉自動(dòng)鎖屏。在執(zhí)行模擬操作之前我會(huì)先手動(dòng)進(jìn)一次應(yīng)用記住登錄頁(yè)的幾個(gè)關(guān)鍵坐標(biāo)賬號(hào)輸入框坐標(biāo)、密碼輸入框坐標(biāo)、登錄按鈕坐標(biāo)。這次手動(dòng)操作花不了幾分鐘但能省下腳本調(diào)試階段反復(fù)猜測(cè)坐標(biāo)的時(shí)間。4.2 完整命令串演一遍下面是這個(gè)場(chǎng)景的完整命令串我用的是bash環(huán)境Windows下可以放進(jìn).bat腳本# 檢查設(shè)備在線 hdc list targets # 安裝應(yīng)用如果已經(jīng)安裝可以跳過(guò) hdc install ./demo.hap # 啟動(dòng)應(yīng)用包名和Ability名根據(jù)實(shí)際替換 hdc shell aa start -b com.example.demo -a MainAbility # 等待應(yīng)用啟動(dòng) sleep 3 # 點(diǎn)擊賬號(hào)輸入框 hdc shell input tap 540 1100 # 輸入賬號(hào) hdc shell input text testuser01 # 點(diǎn)擊密碼輸入框 hdc shell input tap 540 1300 # 輸入密碼僅ASCII hdc shell input text Passw0rd # 點(diǎn)擊登錄按鈕 hdc shell input tap 540 1600 # 等待首頁(yè)加載 sleep 5 # 模擬返回鍵退出到桌面 hdc shell input keyevent 4這串命令每一步都有注釋核心邏輯就是“點(diǎn)、等、輸入、點(diǎn)”。執(zhí)行完之后我再截一張圖確認(rèn)最終狀態(tài)hdc shell snapshot_display -f /data/local/tmp/result.png hdc file recv /data/local/tmp/result.png ./result.png打開截圖看到首頁(yè)元素出現(xiàn)說(shuō)明整條流程跑通了。如果發(fā)現(xiàn)卡在中間某一步我會(huì)在對(duì)應(yīng)步驟前后各加一次截圖快速定位是哪一步?jīng)]生效。4.3 延時(shí)與等待不要裸奔執(zhí)行在上面命令串里我反復(fù)用了sleep這不是隨便寫的而是模擬操作最容易被低估的點(diǎn)。真實(shí)用戶點(diǎn)擊登錄按鈕之后眼睛會(huì)看到加載動(dòng)畫等到頁(yè)面跳轉(zhuǎn)完才進(jìn)行下一步。但HDC命令是按順序執(zhí)行的上一秒點(diǎn)完登錄下一秒可能直接發(fā)返回鍵結(jié)果應(yīng)用還沒(méi)來(lái)得及跳轉(zhuǎn)返回鍵就把應(yīng)用退了。我的經(jīng)驗(yàn)是不同操作之間必須給足緩沖時(shí)間。啟動(dòng)應(yīng)用后至少等3秒頁(yè)面跳轉(zhuǎn)至少等3到5秒網(wǎng)絡(luò)請(qǐng)求頻繁的場(chǎng)景建議等更久。更穩(wěn)妥的方式是輪詢。比如想確認(rèn)登錄后的首頁(yè)是否出現(xiàn)可以寫一個(gè)循環(huán)每隔1秒查一次當(dāng)前頂層窗口直到出現(xiàn)目標(biāo)頁(yè)面或者超時(shí)。例如可以嘗試這樣的思路用hdc shell hidumper -s WindowManager查看當(dāng)前窗口信息在循環(huán)里解析關(guān)鍵字段匹配到目標(biāo)頁(yè)面就繼續(xù)超時(shí)就報(bào)錯(cuò)退出。這種方式比固定sleep更可靠但代碼量會(huì)大一些。我個(gè)人的習(xí)慣是腳本前期用固定sleep快速跑通流程流程穩(wěn)定后再把關(guān)鍵節(jié)點(diǎn)改成輪詢等待提高整條自動(dòng)化鏈路的穩(wěn)定性。5. 模擬操作失效時(shí)我的排查鏈路5.1 命令返回錯(cuò)誤碼但沒(méi)有具體提示最讓人頭疼的情況是命令執(zhí)行了可是界面紋絲不動(dòng)。這時(shí)候我第一步會(huì)檢查HDC是不是還連著設(shè)備。無(wú)線連接偶爾會(huì)悄悄斷開但命令仍然能下發(fā)設(shè)備卻沒(méi)響應(yīng)。先跑一下hdc list targets如果輸出為空?qǐng)?zhí)行hdc tconn 設(shè)備IP:端口重連再跑一次。如果設(shè)備在線接著檢查設(shè)備是不是熄屏了。可別笑我至少有兩三次在設(shè)備息屏狀態(tài)下跑自動(dòng)化命令全部“成功”了但屏幕一直是黑的后來(lái)才意識(shí)到是設(shè)備自動(dòng)鎖屏。檢查方法也很簡(jiǎn)單執(zhí)行hdc shell power-shell wakeup讓設(shè)備亮屏然后重新解鎖再跑。這個(gè)問(wèn)題暴露了模擬操作的盲區(qū)它只會(huì)發(fā)事件不會(huì)等待屏幕狀態(tài)變化所以你在腳本里要主動(dòng)管理亮屏狀態(tài)。5.2 點(diǎn)擊了但界面沒(méi)反應(yīng)如果設(shè)備在線、屏幕亮著、命令也執(zhí)行了但頁(yè)面沒(méi)有預(yù)期變化我一般懷疑三個(gè)原因。第一個(gè)原因是點(diǎn)擊位置被其他元素遮擋。常見的遮擋源是系統(tǒng)彈窗、懸浮球、下拉通知欄。尤其是懸浮球很多設(shè)備開著三指截屏或懸浮導(dǎo)航透明觸控層會(huì)在某些區(qū)域吃掉點(diǎn)擊事件。我調(diào)試時(shí)習(xí)慣把這類輔助功能全部關(guān)掉。第二個(gè)原因是控件實(shí)際響應(yīng)區(qū)域和視覺位置不一致。有些自定義控件、WebView里的元素視覺上在上方實(shí)際可點(diǎn)擊區(qū)域卻在另一個(gè)位置。遇到這種情況我會(huì)用開發(fā)者選項(xiàng)里“指針位置”功能手動(dòng)點(diǎn)一次目標(biāo)看系統(tǒng)上報(bào)的坐標(biāo)是多少再對(duì)比HDC里填的坐標(biāo)就知道偏差了多少。第三個(gè)原因是時(shí)序問(wèn)題。點(diǎn)擊真的發(fā)出去了但當(dāng)時(shí)頁(yè)面還在加載目標(biāo)控件還沒(méi)渲染出來(lái)點(diǎn)擊落在了空白區(qū)域。這種問(wèn)題很好判斷把點(diǎn)擊前的sleep加長(zhǎng)或者改成輪詢等待頁(yè)面元素出現(xiàn)而不是等固定秒數(shù)。5.3 坐標(biāo)漂移換個(gè)設(shè)備就偏固定坐標(biāo)的腳本換個(gè)分辨率設(shè)備就跑偏這是坐標(biāo)模擬的天生弱點(diǎn)。前面我提到過(guò)用hdc shell wm size做比例換算這里再補(bǔ)充一個(gè)細(xì)節(jié)比例換算對(duì)設(shè)備的“可用顯示區(qū)域”很敏感。有些設(shè)備的屏幕比例是19.5:9有些是20:9單單按分辨率等比縮放底部導(dǎo)航欄、狀態(tài)欄的高度占比不一樣導(dǎo)致?lián)Q算后的坐標(biāo)在豎屏頁(yè)面上接近正確但頁(yè)面偏下部分的按鈕會(huì)發(fā)生明顯偏移。我在項(xiàng)目里給過(guò)一條曲線救國(guó)的方案先在同一型號(hào)設(shè)備上寫死基準(zhǔn)坐標(biāo)用腳本啟動(dòng)時(shí)自動(dòng)讀取當(dāng)前設(shè)備分辨率只對(duì)同一比例范圍的設(shè)備做換算如果相差太大干脆用單獨(dú)一套坐標(biāo)配置。5.4 系統(tǒng)限制安全輸入、鎖屏和隱私保護(hù)不是所有操作都能用HDC模擬搞定這一點(diǎn)必須提前知道。鴻蒙和所有主流移動(dòng)操作系統(tǒng)一樣對(duì)敏感輸入有保護(hù)機(jī)制。典型例子是鎖屏密碼、支付密碼這類安全輸入框系統(tǒng)會(huì)攔截來(lái)自非物理輸入設(shè)備的模擬輸入。我測(cè)試過(guò)在鎖屏密碼界面用input text輸入數(shù)字事件可以發(fā)出但密碼框根本收不到這是系統(tǒng)層面的安全策略不是命令寫錯(cuò)了。另外一個(gè)容易踩的坑是應(yīng)用自行實(shí)現(xiàn)的“防自動(dòng)化”邏輯。有些金融、風(fēng)控類應(yīng)用會(huì)檢測(cè)觸摸事件的來(lái)源如果發(fā)現(xiàn)輸入事件不是來(lái)自真實(shí)屏幕觸摸會(huì)彈出安全提示或踢出登錄狀態(tài)。遇到這種情況HDC模擬操作就不是合適的工具應(yīng)該考慮使用官方提供的自動(dòng)化測(cè)試框架通過(guò)系統(tǒng)授權(quán)的方式完成輸入。排查完這些之后我一般會(huì)重新讀一遍自己腳本的每個(gè)動(dòng)作設(shè)備狀態(tài)檢查、亮屏喚醒、屏幕解鎖、點(diǎn)擊、等待、校驗(yàn)。這套鏈路上任何一個(gè)環(huán)節(jié)斷開都可能導(dǎo)致“命令成功但實(shí)際沒(méi)操作”。6. 從單條命令到自動(dòng)化腳本把模擬操作變成生產(chǎn)力6.1 用批處理/Shell串起來(lái)模擬操作要真正提升效率必須從“手工敲”變成“腳本跑”。最簡(jiǎn)單的形式就是Shell腳本把命令串成一串。我在Shell里習(xí)慣先定義一個(gè)公共函數(shù)避免到處重復(fù)function tap() { hdc shell input tap $1 $2 sleep 1 } function type_text() { hdc shell input text $1 sleep 1 } tap 540 1100 type_text testuser01這樣做的價(jià)值有兩個(gè)一是統(tǒng)一處理延時(shí)不會(huì)漏寫sleep二是如果以后命令變了只需要改函數(shù)內(nèi)部不用滿世界找命令。Windows下的.bat腳本也差不多不過(guò)語(yǔ)法更受限我建議Windows用戶直接裝一個(gè)Git Bash或者使用Python跨平臺(tái)。腳本跑起來(lái)之后建議在關(guān)鍵節(jié)點(diǎn)加上日志輸出比如echo [$(date)] 點(diǎn)擊登錄按鈕。自動(dòng)化腳本一旦跑得時(shí)間長(zhǎng)沒(méi)有日志就完全不知道執(zhí)行到哪一步掛了加日志雖然土但排查效率翻倍。6.2 用Python的subprocess統(tǒng)一管理當(dāng)腳本變得復(fù)雜判斷分支變多Shell腳本就不太好維護(hù)了我一般切到Python。Python的優(yōu)勢(shì)是異常處理、數(shù)據(jù)解析、循環(huán)和重試都更好寫。調(diào)用HDC的命令很直接import subprocess import time def hdc(*args): 統(tǒng)一執(zhí)行hdc命令返回stdout文本 result subprocess.run( [hdc, *args], capture_outputTrue, textTrue, encodingutf-8 ) return result.stdout.strip() def tap(x, y): hdc(shell, input, tap, str(x), str(y)) time.sleep(1) def is_device_online(): targets hdc(list, targets) return bool(targets) if not is_device_online(): print(設(shè)備不在線開始重連...) hdc(tconn, 192.168.1.100:5555) time.sleep(2) tap(540, 1100)這個(gè)封裝的好處是以后換命令、加重試都只改函數(shù)不用動(dòng)業(yè)務(wù)流程。我甚至?xí)趖ap函數(shù)里加一個(gè)簡(jiǎn)單的重試邏輯點(diǎn)擊后截圖對(duì)比前后像素差異判定是否需要再點(diǎn)一次。這種“點(diǎn)擊-截圖-校驗(yàn)”的模式能讓自動(dòng)化腳本穩(wěn)定不少不過(guò)實(shí)現(xiàn)復(fù)雜度也高一些適合需要長(zhǎng)時(shí)間跑回歸的場(chǎng)景。6.3 結(jié)合控件樹讓坐標(biāo)不再硬編碼如果說(shuō)HDC模擬操作有什么讓我覺得可惜的那就是純坐標(biāo)驅(qū)動(dòng)太脆UI一變?nèi)?。后?lái)我嘗試把它和控件樹結(jié)合起來(lái)才算稍微緩解了這個(gè)問(wèn)題。思路是在執(zhí)行模擬操作前先導(dǎo)出當(dāng)前界面的控件樹XML然后在XML里找到目標(biāo)文本比如“登錄按鈕”讀取它的bounds屬性算出中心點(diǎn)坐標(biāo)再調(diào)用tap。這樣就算按鈕在界面上移動(dòng)了位置只要文本文案不變腳本也能找到新坐標(biāo)。實(shí)現(xiàn)大致是hdc shell uiautomator dump導(dǎo)出的XML可能在不同鴻蒙版本上路徑不同我用的時(shí)候會(huì)先執(zhí)行一次看輸出路徑再用hdc shell cat 對(duì)應(yīng)路徑查看內(nèi)容。解析XML用Python的xml.etree.ElementTree或者正則都行。這個(gè)方法不是萬(wàn)能的有些自繪控件、Canvas渲染的界面不會(huì)暴露標(biāo)準(zhǔn)控件樹那就只能退回坐標(biāo)方案。但它確實(shí)能處理很大一部分常規(guī)按鈕、文本框值得一試。6.4 真實(shí)自動(dòng)化中的幾個(gè)小習(xí)慣最后聊幾個(gè)我在長(zhǎng)期實(shí)踐中沉淀下來(lái)的習(xí)慣都不是什么高級(jí)技巧但能實(shí)實(shí)在在減少踩坑次數(shù)。第一腳本開頭一定要寫設(shè)備與分辨率校驗(yàn)。很多自動(dòng)化跑掛不是用例寫錯(cuò)了而是連接設(shè)備變了或者分辨率變了。先確認(rèn)環(huán)境再開始執(zhí)行能省下一半的排錯(cuò)時(shí)間。第二危險(xiǎn)操作前加日志和確認(rèn)。比如腳本要?jiǎng)h除數(shù)據(jù)、退出登錄、或者執(zhí)行頻率很高的循環(huán)我都會(huì)在日志里打印當(dāng)前執(zhí)行位置必要時(shí)在執(zhí)行前加一個(gè)人工確認(rèn)的交互。第三敏感信息不要硬編碼在腳本里。測(cè)試賬號(hào)和密碼最好從環(huán)境變量或單獨(dú)的配置文件中讀取腳本本身可以提交到代碼倉(cāng)庫(kù)但敏感信息不要跟著提交。第四每個(gè)關(guān)鍵動(dòng)作后給足等待時(shí)間但也不要為了追求穩(wěn)妥把所有sleep都拉滿。我通常先用3到5秒的sleep跑通流程穩(wěn)定后再逐步減小等待時(shí)間優(yōu)化到“剛好夠用”的程度。第五跑完自動(dòng)化一定要留證據(jù)。至少截一張最終屏幕圖有條件就錄屏。這樣出了問(wèn)題回看證據(jù)比猜原因高效得多。這些習(xí)慣讓我的HDC模擬操作腳本從“能跑一次”進(jìn)化到“每天跑幾輪也不容易掛”這才是自動(dòng)化真正產(chǎn)生價(jià)值的地方。