更新记录
3.3.1(2024-09-27) 下载此版本
优化文档和代码示例
3.3.0(2024-06-21) 下载此版本
修复请求错误loading不消失 修复wgt安装失败按钮无法再次点击 增加错误日志记录,可在管理后台查看
3.2.2(2023-12-13) 下载此版本
更新readme
查看更多平台兼容性
Vue2 | Vue3 |
---|---|
√ | √ |
App | 快应用 | 微信小程序 | 支付宝小程序 | 百度小程序 | 字节小程序 | QQ小程序 |
---|---|---|---|---|---|---|
HBuilderX 3.1.0 app-vue app-nvue | × | × | × | × | × | × |
钉钉小程序 | 快手小程序 | 飞书小程序 | 京东小程序 |
---|---|---|---|
× | × | × | × |
H5-Safari | Android Browser | 微信浏览器(Android) | QQ浏览器(Android) | Chrome | IE | Edge | Firefox | PC-Safari |
---|---|---|---|---|---|---|---|---|
× | × | × | × | × | × | × | × | × |
wrap-version-update
1.一行代码实现APP版本更新,更提供后台管理让版本的发布和迭代再也不用愁了
2.支持安卓apk安装更新、支持安卓和ios热更新、支持ios跳转到appStore更新
3.支持配置非强制更新,暴露绝大部分参数自定义性强
4.封装了大部分js方法,让向完全自定义界面的开发者更加便捷
5.提供后台管理 WrapAppStore,轻松完成版本更新
6.提供发布页,效果可查看案例 Telegram发布页
7.提供后台有偿私有化部署,具体可加群联系群主
-
由于uniCloud收费,服务器做了迁移,请插件版本低于
3.0.0
的尽快升级!!!; -
WrapAppStore官方QQ群:855298680,有问题请加群讨论,避免应用发布后无法控制版本更新造成损失;
一、后台管理添加应用
1.登录网址
点我前往WrapAppStore后台管理,后台提供版本更新服务,扫码登录即可。
2.创建应用
3.添加版本
创建完应用后,点击菜单栏的版本管理,点击添加版本即可。其中HBuilderX是否更新和是否强制更新底部皆有解释,若还不明白的可添群讨论咨询。
4.设置正式版
在添加的版本菜单栏,选择设为正式版即可。
二、使用
1.获取应用id
2.引入组件,修改id值
将插件导入项目,在首页引入组件,id记得替换为上一步获取到的
<wrap-version-update id="3729"></wrap-version-update>
// vue3需要手动引入
// import WrapVersionUpdate from '@/uni_modules/wrap-version-update/components/wrap-version-update/wrap-version-update.nvue'
// 非setup模式还需要在组件中注册
// export default{
// components:{ WrapVersionUpdate }, // 需要加到这里
// data() {
// return {}
// }
// ...
// }
3.监听事件
当需要更新会自动弹窗,当无需更新会触发finish
事件,此时可表示应用为最新版,可由此事件继续应用的相关业务逻辑。
- @check (version):无论是否需要更新都会触发事件,传入版本参数
- @finish (version): 当无需更新会触发事件,传入版本参数
- @error (err): 当发生错误会触发事件,传入错误信息
4.更多参数
参数 | 说明 | 类型 | 默认 |
---|---|---|---|
id | 应用appId | String | |
uniqueId | 唯一id,例如用户id等,可在后台查看到此值,统计某用户打开了多少次app | String | |
auto | 是否自动检查新版本,若设为false,需要主动调用$refs.versionRef.check()去检查版本,适用于当开启了不强制更新,在设置->关于中可以提供让用户主动去检查更新的入口 | Boolean | true |
apiUrl | 请求版本更新接口 | String | https://appsapi.seepine.com/v1/check |
loading | 是否显示检查接口加载 | Boolean | true |
loadingText | 加载文字 | String | 检查更新中 |
loadingMask | 加载弹窗mask,为true则不可通过返回键取消动画 | Boolean | true |
loadingDelay | 加载动画延时,默认1.5秒后出现(表现为用户网络环境差时,1.5秒接口还未获得返回值则出现加载弹窗) | Number | 1500 |
loadingDelay | 加载动画延时,默认1.5秒后出现(表现为用户网络环境差时,1.5秒接口还未获得返回值则出现加载弹窗) | Number | 1500 |
lines | 更新说明最多展示几行 | Number | 4 |
bgImage | 背景图片 | String | 默认蓝色调火箭背景图 |
btnBgColor | 升级按钮背景颜色 | String | #0a84ec |
btnTextColor | 升级按钮文字颜色 | String | #FFFFFF |
secondaryBtnText | 暂不更新按钮文字 | String | 以后再说 |
secondaryBtnTextColor | 暂不更新按钮文字颜色 | String | #afafaf |
textColor | 升级弹窗版本说明文字颜色 | String | #1e1e1e |
errToast | 检测新版本接口请求失败是否展示错误信息 | Boolean | true |
errTimes | 安装错误次数超过此值提示打开浏览器下载,一般若由高版本降回低版本会出现无法安装的情况 | Number | 2 |
三、体验
1.下载demo查看效果
打开后会提示有新版,升级使用热更新的方式。
- 直接下载apk:点击demo_1.0.0.apk
-
手机扫码下载v1.0.0
四、其他
基座版本提示
使用热更新时,若没有注意基座版本一致,用户打开app会弹出基座版本不同的弹窗,建议在 manifest.json
配置忽略
"app-plus": {
"compatible": {
"ignoreVersion": true
}
}