From 15f13d05dbb215ee4ad72d3c92c64d770f7afeb5 Mon Sep 17 00:00:00 2001 From: DCloud_LXH <283700113@qq.com> Date: Thu, 9 Feb 2023 17:59:30 +0800 Subject: [PATCH] =?UTF-8?q?chore:=20=E5=8D=87=E7=BA=A7=E4=B8=AD=E5=BF=83?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/uniCloud/upgrade-center.md | 77 +++++++++++++++++---------------- 1 file changed, 40 insertions(+), 37 deletions(-) diff --git a/docs/uniCloud/upgrade-center.md b/docs/uniCloud/upgrade-center.md index 900dfc2e1..3cef296b3 100644 --- a/docs/uniCloud/upgrade-center.md +++ b/docs/uniCloud/upgrade-center.md @@ -21,13 +21,9 @@ App升级中心 uni-upgrade-center，提供了 App 的版本更新服务。包 每个App开发者都要开发升级功能，这是巨大的社会资料浪费。DCloud推出 uni-upgrade-center，让应用开发更轻松、高效，让开发者专注于自己的业务。 -### 使用 +> 升级中心分为两个部分：[uni-upgrade-center Admin管理后台](https://ext.dcloud.net.cn/plugin?id=4470) 和 [uni-upgrade-center-app前台检测更新](https://ext.dcloud.net.cn/plugin?id=4542)。 -升级中心分为两个部分：[uni-upgrade-center Admin管理后台](https://ext.dcloud.net.cn/plugin?id=4470) 和 [uni-upgrade-center-app前台检测更新](https://ext.dcloud.net.cn/plugin?id=4542)。 - -#### uni-upgrade-center Admin 管理后台@uni-upgrade-center-admin - -> 在 uni-admin 1.9.3+ 中已作为内置插件。在应用管理新增应用后，即可在 `App升级中心` 发布该应用的版本 +### uni-upgrade-center Admin 管理后台@uni-upgrade-center-admin 负责发布新版和管理历史版本的上下线。提供了如下功能： @@ -45,15 +41,28 @@ App升级中心 uni-upgrade-center，提供了 App 的版本更新服务。包 - App 管理列表及 App 版本记录列表搜索 -> 插件市场下载 `uni-admin 1.9.3+`，上传云函数、初始化数据库运行至浏览器则可以在左侧菜单看到 `App 升级中心` +#### 使用教程 + +**新建 uni-admin 项目** + +1. 新建项目：`打开HBuilderX` -> `文件` -> `新建` -> `项目` -> `uni-app` 选择 `uniCloud admin`模板，键入一个名字，确定 + +2. 鼠标右键 `uniCloud 文件夹` 选择`关联云服务空间`和`运行云服务空间初始化向导` **添加应用** -使用升级中心前需要在应用管理新增应用 [详情](https://uniapp.dcloud.net.cn/uniCloud/admin.html#app-manager) +> 运行 uni-admin 到浏览器，在左侧菜单 `系统管理 -> 应用管理` 中新增应用后，即可在 `App升级中心` 发布该应用的版本 [详情](https://uniapp.dcloud.net.cn/uniCloud/admin.html#app-manager) + + +添加应用后，即可在应用管理列表中跳转至版本管理页面： + +
+ +
**版本管理** -1. 在版本管理list的右上角点击`发布新版`，可以发布`原生App安装包`和`wgt资源包`。在左上角点击`下拉列表`，可以切换展示应用。 +1. 在版本管理列表页面右上角点击`发布新版`，可以发布`原生App安装包`和`wgt资源包`。在左上角点击`下拉列表`，可以切换展示应用。
@@ -65,28 +74,29 @@ App升级中心 uni-upgrade-center，提供了 App 的版本更新服务。包
+ + 2. `版本号`：请填写以`.`分隔字符串，例如：`0.0.1`。在构建应用安装包时，`manifest.json` 中的 `应用版本名称` 也要是该格式。 - 1. `Android应用市场` + 3. `Android应用市场` - 此处会与 `新增应用` 时填写的 `Android应用市场` 信息保持同步。当在应用管理修改应用信息时，这里也会修改 - 启用商店：当勾选某一商店启用时，在 `upgrade-center-app` 端会检测手机上是否有该应用市场 - 如果有，则会跳转至该应用商店进行 App 升级 - 如果都跳转失败，最后会使用填写的 `下载链接` 下载 apk 安装包升级 - 优先级：检查更新时，按照优先级从大到小依次尝试跳转商店 - 1. `下载链接/AppStore` + 4. `下载链接/AppStore` - 可以选择手动上传一个文件到 `云存储`，会自动将地址填入该项 - 也可以手动填写一个地址，就可以不用再上传文件 - - 如果是发布`苹果`版本，包地址则为 应用在`AppStore的链接` + - 如果是发布 `苹果` 版本，包地址则为应用的 `AppStore 链接` - 2. `强制更新` - - 如果使用强制更新，App端接收到该字段后，App升级弹出框不可取消 + 5. `强制更新` + - 如果使用强制更新，App端的升级弹框将不可被关闭 - 4. `上线发行` + 6. `上线发行` - 可设置当前包是否上线发行，只有已上线才会进行更新检测 - 同时只可有一个线上发行版，线上发行不可更设为下线。未上线可以设为上线发行并自动替换当前线上发行版 - 修改当前包为上线发行，自动替换当前线上发行版 - **注：版本号请填写以`.`分隔字符串，例如：`0.0.1`** - 发布wgt资源包 1. 大部分配置与发布 `原生App安装包` 一致 @@ -95,17 +105,14 @@ App升级中心 uni-upgrade-center，提供了 App 的版本更新服务。包
2. `原生App最低版本` - - 上次使用新Api或打包新模块的App版本 - - 如果此次打包wgt使用了`新的api`或者打包了`新的模块`，则在发布 `wgt资源包` 的时候，将此版本更新为本次版本 - - - 如果已有正式版`wgt资源包`，则本次新增会自动带出 + - 上次使用新api或打包新模块的pp版本 + - 如果此次打包的wgt使用了 `新的 api` 或者打包了 `新的模块` ，则在发布 `wgt资源包` 的时候，要将 `原生App最低版本` 填写为本次版本 + - 如果已有正式版 `wgt资源包` ，则会自动带出 3. `静默更新` - App升级时会在后台下载wgt包并自行安装。新功能在下次启动App时生效 - **静默更新后不重启应用，可能会导致正在访问的应用的页面数据错乱，请谨慎使用！** - **注：版本号请填写以`.`分隔字符串，例如：`0.0.1`** - - 发布完成页面
@@ -113,7 +120,7 @@ App升级中心 uni-upgrade-center，提供了 App 的版本更新服务。包
**Tips** -- `/uni_modules/uni-upgrade-center/pages/system/upgradecenter/version/add.vue`中有版本对比函数（compare）。 +- `/uni_modules/uni-upgrade-center/pages/version/add.vue`中有版本对比函数（compare）。 - 使用多段式版本格式（如："3.0.0.0.0.1.0.1", "3.0.0.0.0.1"）。如果不满足对比规则，请自行修改。 - 删除应用会把该应用的所有版本记录同时删除 - 升级中心设计之初就支持iOS的wgt更新 @@ -126,10 +133,7 @@ App升级中心 uni-upgrade-center，提供了 App 的版本更新服务。包 > > 将 `data` 中的 `enableiOSWgt` 属性设置为 `true` 即可 - -在插件市场安装（uni-admin 1.9.3+ 升级中心已作为内置插件，内置在uni-admin项目中），根据 readme 部署即可。[插件地址](https://ext.dcloud.net.cn/plugin?id=4470) - -#### uni-upgrade-center-app 前台检测更新@uni-upgrade-center-app +### uni-upgrade-center-app 前台检测更新@uni-upgrade-center-app 负责前台检查升级更新。 @@ -155,21 +159,19 @@ App升级中心 uni-upgrade-center，提供了 App 的版本更新服务。包 **安装指引** -1. 依赖数据库`opendb-app-versions`，如果没有此库，请在云服务空间中创建。 +1. 在插件市场打开本插件页面，在右侧点击`使用 HBuilderX 导入插件`，选择要导入的项目点击确定 [插件地址](https://ext.dcloud.net.cn/plugin?id=4542) -2. 使用`HBuilderX 3.1.0+`，因为要使用到`uni_modules` +2. 创建 uniCloud 云开发环境 -3. 在插件市场打开本插件页面，在右侧点击`使用 HBuilderX 导入插件`，选择要导入的项目点击确定 - -4. 绑定服务空间： +3. 绑定服务空间： - 插件版本 `>= 0.6.0`，依赖 `uni-admin 1.9.3+` 的 `uni-upgrade-center 云函数`，请和 uni-admin 项目关联同一个服务空间 - 插件版本 `<= 0.6.0`，请绑定到一个已有的服务空间或者新建一个服务空间进行绑定 -5. 上传云函数： +4. 上传云函数： - 插件版本 `>= 0.6.0`，依赖 `uni-admin 1.9.3+` 的 `uni-upgrade-center 云函数`，插件不再单独提供云函数，可以跳过此步骤 - 插件版本 `<= 0.6.0`，找到`/uni_modules/uni-upgrade-center-app/uniCloud/cloudfunctions/check-version`，右键上传部署 -6. 在`pages.json`中添加页面路径。**注：请不要设置为pages.json中第一项** +5. 在`pages.json`中添加页面路径。**注：请不要设置为pages.json中第一项** ```json "pages": [ @@ -192,12 +194,13 @@ App升级中心 uni-upgrade-center，提供了 App 的版本更新服务。包 } ] ``` -7. 将`@/uni_modules/uni-upgrade-center-app/utils/check-update.js` 使用 import 导入到需要用到的地方，调用一下即可： +6. 将`@/uni_modules/uni-upgrade-center-app/utils/check-update.js` 使用 import 导入到需要用到的地方，调用一下即可： 1. `import checkUpdate from '@/uni_modules/uni-upgrade-center-app/utils/check-update.js'` 2. 默认使用当前绑定的服务空间，如果要请求其他服务空间，可以使用其他服务空间的 `callFunction`。[详情](https://uniapp.dcloud.io/uniCloud/cf-functions.html#call-by-function-cross-space) -8. 升级弹框可自行编写，也可以使用`uni.showModal`，或使用现有的升级弹框样式，如果不满足UI需求请自行替换资源文件。在`utils/check-update.js`中都有实例。 -9. wgt更新时，打包前请务必将manifest.json中的版本修改为更高版本。 +7. 升级弹框可自行编写，也可以使用`uni.showModal`，或使用现有的升级弹框样式，如果不满足UI需求请自行替换资源文件。在`utils/check-update.js`中都有实例。 + +8. 使用wgt更新，打包前请务必将 manifest.json 中的版本名称修改为更高版本。 **更新下载安装`check-update.js`** -- GitLab