本文主要是介绍UniAPP 安卓应用版本自动更新及下载安装,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!
一. 前言
近期进行 Uniapp
的开发,在项目发布的最后需要实现版本的自动检测和更新下载功能
特地在此进行文章的整理,以方便道友们减少前进道路上的坎坷,多谢指摘 …
注: 本次指导,以更新
安卓应用
为案例(非热更新),ios、小程序等可举一反三,稍作优化!
二. 设计思路
1. 在服务端配置一个最新的应用版本号;并将打包生成的 apk(安卓应用) 置于服务器,保证可成功访问的链接2. 在前端 Uniapp 的最常用的访问页面 (比如,鄙人选取的是 首页vue);设置当前应用的版本号;并进行代码编写,判断缓存时间和版本号的大小;进而通过提示窗口,指导用户实现版本的更新下载等 ...
三. 代码配置实现
- 代码的编写与配置,需要分服务端和UniAPP前端的修改,不要混乱,按部就班就好
①☞ 服务端代码配置
- 首先需要配置一下最新的应用版本
以我的ThinkPHP5.1
框架结构为例,参考如下:
- 定义检测安卓版本的请求链接
以我的PHP实现方式
为例如下,注意:补充了一下鄙人自定义使用的函数showMsg()
/*** 检测安卓版本的请求链接* @param Request $request*/public function checkAndroidVersion(Request $request){//此处 version 为配置的一个版本号,整数,例:102$version = config("app.android_app_version");return showMsg(1,"checkAndroidVersion",['version'=>$version,'timestamp'=>time()]);}//TODO 补充自定义函数 showMsg()/*** 公用的方法 返回json数据,进行信息的提示* @param $status 状态* @param string $message 提示信息* @param array $data 返回数据*/function showMsg($status,$message = '',$data = array()){$result = array('status' => $status,'message' =>$message,'data' =>$data);exit(json_encode($result));}
②☞ UniAPP 前端代码配置指导
- 首先进行当前版本号的设置
一般在每次确定发布前进行更新即可,同时要保证和服务器中的版本号一致(建议使用整数,递增 ↑)
data() {return {version:101,}},
- 然后进行检测操作
为保证版本检测的即时性,我选择将方法配置于onShow()
中
onShow(){uni.getSystemInfo({success:(res) => {//检测当前平台,如果是安卓则启动安卓更新 if(res.platform=="android"){ this.AndroidCheckUpdate(); } } })},
- 后面就是处理上面一步中所调用的自定义方法 ——
AndroidCheckUpdate()
等
建议阅读代码,参考我的注释进行理解即可,不算麻烦
methods: {/*** 安卓应用的检测更新实现*/AndroidCheckUpdate:function(){ var _this = this; uni.request({//请求地址,设置为自己的服务器链接url: GLOBAL.DOMAIN_URL+'/uniapi/checkAndroidVersion.html',//method: 'GET', data: {}, success: resMz => {var server_version = resMz.data.data.version;var currTimeStamp = resMz.data.data.timestamp;// 判断缓存时间uni.getStorage({key: 'tip_version_update_time',success: function (res) {var lastTimeStamp = res.data;//定义提醒的时间间隔,避免烦人的一直提示,一个小时:3600;一天:86400var tipTimeLength = 3600;if((lastTimeStamp+tipTimeLength) > currTimeStamp){//避免多次提醒,不要更新console.log("避免多次提醒,不要更新");}else{//重新设置时间戳_this.setStorageForAppVersion(currTimeStamp);//进行版本型号的比对 以及下载更新请求_this.checkVersionToLoadUpdate(server_version, _this.version);}},fail:function(res){_this.setStorageForAppVersion(currTimeStamp);}});}, fail: () => {}, complete: () => {} }); }, /*** //设置应用版本号对应的缓存信息* @param {Object} currTimeStamp 当前获取的时间戳*/setStorageForAppVersion:function(currTimeStamp){uni.setStorage({key: 'tip_version_update_time',data: currTimeStamp,success: function () {console.log('setStorage-success');}});},/*** 进行版本型号的比对 以及下载更新请求* @param {Object} server_version 服务器最新 应用版本号* @param {Object} curr_version 当前应用版本号*/checkVersionToLoadUpdate:function(server_version,curr_version){if(server_version > curr_version){//TODO 此处判断是否为 WIFI连接状态if(plus.networkinfo.getCurrentType()!=3){uni.showToast({ title: '有新的版本发布,检测到您目前非Wifi连接,为节约您的流量,程序已停止自动更新,将在您连接WIFI之后重新检测更新', mask: true, duration: 5000,icon:"none"}); return; }else{uni.showModal({title: "版本更新",content: '有新的版本发布,检测到您当前为Wifi连接,是否立即进行新版本下载?',confirmText:'立即更新',cancelText:'稍后进行',success: function (res) {if (res.confirm) {uni.showToast({icon:"none",mask: true,title: '有新的版本发布,检测到您目前为Wifi连接,程序已启动自动更新。新版本下载完成后将自动弹出安装程序', duration: 5000, }); //设置 最新版本apk的下载链接var downloadApkUrl = GLOBAL.DOMAIN_URL+"/apk/mzz2.apk";var dtask = plus.downloader.createDownload( downloadApkUrl, {}, function ( d, status ) { // 下载完成 if ( status == 200 ) { plus.runtime.install(plus.io.convertLocalFileSystemURL(d.filename),{},{},function(error){ uni.showToast({ title: '安装失败', duration: 1500 }); })} else { uni.showToast({ title: '更新失败',duration: 1500 }); } }); dtask.start();} else if (res.cancel) {console.log('稍后更新');}}});}}},}
四. 运行效果:
附录:
①☞ 如果 测试遇到报错 :ReferenceError: plus is not defined
那是因为没有使用安卓真机、虚拟机测试,如果使用了谷歌浏览器是不支持的哦
②☞ 注意事项:
①. AndroidCheckUpdate() 中的请求地址 url 不要错哦②. AndroidCheckUpdate() 中的 tipTimeLength 需要自定义设置,以秒为单位③. checkVersionToLoadUpdate() 中最新版本apk的下载链接 downloadApkUrl 不要配置错
③☞ 使用步骤:
①. 前端代码更新完成后,确定修改一下 当前版本号 version,可以递增加一就好
②. 代码打包(我是云打包)后,将得到的 打包文件(apk 等) 准确放置于 下载链接 downloadApkUrl
下
③. 更新服务端配置项:android_app_version
,确认与第①步中的版本号一致
④☞ 参考文章:
- uni APP自动更新并安装
这篇关于UniAPP 安卓应用版本自动更新及下载安装的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!