JetLinks物联网平台前后端开发环境搭建教程

前提条件

前提条件引用官方原文

后端环境准备如下：

1. 硬件资源最低要求4c8G，硬盘40G。
2. JDK 1.8.0_2xx (需要小版本号大于200) 下载jdk。
3. Maven3.6.3。（IDEA启动时使用IDEA默认自带的版本即可）。

启动JetLinks之前，请先确定已经安装好以下基础服务：

开发者根据自身环境情况选择参考离线基础服务部署或Docker基础服务部署文档。

1. Redis 5.x。
2. PostgreSQL 11 或者 mysql 5.7 +。
3. ElasticSearch 6.8-7.17.5 下载。

前端环境准备如下：

1. NodeJs v18.14.0 +
2. Yarn v1.22.19 +
3. Nginx 1.24.0

后端搭建

后端项目层级架构
**

--jetlinks-community
------|----docker
------|------|----dev-env       # 启动开发环境
------|------|----run-all       # 启动全部,通过http://localhost:9000 访问系统.
------|----jetlinks-components  # 公共组件模块
------|-------|----common-component # 通用组件.
------|-------|----configuration-component # 通用配置.
------|-------|----dashboard-component # 仪表盘.
------|-------|----datasource-component # 数据源.
------|-------|----elasticsearch-component # elasticsearch集成.
------|-------|----gateway-component # 网关组件,消息网关,设备接入.
------|-------|----io-component # IO 组件,Excel导入导出等.
------|-------|----logging-component # 日志组件
------|-------|----network-component # 网络组件,MQTT,TCP,CoAP,UDP等
------|-------|----notify-component # 通知组件,短信,右键等通知
------|-------|----protocol-component # 协议组件
------|-------|----relation-component # 关系组件
------|-------|----rule-engine-component # 规则引擎
------|-------|----script-component # 脚本组件
------|-------|----timeseries-component # 时序数据组件
------|-------|----tdengine-component # TDengine集成
------|-------|----things-component # 物组件
------|----jetlinks-manager     # 业务管理模块
------|-------|----authentication-manager   # 用户,权限管理
------|-------|----device-manager   # 设备管理
------|-------|----logging-manager   # 日志管理
------|-------|----network-manager   # 网络组件管理
------|-------|----notify-manager   # 通知管理
------|-------|----visualization-manager   # 数据可视化管理
------|-------|----rule-engine-manager   # 规则引擎管理
------|----jetlinks-standalone  # 服务启动模块
------|----simulator            # 设备模拟器

首先访问项目的github地址：https://github.com/jetlinks/jetlinks-community，复制项目github的下载地址https://github.com/jetlinks/jetlinks-ui-components.git

用idea拉取项目源码
等待项目初始化完毕，如果遇到依赖下载不下来的情况需要将setting.xml中配置的国内镜像地址注释，使用maven默认的地址即可
项目初始化完毕后，修改配置文件，需要配置数据库，这里我用的是mysql，并使用内嵌的elasticsearch（在硬件条件较差时，可以使用内嵌的ElasticSearch，不用单独安装。）

创建对应的数据库
启动项目
如果出现java: 程序包jdk.nashorn.internal.runtime不存在需要把java版本改为1.8
如果提示Error running 'JetLinksApplication': Command line is too long. Shorten command line for JetLinksApplication or also for Spring Boot default configuration?参考【IDEA提示：Error running ‘JetLinksApplication’: Command line is too long. Shorten command line for JetLinksApplication or also for Spring Boot default configuration?】的解决办法

项目启动成功后，会自动往数据库中生成表结构并插入数据，到这里后端搭建就完成了

前端搭建

前端有2个代码库，ant版本(旧) 和 vue版本(新)，这里我使用vue版本

首先访问项目的github地址：https://github.com/jetlinks/jetlinks-ui-vue，复制项目github的下载地址https://github.com/jetlinks/jetlinks-ui-vue.git
我习惯用idea写前端所以用idea拉取项目源码
官方文档提供了下面几个命令

# 安装依赖
yarn

# 启动服务
yarn dev

# 更新jetlinks-ui-components
yarn add jetlinks-ui-components@latest

# 更新jetlinks-ui-components之后没有效果时
yarn dev:force

执行完yarn命令后修改后端的连接地址，改为localhost即可，端口号需要与之对应
执行yarn dev命令
通过http://localhost:5173/访问页面，默认的用户名密码为admin,admin
设置系统初始信息后即可正常使用