ThingsBoard源码分析——调试环境搭建|江阴雨辰互联

2023年7月7日发(作者：)

ThingsBoard源码分析——调试环境搭建摘要: 此⽂档安装系统为win7 64位，因为使⽤虚拟机，所以安装软件位置都为C盘，涉及到编译时会有权限问题，和造成电脑很卡，建议⼤家不要安装在C盘

1. 依赖⼯具2. 源码调试2.1 源码拉取2.2 源码编译2.3 IDE(编译器)导⼊3. 数据源处理4. 登录ThingBoard1、依赖⼯具 —JDK Jdk安装，安装过程中会出现两次安装提⽰。第⼀次是安装 jdk ，第⼆次是安装 jre 。建议两个都安装在同⼀个java⽂件夹中的不同⽂件夹中。（不能都安装在java⽂件夹的根⽬录下，jdk和jre安装在同⼀⽂件夹会出错）

点击安装程序，如下图所⽰

点击下⼀步，jdk安装随意选择⽬录,只需把默认安装⽬录 java 之前的⽬录修改即可，如E：Javajdk1.8.0_91，然后点击下⼀步, 若⽆安装⽬录要求，可全默认设置。⽆需做任何修改，直接点下⼀步

如图，请耐⼼等待

安装jre→更改→ java 之前⽬录和安装 jdk ⽬录相同即可

点击下⼀步，

到此jdk就安装完成了，但是还需配置环境变量电脑桌⾯上⿏标右击计算机→属性→⾼级系统设置→⾼级→环境变量

新建 JAVA_HOME 变量，变量值填写为jdk的安装⽬录，写好后点击确定

系统变量→寻找 Path 变量→编辑在变量值最后输⼊ %JAVA_HOME%bin（注意原来Path的变量值末尾有没有“ ; “号，如果没有，先输⼊” ； “号再输⼊上⾯的代码）

系统变量→新建 CLASSPATH 变量变量值填写 .;%JAVA_HOME%;%JAVA_HOME%;（变量值前⾯有点号和分号，后边结尾也有分号）或者可以写成“.;%JAVA_HOME%lib”（注意最前⾯有⼀点）

系统变量配置完毕！现在检验⼀下是否配置成功运⾏cmd分别输⼊java， javac， javadoc。终端都显⽰内容，才能说明JDK安装成功

输⼊ java -version （java 和 -version 之间有空格）如图所⽰显⽰版本信息Maven将maven安装包根据⾃⼰需求解压缩到指定⽬录，本⼈放在⾥⾯C盘下⾯，⾥⾯有bin、lib、conf等⽂件夹

1）更换你的maven镜像为阿⾥云镜像，以免导⼊依赖时消耗过多时间修改maven配置⽂件，修改时最好⽤notepad++打开，不要⽤记事本打开记事本打开是

⽽notepad++打开则排布整齐

打开

在中加⼊如下这段，然后保存 nexus * nexus-public-snapshots public-snapshots

（2）配置Maven环境变量，如上jdk配置⼀样在计算机--属性--⾼级系统设置--环境变量--系统变量--新建

新建变量变量名：M2_HOME变量值：C:Program Filesapache-maven-3.3.9 （你的maven路径）

找到Path在环境变量值尾部加⼊：;%M2_HOME%bin;

（注意原来Path的变量值末尾有没有“ ; “号，如果没有，先输⼊” ； “号再输⼊上⾯的代码）

系统变量配置完毕！现在检验⼀下是否配置成功运⾏cmd输⼊mvn -v ，显⽰版本信息表⽰配置成功

（3）修改本地仓库位置 Maven会将下载的类库（jar包）放置到本地的⼀个⽬录下（⼀般默认情况下maven在本机的仓库位于C:我的⽂档中.tory），如果想重新定义这个⽬录的位置就需要修改Maven本地仓库的配置： 1、在⾃⼰喜欢的位置创建⽂件夹，此处本⼈创建的位置是（C:Program FilesMavenMavenRepo） 2、在安装Maven的⽬录下找到conf⽂件夹，在⽂件夹中找到⽂件，复制⽂件放于C:Program FilesMaven，如下图所⽰：

并修改⽂件

在安装Maven的⽬录下找到conf⽂件夹，在⽂件夹中找到⽂件，更改默认的仓库位置如下图所⽰：（注意两个地⽅的都要修改）依据该配置，Maven就会将下载的类库保存到C:Program FilesMavenMavenRepo中。Nodejsnodejs版本推荐6.9.5

注意：Linux上安装需要安装Python 2.6 或 2.7 ，不建议安装Python 3.0以上版本。双击下载的安装包，⼀路Next检测PATH环境变量是否配置了，点击开始=》运⾏=》输⼊"cmd" => 输⼊命令"path"，输出如下结果

我们可以看到环境变量中已经包含了C:Program Filesnodejs检测nodejs版本,输⼊node -v,可以看到nodejs版本

说明你已经成功安装了:(1)node -v检测当前的操作系统的nodejs版本

(2)执⾏ThingsBoard所需模块:npm install -g cross-env

(3)执⾏ThingsBoard所需模块:npm install -g webpack

(4)执⾏ThingsBoard所需模块:npm install --global gulp

Git双击安装程序，按默认选项安装即可

选择组件

