编辑 | blame | 历史 | 原始文档

uni-admin 1.9.3+ 已内置,此插件不再维护 点击查看文档

  • uni-admin < 1.9.0:请前往 Gitee 下载 tag v0.4.2 版本使用
    -1.9.0 <= uni-admin < 1.9.2 :请前往 Gitee 下载 tag v0.5.1 版本使用
  • uni-admin >= 1.9.3 :uni-admin 已内置 升级中心,直接使用即可 详情。并且云函数 upgrade-center 废弃,使用 uni-upgrade-center 云函数。

uni-upgrade-center - Admin

概述

统一管理App及App在AndroidiOS平台上App安装包wgt资源包的发布升级

本插件为uni升级中心后台管理系统,客户端检查更新插件请点击查看 uni-upgrade-center-app

基于uniCloud的App升级中心,本插件具有如下特征:

  • 云端基于uniCloud云函数实现
  • 数据库遵循opendb规范
  • 遵循uni-Admin框架规范,可直接导入uni-admin项目中
  • 支持App整包升级及wgt资源包升级

升级中心解决了什么问题?

升级中心是一款uni-admin插件,负责App版本更新业务。包含后台管理界面、更新检查逻辑,App内只要调用弹出提示即可。

升级中心有以下功能点:

  • 应用管理,对App的信息记录和应用版本管理
  • 版本管理,可以发布新版,也可方便直观的对当前App历史版本以及线上发行版本进行查看、编辑和删除操作
  • 版本发布信息管理,包括 更新标题,更新内容,版本号,静默更新,强制更新,灵活上线发行 的设置和修改
  • 原生App安装包,发布Apk更新,用于App的整包更新,可设置是否强制更新
  • wgt资源包,发布wgt更新,用于App的热更新,可设置是否强制更新,静默更新
  • App管理列表及App版本记录列表搜索

只需导入插件,初始化数据库即可拥有上述功能。

您也可以自己修改逻辑自定义数据库字段,和随意定制 UI 样式。

