上周陪一個(gè)團(tuán)隊(duì)排查HarmonyOS應(yīng)用的更新問題他們的應(yīng)用還沒上架測(cè)試在“檢查更新”上點(diǎn)了半天頁(yè)面紋絲不動(dòng)。負(fù)責(zé)產(chǎn)品的同事問我更新功能是不是必須上架才能調(diào)試我說不是更新鏈路拆開看真正要驗(yàn)證的東西和上不上架沒有必然關(guān)系。真正需要解決的是“未上架時(shí)沒有應(yīng)用市場(chǎng)幫你分發(fā)新版本”但你完全可以用一個(gè)本地服務(wù)模擬這個(gè)分發(fā)動(dòng)作把整個(gè)流程測(cè)通。這篇就記錄一下我怎么在應(yīng)用未上架的情況下完整調(diào)試和檢測(cè)HarmonyOS應(yīng)用更新功能是否正常的。先說結(jié)論未上架不影響你驗(yàn)證“檢查更新邏輯是否正確、下載流程是否通、安裝拉起是否順利”這三件事。應(yīng)用市場(chǎng)在上架后只是多了一個(gè)官方分發(fā)渠道而我們?cè)谡{(diào)試階段需要的只是一個(gè)可控的“更新源”。1. 更新鏈路拆開看未上架時(shí)真正要驗(yàn)證的是哪三件事很多團(tuán)隊(duì)一聽到“未上架”就覺得更新功能沒法測(cè)其實(shí)是把“應(yīng)用市場(chǎng)能力”和“應(yīng)用自身邏輯”混在一起了。應(yīng)用更新功能在代碼層面只做三件事對(duì)比版本、取回新包、交給系統(tǒng)安裝。這三件事運(yùn)行在應(yīng)用內(nèi)不依賴應(yīng)用市場(chǎng)。1.1 更新不是“點(diǎn)個(gè)按鈕”而是三段鏈路第一段是檢測(cè)更新。應(yīng)用啟動(dòng)或者用戶點(diǎn)擊檢查更新時(shí)客戶端把當(dāng)前版本號(hào)發(fā)給服務(wù)器服務(wù)器返回“有沒有新版本、新版本號(hào)、下載地址、包大小”等信息。這一段的核心是版本號(hào)讀取和網(wǎng)絡(luò)請(qǐng)求只要服務(wù)器接口可控沒上架也一樣能測(cè)。第二段是下載新包。確認(rèn)有新版本后客戶端把hap包下載到應(yīng)用自己的沙箱目錄里。這段的核心是下載任務(wù)調(diào)度、進(jìn)度回調(diào)和異常處理和上架不上架沒有半點(diǎn)關(guān)系。實(shí)際調(diào)試時(shí)你會(huì)發(fā)現(xiàn)下載階段最容易出問題的是路徑寫錯(cuò)、權(quán)限沒配、防火墻攔截。第三段是拉起安裝。下載完成后應(yīng)用需要調(diào)用系統(tǒng)安裝能力把hap包路徑通過Intent傳給系統(tǒng)由系統(tǒng)彈窗讓用戶確認(rèn)安裝。這一段的重點(diǎn)是“系統(tǒng)是否接受這個(gè)包”安裝成功與否取決于包簽名、版本號(hào)和系統(tǒng)安裝策略這些和上架狀態(tài)也無(wú)關(guān)。所以你看整個(gè)更新功能能不能跑通取決于你寫的代碼和測(cè)試服務(wù)器的配合而不是應(yīng)用市場(chǎng)。未上架唯一的影響是你拿不到AppGallery Connect那邊托管的“正式更新源”需要自己搭一個(gè)。1.2 未上架到底缺了什么應(yīng)用市場(chǎng)通道與本地自建通道的差異如果用了華為應(yīng)用市場(chǎng)提供的“應(yīng)用內(nèi)更新”SDK那確實(shí)要上架后在AGC后臺(tái)配置版本才能分發(fā)。SDK會(huì)去應(yīng)用市場(chǎng)后臺(tái)拉取升級(jí)包列表應(yīng)用沒上架時(shí)這個(gè)列表根本不存在自然返回不了任何更新信息。所以如果你走的是官方SDK路線未上架階段測(cè)不出來(lái)是正常的這是第一個(gè)必須認(rèn)清的差異。但自建更新通道是完全繞開應(yīng)用市場(chǎng)的服務(wù)器地址、版本規(guī)則、包分發(fā)全由你自己控制。未上架階段你完全可以搭一個(gè)臨時(shí)的HTTP服務(wù)放一個(gè)測(cè)試hap包讓手機(jī)走局域網(wǎng)訪問這個(gè)服務(wù)來(lái)完成整個(gè)更新閉環(huán)。這個(gè)閉環(huán)一旦跑通等上架后再切到官方SDK邏輯驗(yàn)證成本會(huì)低很多。另外還要提醒一點(diǎn)AppGallery的“應(yīng)用內(nèi)更新”SDK在應(yīng)用未上架時(shí)有時(shí)會(huì)返回特定的錯(cuò)誤碼比如未配置或未授權(quán)。如果你在未上架階段看到這類錯(cuò)誤不要慌不代表代碼寫錯(cuò)了只是渠道還沒激活。1.3 先定驗(yàn)收標(biāo)準(zhǔn)什么樣的狀態(tài)才算“更新功能正?！闭{(diào)試之前先明確“正常”的含義后面才不會(huì)測(cè)了個(gè)寂寞。我的驗(yàn)收標(biāo)準(zhǔn)很簡(jiǎn)單四個(gè)鉤子全打上就算通過老版本啟動(dòng)后能正確觸發(fā)檢查更新服務(wù)器日志能看到請(qǐng)求返回?cái)?shù)據(jù)能被解析。檢測(cè)到新版本后提示語(yǔ)、版本號(hào)、包大小展示正確用戶點(diǎn)擊確認(rèn)后開始下載。下載過程有進(jìn)度反饋下載完成后文件確實(shí)落在沙箱目錄里大小和服務(wù)器一致。系統(tǒng)安裝頁(yè)面能正常拉起用戶確認(rèn)后安裝成功重新打開應(yīng)用顯示的是新版本號(hào)。這四條聽起來(lái)樸素但真跑起來(lái)你會(huì)發(fā)現(xiàn)卡在第二條和第四條的情況最多。后面我會(huì)按這個(gè)標(biāo)準(zhǔn)鋪開講怎么操作。2. 版本讀取、下載與安裝拉起HarmonyOS更新鏈路的核心API進(jìn)入實(shí)操前先把更新鏈路涉及的HarmonyOS API過一遍。這部分我不打算貼一堆官方文檔只挑你寫代碼時(shí)真正會(huì)用到的東西講順便說說容易踩的坑。2.1 拿當(dāng)前版本號(hào)versionCode 與 versionName 別混淆更新檢測(cè)的第一件事就是知道自己當(dāng)前是什么版本。HarmonyOS應(yīng)用的版本信息有兩個(gè)字段versionCode是整數(shù)必須遞增機(jī)器比較用它versionName是字符串給用戶看的比如“1.0.2”。很多新手用versionName比較大小寫過一次就知道有多坑這個(gè)我放到第五章再說。讀取版本號(hào)的代碼框架大概是這樣的// 示意代碼不同SDK版本的導(dǎo)入路徑略有差異 import { bundleManager } from kit.AbilityKit; let bundleInfo bundleManager.getBundleInfoForSelfSync( bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_APPLICATION ); let currentVersionCode bundleInfo.versionCode; // 整數(shù)用于邏輯比較 let currentVersionName bundleInfo.versionName; // 字符串用于界面展示注意一點(diǎn)在API 12HarmonyOS NEXT的Kit化寫法里模塊導(dǎo)入路徑可能和API 9時(shí)代的ohos.bundle.bundleManager不同。你自己工程里按SDK文檔確認(rèn)即可重點(diǎn)是拿到versionCode和versionName這兩個(gè)字段。我在實(shí)際項(xiàng)目里習(xí)慣把這兩個(gè)值在應(yīng)用啟動(dòng)時(shí)打一條日志這樣后面用hdc看日志時(shí)第一件事就能確認(rèn)當(dāng)前裝的到底是哪個(gè)版本排查問題不必靠猜。2.2 檢查更新用 http 請(qǐng)求問服務(wù)器要版本信息檢查更新本質(zhì)就是一個(gè)GET請(qǐng)求?？蛻舳税旬?dāng)前versionCode帶給服務(wù)器服務(wù)器返回有沒有新版本。HarmonyOS上標(biāo)準(zhǔn)的做法是使用ohos.net.http模塊大致寫法如下import { http } from kit.NetworkKit; let httpRequest http.createHttp(); httpRequest.request( http://192.168.1.100:8080/api/update?versionCode currentVersionCode, { method: http.RequestMethod.GET, connectTimeout: 10000, readTimeout: 10000 } ).then((response) { if (response.responseCode 200) { // 解析JSON判斷 hasUpdate 和 serverVersionCode let result JSON.parse(response.result as string); // 先判斷網(wǎng)絡(luò)層再判斷業(yè)務(wù)層 } }).catch(() { // 斷網(wǎng)、超時(shí)、地址不可達(dá)都會(huì)走到這里 });這里我強(qiáng)烈建議把超時(shí)時(shí)間設(shè)置好不要依賴默認(rèn)值。我在真機(jī)調(diào)試時(shí)遇到過一種情況電腦開了防火墻手機(jī)訪問不到本地服務(wù)結(jié)果客戶端一直轉(zhuǎn)圈不報(bào)錯(cuò)后來(lái)才發(fā)現(xiàn)是超時(shí)時(shí)間設(shè)得太長(zhǎng)體驗(yàn)上像“卡死”。服務(wù)端返回的數(shù)據(jù)結(jié)構(gòu)建議固定一套至少要包含hasUpdate、versionCode、versionName、downloadUrl、size這幾個(gè)字段。后面章節(jié)我會(huì)給一個(gè)可以直接跑的本地服務(wù)示例字段就是按這套來(lái)的。2.3 下載新包官方下載任務(wù)與本地路徑選擇下載hap包推薦用ohos.request模塊的下載任務(wù)而不是自己拿HTTP流一段段寫文件。理由很簡(jiǎn)單官方下載任務(wù)自帶進(jìn)度回調(diào)和斷點(diǎn)續(xù)傳能力代碼量少穩(wěn)定性高。import { request } from kit.BasicServicesKit; let downloadTask await request.downloadFile(context, { url: http://192.168.1.100:8080/app-1.0.2.hap, filePath: ${context.cacheDir}/update/app-1.0.2.hap }); downloadTask.on(progress, (data) { console.info(UpdateManager progress: ${data.receivedSize}/${data.totalSize}); });文件路徑這塊是個(gè)隱性坑。我見過不少人把更新包直接寫到filesDir結(jié)果安裝時(shí)會(huì)遇到沙箱路徑傳參問題。我的建議是下載到cacheDir/update/下面原因有兩個(gè)一是更新包屬于臨時(shí)數(shù)據(jù)裝完就應(yīng)該清理二是cacheDir空間被系統(tǒng)清理不影響用戶業(yè)務(wù)數(shù)據(jù)即使更新包殘留也不會(huì)白白占用用戶手機(jī)空間。下載完成后什么算成功標(biāo)準(zhǔn)有兩層下載任務(wù)狀態(tài)正常返回且落盤文件大小與服務(wù)器返回的size一致。如果服務(wù)器能提供MD5建議再校驗(yàn)一遍調(diào)試階段可以省掉但正式上線最好加上。2.4 拉起安裝把 hap 交給系統(tǒng)讓用戶確認(rèn)下載完成后就是拉起系統(tǒng)安裝頁(yè)面。HarmonyOS里應(yīng)用自身不能靜默安裝必須通過系統(tǒng)安裝能力最終由用戶點(diǎn)擊確認(rèn)。代碼結(jié)構(gòu)如下// 示意代碼具體action與參數(shù)名以當(dāng)前SDK文檔為準(zhǔn) let want { action: ohos.intent.action.INSTALL_PACKAGE, parameters: { path: ${context.cacheDir}/update/app-1.0.2.hap } }; context.startAbility(want).then(() { console.info(UpdateManager: install page launched); }).catch((err) { console.error(UpdateManager: startAbility failed, ${JSON.stringify(err)}); });這一段在API 12HarmonyOS NEXT上行為會(huì)比舊版嚴(yán)格很多。系統(tǒng)會(huì)強(qiáng)制校驗(yàn)hap包的簽名和來(lái)源如果簽名不一致安裝頁(yè)面會(huì)直接拒絕或者安裝到一半報(bào)“安裝失敗”。這也是我說未上架調(diào)試時(shí)最容易碰壁的點(diǎn)具體原因在第五章展開。另外安裝結(jié)果不在startAbility的返回值里因?yàn)槔鸢惭b頁(yè)后用戶可能確認(rèn)、取消、也可能因?yàn)楹灻麊栴}直接失敗。你需要通過“安裝后重查版本號(hào)”來(lái)驗(yàn)證是否真的裝上了這個(gè)檢測(cè)方法我放在第四章第4節(jié)。3. 把“遠(yuǎn)端更新源”搬到本地搭建調(diào)試版本服務(wù)與測(cè)試包如果你已經(jīng)有一個(gè)測(cè)試服務(wù)器可以跳過本章直接看第四章的檢測(cè)清單。如果和我一樣平時(shí)主要用DevEco Studio本機(jī)調(diào)試那這一章就是為你準(zhǔn)備的——十分鐘搭一個(gè)本地更新源讓手機(jī)和平板能訪問到。3.1 準(zhǔn)備兩個(gè)版本的測(cè)試 hap更新鏈路要跑通至少需要兩個(gè)不同versionCode的包一個(gè)當(dāng)當(dāng)前安裝的老版本一個(gè)當(dāng)服務(wù)器上的新版本。操作上很簡(jiǎn)單在DevEco Studio里把a(bǔ)pp.json5的versionCode先設(shè)成1000001打一個(gè)包安裝到手機(jī)然后把versionCode改到1000002再把versionName改成1.0.2打出的這個(gè)包放到你的更新服務(wù)器目錄下。有一個(gè)細(xì)節(jié)要注意調(diào)試階段建議都用同一個(gè)簽名來(lái)打這兩個(gè)包。如果你用DevEco Studio的自動(dòng)簽名Debug簽名裝老版本但塞到服務(wù)器上的新版本換了上傳簽名或Release簽名那安裝環(huán)節(jié)會(huì)報(bào)簽名不一致干擾你判斷“工期是不是真的通了”。還有一個(gè)技巧為了讓下載進(jìn)度看得清楚你可以在新版本里隨便塞一個(gè)幾MB的素材讓hap包大一點(diǎn)這樣下載進(jìn)度條變化明顯不會(huì)一兩秒就閃過去。3.2 一個(gè)十分鐘就能跑起來(lái)的本地更新服務(wù)我一直覺得調(diào)試階段沒必要上個(gè)完整后端Python的標(biāo)準(zhǔn)庫(kù)就能搞定更新接口和文件托管。下面這個(gè)腳本可以直接保存為update_server.py運(yùn)行# update_server.py -- 本機(jī)調(diào)試用不建議直接上生產(chǎn) import json import os from http.server import BaseHTTPRequestHandler, HTTPServer from urllib.parse import urlparse, parse_qs HAP_FILE app-1.0.2.hap # 與腳本放同一個(gè)目錄 CURRENT_CODE 1000002 # 服務(wù)器認(rèn)為的最新版本號(hào) PORT 8080 class UpdateHandler(BaseHTTPRequestHandler): def log_message(self, fmt, *args): pass # 去掉默認(rèn)的訪問日志噪音 def do_GET(self): url urlparse(self.path) if url.path /api/update: current int(parse_qs(url.query).get(versionCode, [0])[0]) if current CURRENT_CODE: data { code: 0, data: { hasUpdate: True, versionCode: CURRENT_CODE, versionName: 1.0.2, downloadUrl: http://電腦局域網(wǎng)IP:8080/app-1.0.2.hap } } else: data {code: 0, data: {hasUpdate: False}} body json.dumps(data).encode(utf-8) self.send_response(200) self.send_header(Content-Type, application/json; charsetutf-8) self.send_header(Content-Length, str(len(body))) self.end_headers() self.wfile.write(body) elif url.path f/{HAP_FILE}: if not os.path.exists(HAP_FILE): self.send_error(404) return self.send_response(200) self.send_header(Content-Type, application/octet-stream) self.send_header(Content-Length, str(os.path.getsize(HAP_FILE))) self.end_headers() with open(HAP_FILE, rb) as f: self.wfile.write(f.read()) else: self.send_error(404) if __name__ __main__: HTTPServer((0.0.0.0, PORT), UpdateHandler).serve_forever()啟動(dòng)后先用電腦瀏覽器驗(yàn)證一下訪問http://127.0.0.1:8080/api/update?versionCode1000001應(yīng)該能看到JSON返回hasUpdate: true。再把versionCode1000002傳一次應(yīng)該返回hasUpdate: false。接口通了這個(gè)服務(wù)就跑起來(lái)。這里那個(gè)電腦局域網(wǎng)IP需要你換成實(shí)際的IP不要照抄。真機(jī)訪問時(shí)不能填127.0.0.1那是手機(jī)自己。3.3 讓手機(jī)/平板找到開發(fā)電腦最省事的方案是讓手機(jī)和電腦連同一個(gè)WiFi然后給手機(jī)一個(gè)局域網(wǎng)IP下的下載地址。電腦IP怎么查Windows下在命令行敲ipconfig找“無(wú)線局域網(wǎng)適配器 WLAN”下面的IPv4地址Mac下在終端敲ipconfig getifaddr en0Linux桌面用ip addr。查到IP后先做兩件事驗(yàn)證連通性手機(jī)瀏覽器直接訪問http://電腦IP:8080/app-1.0.2.hap能看到下載動(dòng)作就是通的。如果打不開九成是電腦防火墻攔了8080端口。Windows在“允許應(yīng)用通過防火墻”里放行Python或者在入站規(guī)則里臨時(shí)放行8080然后重試。如果你用的是DevEco Studio的模擬器就不存在局域網(wǎng)IP的問題但模擬器訪問宿主機(jī)通常有專用的映射地址查一下當(dāng)前模擬器的網(wǎng)絡(luò)說明就行不要照搬真機(jī)的IP方案。3.4 權(quán)限與明文HTTP調(diào)試期的小配置HarmonyOS應(yīng)用要訪問網(wǎng)絡(luò)必須先在module.json5里申請(qǐng)ohos.permission.INTERNET權(quán)限。忘了這一步請(qǐng)求會(huì)直接失敗而且有時(shí)候日志不直觀。{ module: { name: entry, type: entry, requestPermissions: [ { name: ohos.permission.INTERNET } ] } }還有一個(gè)隱形問題本地調(diào)試時(shí)服務(wù)器地址是http://明文而HarmonyOS從某個(gè)版本開始對(duì)明文流量有限制。如果請(qǐng)求發(fā)起后一直報(bào)錯(cuò)提示不安全連接要么臨時(shí)在網(wǎng)絡(luò)配置里放行明文流量要么干脆把本地服務(wù)套一層HTTPS開發(fā)環(huán)境也可以用openssl生成自簽名證書但真機(jī)上還要處理證書信任比較麻煩。我的經(jīng)驗(yàn)是調(diào)試期優(yōu)先處理明文HTTP的放行把鏈路跑通正式上線再統(tǒng)一換HTTPS不要一上來(lái)就糾結(jié)證書。4. 從觸發(fā)更新到安裝成功調(diào)試檢測(cè)的完整操作清單環(huán)境搭好了代碼也寫得差不多了接下來(lái)按步驟把整個(gè)更新功能從頭到尾測(cè)一遍。這一章我給出一套可復(fù)用的操作清單每一步都帶預(yù)期結(jié)果方便自測(cè)也方便團(tuán)隊(duì)內(nèi)部轉(zhuǎn)交。4.1 確認(rèn)當(dāng)前版本先排除“裝的不是你以為的包”調(diào)試最怕的是你辛辛苦苦測(cè)了半小時(shí)最后發(fā)現(xiàn)手機(jī)上裝的包根本不是你以為的那個(gè)版本。所以第一步永遠(yuǎn)是把當(dāng)前版本確認(rèn)清楚。手機(jī)上可以直接看應(yīng)用“關(guān)于”頁(yè)里的版本號(hào)但更可靠的方式是用hdc命令行工具h(yuǎn)dc shell bm dump -n 你的包名 | grep -E versionCode|versionNamebm dump是鴻蒙設(shè)備側(cè)的包管理命令能直接看到已安裝應(yīng)用的版本信息。hdc工具在DevEco Studio的toolchains目錄下把它的路徑加到環(huán)境變量里或者直接在DevEco終端里執(zhí)行。這一條命令應(yīng)該出現(xiàn)在你的調(diào)試肌肉記憶里因?yàn)樗芡瑫r(shí)驗(yàn)證兩件事應(yīng)用裝沒裝上、裝的是哪個(gè)版本。4.2 觸發(fā)更新并驗(yàn)證請(qǐng)求與返回版本確認(rèn)后進(jìn)入應(yīng)用執(zhí)行檢查更新的動(dòng)作點(diǎn)按鈕或等自動(dòng)觸發(fā)。此時(shí)打開本地更新服務(wù)器的終端窗口應(yīng)該能看到客戶端發(fā)來(lái)的請(qǐng)求記錄。我腳本里屏蔽了默認(rèn)日志如果你想觀察請(qǐng)求可以臨時(shí)在do_GET里加一行print(self.path)。這一步的驗(yàn)證點(diǎn)有三個(gè)客戶端確實(shí)發(fā)出了帶versionCode參數(shù)的請(qǐng)求。服務(wù)器返回的JSON能被客戶端正確解析沒有類型轉(zhuǎn)換之類的崩潰。返回hasUpdate: true時(shí)界面彈出了更新提示框版本號(hào)、更新說明文案和服務(wù)器返回一致。如果提示框沒彈出來(lái)優(yōu)先看客戶端日志里解析是否異常再看服務(wù)器返回的JSON格式是否符合預(yù)期。我遇到過一種情況服務(wù)器返回的versionName是1.0.2但客戶端代碼用了parseInt去轉(zhuǎn)換直接導(dǎo)致提示框崩潰這種小問題在聯(lián)調(diào)階段特別容易發(fā)生。4.3 下載階段的進(jìn)度與異常驗(yàn)證提示框彈出后點(diǎn)擊“立即更新”進(jìn)入下載階段。這時(shí)候你的本地服務(wù)器會(huì)開始傳輸hap文件。正常的現(xiàn)象是客戶端出現(xiàn)進(jìn)度條或者通過日志能看到progress回調(diào)的receivedSize在增長(zhǎng)。建議刻意做兩次異常測(cè)試測(cè)試一下載過程中把手機(jī)WiFi斷掉觀察客戶端有沒有走到失敗分支有沒有給出“下載失敗請(qǐng)重試”之類的提示。很多團(tuán)隊(duì)只測(cè)順風(fēng)路斷網(wǎng)場(chǎng)景根本沒人看。測(cè)試二服務(wù)器返回的size字段故意寫成錯(cuò)誤的比如比真實(shí)大小大很多看客戶端下載完成后會(huì)不會(huì)做大小校驗(yàn)。如果代碼里直接跳過校驗(yàn)這個(gè)問題會(huì)在用戶身上以“下載完成但安裝失敗”的形式暴露。下載完成的正常標(biāo)準(zhǔn)日志看到progress達(dá)到totalSize然后應(yīng)用跳轉(zhuǎn)到拉起安裝的邏輯。你還可以在下載完成后用hdc進(jìn)文件目錄看一眼hdc shell ls -l /data/app/el2/100/base/你的包名/haps/entry/cache/update/注意不同SDK版本的沙箱路徑規(guī)則可能不一樣最簡(jiǎn)單的是在代碼里把下載路徑打日志然后用日志里的路徑去查文件。4.4 安裝拉起、覆蓋安裝與結(jié)果確認(rèn)下載完成后的動(dòng)作是拉起系統(tǒng)安裝頁(yè)面。操作到這一步觀察點(diǎn)有三個(gè)是否彈出了系統(tǒng)安裝確認(rèn)窗口。點(diǎn)擊確認(rèn)后安裝是否報(bào)錯(cuò)簽名不一致、包已損壞等都會(huì)在這里暴露。安裝完成后重新打開應(yīng)用顯示的版本號(hào)是不是新版本。重開應(yīng)用后不要急著點(diǎn)“檢查更新”先用前面提到的bm dump確認(rèn)版本號(hào)確實(shí)切換到了新版本然后再點(diǎn)一次檢查更新此時(shí)服務(wù)器應(yīng)該返回hasUpdate: false界面提示“已是最新版本”。這一條閉環(huán)走完整個(gè)更新功能才算真正合格。這里再提醒一句安裝結(jié)果不要依賴startAbility返回的Promise因?yàn)橛脩艨赡苋∠?、也可能安裝失敗。一定要靠“安裝后重查版本號(hào)”來(lái)判定結(jié)果這是最穩(wěn)的檢測(cè)方式。4.5 全程日志觀測(cè)DevEco Log 和 hdc/hilog 雙管齊下調(diào)試全程建議開兩個(gè)日志通道DevEco Studio的Log面板優(yōu)點(diǎn)是可以直接看到console.info日志和崩潰堆棧適合在開發(fā)調(diào)試期看業(yè)務(wù)邏輯。命令行hdc shell hilog優(yōu)點(diǎn)是不受DevEco運(yùn)行狀態(tài)影響即使應(yīng)用是手動(dòng)安裝的也能看到系統(tǒng)側(cè)日志。常用命令大概是hdc shell hilog | grep UpdateManager我習(xí)慣在代碼里把每個(gè)階段的關(guān)鍵日志都加上UpdateManager前綴這樣排查問題時(shí)一行命令就能過濾出完整鏈路。日志一定要舍得打更新功能本身不復(fù)雜怕的是故障時(shí)靠猜。5. 未上架調(diào)試特有的大坑簽名、版本號(hào)、路徑與日志斷連這一章是干貨中的干貨全是我自己或團(tuán)隊(duì)在未上架狀態(tài)下調(diào)試更新功能時(shí)真實(shí)踩過的坑。每一個(gè)都足以讓半天調(diào)試時(shí)間白費(fèi)希望你提前繞開。5.1 簽名不一致調(diào)試包與發(fā)布包涇渭分明現(xiàn)象很典型下載進(jìn)度100%系統(tǒng)安裝頁(yè)面也彈了點(diǎn)確認(rèn)之后直接報(bào)“安裝失敗”?？慈罩径喟胧呛灻ｒ?yàn)失敗。根因在于你用DevEco Studio的自動(dòng)簽名打了一個(gè)Debug包安裝到手機(jī)但服務(wù)器上放的新版本hap用了上傳簽名或者別的證書簽名。兩個(gè)包簽名不一致系統(tǒng)拒絕覆蓋安裝。這類問題在未上架調(diào)試階段特別容易踩因?yàn)槟愀静粫?huì)去注意簽名。解決方案有兩個(gè)整個(gè)調(diào)試期統(tǒng)一簽名。Debug包和測(cè)試包都用DevEco的自動(dòng)簽名保證覆蓋安裝能過。如果就是要驗(yàn)證“簽名不一致”時(shí)的表現(xiàn)那就把這次當(dāng)成一個(gè)獨(dú)立的測(cè)試用例明確預(yù)期結(jié)果就是安裝失敗而不是讓它混在正常鏈路測(cè)試?yán)锔蓴_判斷。另外要記住真機(jī)連DevEco調(diào)試時(shí)每次Run都相當(dāng)于重新安裝。如果你在設(shè)備上手動(dòng)裝了一個(gè)測(cè)試包再點(diǎn)DevEco的Run它會(huì)先卸載再安裝這是正常的不要當(dāng)成更新功能的問題。5.2 版本號(hào)比較字符串排序坑了所有人檢查更新時(shí)最常見的低級(jí)bug就是用versionName做比較。字符串比較有一個(gè)人盡皆知的坑1.0.9 1.0.10因?yàn)榘醋值湫虮容^時(shí)9比1大。所以再次強(qiáng)調(diào)邏輯判斷只認(rèn)整數(shù)versionCodeversionName只做展示。服務(wù)器返回的字段要設(shè)計(jì)成同時(shí)給versionCode和versionName客戶端判斷用前者展示用后者兩不耽誤。還有一個(gè)細(xì)節(jié)versionCode在HarmonyOS里是整數(shù)不要用負(fù)數(shù)不要用超長(zhǎng)數(shù)字。我曾見過一個(gè)團(tuán)隊(duì)為了配合灰度策略把版本號(hào)寫成1000000321這種很長(zhǎng)的大數(shù)雖然沒出事但完全沒有必要版本號(hào)只要保證單調(diào)遞增就行。5.3 文件路徑與 URI拉到安裝界面卻找不到文件下載是成功的文件也確實(shí)寫進(jìn)去了但拉起安裝時(shí)系統(tǒng)提示“找不到文件”。這種情況多半是傳給startAbility的參數(shù)不對(duì)。HarmonyOS的沙箱機(jī)制下應(yīng)用能訪問的是自己的filesDir、cacheDir等目錄。如果你把更新包下載到了這些目錄之外或者構(gòu)建Intent時(shí)用了不正確的路徑格式系統(tǒng)側(cè)自然找不到。調(diào)試時(shí)我的做法是下載完成后立刻打一條日志打印完整路徑和文件大小。用hdc進(jìn)沙箱目錄實(shí)際看一眼文件是否存在。確保傳給系統(tǒng)的路徑和日志里打印的完全一致。另外不同SDK版本對(duì)打開文件的協(xié)議支持可能不同有的版本要求傳file://協(xié)議有的直接傳絕對(duì)路徑就行。這個(gè)以你工程對(duì)應(yīng)的SDK文檔為準(zhǔn)不要盲抄網(wǎng)上舊代碼。5.4 DevEco 重新 Run 打斷沙箱更新測(cè)到一半就清場(chǎng)這個(gè)坑尤其隱蔽。你正在真機(jī)上測(cè)更新下載完了準(zhǔn)備點(diǎn)系統(tǒng)安裝頁(yè)面。這時(shí)候如果你不小心在DevEco Studio里點(diǎn)了Run或者手機(jī)上重新裝了應(yīng)用沙箱目錄會(huì)被系統(tǒng)清理剛才下載的hap包直接沒了。安裝頁(yè)面即使彈出來(lái)也找不到目標(biāo)文件。解決辦法是測(cè)更新鏈路時(shí)不要中途重新Run工程。如果需要重裝用hdc install -r覆蓋安裝避免清空沙箱。我自己還養(yǎng)成了一個(gè)習(xí)慣——下載下來(lái)的更新包文件名帶版本號(hào)比如app-1.0.2.hap這樣就算文件真的被清了日志里也能明確看到是誰(shuí)清掉了鏈路。5.5 “已是最新”測(cè)不出來(lái)等于號(hào)語(yǔ)義要提前定更新檢測(cè)邏輯里有一個(gè)產(chǎn)品層面容易忽略的點(diǎn)當(dāng)客戶端版本號(hào)等于服務(wù)器版本號(hào)時(shí)到底顯示什么大多數(shù)實(shí)現(xiàn)是if (serverVersionCode currentVersionCode) 有更新 else 無(wú)更新所以等于時(shí)顯示“已是最新”。但在調(diào)試階段你為了驗(yàn)證“已是最新”的展示必須把服務(wù)器版本號(hào)改成和你當(dāng)前安裝版本一致。很多團(tuán)隊(duì)只準(zhǔn)備了“有更新”的包一測(cè)到“已是最新”就被卡住以為功能壞了。其實(shí)不是是測(cè)試數(shù)據(jù)沒設(shè)計(jì)好。我建議準(zhǔn)備三組測(cè)試數(shù)據(jù)服務(wù)器版本號(hào)大于當(dāng)前有更新、等于當(dāng)前已是最新、小于當(dāng)前異常場(chǎng)景驗(yàn)證客戶端能兜住。三組都過才說明版本比較邏輯是真的穩(wěn)了。6. 調(diào)試環(huán)境回歸上線更新策略的取舍與收尾建議本地鏈路完全跑通只是第一步。真要上架你還需要面對(duì)“官方應(yīng)用市場(chǎng)通道”和“自建通道”的取舍。這里我給一點(diǎn)實(shí)際建議。6.1 上架前用官方更新通道回歸一遍如果正式產(chǎn)品打算走AppGallery的應(yīng)用內(nèi)更新SDK上架前必須用官方SDK完整回歸一遍更新流程。注意這時(shí)候你已經(jīng)上架或者在AGC后臺(tái)配置了灰度版本SDK才能拉到列表。回歸時(shí)重點(diǎn)驗(yàn)證三件事SDK的更新策略強(qiáng)制更新、非強(qiáng)制更新是否符合產(chǎn)品定義。權(quán)限彈窗和隱私說明是否合規(guī)應(yīng)用市場(chǎng)審核對(duì)這部分很敏感。從舊版本升到新版本后應(yīng)用數(shù)據(jù)是否保留。更新不同于卸載重裝用戶數(shù)據(jù)應(yīng)該原樣保留這一點(diǎn)在自建通道里可能靠覆蓋安裝天然成立但在官方SDK里也需要確認(rèn)一次。不要以為本地自建鏈路測(cè)通了官方SDK就一定通API不同、鑒權(quán)方式不同、版本分發(fā)策略也不同花半天時(shí)間回歸是值得的。6.2 自更新通道要不要保留我的取舍建議很多團(tuán)隊(duì)因?yàn)橐龌叶取⒁@開市場(chǎng)審核周期傾向于保留自建更新通道。我的看法是調(diào)試期用自建通道沒問題但正式環(huán)境優(yōu)先走官方應(yīng)用內(nèi)更新除非你能保證自建通道的簽名校驗(yàn)、HTTPS傳輸、包源安全都做到位。自建通道最大的風(fēng)險(xiǎn)不是技術(shù)上跑不通而是用戶從“應(yīng)用市場(chǎng)版”升級(jí)時(shí)道德信任和安全感知很微妙。萬(wàn)一自建通道被中間人攻擊或者包源被污染影響的是整個(gè)應(yīng)用的口碑。應(yīng)用市場(chǎng)審核看到應(yīng)用有自更新邏輯也會(huì)重點(diǎn)檢查這是另一個(gè)不可控因素。如果你最終還是決定保留自更新至少做到三點(diǎn)下載URL一律HTTPS、安裝前校驗(yàn)文件MD5或簽名、每次更新前彈明確說明。這三點(diǎn)能幫你規(guī)避九成風(fēng)險(xiǎn)。6.3 最后小技巧把更新地址做成構(gòu)建期可配置調(diào)試期你用的服務(wù)器地址是http://192.168.1.100:8080上線時(shí)要改成正式域名。最怕的是開發(fā)人員上線時(shí)忘了改地址導(dǎo)致正式用戶全部連到內(nèi)網(wǎng)IP。我建議把更新接口地址做成按構(gòu)建類型配置Debug構(gòu)建讀本地環(huán)境里的配置指向本地或測(cè)試服務(wù)器。Release構(gòu)建只允許讀正式域名調(diào)試地址硬編碼不進(jìn)Release邏輯。實(shí)現(xiàn)方式很簡(jiǎn)單在工程里用一個(gè)常量文件區(qū)分buildMode或者在CI/CD環(huán)境變量里注入地址。這個(gè)改動(dòng)成本不大但能徹底杜絕“上線忘改地址”這種低級(jí)事故。整個(gè)流程測(cè)下來(lái)你會(huì)發(fā)現(xiàn)HarmonyOS應(yīng)用更新功能的調(diào)試難點(diǎn)不在“上架”而在你對(duì)簽名、沙箱路徑、網(wǎng)絡(luò)策略這些基礎(chǔ)工作的熟悉程度。把這些基礎(chǔ)打牢未上架階段測(cè)出來(lái)的結(jié)果基本就能代表線上行為。以后不管產(chǎn)品怎么變只要版本號(hào)管理和簽名策略不亂更新功能這道關(guān)就守得住。