更新记录

0.2.2(2021-09-06)

  • 解决 opendb-app-list表对应的schema名称冲突的问题

0.2.1(2021-09-03)

  • 修复 一个在添加菜单时报错,createdate不与默认值匹配 的Bug
查看更多

平台兼容性

阿里云 腾讯云
Vue2 Vue3
×
App 微信小程序 支付宝小程序 百度小程序 字节小程序 QQ小程序 快应用
3.1.0 × × × × × ×
H5-Safari Android Browser 微信浏览器(Android) QQ浏览器(Android) Chrome IE Edge Firefox PC-Safari
× × × × × × × × ×

uniCloud admin插件通用教程:

uniCloud admin是一套基于uniCloud的开源应用管理端系统。详见:uniCloud admin 基础框架
本插件是uniCloud admin系统的扩展插件,为开发者的admin系统添加功能。
需先确保本机有uniCloud admin项目,然后将此插件导入到uniCloud admin项目下。
如本机没有uniCloud admin项目,需要先在HBuilderX中新建项目 -> uni-app项目 -> 选择uniCloud admin模板。
如本机的uniCloud admin项目版本过老,可能无法使用新插件,需及时升级本机的uniCloud admin项目。详见uniCloud admin项目更新日志


uni-upgrade-center - Admin

概述

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

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

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

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

什么是 uniCloud

uniCloud 是 DCloud 联合阿里云、腾讯云,为开发者提供的基于 serverless 模式和 js 编程的云开发平台,更多请参考uniCloud 文档

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

升级中心是一款uniCloud 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. 找到/uni_modules/uni-upgrade-center/uniCloud/database/db_init.json,右键初始化数据库

  8. pages.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": "版本信息查看"
                }
            }, {
                "path": "uni_modules/uni-upgrade-center/pages/app/list",
                "style": {
                    "navigationBarTitleText": "应用列表"
                }
            }, {
                "path": "uni_modules/uni-upgrade-center/pages/app/detail",
                "style": {
                    "navigationBarTitleText": "应用信息查看"
                }
            }, {
                "path": "uni_modules/uni-upgrade-center/pages/app/add",
                "style": {
                    "navigationBarTitleText": "新增应用"
                }
            }
    ]
  9. manifest.json -> 源码视图中添加以下配置:

    "networkTimeout":{
        "uploadFile":1200000    //ms, 如果不配置,上传大文件可能会超时
    }
  10. 运行项目到Chrome

  11. 运行起来uniCloud admin,菜单管理模块会自动读取/uni_modules/uni-upgrade-center/menu.json文件中的菜单配置,生成【待添加菜单】,选中升级中心,点击添加选中的菜单即可

  1. 添加成功后,就可以在左侧的菜单栏中找到升级中心菜单
  1. 由于插件依赖的uni-ui的一些组件,建议右键/uni_modules/uni-upgrade-center安装一下第三方依赖,否则可能会出现一些问题

  2. 运行在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的链接

    2. 强制更新

      • 如果使用强制更新,App端接收到该字段后,App升级弹出框不可取消
    3. 上线发行

      • 可设置当前包是否上线发行,只有已上线才会进行更新检测

      • 同时只可有一个线上发行版,线上发行不可更设为下线。未上线可以设为上线发行并自动替换当前线上发行版

      • 修改当前包为上线发行,自动替换当前线上发行版

  • 发布wgt资源包

    1. 大部分配置与发布 原生App安装包 一致
    1. 原生App最低版本

      • 上次使用新Api或打包新模块的App版本

      • 如果此次打包wgt使用了新的api或者打包了新的模块,则在发布 wgt资源包 的时候,将此版本更新为本次版本

      • 如果已有正式版wgt资源包,则本次新增会自动带出

    2. 静默更新

      • App升级时会在后台下载wgt包并自行安装。新功能在下次启动App时生效
  • 发布完成页面

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)。解决方案:直接在控制台修改数据库

隐私、权限声明

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

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

插件不采集任何数据

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

许可协议

MIT协议

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