App升级中心 uni-upgrade-center

展示全部

# App升级中心 uni-upgrade-center

# 概述

App升级中心 uni-upgrade-center，提供了 App 的版本更新服务。包括

Android、iOS、鸿蒙的完整App安装包升级和wgt资源包热更新
支持 uni-app 和 uni-app x。其中 uni-app 和 uni-app x 蒸汽模式支持 wgt 热更新。
后台管理系统，用于发布新版、设置升级策略

如果需要初次发布，而不是升级，另见产品 uni-portal 统一发布页

本产品具有如下特征：

开源、免费。uniCloud支付宝云版和阿里云版都有免费空间。
云端基于 uniCloud 实现。后台管理是 uni-admin 框架的插件。
数据库遵循 opendb 规范
关于应用转让后升级中心（uni-upgrade-center）的使用问题 详情

为了一套代码同时兼容 uni-app 和 uni-app x，升级中心原本的 js 文件改为了 ts 文件。如果开发者的项目下未使用ts，那么需要增加ts编译。HBuilderX项目会自动加载ts编译器，cli项目则需要自己手动配置。

# 为什么需要升级中心？

每个App开发者都要开发升级功能。
完善的升级功能细节很多：如果把apk下载升级、应用商店引导升级、wgt热更新、下载文件验签保障、版本管理、升级策略、客户端子线程处理验签升级逻辑（避免影响主UI）等一系列功能都做好，测试通过无bug，从客户端到服务器，没有十几个工作日是无法完成的。
几百万个应用，每个应用开发者都要耗费这十几个工作日是巨大的社会资源浪费。
DCloud推出 uni-upgrade-center，开源的、完善的升级系统，让开发者专注于自己的业务。

# 升级中心的系统组成

升级中心分为两个部分：

uni-upgrade-center Admin管理后台：它是 uni-admin 的一个插件，包括一组云函数。
uni-upgrade-center-app 客户端检测更新的uni_modules：它是一个客户端的uni_modules，集成到客户端项目中后，需要在app.uvue里添加调用入口。

# uni-upgrade-center Admin 管理后台

负责发布新版和管理历史版本的上下线。提供了如下功能：

云储存安装包CDN加速，使安装包下载的更快、更稳定
应用管理，对 App 的信息记录和应用版本管理
版本管理，可以发布新版，也可方便直观的对当前 App 历史版本以及线上发行版本进行查看、编辑和删除操作
版本发布信息管理，包括更新标题，更新内容，版本号，静默更新，强制更新，灵活上线发行的设置和修改
原生 App 安装包，发布 Apk 更新，用于 App 的整包更新，可设置是否强制更新
wgt 资源包，发布 wgt 更新，用于 App 的热更新，可设置是否强制更新，静默更新（uni-app x 的蒸汽模式应用支持 wgt 热更新，VDOM 不支持）
App 管理列表及 App 版本记录列表搜索

# 使用教程

新建 uni-admin 项目

uni-admin 是很多uni-app功能的配套云管理基础平台。升级中心、uni-push、一键登陆、短信、激励视频广告回调都要使用uni-admin。

如果您的应用已经绑定过uni-admin，可以直接在已绑定的项目上操作。如果没有，按此教程新建 uni-admin。

新建项目：打开HBuilderX -> 文件 -> 新建 -> 项目 -> uni-app 选择 uniCloud admin模板，键入一个名字，确定
鼠标右键 uniCloud 文件夹 选择关联云服务空间和运行云服务空间初始化向导

添加应用

运行 uni-admin 到浏览器，在左侧菜单 系统管理 -> 应用管理 中新增应用后，即可在 App升级中心 发布该应用的版本详情

添加应用后，即可在应用管理列表中跳转至版本管理页面：

版本管理

在版本管理列表页面右上角点击发布新版，可以发布原生App安装包和wgt资源包。在左上角点击下拉列表，可以切换展示应用。

发布原生App安装包
1. 在上传安装包界面填写此次发版信息
1. 版本号：请填写以.分隔字符串，例如：0.0.1。在构建应用安装包时，manifest.json 中的 应用版本名称 也要是该格式。
2. 存储选择：
  1. 内置存储：内置存储是服务空间开通后自带的云存储，不支持自定义域名，不支持阶梯计费
  2. 扩展存储：扩展存储支持自定义域名、阶梯计费，越用越便宜、功能更强大扩展存储开通文档
3. Android应用市场
- 此处会与 新增应用 时填写的 Android应用市场 信息保持同步。当在应用管理修改应用信息时，这里也会修改
- 启用商店：当勾选某一商店启用时，在 upgrade-center-app 端会检测手机上是否有该应用市场
  - 如果有，则会跳转至该应用商店进行 App 升级
  - 如果都跳转失败，最后会使用填写的 下载链接 下载 apk 安装包升级
