低版本兼容
We码功能在不断优化,但是低版本的WeLink不支持,所以在使用这些新能力的时候需要做兼容。
开发者可以通过以下方式进行低版本的兼容。
一、引入补丁文件
对于旧版本的WeLink想使用新的JSAPI,可以使用打补丁的方式实现兼容。
我们会在新开发模板的 public/js
目录下放入 hwh5.compatible.js
,旧开发模板可以点击这里下载,然后解压至 public/js
目录下即可。
// 根目录index.html引入补丁文件
<script type="text/javascript" src="../../../../common/js/hwh5.js?v=<%= htmlWebpackPlugin.options.version %>"></script>
<script type="text/javascript" src="../js/hwh5.compatible.js"></script>
注意:
hwh5.compatible.js
必须在hwh5.js
后引入。
二、方法名兼容
引入补丁文件后,即可使用新API名称进行低版本兼容,例如:
// 兼容后调用方式
HWH5.getAppInfo().then(data => {
console.log(data);
});
注意: 做兼容处理之前,需要保证当前WeLink版本支持旧的"API"调用才能做新版本兼容。
三、JSAPI 兼容列表
新API | 旧API | 基础库版本 |
---|---|---|
getAppInfo | appInfo | 10.0.5 |
getDeviceInfo | deviceInfo | 10.0.5 |
getNetworkType | networkStatus | 10.0.5 |
navigateBack | goBack | 10.0.5 |
setNavigationBarTitle | navTitle | 10.0.5 |
scanCode | scanQR | 10.0.5 |
setStorage | cache | 10.0.5 |
getStorage | cache | 10.0.5 |
clearStorage | clearCache | 10.0.5 |
removeStorage | deleteCache | 10.0.5 |
openUserProfile | viewContactInfo | 10.0.5 |
getLocation | location | 10.0.5 |
getWecodeInfo | wecodeInfo | 10.0.5 |
chooseImage | imagePicker | 10.0.5 |
showExceptionTip | exceptionTip | 10.0.5 |
showLoading | loading | 10.0.5 |
hideLoading | loading | 10.0.5 |
showToast | toast | 10.0.5 |