vk-unicloud 快速开发框架

# 快速上手 - 安装步骤

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

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

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

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

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

# 这里需要分三种情况

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

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

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

# 情况一

# 思路：因为云函数会互相覆盖，因此我们可以把 service端（云函数端） 统一放在 client端 的项目中，而 admin端 项目 直接绑定 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
  • 4、把 admin端 的服务空间直接绑定 client端 项目（注意是 绑定 不是 关联）（注意是 绑定 不是 关联）（注意是 绑定 不是 关联）

  • 5、上传 router 云函数

  • 6、完成

# 情况二

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

# 安装步骤：

  • 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

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

  • 3、完成，可以登录了。

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

← admin框架目录结构 →