- 优先级：检查更新时，按照优先级从大到小依次尝试跳转商店
1. 下载链接/AppStore
- 可以选择手动上传一个文件到 云存储，会自动将地址填入该项
- 也可以手动填写一个地址，就可以不用再上传文件
- 如果是发布 苹果 版本，包地址则为应用的 AppStore 链接
1. 强制更新
- 如果使用强制更新，App端的升级弹框将不可被关闭
1. 上线发行
- 可设置当前包是否上线发行，只有已上线才会进行更新检测
- 同时只可有一个线上发行版，线上发行不可更设为下线。未上线可以设为上线发行并自动替换当前线上发行版
- 修改当前包为上线发行，自动替换当前线上发行版
发布wgt资源包
1. 大部分配置与发布 原生App安装包 一致
1. 原生App最低版本
- 上次使用新api或打包新模块的pp版本
- 如果此次打包的wgt使用了 新的 api 或者打包了 新的模块 ，则在发布 wgt资源包 的时候，要将 原生App最低版本 填写为本次版本
- 如果已有正式版 wgt资源包 ，则会自动带出
1. 静默更新
- App升级时会在后台下载wgt包并自行安装。新功能在下次启动App时生效
- 静默更新后不重启应用，可能会导致正在访问的应用的页面数据错乱，请谨慎使用！
1. uni-app x 蒸汽模式（鸿蒙暂不支持）
- 发布 uni-app x 蒸汽模式的资源包时勾选
- 勾选后上传 .wgt 格式的资源包，上传后自动计算 SHA256，供客户端下载后校验完整性
- 蒸汽模式的平台仅支持单选，暂不支持鸿蒙
- 如果勾选了 蒸汽模式，则平台会变为单选，因为蒸汽模式的 wgt 包各平台不通用
发布完成页面
- uni-admin 3.0.1
  - 新增 wgt 包 蒸汽 标识
  - 新增 清理废弃资源：在编辑界面重新上传新包会将旧包标记为废弃资源；在编辑页面重新上传包，但是取消提交，会将新包标记为废弃资源
uni-upgrade-center 云函数 - 检查应用更新：
- 根据传参，先检测传参是否完整，appid appVersion wgtVersion 必传，is_uniapp_x、is_vapor 选传，默认 false
- 先从数据库取出所有该平台（会从上下文读取平台信息）的所有线上发行更新
- 再从所有线上发行更新中取出版本最大的一版。如果可以，尽量先检测wgt的线上发行版更新
- 使用上一步取出的版本包的版本号和传参 appVersion、wgtVersion 来检测是否有更新。必须同时大于这两项，因为上一次可能是wgt热更新，否则返回暂无更新
- 如果库中 wgt包版本大于传参 appVersion，但是不满足 min_uni_version < appVersion，则不会使用wgt更新，会接着判断库中 app包version 是否大于 appVersion
- wgt 包按 蒸汽模式 标记与客户端能力匹配：蒸汽模式应用仅会收到 蒸汽模式 标记的 wgt；uni-app 及 VDOM 的 uni-app x 应用不会收到 蒸汽模式 标记的 wgt
- 返回结果：
  
  code message
  
  0 当前版本已经是最新的，不需要更新
  
  101 wgt更新
  
  102 整包更新
  
  -101 暂无更新或检查appid是否填写正确
  
  -102 请检查传参是否填写正确

code	message
0	当前版本已经是最新的，不需要更新
101	wgt更新
102	整包更新
-101	暂无更新或检查appid是否填写正确
-102	请检查传参是否填写正确

Tips

/uni_modules/uni-upgrade-center/pages/version/add.vue中有版本对比函数（compare）。
- 使用多段式版本格式（如："3.0.0.0.0.1.0.1", "3.0.0.0.0.1"）。如果不满足对比规则，请自行修改。
删除应用会把该应用的所有版本记录同时删除
- uni-admin 3.0.0 之后同时会提示是否删除相关资源包
iOS的Appstore是禁止热更新的。本产品的iOS热更新功能，主要是为企业用户设计的。如果您在Appstore公开市场使用热更新，需要自己承担政策风险。
可以通过以下修改支持iOS的wgt更新：
\uni_modules\uni-upgrade-center\pages\use-version-form.js

将 useVersionForm 中的 enableiOSWgt 属性设置为 true 即可

# uni-upgrade-center-app 前台检测更新

除了管理端，升级中心还包括客户端。负责前台检查升级更新，弹出提示框，下载和安装新版。

提供了如下功能：

基于uni-upgrade-center一站式检查更新，统一整包与 wgt 资源包更新
自行根据传参完成校验，判断此次更新使用哪种方式
弹框、下载、安装、是否强制重启等逻辑已集成
下载完成如被用户取消升级，自动缓存安装包，下次进入判断是否符合安装条件，判断通过会复用已下载的包进行安装；判断不通过则自动清除（uni-app x 的 app-Android 端暂不支持安装包缓存功能：下载到临时保存目录，在 App 下次启动时自动清除）
弹框美观，可自定义ui

