Skip to content

安装说明

1. 安装插件

1.1 Marketplace 商店(推荐)

  1. 打开 IDE Settings 并选择 Plugins
  2. Marketplace 搜索 DebugTools 并点击 install
  3. 重启应用

marketplace

1.2 自行安装

text
https://plugins.jetbrains.com/plugin/24463-debugtools
text
https://download.debug-tools.cc/DebugToolsIdeaPlugin.zip
sh
git clone https://github.com/future0923/debug-tools.git
cd debug-tools
# maven打包需要使用 `java17+` 版本构建
mvn clean install -T 2C -Dmaven.test.skip=true
# dist目录下
# debug-tools-boot.jar 远程agent包
cd debug-tools-idea
# grade打包Idea插件时需要使用`java17+`版本构建
./gradlew clean buildPlugin
# dist目录下
# DebugTools-{version}.zip IDEA插件包
text
https://github.com/future0923/debug-tools/releases
text
https://gitee.com/future94/debug-tools/releases

2. 安装JDK

只有使用热部署热重载功能时才需要特定的JDK支持。

2.1 JDK 8

2.1.1 直接使用打包好的JDK包

通过github下载

https://github.com/future0923/debug-tools/releases/tag/dcevm-jdk-1.8.0_181

DebugTools官网下载

2.1.2 自行安装

Windows/Mac OS

下载对应版本的 .jar 文件。目前只支持下面版本的JDK,请选择对应版本的。

java versiondownload by debug toolsdownload by github
1.8.0_181DCEVM-8u181-installer.jarDCEVM-8u181-installer.jar
1.8.0_172DCEVM-8u172-installer.jarDCEVM-8u172-installer.jar
1.8.0_152DCEVM-8u152-installer.jarDCEVM-8u152-installer.jar
1.8.0_144DCEVM-8u144-installer.jarDCEVM-8u144-installer.jar
1.8.0_112DCEVM-8u112-installer.jarDCEVM-8u112-installer.jar
1.8.0_92DCEVM-8u92-installer.jarDCEVM-8u92-installer.jar
1.8.0_74DCEVM-8u74-installer.jarDCEVM-8u74-installer.jar
1.8.0_66DCEVM-8u66-installer.jarDCEVM-8u66-installer.jar
1.8.0_51DCEVM-8u51-installer.jarDCEVM-8u51-installer.jar
1.8.0_45DCEVM-8u45-installer.jarDCEVM-8u45-installer.jar

运行对应的 java -jar DCEVM-8uXX-installer.jar 文件,找到对应的版本,点击 Install DCEVM as altjvm 按钮即可。

dcevm-installer.png

Linux

如输入 java -XXaltjvm=dcevm -version 输入如下提示

text
Error: missing `dcevm' JVM at `/home/java/jdk1.8.0_291/jre/lib/amd64/dcevm/libjvm.so'.
Please install or use the JRE or JDK that contains these missing components.

下载对应版本的文件并改名为 libjvm.so 到上面提取的目录下即可。

java versiondownload by debug toolsdownload by github
>= 1.8.0_181libjvm181.solibjvm181.so
1.8.0_172libjvm172.solibjvm172.so
1.8.0_152libjvm152.solibjvm152.so
1.8.0_144libjvm144.solibjvm144.so
1.8.0_112libjvm112.solibjvm112.so
1.8.0_92libjvm92.solibjvm92.so
1.8.0_74libjvm74.solibjvm74.so
<= 1.8.0_66libjvm66.solibjvm66.so

2.2 JDK 11

trava-jdk-11-dcevm

使用 trava-jdk-11-dcevm JDK 可以支持热部署/热重载。

JetBrainsRuntime

使用 JetBrainsRuntime JDK 可以支持热部署/热重载。

建议使用最新版 11_0_15-b2043.56

2.3 JDK 17/21

使用 JetBrainsRuntime JDK 可以支持热部署/热重载。

INFO

苹果系统如果下载JDK后提示已损坏或无法验证开发者等原因不能启动JDK,输入 sudo xattr -r -d com.apple.quarantine /$jdkPath 即可, $jdkPath 是你的jdk目录

3. 下载debug-tools-agent.jar

debug-tools-agent.jar 是一个 Java Agent 包,他是 DebugTools 功能的核心,DebugTools 功能都是通过 Java Agent 实现。

只有热部署需要此jar,其他在Idea插件中已经内置了。

text
https://download.debug-tools.cc/debug-tools-agent.jar
sh
git clone https://github.com/future0923/debug-tools.git
cd debug-tools
# 目前maven打包需要使用 `java17+` 版本构建。
mvn clean install -T 2C -Dmaven.test.skip=true
# dist目录下
# debug-tools-agent.jar 远程agent包
text
https://github.com/future0923/debug-tools/releases
text
https://gitee.com/future94/debug-tools/releases

4. 下载debug-tools-boot.jar

使用 debug-tools-boot.jar 可以在应用启动后动态启动 debug tools server 服务。

text
https://download.debug-tools.cc/debug-tools-boot.jar
sh
git clone https://github.com/future0923/debug-tools.git
cd debug-tools
# 目前maven打包需要使用 `java17+` 版本构建。
mvn clean install -T 2C -Dmaven.test.skip=true
# dist目录下
# debug-tools-boot.jar 远程agent包
text
https://github.com/future0923/debug-tools/releases
text
https://gitee.com/future94/debug-tools/releases