vk-unicloud 快速开发框架

# 快速上手 - 安装步骤

  1. 下载uniapp插件市场的 vk-unicloud-admin 项目

下载地址：https://ext.dcloud.net.cn/plugin?id=5043 (opens new window)

  1. 项目根目录 执行 npm i 命令 （必须先执行此npm命令，安装必要的依赖，否则会无法启动。）

接下来是后端（云函数端）安装步骤

  • 通常一个完整的项目分为 client端（客户端）、admin端（管理端）、service端（服务端，这里指云函数端）

这里需要分三种情况

  • 情况一：你之前已经在用 vk-unicloud-router 框架开发H5、小程序、APP的开发者。情况一详情

  • 情况二：你之前是用别的框架开发H5、小程序、APP，现在只想用VK框架单独开发 admin 项目。情况二详情

  • 情况三：你的项目刚开始，client端 和 admin端 都还没开发。情况三详情

# 情况一

思路：因为云函数会互相覆盖，因此我们可以把 service端（云函数端） 统一放在 client端 的项目中，而 admin端 项目 直接绑定 client端 项目

安装步骤：

友情提示：可以直接从第4步开始，1-3步client端已经自带了

  1. 把 admin端 内的 uniCloud/router/service/admin 内的以下文件复制到你之前的 client端 项目 uniCloud/router/service/admin 内（复制整个目录）
  2. 把 admin端 内的 uniCloud/router/service/template 内的以下文件复制到你之前的 client端 项目 uniCloud/router/service/template 内（复制整个目录）
  3. 把 admin端 内的 uniCloud/database/db_init/ 目录下的3个数据库表数据导入对应的表内（导入方法：服务空间后台 - 数据库 - 导入）
uni-id-roles 角色表
uni-id-permissions 权限表
opendb-admin-menus 菜单表
1
2
3
  1. 把 admin端 的服务空间直接绑定 client端 项目（注意是 绑定 不是 关联）（注意是 绑定 不是 关联）（注意是 绑定 不是 关联）

  1. 上传 router 云函数

  2. 完成

# 情况二

已完成情况一的请直接跳过情况二和情况三

安装步骤：

  1. 在 项目根目录 目录执行 npm i

  2. 右键 uniCloud 目录 点击 运行云服务空间初始化向导

  3. 完成

# 情况三

安装步骤：

  • 建议你先使用 vk-unicloud-router 框架进行 client端 开发，client端 开发完成后，使用 vk-unicloud-admin 开发 admin端

  • 当然你也可以先开发 admin端，再开发 client端。

  • 如果先开发 admin端，则直接用 情况二 的安装步骤即可。

  • 如果先开发 client端，则先下载 client端 开发框架，等 client端 开发完后再用 情况一 的安装步骤即可 点击前往下载client端开发框架 (opens new window)

初始admin账号密码：123456

如密码错误，可以强制重置admin账号密码

点击查看『强制重置admin账号密码步骤』 (opens new window)

安装代码快捷提示步骤

  1. 将 根目录/使用帮助/代码快捷提示/javascript代码块提示.json 内的代码 复制到 hbx 工具 - 代码块设置 - javascript代码块
  2. 将 根目录/使用帮助/代码快捷提示/vue代码块提示.json 内的代码 复制到 hbx 工具 - 代码块设置 - vue代码块

其他

删除 pages.json 内的 pages_template/components 和 pages_template/element 分包（此为发布演示版本需要而加，你的项目可以删除，删除后开发模式下依然存在（因为在pages-dev.json中配置了），发布到线上环境时自动屏蔽）

若提示上传云函数失败，请仔细对比下你的项目 uniCloud/common 目录是否跟下图完全一致

如果不一致，特别是 uni-id 目录下没有这个文件 uni-id/node_modules/uni-config-center/uni-id/config.json，则在 uni-id 目录执行 npm i 试试（如果有这个uni-id/node_modules目录，先删除目录，再执行npm i）

若新建的用户登录提示用户不存在（数据库明明有数据），此时是因为不同端用户隔离导致的

  1. 先用admin账号登录后台，进入应用管理

因为每个人的 DCloud Appid是不一样的，所以你需要在应用管理中添加自己的应用（或直接修改内置的2条数据的appid即可）

DCloud Appid 获取方法

复制 uniapp 项目根目录的 manifest.json 文件内的 appid

  1. 再进入用户管理，对需要设置的用户点击编辑，设置该用户可以登录哪些端。

  1. 完成，可以登录了。

如有疑问，请加群：22466457 关于插件的问题包教包会！

← admin框架目录结构 →