# 目录结构

  
┌─uniCloud                            云空间目录，在 uni-upgrade-center-app 组件中为空，占位使用
│─components(0.9.0 版本起删除，请使用 `pages/uni-app-x/upgrade-popup.vue`)
│  └─uni-upgrade-center-app(0.9.0 版本起删除，请使用 `pages/uni-app-x/upgrade-popup.vue`)
│     └─uni-upgrade-center-app.uvue(0.9.0 版本起删除，请使用 `pages/uni-app-x/upgrade-popup.vue`)
├─pages                               页面文件存放的目录
│  ├─uni-app-x
│  │  └─upgrade-popup.vue              uni-app x 项目中要使用到的升级中心弹窗页面，如果需要自定义弹窗样式，可以修改此页面，使用请看dialogPage
│  └─upgrade-popup.vue                uni-app 项目中要使用到的升级中心页面，如果需要自定义样式，可以修改此页面
├─static                              存放升级中心引用的静态资源（图片）的目录，如需自定义样式，可以替换此目录下的图片
├─utils                               存放升级中心引用的工具函数的目录
│  ├─call-check-version.ts            升级中心请求云端函数方法，调用 uni-upgrade-center 云函数，获取 App 版本信息
│  ├─check-update.ts                  调用升级中心方法，检查更新，并根据结果判断是否显示更新弹框
│  ├─install-wgt.ts                   蒸汽模式 wgt 安装（SHA256 完整性校验、uni.installWgt 安装、安装后重启），仅在蒸汽模式平台编译
│  └─check-update-nvue.js             由于 uni-app 项目 `nvue` 页面不支持 ts ，因此调用检查更新函数在这里导出
├─changelog.md                        uni-upgrade-center-app 更新日志
├─package.json                        uni-upgrade-center-app 插件信息日志
└─readme.md                           uni-upgrade-center-app 说明文档

upgrade-popup.vue - 更新应用：
- 如果云函数uni-upgrade-center返回的参数表明需要更新，则将参数保存在localStorage中，带着键值跳转该页面
- 进入时会先从localStorage中尝试取出之前存的安装包路径（此包不会是强制安装类型的包）
- 如果有已经保存的包，则和传进来的 version 进行比较，如果相等则安装。大于和小于都不进行安装，因为admin端可能会调整包的版本。不符合更新会将此包删除
- 如果本地没有包或者包不符合安装条件，则进行下载安装包
- 点击下载会有进度条、已下载大小和下载包的大小
- 下载完成会提示安装：
  - 如果是 wgt 包，安装时则会提示正在安装…… 和安装完成。安装完成会提示是否重启
  - 如果是蒸汽模式应用的 wgt 包，安装前会校验 SHA256，安装成功后强制更新直接重启应用（getApp().restart）、非强制更新询问是否立即重启
  - 如果是原生安装包，则直接跳出去覆盖安装
- 下载过程中，如果退出会提示是否取消下载。如果是强制更新，则只会提示正在下载请稍后，此时不可退出
- 如果是下载完成了没有安装就退出，则会将下载完成的包保存在本地。将包的本地路径和包version保存在localStorage中

# 在 uni-app 中使用升级中心

安装指引

在插件市场打开本插件页面，在右侧点击使用 HBuilderX 导入插件，选择要导入的项目点击确定插件地址
创建 uniCloud 云开发环境
绑定服务空间：
- 插件版本 >= 0.6.0，依赖 uni-admin 1.9.3+ 的 uni-upgrade-center 云函数，请和 uni-admin 项目关联同一个服务空间
- 插件版本 <= 0.6.0，请绑定到一个已有的服务空间或者新建一个服务空间进行绑定
上传云函数：
- 插件版本 >= 0.6.0，依赖 uni-admin 1.9.3+ 的 uni-upgrade-center 云函数，插件不再单独提供云函数，可以跳过此步骤
- 插件版本 <= 0.6.0，找到/uni_modules/uni-upgrade-center-app/uniCloud/cloudfunctions/check-version，右键上传部署
修改 pages.json

如果是uni-app，需在pages.json中添加页面路径。注：请不要设置为pages.json中第一项。(在 uni-app 上，为了盖住 tabbar、导航栏以及 vue 页面上的原生元素，使用了背景透明的独立页面)

"pages": [
    // ……其他页面配置
    {
      "path": "uni_modules/uni-upgrade-center-app/pages/upgrade-popup",
      "style": {
        "disableScroll": true,
        "app-plus": {
          "backgroundColorTop": "transparent",
          "background": "transparent",
          "titleNView": false,
          "scrollIndicator": false,
          "popGesture": "none",
          "animationType": "fade-in",
          "animationDuration": 200

        }
      }
    }
  ]

示例源码如下，请查看 pre > code 标签中的内容

"pages": [
    // ……其他页面配置
    {
      "path": "uni_modules/uni-upgrade-center-app/pages/upgrade-popup",
      "style": {
        "disableScroll": true,
        "app-plus": {
          "backgroundColorTop": "transparent",
          "background": "transparent",
          "titleNView": false,
          "scrollIndicator": false,
          "popGesture": "none",
          "animationType": "fade-in",
          "animationDuration": 200

        }
      }
    }
  ]

如果是 uni-app-x 项目，自 0.9.0 起，使用 dialogPage 实现弹窗，需要在 pages.json 中添加页面路径

"pages": [
  {
    "path": "uni_modules/uni-upgrade-center-app/pages/uni-app-x/upgrade-popup",
    "style": {
      "navigationBarTitleText": ""
    }
  }
]

示例源码如下，请查看 pre > code 标签中的内容

