likeadmin开发文档(Python)

快速上手

技术栈

服务端

前端-PC端管理后台

目录结构

├─📂 server  //服务端根目录（管理后台、接口）
│
├─📂 admin  //管理后台前端源码
│  ├─📂 router //路由文件夹
│  ├─📄 .env.development.example //开发环境接口地址配置文件模板
│  ├─📄 .env.production.example //生产环境接口地址配置文件模板

服务端运行

安装依赖

项目推荐使用Python3.8版本，最低使用Python3.7 打开终端，使用cd命令进入server目录，运行python -m pip install -r requirements.txt命令安装依赖。

cd likeadmin_python/server
python -m pip install -r requirements.txt

配置文件

复制: “server/.example.env”文件
改为: “server/.env”

启动

服务端项目分为 后台 、 前台 两个服务

后台

打开终端，使用cd命令进入server目录，运行python asgi.py命令启动项目。

cd likeadmin_python/server
# 方式一
python3 asgi.py
# 方式二
python3 -m uvicorn asgi:app --reload

打开浏览器，访问http://127.0.0.1:8000/api/common/index/configopen in new window，即可看到接口返回信息，说明启动成功。

前台

打开终端，使用cd命令进入server目录，运行python asgi_front.py命令启动项目。

cd likeadmin_python/server
# 方式一
python3 asgi_front.py
# 方式二
python3 -m uvicorn asgi_front:app --reload

打开浏览器，访问http://127.0.0.1:8002/api/indexopen in new window，即可看到接口返回信息，说明启动成功。

前端开发模式

likeadmin管理后台使用前后端分离技术开发，在二次开发的时候，需要启动前端开发模式，然后对前端的代码进行修改，即可实时修改预览。

提示

在开发者模式下预览页面速度会比较慢，打包以后非常流畅。

Windows①

  • 步骤1: 设置服务端域名接口。 使用编辑器打开likeadmin项目，复制.env.development.example文件并改名为.env.development，打开likeadmin/admin/.env.development文件，修改VITE_APP_BASE_URL变量的值为项目安装部署的服务端地址，记得保存。

  • 步骤2: node环境安装。 打开https://nodejs.org/en/download/releases/open in new window，下载对应的版本安装包，下载msi后缀文件，方便安装。node版本大于v14.18.0，避免编译出现未知错误。

  • 步骤3: 打开系统自带的终端，Windows Powershell，以管理员身份运行。

  • 步骤4: 在终端运行命令，设置淘宝镜像。

npm config set registry https://registry.npm.taobao.org

  • 步骤4: 使用cd命令进入likeadmin/admin后台前端源码目录，请根据项目实际目录输入cd命令，请勿直接复制命令运行。
  • 步骤5: 在终端运行命令安装依赖。
npm install

  • 步骤6: 在终端运行命令运行项目。
npm run dev

MacOS、Linux②

  • 步骤1: 设置服务端域名接口。 使用编辑器打开likeadmin项目，复制.env.development.example文件并改名为.env.development，打开likeadmin/admin/.env.development文件，修改VITE_APP_BASE_URL变量的值为项目安装部署的服务端地址，记得保存。

  • 步骤2: node环境安装。 打开https://nodejs.org/en/download/releases/open in new window，下载对应的版本安装包，下载pkg后缀文件，方便安装。node版本大于v14.18.0，避免编译出现未知错误。

  • 步骤3: 在终端运行命令，设置淘宝镜像。

npm config set registry https://registry.npm.taobao.org

  • 步骤4: 使用cd命令进入likeadmin/admin后台前端源码目录，请根据项目实际目录输入cd命令，请勿直接复制命令运行。
  • 步骤5: 在终端运行命令安装依赖。
npm install

  • 步骤6: 在终端运行命令运行项目。
npm run dev

docker（即将更新，尽请期待）③

如果服务端使用docker部署方式，前端开发模式运行非常方便。

  • 步骤1: 复制.env.development.example文件并改名为.env.development，打开likeadmin/admin/.env.development文件，修改VITE_APP_BASE_URL变量的值为项目安装部署的服务端地址，记得保存。

  • 步骤2: 在终端运行命令安装依赖。
docker exec -it likeadmin-node npm install



  • 步骤3: 在终端运行命令运行项目。
docker exec -it likeadmin-node npm install



打包上线

  • 步骤1: 在likeadmin/admin目录下，运行命令重新编译打包。
npm run build

如果使用docker，请运行以下命令打包。

docker exec -it likeadmin-node npm run build

  • 步骤2: 编译以后，在admin目录下，生成dist目录，将dist目录改名为admin，覆盖掉server/public/admin目录。
上次更新:
贡献者: levi, lr