本指南将帮助您从源码下载并构建TBMQ。以下说明已在Ubuntu 20.04 LTS/22.04 LTS/24.04 LTS上测试通过。
所需工具
本节包含构建工具的安装说明。
Java
TBMQ使用Java 17构建。请按以下说明安装OpenJDK 17：
1
2
sudo apt update
sudo apt install openjdk-17-jdk-headless
请勿忘记将操作系统配置为默认使用OpenJDK 17。 可使用以下命令配置默认版本：
1
sudo update-alternatives --config java
可使用以下命令检查安装是否成功：
1
java -version
预期命令输出为：
1
2
3
openjdk version "17.0.xx"
OpenJDK Runtime Environment (...)
OpenJDK 64-Bit Server VM (build ...)
Maven
TBMQ构建需要Maven 3.6.3及以上版本。
1
sudo apt install maven
请注意：在部分Linux机器上，Maven安装可能会将Java 7设为默认JVM。 请使用Java安装说明进行修复。
源码
您可从官方 GitHub仓库克隆项目源码。
1
2
git clone -b release-2.2.0 https://github.com/thingsboard/tbmq.git
cd tbmq
构建
在TBMQ目录下运行以下命令构建项目：
1
mvn clean install -DskipTests
构建本地Docker镜像
请确保已安装 Docker。
1
mvn clean install -DskipTests -Ddockerfile.skip=false
构建产物
您可在target目录中找到debian、rpm和windows安装包：
1
cd application/target
运行测试
我们使用 Docker 运行各类集成测试和黑盒测试。
请配置 以非root用户管理Docker 以正确运行测试。
主分支和发布分支均已通过测试，因此您可跳过测试，也无需安装Docker。
运行全部单元测试和集成测试：
1
mvn clean install
技巧与提示
在全新的纯净环境中，TBMQ源码安装较为简便。
以下是一些提升构建体验的技巧：
- 清理Maven缓存
1
rm -rf ~/.m2/repository
{: .copy-code}-清理Gradle缓存
1
rm -rf ~/.gradle/caches/
{: .copy-code}-清理node modules
1
rm -rf ui-ngx/node_modules
{: .copy-code}-并行构建、格式化头文件、构建Docker镜像
1
mvn -T 0.8C license:format clean install -DskipTests -Ddockerfile.skip=false