"pages": [
  {
    "path": "uni_modules/uni-upgrade-center-app/pages/uni-app-x/upgrade-popup",
    "style": {
      "navigationBarTitleText": ""
    }
  }
]

将@/uni_modules/uni-upgrade-center-app/utils/check-update 使用 import 导入到需要用到的地方调用一下即可（一般在首页调用或设置页面检查更新按钮调用）：
1. 使用方式：import checkUpdate from '@/uni_modules/uni-upgrade-center-app/utils/check-update'，然后在需要的执行的地方调用 checkUpdate 方法即可
2. 默认使用当前绑定的服务空间，如果要请求其他服务空间，可以使用其他服务空间的 callFunction。详情
3. 注： uni-app 的 vue2 模式不支持在 nvue 页面中使用 ts，请引入用插件根目录 utils/check-update-nvue.js 文件

import checkUpdate from '@/uni_modules/uni-upgrade-center-app/utils/check-update'

示例源码如下，请查看 pre > code 标签中的内容

import checkUpdate from '@/uni_modules/uni-upgrade-center-app/utils/check-update'

在需要调用的页面中（一般在首页加载完成后调用或设置页面检查更新按钮调用）执行 checkUpdate 方法，比如在 onReady 生命周期中（注：因为是组件所以一定要保证组件加载完毕），以下为完整使用示例：

import checkUpdate from '@/uni_modules/uni-upgrade-center-app/utils/check-update'
// ...
export default {
  // ...
  onReady() {
    checkUpdate()
  }
  // ...
}

示例源码如下，请查看 pre > code 标签中的内容

import checkUpdate from '@/uni_modules/uni-upgrade-center-app/utils/check-update'
// ...
export default {
  // ...
  onReady() {
    checkUpdate()
  }
  // ...
}

升级弹框可自行编写，也可以使用uni.showModal，或使用现有的升级弹框样式，如果不满足UI需求请自行替换 static 目录下的资源文件。在utils/check-update.ts中都有实例。

注意使用wgt更新，打包前请务必将 manifest.json 中的版本名称修改为更高版本。（请使用类似 1.0.0 以 . 分隔的多段式格式）

# 在 uni-app x 中使用升级中心 0.7.0+

安装指引

在插件市场打开本插件页面，在右侧点击使用 HBuilderX 导入插件，选择要导入的项目点击确定插件地址
创建 uniCloud 云开发环境
绑定服务空间：
- 插件版本 >= 0.6.0，依赖 uni-admin 1.9.3+ 的 uni-upgrade-center 云函数，请和 uni-admin 项目关联同一个服务空间
- 插件版本 <= 0.6.0，请绑定到一个已有的服务空间或者新建一个服务空间进行绑定
上传云函数：
- 插件版本 >= 0.6.0，依赖 uni-admin 1.9.3+ 的 uni-upgrade-center 云函数，插件不再单独提供云函数，可以跳过此步骤
- 插件版本 <= 0.6.0，找到/uni_modules/uni-upgrade-center-app/uniCloud/cloudfunctions/check-version，右键上传部署
如果是uni-app，需在pages.json中添加页面路径。注：请不要设置为pages.json中第一项

"pages": [
    // ……其他页面配置
    {
      "path" : "uni_modules/uni-upgrade-center-app/pages/uni-app-x/upgrade-popup"
    }
  ]

示例源码如下，请查看 pre > code 标签中的内容

"pages": [
    // ……其他页面配置
    {
      "path" : "uni_modules/uni-upgrade-center-app/pages/uni-app-x/upgrade-popup"
    }
  ]

在 script 标签内顶部引入 checkUpdate 方法

import checkUpdate from '@/uni_modules/uni-upgrade-center-app/utils/check-update'

示例源码如下，请查看 pre > code 标签中的内容

import checkUpdate from '@/uni_modules/uni-upgrade-center-app/utils/check-update'

在需要调用的页面中（一般在首页加载完成后调用或设置页面检查更新按钮调用）执行 checkUpdate 方法，比如在 onReady 生命周期中（注：因为是组件所以一定要保证组件加载完毕），以下为完整使用示例：

import checkUpdate from '@/uni_modules/uni-upgrade-center-app/utils/check-update'
// ...
export default {
  // ...
  onReady() {
    checkUpdate()
  }
  // ...
}

示例源码如下，请查看 pre > code 标签中的内容

import checkUpdate from '@/uni_modules/uni-upgrade-center-app/utils/check-update'
// ...
export default {
  // ...
  onReady() {
    checkUpdate()
  }
  // ...
}

当你打开调用升级中心组件的页面就会检查更新，如有更新就出弹窗。也可以在其他页面或者组件中使用

注意在 uni-app x 的非蒸汽模式（VDOM）下没有 wgt 更新，也不会检测到 wgt 包的更新；在蒸汽模式下支持 wgt 热更新，详见下文

# 在 uni-app x 蒸汽模式中使用 wgt 热更新

需要 HBuilderX 5.31+

发布端（uni-upgrade-center Admin）

发布 wgt资源包 时勾选 蒸汽模式，上传 .wgt 格式的资源包
上传后自动计算资源包 SHA256 并随版本信息入库，客户端下载完成后会校验本地文件的 SHA256，一致后才进行安装

