本文針對(duì)鴻蒙上的小程序常見的一些問題適配，做下分享，大部分開發(fā)者可能就改幾行代碼(微信小程序本身就是類OS系統(tǒng)，本身就是跨端)，就能完成適配。

最近是否有人反饋微信小程序不可用或者界面異常，比如：

而開發(fā)者可能比較困惑，我的代碼一直都沒有更新過，為什么最近突然這么多報(bào)障的了？

其實(shí)很有可能反饋者使用的是華為新的鴻蒙操作系統(tǒng)，

華為的HarmonyOS 5自從24年9月開啟商用后，發(fā)展極為迅速，尤其是25年3月的pura x以及5月底的nova 14系列發(fā)布后，用戶量增長(zhǎng)迅速,預(yù)計(jì)現(xiàn)有使用者過千萬(wàn)，微信小程序作為基礎(chǔ)使用，必不可少，另外，華為新鴻蒙系統(tǒng)基本都在華為高端手機(jī)上才適配，這部分用戶本身也是相對(duì)高價(jià)值用戶，因此，小程序業(yè)主也比較關(guān)注這部分用戶，作為開發(fā)者，需要提早做兼容，避免后續(xù)輿情和緊急修復(fù)。

本文針對(duì)鴻蒙上的小程序常見的一些問題適配，做下分享，大部分開發(fā)者可能就改幾行代碼(微信小程序本身就是類OS系統(tǒng)，本身就是跨端)，就能完成適配。(微信開發(fā)者官網(wǎng)提示說明)

1. platform支持問題

小程序開發(fā)者習(xí)慣針對(duì)不同的平臺(tái)做不同的策略處理，比如，區(qū)分andorid, ios , windows, 那么在新增一個(gè)OS 系統(tǒng)HarmonyOS的時(shí)候，可能就讓程序不可用。

舉例(錯(cuò)誤代碼)：

wx.getSystemInfo({ 
success: function (t) { 
var p = t.platform; 
this.isMobile = "android" === p || "ios" === p; 
} 
fail: function (t) { 
this.isMobile = 0; 
} 
})

舉例(錯(cuò)誤代碼)：

var p = wx.getSystemInfoSync(); 
var num = { 
devtools: 44, 
ios: 40, // IOS平臺(tái) 
android: 48 // android平臺(tái) 
} [p.platform], 
this.someting.set(num);
建議修改代碼(平臺(tái)判斷時(shí)，需要增加鴻蒙平臺(tái)的識(shí)別)： 
wx.getSystemInfo({ 
success: function (t) { 
var p = t.platform; 
this.isMobile = "android" === p || "ios" === p || "ohos" === p; 
} 
fail: function (t) { 
this.isMobile = 0; 
} 
})

建議修改代碼(業(yè)務(wù)適配時(shí)，增加鴻蒙平臺(tái)的處理)：

var p = wx.getSystemInfoSync(); 
var num = { 
devtools: 44, 
ios: 40, 
android: 48, 
ohos: 48, 
} [p.platform], 
this.someting.set(num);

快速排查建議：
針對(duì)此類問題，建議在代碼中搜索 調(diào)用getSystemInfoSync /getSystemInfo/getDeviceInfo的地方，看看相關(guān)邏輯是否只處理IOS/android， 如果存在上述問題，建議優(yōu)先加入OHOS分支，嘗試讓代碼走android分支即可。

2. UserAgent支持問題

部分微信小程序開發(fā)者會(huì)使用UA的系統(tǒng)版本/XWEB等描述進(jìn)行策略區(qū)分，導(dǎo)致小程序在新增HarmonyOS的環(huán)境，代碼走入異常分支。

舉例： android 和HarmonyOS的UA參考
HarmonyOS Next 微信的 UA(微信1.0.6.41版本測(cè)試)：

Mozilla/5.0 (Phone; OpenHarmony 5.0) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/114.0.0.0 Safari/537.36 ArkWeb/4.1.6.1 Mobile MicroMessenger/8.0.6.41(0xf3100629) Weixin NetType/4G Lang uage/zh_CN MiniProgramEnv/ohos MMWE BID/8794 MMWEBSDK/202504030004X WEB/1140209

Android 系統(tǒng)微信中的 UA

Mozilla/5.0 (Linux; Android 12; ALT-AL10 Build/HUAWEIALT-AL10; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/130.0.6723.103 Mobile Safari/537.36 XWEB/1300149 MMWEBSDK/20241103 MMWEBID/6593 MicroMessenger/8.0.54.2760(0x2800363F) WeChat/arm64 Weixin NetType/WIFI Language/zh_CN ABI/arm64

如何適配：

1. 針對(duì)是否是移動(dòng)端的設(shè)備，需要增加檢測(cè)是否包含 OpenHarmony的判斷。
2. 其他針對(duì)UA返回值里面的字符串匹配，建議要區(qū)分OpenHarmony的平臺(tái)，比如，ArkWeb/XWEB.

舉例(錯(cuò)誤代碼)：

function isMobile() { 
var e = navigator.userAgent.toLowerCase(); 
return /Android|webos|iPhone|iPod|BlackBerry/i.test(e) ? !0 : 0; // 小程序只在移動(dòng)端支持 
}

建議修改代碼(平臺(tái)判斷時(shí)，需要增加鴻蒙平臺(tái)的識(shí)別)：

function isMobile() { 
var e = navigator.userAgent.toLowerCase(); 
return /Android|webos|iPhone|iPod|BlackBerry|OpenHarmony/i.test(e) ? !0 : 0; // 移動(dòng)端新增openHarmony支持 
}

快速排查建議：

針對(duì)此類問題，建議在代碼中搜索 調(diào)用navigator.userAgent的地方，看看相關(guān)邏輯是否未考慮HarmonyOS的邏輯， 如果存在上述問題，建議優(yōu)先加入OHOS分支，嘗試讓代碼走android分支即可。

3. 其他問題

作者在開發(fā)中也遇到一些其他問題，比如，鴻蒙上微信小程序的支持API還不完善，導(dǎo)致個(gè)別功能受阻，

可以去官網(wǎng)看最新的API列表中：
https://developers.weixin.qq.com/miniprogram/dev/api/

找到希望使用的API以后，在看這里可以確認(rèn)當(dāng)前是否支持鴻蒙：

遇到尚未支持的API，可以通過這里向微信小程序官方進(jìn)行反饋：
https://developers.weixin.qq.com/community/blog/create/1

好在微信現(xiàn)在更新挺快的，基本上1個(gè)月好幾個(gè)內(nèi)測(cè)版本更新，應(yīng)該是在快速補(bǔ)齊能力，建議小程序開發(fā)者可以定期1-2周查看下需要的API是否已支持。

4. 參考文檔

鴻蒙 OS 適配指南：developers.weixin.qq.com/miniprogram…
微信開放標(biāo)簽：developers.weixin.qq.com/doc/offiacc…