Thingsboard（release-3.3）编译指南

一、前期准备 1. 编译环境

Git
JDK11
Maven：3.8.2
Node.js：16.15.1
Yarn：1.22.4
Postgresql：12.x

2. 环境准备 2.1 Git 2.1.1 下载安装

Git下载
安装时选择Git Bash即可

2.1.2 Git本地配置

1.右键任意地方点击Git bash
2.配置邮箱和用户名
git config --global user.name"用户名"
git config --global user.name"邮箱"
3.创建本地SSH（邮箱为注册邮箱）
ssh-keygen -t rsa -C "邮箱"
此处会提示让选择ssh位置，可直接选择默认位置，让输入密码的话，可以两次回车跳过
4.打开Github网站，登录，点击右上角Settings，SSH and GPG keys，New SSH key
5.Title随意，key为生成的本地SSH的文件内容，路径：C:Usersadmin.sshid_rsa.pub，记事本复制打开，将内容复制到Key中即可。
6.Git Bash中输入ssh -T git@github.com，出现

Hi 你的用户名! You’ve successfully authenticated, but GitHub does not provide shell access.
即为配置成功

2.2 JDK 2.2.1 下载

JDK下载

2.2.2 安装，配置环境变量

1.Win+S，搜索环境变量，打开环境变量，在系统变量一栏中新建变量,变量名为JAVA_HOME，变量值为jdk11安装路径，我的在C:Program FilesJavajdk-11.0.15.1
2.双击Path，新建%JAVA_HOME%bin

2.2.3 验证

打开cmd，输入java -version

2.3.Maven 2.3.1 下载

Maven下载

2.3.2 配置环境变量

1.Win+S，搜索环境变量，打开环境变量，在系统变量一栏中新建变量,变量名为MAVEN_HOME，变量值为Maven安装路径，我的在D:Program FilesApacheapache-maven-3.8.2
2.双击Path，新建%MAVEN_HOME%bin

2.3.3 验证

打开cmd，输入mvn -v

出现以上即为成功

2.3.4 配置本地仓库路径及远程仓库

配置本地仓库路径可以节省C盘空间，更改镜像可以加快下载速度

打开/maven安装路径/conf/settings.xml文件，在localRepository注释块下方添加路径即可

更改远程仓库
在下图位置添加即可

如果提示没找到相应的包，更换下方的任意一个镜像重试即可。


     nexus-public-snapshots
     public-snapshots
     http://maven.aliyun.com/nexus/content/repositories/snapshots/


     nexus
     internal nexus repository
     https://repo.maven.apache.org/maven2
     central
 


     maven-central
    central
    https://repo1.maven.org/maven2/
    central
 

 
     uk
     central
     Human Readable Name for this Mirror.
     http://uk.maven.org/maven2/
 

 
     CN
     OSChina Central
     http://maven.oschina.net/content/groups/public/
     central

2.4.Node.js 2.4.1 下载

Node.js下载，全部默认，一路next即可。

2.4.2 验证

node -v

2.4.3 更换淘宝源

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

2.4.4 可能遇到的问题

安装后在cmd输入node -v提示不是内部或外部命令。

查看环境变量->系统环境变量->path中是否有nodejs的安装路径，如果没有手动添加，添加后保存重启电脑即可生效。

2.5.Yarn 2.5.1 Yarn安装

win+R输入cmd打开命令行，输入npm install -g yarn@1.22.4

2.5.2 验证

yarn -v

2.5.3 更改Yarn缓存路径

进入cmd

yarn config set cache-folder "你打算存放的地方"

2.5.4 更换淘宝源

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

2.6.Postgresql 2.6.1 下载安装

Postgressql下载

12.x以上版本都可，我这里选择12.11。
安装没什么好说的，一路next即可

注：配置密码时建议使用postgres作为密码，这样在后期启动Thingsboard时不用更改yml文件中的数据库配置

最后Stack builder不用勾选。

2.6.2 验证

开始菜单->打开pgAdmin4

输入安装时配置的密码即可

登陆成功后

2.6.3 创建数据库

Databases->右键->Create->Database。
名称为thingsboard，直接save即可。

至此所有编译thingsboard所需的环境都准备完毕。

二、编译Thingsboard 1.开始编译

打开Thingsboard文件夹，在地址栏输入cmd，在命令行中打开thingsboard文件夹。

输入命令，开始编译

mvn clean install -DskipTests

2.可能遇见的错误 2.1 [27/46]Failed to execute goal org.thingsboard:gradle-maven-plugin:1.0.11:invoke

原因：网络连接超时导致下载失败
解决方案：手动从https://services.gradle.org/distributions/gradle-7.1.1-bin.zip下载所需依赖，放入Maven本地仓库/org/thingsboard/gradle-maven-plugin/1.0.11/中，重新编译即可

2.2 [32/46]Failed to execute goal com.github.eirslett:frontend-maven-plugin:1.12.0:yarn (yarn install) on project ui-ngx: Failed to run task: ‘yarn install’ failed.

原因：网络连接超时，导致下载失败
解决方法：首先cmd进入Thingsboard/ui-ngx文件夹，输入yarn，出现如下

查看package.json发现，有三个依赖是从github下载的，格式为git://xxx.git，查资料已经被github禁用，改用https://xxx.git。

git config --global url."https://".insteadOf git://

再设置不进行https验证

git config http.sslVerify "false"

再次运行yarn install即可，如果卡住或失败多试几次。
install成功后，返回thingsboard文件夹下，继续重新编译即可。

祝大家都能顺利编译成功。

Thingsboard（release-3.3）编译指南

Java相关栏目本月热门文章