客户端

客户端是否为蒸汽模式由编译期条件编译（VUE3-VAPOR）确定并上报云函数，云函数仅向蒸汽模式下发 蒸汽模式 标记的 wgt 包
下载完成后使用计算本地文件 SHA256，与版本信息中的 SHA256 比对一致后才调用 uni.installWgt 安装（防止下载损坏或被篡改）
安装成功后的重启策略：
- 静默更新：后台下载安装，下次启动应用生效
- 强制更新：安装成功后直接重启应用（getApp().restart）
- 非强制更新：安装成功后弹窗询问是否立即重启
鸿蒙平台暂不支持的 wgt 热更新

# 在 HarmonyOS Next 中使用升级中心 0.9.1+ HBuilderX 4.32+

安装指引

步骤 1 - 5 可以参考 uni-app 的使用指引，然后接下来的步骤为：

在需要使用的地方引入 js 和组件，一般为首页：

import checkUpdate from '@/uni_modules/uni-upgrade-center-app/utils/check-update';
// #ifdef APP-HARMONY
import upgradePopupVue from '@/uni_modules/uni-upgrade-center-app/pages/upgrade-popup.vue';
// #endif

示例源码如下，请查看 pre > code 标签中的内容

import checkUpdate from '@/uni_modules/uni-upgrade-center-app/utils/check-update';
// #ifdef APP-HARMONY
import upgradePopupVue from '@/uni_modules/uni-upgrade-center-app/pages/upgrade-popup.vue';
// #endif

在 components 中声明组件，并新建方法来供 template 调用（也可以在 onLoad 生命周期中调用）：

export default {
  // ...
  components: {
    // #ifdef APP-HARMONY
    upgradePopupVue
    // #endif
  },
  methods: {
    checkVersion() {
      // #ifdef APP-PLUS
      checkUpdate()
      // #endif
      // #ifdef APP-HARMONY
      checkUpdate(this.$refs.upgradePopup)
      // #endif
        .then((res) => {
          console.log('res: ', JSON.stringify(res));
        })
        .catch((e) => {
          console.log('e: ', JSON.stringify(e), e);
        });
    }
  }
  // ...
}

示例源码如下，请查看 pre > code 标签中的内容

export default {
  // ...
  components: {
    // #ifdef APP-HARMONY
    upgradePopupVue
    // #endif
  },
  methods: {
    checkVersion() {
      // #ifdef APP-PLUS
      checkUpdate()
      // #endif
      // #ifdef APP-HARMONY
      checkUpdate(this.$refs.upgradePopup)
      // #endif
        .then((res) => {
          console.log('res: ', JSON.stringify(res));
        })
        .catch((e) => {
          console.log('e: ', JSON.stringify(e), e);
        });
    }
  }
  // ...
}

在 template 中使用 button 组件来触发升级检测：

<template>
  <!-- 页面其他内容... -->
  <button @click="checkVersion">检查升级</button>
  <!-- #ifdef APP-HARMONY -->
  <upgradePopupVue ref="upgradePopup" @show="upgradePopupShow" @close="upgradePopupClose" />
  <!-- #endif -->
</template>

示例源码如下，请查看 pre > code 标签中的内容

<template>
  <!-- 页面其他内容... -->
  <button @click="checkVersion">检查升级</button>
  <!-- #ifdef APP-HARMONY -->
  <upgradePopupVue ref="upgradePopup" @show="upgradePopupShow" @close="upgradePopupClose" />
  <!-- #endif -->
</template>

# 更新下载安装`check-update.ts`

该函数在utils目录下

如果是静默更新（wgt 更新特有），则不会打开更新弹框，只在后台下载后安装，下次启动应用生效
如果是 iOS，则会直接打开AppStore的链接
会将检查更新云函数返回的结果保存在localStorage中，并跳转进入upgrade-popup.vue打开更新弹框

Tips

检查更新云函数内部有版本对比函数（compare）。

使用多段式版本格式（如："3.0.0.0.0.1.0.1", "3.0.0.0.0.1"）。如果不满足对比规则，请自行修改。
如果修改，请将pages/upgrade-popup.vue中compare函数一并修改

# 版本说明

此处版本与 gitee 的 tag 和 uni-upgrade-center-app 的版本相对应

从 uni-upgrade-center v0.7.0 版本起，开始支持uni-app x。
v0.8.5 之后的版本（如 0.9.0）将不再支持 HBuilderX 4.31 之前的版本，如需使用请升级 HBuilderX 至 4.31 以上版本。
v0.9.0 版本起在 uni-app x 上使用 dialogPage 实现，效果更好
升级至 uni-admin 3.0.1 之后，需要将 uni-upgrade-center 云函数删除后重新上传部署：新版云函数依赖扩展存储，运行环境需要 Node.js >= 16。

# 费用评测

使用升级中心，涉及uniCloud的付费问题，那么相比于自己搭服务器，使用uniCloud的费用到底合不合适。这里帮开发者算下账。

以阿里云按量计费为例，预测下uni-upgrade-center在不同用户规模下的资源消耗及对应费用，帮助大家明智选择。

