Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
qq_16800119
unidocs-zh
提交
15f13d05
unidocs-zh
项目概览
qq_16800119
/
unidocs-zh
与 Fork 源项目一致
Fork自
DCloud / unidocs-zh
通知
1
Star
0
Fork
0
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
DevOps
流水线
流水线任务
计划
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
unidocs-zh
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
DevOps
DevOps
流水线
流水线任务
计划
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
流水线任务
提交
Issue看板
体验新版 GitCode,发现更多精彩内容 >>
提交
15f13d05
编写于
2月 09, 2023
作者:
D
DCloud_LXH
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
chore: 升级中心
上级
7fbc9049
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
40 addition
and
37 deletion
+40
-37
docs/uniCloud/upgrade-center.md
docs/uniCloud/upgrade-center.md
+40
-37
未找到文件。
docs/uniCloud/upgrade-center.md
浏览文件 @
15f13d05
...
...
@@ -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)
添加应用后,即可在应用管理列表中跳转至版本管理页面:
<div
align=
"center"
>
<img
src=
"https://web-assets.dcloud.net.cn/unidoc/zh/upgrade-center-jump.jpg"
width=
"800"
></img>
</div>
**版本管理**
1.
在版本管理
list的
右上角点击
`发布新版`
,可以发布
`原生App安装包`
和
`wgt资源包`
。在左上角点击
`下拉列表`
,可以切换展示应用。
1.
在版本管理
列表页面
右上角点击
`发布新版`
,可以发布
`原生App安装包`
和
`wgt资源包`
。在左上角点击
`下拉列表`
,可以切换展示应用。
<div
align=
"center"
>
<img
src=
"https://web-assets.dcloud.net.cn/unidoc/zh/version_list_new.png"
width=
"800"
></img>
...
...
@@ -65,28 +74,29 @@ App升级中心 uni-upgrade-center,提供了 App 的版本更新服务。包
<div align="center" >
<img src="https://web-assets.dcloud.net.cn/unidoc/zh/publish_apk.jpg" width="600"></img>
</div>
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 的版本更新服务。包
</div>
2. `原生App最低版本`
- 上次使用新Api或打包新模块的App版本
- 如果此次打包wgt使用了`新的api`或者打包了`新的模块`,则在发布 `wgt资源包` 的时候,将此版本更新为本次版本
- 如果已有正式版`wgt资源包`,则本次新增会自动带出
- 上次使用新api或打包新模块的pp版本
- 如果此次打包的wgt使用了 `新的 api` 或者打包了 `新的模块` ,则在发布 `wgt资源包` 的时候,要将 `原生App最低版本` 填写为本次版本
- 如果已有正式版 `wgt资源包` ,则会自动带出
3. `静默更新`
- App升级时会在后台下载wgt包并自行安装。新功能在下次启动App时生效
- **静默更新后不重启应用,可能会导致正在访问的应用的页面数据错乱,请谨慎使用!**
**注:版本号请填写以`.`分隔字符串,例如:`0.0.1`**
-
发布完成页面
<div align="center">
...
...
@@ -113,7 +120,7 @@ App升级中心 uni-upgrade-center,提供了 App 的版本更新服务。包
</div>
**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`**
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录