更新记录

0.6.1(2023-11-02)

  • 修复 输入更新内容时有长度限制的Bug

0.6.0(2023-02-24)

  • 修复 升级中心安卓应用市场不显示的Bug
查看更多

平台兼容性

阿里云 腾讯云 支付宝小程序云
×
Vue2 Vue3
App 快应用 微信小程序 支付宝小程序 百度小程序 字节小程序 QQ小程序
HBuilderX 3.3.10 app-vue app-nvue
钉钉小程序 快手小程序 飞书小程序 京东小程序
× × × ×
H5-Safari Android Browser 微信浏览器(Android) QQ浏览器(Android) Chrome IE Edge Firefox PC-Safari

uni-admin插件通用教程:

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


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中添加页面路径

    //此结构与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 -> 源码视图中添加以下配置:

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

  10. 添加菜单

    • vue2

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

    • 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的链接

    2. 强制更新

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

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

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

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

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

  • 发布wgt资源包

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

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

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

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

    2. 静默更新

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

隐私、权限声明

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

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

插件不采集任何数据

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

许可协议

升级中心 uni-upgrade-center - Admin(以下简称软件)源码使用许可协议

2022年10月

本许可协议,是数字天堂(北京)网络技术有限公司(以下简称DCloud)对其所拥有著作权的“软件”,提供的使用许可协议。

您对“软件”的复制、使用、修改及分发受本许可协议的条款的约束,如您不接受本协议,则不能使用、复制、修改本软件。

授权许可范围

a) 授予您永久性的、全球性的、免费的、非独占的、不可撤销的本软件的源码使用许可,您可以使用这些源码制作自己的应用。

b) 您只能在DCloud产品体系内使用本软件及其源码。您不能将源码修改后运行在DCloud产品体系之外的环境,比如客户端脱离uni-app,或服务端脱离uniCloud(如涉及uniCloud)。

c) DCloud未向您授权商标使用许可。您在根据本软件源码制作自己的应用时,需以自己的名义发布软件,而不是以DCloud名义发布。

d) 本协议不构成代理关系。

DCloud的责任限制 “软件”在提供时不带任何明示或默示的担保。在任何情况下,DCloud不对任何人因使用“软件”而引发的任何直接或间接损失承担责任,不论因何种原因导致或者基于何种法律理论,即使其曾被建议有此种损失的可能性。

您的责任限制

a) 您需要在授权许可范围内使用软件。

b) 您在分发自己的应用时,不得侵犯DCloud商标和名誉权利。

c) 您不得进行破解、反编译、套壳等侵害DCloud知识产权的行为。您不得利用DCloud系统漏洞谋利或侵害DCloud利益,如您发现DCloud系统漏洞应第一时间通知DCloud。您不得进行攻击DCloud的服务器、网络等妨碍DCloud运营的行为。未经书面许可,您不得利用DCloud的产品进行与DCloud争夺开发者的行为。

d) 如您违反本许可协议,需承担因此给DCloud造成的损失。

本协议签订地点为中华人民共和国北京市海淀区。

根据发展,DCloud可能会对本协议进行修改。修改时,DCloud会在产品或者网页中显著的位置发布相关信息以便及时通知到用户。如果您选择继续使用本框架,即表示您同意接受这些修改。

条款结束

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