本文主要分为三个部分：

uni-upgrade-center消耗的资源费用测算(云函数、云数据库、云存储、前端网页托管分别测算)
uni-upgrade-center给你带来的收益
综合考虑，你该如何选择

uni-upgrade-center升级中心涉及费用的部分主要分为：

云函数：uni-upgrade-center云函数，将客户端版本和服务端最新版本进行对比，返回是否需升级的逻辑
云数据库：opendb-app-versions表，存储版本信息
云存储：放置近期的升级包资源（apk/ipa/wgt）
前端网站托管：部署uni-admin，管理员发布新版本

接下来，我们对不同资源，分别进行费用评估。

# 云函数

启用uni-upgrade-center升级中心后，你的App每次启动，会请求一次uni-upgrade-center云函数。

我们按照uniCloud官网列出的按量计费规则，可以得出如下云函数资源消耗计算公式：

云函数费用 = 资源使用量 * 0.000110592 + 调用次数 * 0.0133 / 10000 + 出网流量 * 0.8

其中：

资源使用量 = 云函数内存（单位为G） * 云函数平均单次执行时长（单位为秒） * 调用次数
调用次数 = App日活 * 每日活用户平均每天启动App次数，因为App每次启动，均会执行检查更新逻辑

我们假设如下数据模型：

云函数内存：256M，即0.25G；注意云函数内存默认为512M，uni-upgrade-center云函数建议设置为256M
云函数平均单次执行时长：100毫秒，即0.1秒
每日活用户平均每天启动App次数：2次
出网流量：0，升级中心无需链接外网

按照如上公式，你的App若有100个日活用户，其升级中心云函数每天的费用为：

云函数费用（天） = 资源使用量 * 0.000110592  + 调用次数 * 0.0133 / 10000 + 出网流量 * 0.8
        = 云函数内存（单位为G） * 云函数平均单次执行时长（单位为秒） * 调用次数 + 调用次数 * 0.0133 / 10000 + 出网流量 * 0.8
        = 0.25G * 0.1S * 100 * 2 * 0.000110592 + 100 * 2 * 0.0133/10000 + 0
        = 0.00081896（元）

示例源码如下，请查看 pre > code 标签中的内容

云函数费用（天） = 资源使用量 * 0.000110592  + 调用次数 * 0.0133 / 10000 + 出网流量 * 0.8
        = 云函数内存（单位为G） * 云函数平均单次执行时长（单位为秒） * 调用次数 + 调用次数 * 0.0133 / 10000 + 出网流量 * 0.8
        = 0.25G * 0.1S * 100 * 2 * 0.000110592 + 100 * 2 * 0.0133/10000 + 0
        = 0.00081896（元）

即：你的App日活为100，使用uni-upgrade-center商业版后，对应云函数每天大概消耗0.00081896元。

据此，可计算其每月的费用为：0.00081896 * 30 = 0.0245688，即每月只需2分钱；

同理，我们可推导出日活为1000、10000、10万的App，其升级中心云函数每月费用如下表：

日活	资源使用量计费（元）	调用次数计费（元）	合计（元）
100	0.0165888	0.00798	0.0245688
1000	0.165888	0.0798	0.245688
10000	1.65888	0.798	2.45688
100000	16.5888	7.98	24.5688

日活1000的App，云函数月度消耗才两毛五（0.25元），真是毛毛雨了。

# 云数据库

按照uniCloud官网介绍，云数据库费用 = 容量费用 + 读操作次数费用 + 写操作次数费用，其中：

容量费用：数据库存储容量（单位为G） * 0.07
读操作次数费用：读操作次数（万次） * 0.015
写操作次数：写操作次数（万次） * 0.015；

# 容量费用

我们以hello uni-app为例，opendb-app-versions数据表中共存储30条升级记录，容量大小为8K。据此可计算出opendb-app-versions表的日存储费用为：8/1024/1024 * 0.07 = 0.000000534

容量计费单位是G，故需先将8K折算成M，再折算成G，故上述公式中连续除了两个1024

1月按30天算，则月存储费用为0.000000534 * 30 = 0.000016，还不到1分钱，可忽略。

注意：数据库容量仅跟发布版本多少有关系，跟日活用户无关。

# 读操作次数

在uni升级中心业务中，云函数uni-upgrade-center每次执行，仅调用一次数据库读取（读取一次opendb-app-versions表），故数据库的读操作次数等同于云函数的调用次数，前文有过公式，云函数调用次数 = App日活 * 每日活用户平均每天启动App次数，每日活用户平均每天启动App次数我们假设为2次。

我们即可推算，如果一个App的日活为100，则uni升级中心每日云数据库读操作次数费用计算如下：

读操作次数费用 = 读操作次数（万次） * 0.015
      = 云函数调用次数（万次） * 0.015
      = App日活 * 每日活用户平均每天启动App次数 / 10000 * 0.015
      = 100 * 2 / 10000 * 0.015
      = 0.0003

示例源码如下，请查看 pre > code 标签中的内容

