更新记录

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,有问题请加群讨论,避免应用发布后无法控制版本更新造成损失;

  • 视频教程 B站:Uniapp快速实现App版本更新功能

一、后台管理添加应用

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查看效果

打开后会提示有新版,升级使用热更新的方式。

四、其他

基座版本提示

使用热更新时,若没有注意基座版本一致,用户打开app会弹出基座版本不同的弹窗,建议在 manifest.json 配置忽略

    "app-plus": {
      "compatible": {
        "ignoreVersion": true
      }
    }

隐私、权限声明

1. 本插件需要申请的系统权限列表:

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

许可协议

MIT协议

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问