ElasticView

Appearance

插件开发流程 ​

本文档详细介绍 ElasticView 插件的完整开发流程，包括后端调试、前端调试和插件打包。

前置条件 ​

在开始开发前，请确保您已经：

  1. ✅ 完成了开发环境搭建
  2. ✅ 下载了插件模板工程
  3. ✅ ElasticView 服务正在运行（访问 http://localhost:8090）

插件后端调试 ​

1. 初始化项目 ​

在插件模板工程根目录下执行：

bash
go mod tidy

这将下载并整理所有 Go 依赖。

2. 启动后端热编译 ​

在项目根目录执行：

bash
gowatch

当看到以下信息时，说明后端启动成功：

正常链接ev基座

此时后端插件已经连接到 ElasticView 基座，代码修改会自动热重载。

插件前端调试 ​

1. 配置调试模式 ​

重点：修改 plugin.json 中的 frontend_debug 为 true：

json
{
  "frontend_debug": true
}

2. 安装前端依赖 ​

进入前端目录并安装依赖：

bash
cd frontend && pnpm i

3. 启动前端开发服务器 ​

bash
npm run dev

4. 验证调试效果 ​

刷新 ElasticView 页面，如果看到插件页面出现，说明前端调试环境配置成功。

开发调试技巧 ​

日志调试 ​

  • 后端日志：查看 gowatch 的控制台输出
  • 前端日志：使用浏览器开发者工具查看控制台

热重载 ​

  • 后端：使用 gowatch 实现代码自动重载
  • 前端：开发服务器支持热重载，保存即生效

配置切换 ​

开发和生产环境的关键区别在于 plugin.json 中的 frontend_debug 配置：

  • true：前端调试模式，使用开发服务器
  • false：生产模式，使用打包后的静态文件

常见问题 ​

1. 后端无法连接到基座 ​

检查：

  • ElasticView 服务是否正常运行
  • 端口 8090 是否被占用
  • 网络连接是否正常

2. 前端页面无法显示 ​

检查：

  • frontend_debug 是否设置为 true
  • 前端开发服务器是否正常启动
  • 浏览器是否有缓存问题

3. 打包失败 ​

检查：

  • frontend_debug 是否设置为 false
  • Go 环境是否正确配置
  • ev_plugin_builder 工具是否正确安装

下一步 ​