读操作次数费用 = 读操作次数（万次） * 0.015
      = 云函数调用次数（万次） * 0.015
      = App日活 * 每日活用户平均每天启动App次数 / 10000 * 0.015
      = 100 * 2 / 10000 * 0.015
      = 0.0003

1月按30天算，则每月云数据库读操作次数费用为0.0003 * 30 = 0.009，还不到1分钱。

同理，我们可推导出日活为1000、10000的App，其uni升级中心每月云数据库读操作次数费用为9分钱、9毛钱。

# 写操作次数

uni-upgrade-center升级中心，写数据库操作很少；管理员仅在每次发布新版时，通过uni-admin向opendb-app-versions表插入一条新版本信息；用户端App每次启动检查升级，无需数据表的写入操作，故写操作次数可忽略为0；

# 小结

因为容量费和写操作次数费用均可忽略为0，根据公式：

云数据库费用 = 容量费（忽略为0） + 读操作费用 + 写操作费用（忽略为0）
       = 读操作费用

示例源码如下，请查看 pre > code 标签中的内容

云数据库费用 = 容量费（忽略为0） + 读操作费用 + 写操作费用（忽略为0）
       = 读操作费用

可推导，uni升级中心的云数据库计费主要是读操作次数计费，因此我们进一步得出如下预测：

日活	读操作次数费用（元）	合计（元）
100	0.009	0.009
1000	0.09	0.09
10000	0.9	0.9
100000	9	9

# 云存储

扩展存储查看：文档

按照uniCloud官网介绍，云存储费用 = 容量费 + 下载操作次数计费点 + 上传操作次数计费点 + CDN流量费。

如果您的应用每次均上架到apple store或安卓各应用商店，升级时从应用商店下载安装，则云存储费用为0，因为使用的是应用商店的存储和CDN下载流量，本计费点测评章节可直接跳过。

uni-upgrade-center 支持设置应用新版安装包下载地址为应用商店地址，这样就可以使用应用商店的存储和CDN，不消耗uniCloud的云存储资源。

现阶段，iOS平台均需上架apple store，我们可以忽略iOS平台的云存储消耗。

如果您的安卓apk安装包及wgt差量升级包全部托管在uniCloud云存储中，我们也可以算算这笔账。

# 容量费

容量费主要是存储费用，我们可以定期将过期版本删除，从而节省容量费。

假设我们在云存储中保留最近5个版本的文件，apk/wgt全部保留，大小假设分别为：40M、10M。

如前所言，ipa需上架apple store，不使用云存储，测评可忽略。

则每天容量费用为：5 * (40+10)/1024 * 0.0043 = 0.0010498

据此，可计算其每月30天的容量费用为：0.0010498 * 30 = 0.031494，即只需3分钱；

注意：云存储容量仅跟保留的历史升级包多少有关系，跟日活用户无关。

# 下载操作次数计费点

下载操作次数计费点：仅触发文件下载时会触发，若无新版本下载，则不会触发。

假设你的App日活为100、月活为1500，每月发一次版本；月活用户中，50%会选择升级到新版本，我们可计算下载次数为：1500*50% = 750次。

而云存储的下载操作次数计费规则为：每万次0.01元，即每万次下载1分钱，750次下载远还不到1分钱，故下载操作计费点可直接忽略。

# 上传操作次数计费点

每次App发版，仅需管理员上传一次新的资源包，用户App端检查升级时，不涉及上传操作，故上传操作次数计费点亦可忽略。

# CDN流量费

CDN流量费：我们假设50%概率启用wgt资源包升级（升级包为10M），50%概率为整包升级；而整包升级中，20%为苹果用户（使用apple store流量），80%为安卓用户（升级包为40M）。

则按照如上数据模型，日活为100的App，假期其月活为1500，而月活用户中，50%会选择升级到新版本，即750人选择升级，不同升级包消耗CDN流量如下：

wgt资源包CDN流量：750 * 50% * 10 / 1024 = 3.662G
苹果整包升级CDN流量：使用apple store流量，uniCloud云存储流量为0
安卓整包升级CDN流量：750 * 50% * 80% * 40 /1024 = 11.719G

即：日活为100的App，月度CDN流量为：3.662 + 0 + 11.719 = 15.381G，对应费用则为：15.381 * 0.18 = 2.76858 （元）

同理，我们可推导出日活为1000的App，其升级中心云存储每月的CDN费用为27.6858元。

# 和传统 OSS + CDN 对比

如果你不用uni-upgrade-center，选择如阿里云的传统OSS + CDN 方案，同样按量计费的情况下，1PB流量以内，传统CDN都没有价格优势；传统CDN每GB的起步价为0.24元，而uniCloud云存储CDN每GB的费用为0.18元。

详见：阿里云官网CDN定价详情

1PB流量是什么概念？我们以每个安卓安装包为40M为例，需要 1 * 1024 * 1024 * 1024 / 40 = 26843546，即需要2600万人次安装包下载才能达到1PB流量，你可以评估一下你的App何时可以达到这个量级。

具体解释一下：1PB = 1024TB，1TB = 1024G，1G = 1024M，故上面公式连乘3个1024

也有人说了，购买阿里云CDN资源包可以更便宜。确实，购买大额资源包会更便宜，但这个方案有两个缺点：

