DataEase v2 开源代码 Windows 环境搭建


飞致云 发布于 2024-07-09 / 135 阅读 / 0 评论 /
1.环境准备 操作系统: Windows 数据库: MySQL8.0(要求8.0以上版本),需要自己先安装好,参考 DataEase 官网的 MySQL

1.环境准备

操作系统:

Windows

数据库:

MySQL8.0(要求8.0以上版本),需要自己先安装好,参考 DataEase 官网的 MySQL 配置:https://dataease.io/docs/v2/installation/offline_INSTL_and_UPG/#43

开发环境:

IntelliJ IDEA

Maven:3.9

JDK:17(注意 DataEase v2.7 后已更新到 JDK 21)

Nodejs:16+

Npm:8+

Git

先将以上软件都准备好备用,对应的安装可以直接搜索教程

2.代码获取和数据库创建

2.1获取代码

在你选定的文件夹位置使用 git clone 命令克隆 DataEase 的代码。

通过 IDEA 找到刚刚 Git 下载文件夹中的 pom.xml 文件,点击信任该项目,选择想拉取的分支,以下演示 DataEase 为 v2.6版本,避开 dev 分支,并且换成自己的 Maven 仓库等待下载依赖。

此时 IDEA 右侧 Maven 窗口中 dataease 可能出现爆红,可以将 core 文件夹下 pom.xml 右键点击加入 Maven 项目,然后点击刷新。

2.2数据库初始化

  • 登录到自己安装的 MySQL 并创建 dataease 数据库。

CREATE DATABASE `dataease` DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;

  • 进入创建的数据库后,执行 sql 脚本文件初始化,脚本在源码文件夹中  \dataease\core\core-backend\src\main\resources\db\migratio

3.环境配置

以下步骤根据实际情况调整 JDK ,到 IDEA 菜单中 File —> Project Structure —> Project 中选择对应的 SDK 和 Language level,如果 Windows 环境有配置 JDK17 这里下拉框中可以看到选项,同时检查 Modules 下各模块的 Language level。

 

到 IDEA 菜单中 File —> Settings —> Build,Execution,Deployment —> Compilter —> Java Compilter 中选择项目字节码版本 17。

代码需要连接数据库,数据库配置参数在  \core\core-backend\src\main\resources\application-standalone.yml 中,根据你的 MySQL 参数进行修改。

DataEase 在运行过程中需要的静态资源,包括地图、模板素材等,这些资源由后端进行管理,资源位置的相关路径在  \sdk\common\src\main\java\io\dataease\constant\StaticResourceConstants.java 中,先在 Windows 本地创建资源目录,然后将 USR_HOME 原来的/opt/dataease2.0/data 修改为自定义的目录,并将项目中的 divers、mapFiles、staticResource 目录复制到自定义的windows目录中,将mapFiles 名称改为 map,staticResource 名称改为 static-resource。

 

之后由于 Windows 中文件访问协议的不同,需要修改 StaticResourceConstants.java 中的 FILE_PROTOCOL 变量内容为“file:///”。此处资源位置修改主要解决地图数据、模板数据的静态资源访问问题。通过全局查找/opt/dataease2.0/data 字符串来查找整个项目,将 ExcelUtils.java 和 CalciteProvider.java 等代码文件中的 PATH 修改为自定义目录。

首次编译前,需要修改后端项目 core-backend 目录中的 pom.xml 文件,修改 <filtering>true</filtering> 中的值为 false ,避免编译时由前端向后端集成资源包时报错。

4.编译运行

打开前端项目 core-frontend 目录中的pom.xml文件,在 pom.xml 中增加如下代码,会自动全局安装 win-node-env,用于解决 windows 系统出现‘NODE_OPTIONS’ is not recognized as an internal or external command 问题,让 Node.js 的环境变量可以在 Windows 环境下正常运行。

<execution>
  <id>npm install -g win-node-env</id>
  <goals>
    <goal>npm</goal>
  </goals>
  <configuration>
    <arguments>install -g win-node-env</arguments>
  </configuration>
</execution>

修改 core/core-frontend/.eslintrc.js 文件,在最后的 rules 节点中增加以下内容,避免前端项目在编译时因格式问题检查出现错误。

"prettier/prettier": ['off']

在项目管理其中鼠标右键点击根 dataease 模块,在菜单中选择 Build Module 'dataease',开始构建项目,此时构建项目并不包括 core 核心代码,只是将 sdk 中的组件编译完成。

在项目管理器中右键单击core文件夹,选择 Build Module 'core'构建核心项目,此处构建包括前后端,所以时间较长。构建完成后,项目管理中会生成\core\core-backend\target\CoreApplication.jar 文件,右键运行 CoreApplication.jar ,等待可以访问端口 8100 即可。

安装成功后,通过浏览器访问如下页面登录:

访问地址:http://目标服务器 IP 地址:服务运行端口
登录用户名:admin
登录密码:DataEase@123456




是否对你有帮助?