README
APP版本更新、强制更新、漂亮的更新界面、IOS更新(跳转IOS store)、wgt更新
常见问题
1.安卓apk下载完成后没有更新APP?
答:问题是因为没有添加APP安装应用的权限,解决方法在manifest.json
文件里面APP模块权限配置
的Android打包权限配置
勾选以下权限
<uses-permission android:name=\"android.permission.INSTALL_PACKAGES\"/>
<uses-permission android:name=\"android.permission.REQUEST_INSTALL_PACKAGES\"/>
若还有问题请看安装apk无法执行的解决方案
2.APP更新后版本号没变,还是之前的版本号?
答:可能是更新的安装包没有升级版本号,manifest.json
文件里面基本设置应用版本号
和应用版本名称
需要升高(保持一直减少问题)
3.APP更新后没有覆盖之前的APP?
答:可能是更新的安装包包名
和APP的包名
不一样
4.弹窗的图标不显示?
答:检查图片是不是放项目资源文件static
,然后重新运行项目
5.版本号是在前端对比还是在后端接口对比?
答:当前案例是本地的版本号通过接口传递给后台,是后台对比的,若需要前端对比,请在接口返回数据的地方修改,不更新就不要调用callback
方法
6.本地的版本号比接口的版本号高还弹窗升级窗口?
答:当前案例是本地的版本号通过接口传递给后台,后台对比是否需要升级,不需要升级就不要返回数据(特别是需要wgt更新的,建议这种方式)
第一步关键
配置APP更新接口(可以参考上面的示例)
在项目目录下config/componentConfig.js
里面如下配置
// 此方法是接口请求方法
/**** 此文件说明请看注释 *****/
// 可以用自己项目的请求方法
// 请求配置说明:https://ext.dcloud.net.cn/plugin?id=822
import { http } from '@/common/service/service.js'
/**** 结束 *****/
const platform = uni.getSystemInfoSync().platform;
export default {
// 发起ajax请求获取服务端版本号 接口请求
getServerNo: (version, isPrompt = true, callback) => {
let httpData = {
version: version.versionCode,
// 版本名称
versionName: version.versionName,
// setupPage参数说明(判断用户是不是从设置页面点击的更新,如果是设置页面点击的更新,有不要用静默更新了,不然用户点击没反应很奇怪的)
setupPage: isPrompt
};
if (platform == "android") {
httpData.type = 1101;
} else {
httpData.type = 1102;
}
/* 接口入参说明
* version: 应用当前版本号(已自动获取)
* versionName: 应用当前版本名称(已自动获取)
* type:平台(1101是安卓,1102是IOS)
*/
/****************以下是示例*******************/
// 可以用自己项目的请求方法(接口自己找后台要,插件不提供)
http.get('/upgrade/sysAppUpgrade/list').then(par => {
let javaData = par.data.result.records[0]
let res = {
downloadUrl:javaData.appUrl,
updateType:'', //forcibly = 强制更新, solicit = 弹窗确认更新, silent = 静默更新 |
forceUpdate:"",
versionName:javaData.appVersion,
// versionName:'1.0',
versionInfo:javaData.appContent
}
// res的数据说明
// * | 参数名称 | 一定返回 | 类型 | 描述
// * | -------------|--------- | --------- | ------------- |
// * | versionCode | y | int | 版本号 |
// * | versionName | y | String | 版本名称 |
// * | versionInfo | y | String | 版本信息 |
// * | updateType | y | String | forcibly = 强制更新, solicit = 弹窗确认更新, silent = 静默更新 |
// * | downloadUrl | y | String | 版本下载链接(IOS安装包更新请放跳转store应用商店链接,安卓apk和wgt文件放文件下载链接) |
try {
uni.setStorageSync('versionName', res.versionName);
} catch (e) {
// error
}
plus.runtime.getProperty(plus.runtime.appid, function(wgtinfo) {
let client_version = wgtinfo.version
console.log('当前版本',client_version,'最新版本',res.versionName);
let flag_update = client_version.split(".").splice(0, 2).join(".") < res.versionName.split(".").splice(0, 2)
.join(".")
if(flag_update) //true 有新版本 false 没有新版本
{
if (res && res.downloadUrl) {
// 兼容之前的版本(updateType是新版才有的参数)
if(res.updateType){
callback && callback(res);
} else {
if(res.forceUpdate){
res.updateType = "forcibly";
} else {
res.updateType = "solicit";
}
callback && callback(res);
}
} else if (isPrompt) {
uni.showToast({
title: "已是最新版本",
icon: "none"
});
}
}
});
}).catch(err => {
console.log(err);
});
// });
/****************以上是示例*******************/
},
// 弹窗主颜色(不填默认粉色)
appUpdateColor: "f00",
// 弹窗图标(不填显示默认图标,链接配置示例如: '/static/demo/ic_attention.png')
appUpdateIcon: ''
}
第二步 使用方法
// App.vue页面
// #ifdef APP-PLUS
import APPUpdate from '@/uni_modules/yt-APPUpdate/js_sdk/appUpdate';
// #endif
onLaunch: function(e) {
// #ifdef APP-PLUS
APPUpdate();
// #endif
}
第三步 添加APP安装应用的权限
在manifest.json
文件里面APP模块权限配置
的Android打包权限配置
勾选以下权限
<uses-permission android:name=\"android.permission.INSTALL_PACKAGES\"/>
<uses-permission android:name=\"android.permission.REQUEST_INSTALL_PACKAGES\"/>
修改弹窗的主题色或弹窗图标
在APPUpdate/index.js
里面上面$mainColor
常量中定义主题颜色,$iconUrl
常量中定义图标地址
检查APP是否有新版本(一般在设置页面使用)
<!-- #ifdef APP-PLUS -->
<view class="cu-item arrow animation-slide-bottom" :style="[{animationDelay: '0.3s'}]" @tap="upDate">
<view class="content">
<text class="cuIcon-settingsfill text-cyan "></text>
<text class="text-grey">检查更新</text>
</view>
</view>
<!-- #endif -->
// #ifdef APP-PLUS
import APPUpdate, { getCurrentNo } from '@/uni_modules/yt-APPUpdate/js_sdk/appUpdate';
// #endif
export default {
data() {
return {
version: "" // 版本号
};
},
//第一次加载
onLoad(e) {
// #ifdef APP-PLUS
getCurrentNo(res => {
// 进页面获取当前APP版本号(用于页面显示)
this.version = res.version;
});
// #endif
},
//方法
methods: {
// 检查APP是否有新版本 事件按钮
upDate() {
const versionName = uni.getStorageSync('versionName');
console.log('版本号:',versionName);
plus.runtime.getProperty(plus.runtime.appid, function(wgtinfo) {
let client_version = wgtinfo.version
let flag_update = client_version.split(".").splice(0, 2).join(".") < versionName.split(".").splice(0, 2)
.join(".")
if(flag_update)
{
APPUpdate(false);
// true 没有新版本的时候有提示,默认:false
}
else
{
uni.showToast({
title: "已是最新版本",
icon: "none"
});
}
});
},
}
}
QQ交流群(906392632) |
---|
QQ群号:906392632 |