这个资源包仅仅是CDN流量包，你还需要购买OSS回源流量包，而uniCloud直接将回源流量费用包在CDN费用之内了，无需额外购买回源流量。
预付费，在业务发展不明朗的情况下，一次性投入太多钱；一旦业务失败，CDN资源包未消耗完毕，也不能退款，浪费资金；而按量计费则没有这个问题，真实用多少资源，就花多少钱；

综合来看，uniCloud云存储相比传统云厂商的OSS + CDN 方案：

都选择按量计费，uniCloud版CDN默认0.18元更具价格优势；
预付费方式，选购云厂商CDN资源包，需额外购买回源流量包，对普通开发者，特别是中小开发者，并不友好，此时依然是uniCloud按量计费的云存储更具性价比。

# 前端网页托管

uni-upgrade-center需要和uni-admin配合使用，uni-admin需要部署在前端网页托管中。uni-admin主要是管理员使用，使用频次较少，流量也较低。

按照uniCloud官网介绍，前端网页托管费用 = 容量费 + 流量费。

# 容量费

uni-admin编译后为4.7M，按照官网每GB每天0.0043元的规则，uni-admin的月度容量费为：4.7 / 1024 * 0.0043 * 30 = 0.00059，不到1分钱，可忽略。

# 流量费

管理员登录uni-admin，到升级中心管理页面浏览并发布新版，所需流量不超过3M，即使每月发布2次更新，流量费预估为：3 / 1024 * 0.18 * 2 = 0.00105，也不到1分钱，也可忽略。

# 合并计算

细项对比完了，我们来合并看看，使用uniCloud升级中心，到底需要花多少钱，相比传统自己研发升级逻辑、搭建升级中心，哪些地方都需要花钱，差异点在哪里？

不管是开发者自研的升级方案，还是uni-upgrade-center，存储+CDN的费用都是必需的，前文也将传统OSS+CDN和uniCloud云存储的性价比进行了对比，均按量计费的模式下，uniCloud更具性价比；以资源包方式购买传统CDN模式下，各有优劣。

既然两个方案，都绕不开云存储，那我们暂时抛开云存储对比，将其他各项按照日活用户规模罗列一下，看看uni-upgrade-center在其他维度所需费用。

日活	云函数（元）	云数据库（元）	云存储（元）	合计（元）
100	0.0245688	0.009	忽略	0.0335688
1000	0.245688	0.09	忽略	0.335688
10000	2.45688	0.9	忽略	3.35688
100000	24.5688	9	忽略	33.5688

# uni-upgrade-center 给你带来的收益

使用uni-upgrade-center，免费获取、一键安装，你将获得：

经受大量App验证的、完备的检查升级逻辑，同时支持整包/资源包升级，支持静默升级，支持强制升级；
完备的管理功能，分平台发布新版、下线老版，关联应用商店，分渠道发布等。
代码开源，随意定制

如上功能，如果你使用传统模式自研，这些功能做完善从客户端到服务器、从开发到测试至少需要十几个工作日。需要上万的开发费用。

# 总结

再次说回uni-upgrade-center，相比传统方式自研升级中心，存储+CDN的钱都是要花的，我们忽略它。

其它云函数、云数据库等，虽然看起来是额外增加的费用，但实际上你使用传统php/java自研升级逻辑，除了自研人力费用，后期也是需要消耗CPU、内存、带宽资源的，只是这些费用合并到虚拟机的整体租用成本中，你无法拆出来计算罢了。

再看回刚才的计算表，以1000日活用户来说，云函数、云数据库每月才多了0.34元，每年才多了4块钱（不考虑云存储CDN的情况下），一年多花4块钱，可以省掉自研的4500多元人工费用，可以让工程师将更多精力投入核心业务中。这5块钱的买卖，不划算吗？它不香吗？

日活	云函数（元）	云数据库（元）	云存储（元）	合计（元）
100	0.0245688	0.009	忽略	0.0335688
1000	0.245688	0.09	忽略	0.335688
10000	2.45688	0.9	忽略	3.35688
100000	24.5688	9	忽略	33.5688

不重复制造轮子，聚焦业务，快速验证模式，实现商业增长，是更聪明的选择。

# 常见问题

# 使用升级中心的用户需要什么权限？

admin 角色或 READ_OPENDB_APP_VERSIONS、CREATE_OPENDB_APP_VERSIONS、UPDATE_OPENDB_APP_VERSIONS、DELETE_OPENDB_APP_VERSIONS、READ_OPENDB_APP_LIST、CREATE_OPENDB_APP_LIST、UPDATE_OPENDB_APP_LIST 权限

# 在测试时，如果使用标准基座运行，则无法检测出 App 更新

原因是因为标准基座获取到的 appId 是固定的，而不是 manifest 中配置的。建议使用自定义基座测试

# 使用支付宝云无法查询到 App 更新

更新 uni-admin 到 2.5.4+
尝试在database/opendb-app-versions.index.json文件右键“初始化云数据库索引”后重试。
如果database/opendb-app-versions.index.json不存在，请在uniCloud控制台-服务空间-云数据库找到opendb-app-versions表，为platform字段创建数据索引后重试。