From 526d125868e167897587140ecd4ca54366d4a8c0 Mon Sep 17 00:00:00 2001 From: DCloud_LXH <283700113@qq.com> Date: Tue, 19 Jul 2022 16:28:05 +0800 Subject: [PATCH] docs: admin.md --- docs/uniCloud/admin.md | 175 ++++++++++++++++++++++++++++++++++++++++- 1 file changed, 173 insertions(+), 2 deletions(-) diff --git a/docs/uniCloud/admin.md b/docs/uniCloud/admin.md index 48f6c07e4..020b1c06d 100644 --- a/docs/uniCloud/admin.md +++ b/docs/uniCloud/admin.md @@ -1,6 +1,6 @@ -# uni-admin 框架（原名 uniCloud admin） +## uni-admin 框架（原名 uniCloud admin） -### 看视频，15分钟掌握uni-admin +**看视频，15分钟掌握uni-admin** uni-admin视频教程 @@ -490,6 +490,177 @@ _使用步骤:_ ---------------------------------- 分割线 ---------------------------------------- +### 应用管理 @app-manager + +新版的应用管理有以下变化： + +- 新增应用内置 uni-portal 插件。支持填写更多信息，可一键生成统一发布页。 +- 内置升级中心。现在你不再需要去插件市场下载升级中心插件，然后配置上传云函数等，可直接使用。 + +#### 新增应用 + +> 现在应用管理列表页每一行新增了 `发布页管理` 和 `版本管理` + +在进入应用管理后可看到如下界面，点击有上角 `新增` 按钮可新增一个应用 +![新增应用](https://vkceyugu.cdn.bspapp.com/VKCEYUGU-f184e7c3-1912-41b2-b81f-435d1b37c7b4/12b0eb73-f791-4cc4-998c-0c95ec97b3fd.png) + +**整体界面布局** + > 本页面信息，在应用发布、app升级模块中，都会关联使用，请认真填写 + + ![新增页面](https://vkceyugu.cdn.bspapp.com/VKCEYUGU-f184e7c3-1912-41b2-b81f-435d1b37c7b4/12198ea2-34eb-4881-8211-f7c1b7caa116.jpg) + +**各项信息说明** + +- 基础信息 + + 1. `AppID`：所要发布的 app 的 id。唯一 + 2. `应用名称`：应用的名称，填写后不可更改 + 3. `应用简介`：生成发布页时，会在应用名称下方显示 + +- 图片素材 + + 1. `应用图标`：该应用的图标信息 + 2. `应用截图`：该应用的实际截图信息 + +- App 信息 + + 1. 勾选代表填写此类信息，不勾选默认折叠 + 2. Android 平台：可以选择手动填写还是上传安装包到云存储自动填写下载链接 + 3. `自动填充`：仅在编辑页面有。会自动从`App 升级中心`同步 App 当前已上线的安装包信息。 + +- 小程序/快应用信息 + + 1. 勾选代表需要发布此类信息，不勾选会默认折叠 + 2. `折叠`：小程序种类繁多，此按钮可以将所有的小程序信息折叠起来 + 3. `快应用`：只有上传了`快应用码`，才会在统一发布页展示 + +- H5 + + 1. `H5`：当你填写了链接，才会在统一发布页显示 + +**Tips** +1. 在`manifest.json -> 源码视图`中添加以下配置： + + ```js + "networkTimeout":{ + "uploadFile":1200000 // 单位：ms。 如果不配置，上传大文件可能会超时 + } + ``` + +#### uni-portal 发布页管理@uni-portal + +> 点击应用管理列表中的 `发布页管理` 可一键生成统一发布页 + +**1. 整体界面布局** + + ![发布页管理](https://vkceyugu.cdn.bspapp.com/VKCEYUGU-f184e7c3-1912-41b2-b81f-435d1b37c7b4/6cd27bf8-1763-461d-946c-418dc8566c57.png) + +- 点击 `生成并下载发布页` 即可一键生成发布页 +- 需要注意的是。在新增应用或者修改应用信息时，需要确保 `App、小程序、快应用、H5` 至少填写一项，否则生成发布页时会有以下提示： + + ![发布页管理错误](https://vkceyugu.cdn.bspapp.com/VKCEYUGU-f184e7c3-1912-41b2-b81f-435d1b37c7b4/ad51b1c6-2b51-4586-9ccc-528bdb010f40.jpg) + +**2. 页面展示效果** + +> `uni-portal` 统一发布页面是响应式的，兼容PC宽屏和手机窄屏。 + +- **PC宽屏** + + + +- **手机窄屏** + +手机浏览器上，默认展示效果如下： + + + +`uni-portal`统一发布页同时会识别当前浏览器环境，在微信等特殊浏览器上，自动提示“点击右上角菜单，在浏览器中打开”，效果如下： + + + +#### uni-upgrade-center App升级中心@uni-upgrade-center + +> 在应用管理新增一个应用之后，即可在 `App升级中心` 发布该应用的版本 + +**Tips** +- 删除应用会把该应用的所有版本记录同时删除 + +#### 版本管理 +1. 在版本管理list的右上角点击`发布新版`，可以发布`原生App安装包`和`wgt资源包`。在左上角点击`下拉列表`，可以切换展示应用。 + +
+ +
+ +- #### 发布原生App安装包 + 1. 在上传安装包界面填写此次发版信息 + +
+ +
+ + 1. `Android应用市场` + - 此处会与 `新增应用` 时填写的 `Android应用市场` 信息保持同步。当在应用管理修改应用信息时，这里也会修改 + - 启用商店：当勾选某一商店启用时，在 `upgrade-center-app` 端会检测手机上是否有该应用市场 + - 如果有，则会跳转至该应用商店进行 App 升级 + - 如果都跳转失败，最后会使用填写的 `下载链接` 下载 apk 安装包升级 + - 优先级：检查更新时，按照优先级从大到小依次尝试跳转商店 + + 1. `下载链接/AppStore` + - 可以选择手动上传一个文件到 `云存储`，会自动将地址填入该项 + - 也可以手动填写一个地址，就可以不用再上传文件 + - 如果是发布`苹果`版本，包地址则为 应用在`AppStore的链接` + + 2. `强制更新` + - 如果使用强制更新，App端接收到该字段后，App升级弹出框不可取消 + + 4. `上线发行` + - 可设置当前包是否上线发行，只有已上线才会进行更新检测 + - 同时只可有一个线上发行版，线上发行不可更设为下线。未上线可以设为上线发行并自动替换当前线上发行版 + - 修改当前包为上线发行，自动替换当前线上发行版 + + **注：版本号请填写以`.`分隔字符串，例如：`0.0.1`** +- #### 发布wgt资源包 + 1. 大部分配置与发布 `原生App安装包` 一致 + +
+ +
+ + 2. `原生App最低版本` + - 上次使用新Api或打包新模块的App版本 + - 如果此次打包wgt使用了`新的api`或者打包了`新的模块`，则在发布 `wgt资源包` 的时候，将此版本更新为本次版本 + + - 如果已有正式版`wgt资源包`，则本次新增会自动带出 + + 3. `静默更新` + - App升级时会在后台下载wgt包并自行安装。新功能在下次启动App时生效 + - **静默更新后不重启应用，可能会导致正在访问的应用的页面数据错乱，请谨慎使用！** + + **注：版本号请填写以`.`分隔字符串，例如：`0.0.1`** + +- #### 发布完成页面 + +
+ +
+ +**Tips** + +1. `/uni_modules/uni-upgrade-center/pages/system/upgradecenter/version/add.vue`中有版本对比函数（compare）。 + - 使用多段式版本格式（如："3.0.0.0.0.1.0.1", "3.0.0.0.0.1"）。如果不满足对比规则，请自行修改。 + +**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` + ### admin 插件开发 我们不仅是插件的使用者，也可以是插件的开发者，那么如何开发一款 uni-admin 插件呢？ -- GitLab