安装指引

  1. 使用HBuilderX 3.1.0+,因为要使用到uni_modules

  2. 使用已有uniCloud-admin项目或新建项目:打开HBuilderX -> 文件 -> 新建 -> 项目 -> uni-app 选择 uniCloud admin模板,键入一个名字,确定

  3. 鼠标右键选择关联云服务空间运行云服务空间初始化向导

  4. 在插件市场打开本插件页面,在右侧点击使用 HBuilderX 导入插件,选择 uniCloud admin 项目点击确定

  5. 等待下载安装完毕。由于本插件依赖一些uni-ui插件,下载完成后会显示合并插件页面,自行选择即可

  6. 找到/uni_modules/uni-upgrade-center/uniCloud/cloudfunctions/upgrade-center,右键上传部署

  7. pages.json中添加页面路径
    json //此结构与uniCloud admin中的pages.json结构一致 { "pages": [ // ……其他页面配置 { "path": "uni_modules/uni-upgrade-center/pages/version/list", "style": { "navigationBarTitleText": "版本列表" } }, { "path": "uni_modules/uni-upgrade-center/pages/version/add", "style": { "navigationBarTitleText": "新版发布" } }, { "path": "uni_modules/uni-upgrade-center/pages/version/detail", "style": { "navigationBarTitleText": "版本信息查看" } } ] }

  8. manifest.json -> 源码视图中添加以下配置:
    js "networkTimeout":{ "uploadFile":1200000 //ms, 如果不配置,上传大文件可能会超时 }

  9. 运行项目到Chrome

  10. 添加菜单

    • vue2
    运行起来uniCloud admin,菜单管理模块会自动读取`/uni_modules/uni-upgrade-center/menu.json`文件中的菜单配置,生成【待添加菜单】,选中升级中心,点击`添加选中的菜单`即可
    <div align="center">
    <img src="https://vkceyugu.cdn.bspapp.com/VKCEYUGU-a90b5f95-90ba-4d30-a6a7-cd4d057327db/16dc338e-7d5b-4290-98a9-adb7f0c23754.png" width="800"></img>
    </div>
    
    • vue3
    可将 `/uni_modules/uni-upgrade-center/menu.json` 拷贝至 `uniCloud/database/db_init.json` 中的 `opendb-admin-menus` 节点下,并右键初始化数据库即可。
    
  11. 添加成功后,就可以在左侧的菜单栏中找到升级中心菜单

  12. 在进入升级中心之前:

    1. 需要到uni-admin应用管理中添加一个应用,才可以在升级中心中发布对应应用的版本。
    2. 当你有多个应用时,可以在/uni_modules/uni-upgrade-center/pages/utils.js中修改defaultDisplayApp字段来设置默认显示应用的appid
    3. 如果不设置或设置应用不存在则默认从数据库中查出来的第一个应用。
  13. 由于插件依赖的uni-ui的一些组件,建议右键/uni_modules/uni-upgrade-center安装一下第三方依赖,否则可能会出现一些问题

  14. 运行在uniCloud,由于本插件使用了clientDB,因此可能需要配置一下uni-config-center插件关于uni-id的配置信息。如提示公用模块uni-id缺少配置信息请这样做:

    1. 点击uni-config-center导入插件
    2. /uniCloud/cloudfunctions/common/uni-config-center/下创建uni-id文件夹,文件夹内创建config.json文件。
    3. 点击config.json默认配置。将内容拷贝至config.json中。**注:一定要把注释去除!**

使用指南

升级中心

应用列表

  1. 点击菜单 应用管理,这里展示你所添加的 App,点击右上角 新增 可以新增一个 App
  1. 将App的信息都填写完善后,你可以在列表的操作列进行修改应用信息或者删除该应用。

Tips
- 删除应用会把该应用的所有版本记录同时删除

版本管理

  1. 在版本管理list的右上角点击发布新版,可以发布原生App安装包wgt资源包。在左上角点击下拉列表,可以切换展示应用。
  • 发布原生App安装包

    1. 在上传安装包界面填写此次发版信息
    1. 包地址
      • 可以选择手动上传一个文件到 云存储,会自动将地址填入该项
    - 也可以手动填写一个地址,就可以不用再上传文件
    
    - 如果是发布`苹果`版本,包地址则为 应用在`AppStore的链接`
    
    1. 强制更新
      • 如果使用强制更新,App端接收到该字段后,App升级弹出框不可取消
    1. 上线发行
      • 可设置当前包是否上线发行,只有已上线才会进行更新检测
    - 同时只可有一个线上发行版,线上发行不可更设为下线。未上线可以设为上线发行并自动替换当前线上发行版
    
    - 修改当前包为上线发行,自动替换当前线上发行版
    

    注:版本号请填写以.分隔字符串,例如:0.0.1

  • 发布wgt资源包

    1. 大部分配置与发布 原生App安装包 一致
    1. 原生App最低版本
      • 上次使用新Api或打包新模块的App版本
    - 如果此次打包wgt使用了`新的api`或者打包了`新的模块`,则在发布 `wgt资源包` 的时候,将此版本更新为本次版本
    
    - 如果已有正式版`wgt资源包`,则本次新增会自动带出
    
    1. 静默更新
      • App升级时会在后台下载wgt包并自行安装。新功能在下次启动App时生效
      • 静默更新后不重启应用,可能会导致正在访问的应用的页面数据错乱,请谨慎使用!

    注:版本号请填写以.分隔字符串,例如:0.0.1

  • 发布完成页面

Tips

  1. pages/system/upgradecenter/version/add.vue中有版本对比函数(compare)。
    • 使用多段式版本格式(如:"3.0.0.0.0.1.0.1", "3.0.0.0.0.1")。如果不满足对比规则,请自行修改。

项目代码说明

uniCloud 数据表

数据表基于 openDB 规范,它约定了一个标准用户表的表名和字段定义,并且基于 nosql 的特性,可以由开发者自行扩展字段。

本项目用到了 2 个表:

  • opendb-app-list:app管理列表。记录应用的 appid、name、description 用于展示。详见
  • opendb-app-versions:应用版本管理表。记录管理应用的版本信息。详见

前端页面

点击升级中心,会进入应用管理列表,在这里你可以新增应用,或者在应用详情中查看、修改或删除一个已经录入的应用。

在应用管理列表中点击某个应用的版本管理,进入该应用的所有版本记录。列表排序为:先排序已上线版本,剩下已下线版本根据创建时间排列。

在应用版本列表中点击详情,即可进入该版本的信息详情中查看、修改或删除该记录。

Tips
- 升级中心设计之初就支持iOS的wgt更新
- iOS的wgt更新肯定是违反apple政策的,注意事项:
- 审核期间请不要弹窗升级
- 升级完后尽量不要自行重启
- 尽量使用静默更新
- 可以通过以下修改支持iOS的wgt更新:
> \uni_modules\uni-upgrade-center\pages\mixin\version_add_detail_mixin.js
>
> 将 data 中的 enableiOSWgt: false 中 改为 enableiOSWgt: true

常见问题
- 以下问题可以通过升级插件版本解决:
- createdate不与默认值匹配
- ["create_date"]在数据库中并不存在
- 提交的字段["dirty_data"]在数据库中并不存在
- 集合[opendb-app-list]对应的schema内存在错误,详细信息:opendb-app-list表对应的schema名称冲突,这是什么意思呢

  • 没有/找不到 [opendb-app-list] 集合/表。**解决方案:**升级 admin 至 1.6.0+ 即可
  • 测试时发布了高版本的包,测试完了发布包提示需要大于版本号 (x.x.x)。**解决方案:**直接在控制台修改数据库