（1）图标组件(Addition icons) : 选择是否创建桌⾯快捷⽅式。（2）桌⾯浏览(Windows Explorer integration) : 浏览源码的⽅法，使⽤bash 或者使⽤Git GUI⼯具。（3）关联配置⽂件 : 是否关联 git 配置⽂件, 该配置⽂件主要显⽰⽂本编辑器的样式。（4）关联shell脚本⽂件 : 是否关联Bash命令⾏执⾏的脚本⽂件。（5）使⽤TrueType编码 : 在命令⾏中是否使⽤TruthType编码, 该编码是微软和苹果公司制定的通⽤编码。

安装完成后，在开始菜单⾥找到“Git”->“Git Bash”，蹦出⼀个类似命令⾏窗⼝的东西，就说明Git安装成功

安装完成后，还需要最后⼀步设置，在命令⾏输⼊如下：$ git config --global "Your Name"$ git config --global

IntelliJ IDEA(使⽤eclipse编译时会有问题，建议使⽤IDEA)note: 请确保你在你的系统中安装了以上依赖⼯具！下⾯展⽰IntelliJ IDEA的安装教程：IntelliJ IDEA有两个版本：社区版(Community)和旗舰版(Ultimate)。

社区版是免费的、开源的，但功能较少;

旗舰版提供了较多的功能

开始安装，双击安装程序

点击Install开始安装，耐⼼等待⼏分钟

安装成功！安装成功后就是激活软件，

(1)运⾏⾥⾯输⼊hosts⽂件地址，打开hosts⽂件

在hosts⽂件中添加0.0.0.0

(2)在idea进⼊页⾯填⼊激活码，⽅便起见，我这边直接把激活码贴出来

EB101IWSWD-eyJsaWNlbnNlSWQiOiJFQjEwMUlXU1dEIiwibGljZW5zZWVOYW1lIjoibGFuIHl1IiwiYXNzaWduZWVOYW1lIjoiIiwiYXNzaWduZWVFbWFpbCI6IiIsImxpY2Vuc2VSZXN0cmMIIEPjCCAiagAwIBAgIBBTANBgkqhkiG9w0BAQsFADAYMRYwFAYDVQQDDA1KZXRQcm9maWxlIENBMB4XDTE1MTEwMjA4MjE0OFoXDTE4MTEwMTA4MjE0OFowETEPMA0GA1源码调试源码拉取新建⼀个⽂件夹，我这⾥取名为learngit,进⼊⽂件夹，⿏标右键选择git Bash

输⼊git init,⽣成.git⽂件，如果没有可能是隐藏了，没有关系

如图，项⽬就被拉下来了源码编译在你拉取的thingsboard项⽬根⽬录下输⼊命令1. 打开运⾏，cmd ,进⼊thingsboard所在的⽂件夹，输⼊命令mvn clean install –DskipTests

note: 编译时间超长，如果⼀次不⾏，那就多次，只能这么说!

（1）错误解决1：如果编译失败则可以尝试输⼊mvn clear,然后再次运⾏mvn clean install –DskipTests（2）错误解决2：

如遇到上图情况当运⾏项⽬出现[ERROR] Failed to execute goal s:maven-clean说明tomcat服务器已经启动了，⽽你现在⼜启动，后台运⾏造成冲突，需要关闭tomcat，或者重启电脑，然后重新运⾏就可以了

上图编译成功编译器导⼊启动IDEA,打开刚刚编译好的源码项⽬

选择thingsboard⽂件路径，点击“ok”,导⼊可能需要⼀点时间，请耐⼼等待

如上图就是导⼊成功了通过代码统计（这个需要安装⼀个插件Statistic，不重要，只是看下代码量！可以不看，

（1）配置jdk项⽬导⼊以后先配置jdk

点击左侧标签页SDKs选项，再点击左上⾓“+”，选择JDK；

在弹出框选择JDK安装路径，点击OK即可配置成功下图可以看到JDK已经在IDEA中配置好了

（2）配置⽀持es6语法配置好jdk后会发现代码还是有红线，这时候还需改变⼀下设置⽀持es6语法

（3）安装lombok插件

做好以上步骤，当然此时运⾏还是⽆法运⾏成功的！因为没有数据源(也就是数据库，包括关系，⾮关系数据库)啊！关系数据库: postgresql(推荐使⽤9.x版本)安装时选择默认即可，选择你想安装的⽬录下

安装时如果在安装结束时如果弹出⼀个错误的提⽰框：Failed to load sql modules into the database cluster 需要“Secondary Logo” 服务启动，否则就会报如上错误需要在计算机管理—>服务⾥，找到 “SecondaryLogon” 服务，并启动，就会⾃动load sql modules。安装时语⾔需要选Chinese或者Chinese macau，不能默认的default没有错误则忽略接下来使⽤navicat连接postgresql打开navicat

在ThingsBoard项⽬中找到如下的sql⽂件

将两个sql⽂件复制到桌⾯

然后在navicat中选中postgres

右键运⾏sql⽂件

先导⼊,再导⼊如下图导⼊成功

⾮关系数据库: redis 安装redis

redis压缩包解压到相应⽬录，解压后，⽂件夹重新命名为 redis cmd 窗⼝使⽤cd命令切换⽬录到 C:redis 运⾏

cmd窗⼝，原来的不要关闭，不然就⽆法访问服务端了redis⽬录下运⾏ -h 127.0.0.1 -p 6379 set myKey abc get myKey

1. ，修改⾥⾯的数据库连接信息

先注释第164⾏⾄220⾏代码,346⾄360⾏代码（多⾏注释，选中区域，ctrl+"/",解开注释⼀样）

解开362⾄375的注释，然后修改数据库连接

完成以上操作，则再次运⾏项⽬，打开下图箭头所指⽂件，右键选择Run as