Installation instructions
1. Install the plugin
1.1 Marketplace store (recommended)
Open
IDE Settingsand selectPluginsSearch
DebugToolsinMarketplaceand clickinstallRestart the application
1.2 Self-installation
https://plugins.jetbrains.com/plugin/24463-debugtoolshttps://download.debug-tools.cc/DebugToolsIdeaPlugin.zipgit clone https://github.com/future0923/debug-tools.git
cd debug-tools
# Maven packaging needs to use `java17+` version to build
mvn clean install -T 2C -Dmaven.test.skip=true
# In the dist directory
# debug-tools-boot.jar remote agent package
cd debug-tools-idea
# When grade packages the Idea plug-in, it needs to use the `java17+` version to build
./gradlew clean buildPlugin
# In the dist directory
# DebugTools-{version}.zip IDEA plug-in packagehttps://github.com/future0923/debug-tools/releaseshttps://gitee.com/future94/debug-tools/releases2. Install JDK
Specific JDK support is only required when using the hot-deploy and hot-reload functions.
2.1 JDK 8
2.1.1 Use the packaged JDK package directly
Download from github
https://github.com/future0923/debug-tools/releases/tag/dcevm-jdk-1.8.0_181
DebugTools official website download
2.1.2 Self-installation
Windows/Mac OS
Download the corresponding version of the .jar file. Currently only the following versions of JDK are supported, please select the corresponding version.
Run the corresponding java -jar DCEVM-8uXX-installer.jar file, find the corresponding version, and click the Install DCEVM as altjvm button.
Linux
If you enter java -XXaltjvm=dcevm -version, you will get the following prompt
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.Download the corresponding version file and rename it to libjvm.so and put it in the directory extracted above.
| java version | download by debug tools | download by github |
|---|---|---|
| >= 1.8.0_181 | libjvm181.so | libjvm181.so |
| 1.8.0_172 | libjvm172.so | libjvm172.so |
| 1.8.0_152 | libjvm152.so | libjvm152.so |
| 1.8.0_144 | libjvm144.so | libjvm144.so |
| 1.8.0_112 | libjvm112.so | libjvm112.so |
| 1.8.0_92 | libjvm92.so | libjvm92.so |
| 1.8.0_74 | libjvm74.so | libjvm74.so |
| <= 1.8.0_66 | libjvm66.so | libjvm66.so |
2.2 JDK 11
trava-jdk-11-dcevm
Use trava-jdk-11-dcevm JDK to support hot deployment/hot reload.
- MacOS latest version Dcevm-11.0.15+1 Download address
- Windows latest version Dcevm-11.0.15+1 Download address
- Windows latest version Dcevm-11.0.15+1 Download address
- Other versions can be downloaded from https://github.com/TravaOpenJDK/trava-jdk-11-dcevm/releases.
JetBrainsRuntime
Using JetBrainsRuntime JDK can support hot deployment/hot reload.
It is recommended to use the latest version 11_0_15-b2043.56
2.3 JDK 17/21
Using JetBrainsRuntime JDK can support hot deployment/hot reload.
INFO
If the Apple system prompts that the JDK is damaged or the developer cannot be verified after downloading the JDK, you can enter sudo xattr -r -d com.apple.quarantine /$jdkPath, $jdkPath is your jdk directory
3. Download debug-tools-agent.jar
debug-tools-agent.jar is a Java Agent package, which is the core of DebugTools functions. DebugTools functions are all implemented through Java Agent.
Only hot-deploy requires this jar, and the others are already built into the Idea plugin.
https://download.debug-tools.cc/debug-tools-agent.jargit clone https://github.com/future0923/debug-tools.git
cd debug-tools
# Currently, maven packaging needs to be built using the `java17+` version.
mvn clean install -T 2C -Dmaven.test.skip=true
# In the dist directory
# debug-tools-agent.jar remote agent packagehttps://github.com/future0923/debug-tools/releaseshttps://gitee.com/future94/debug-tools/releases4. Download debug-tools-boot.jar
Use debug-tools-boot.jar to dynamically start the debug tools server service after the application starts.
https://download.debug-tools.cc/debug-tools-boot.jargit clone https://github.com/future0923/debug-tools.git
cd debug-tools
# Currently, maven packaging needs to be built using the `java17+` version.
mvn clean install -T 2C -Dmaven.test.skip=true
# In the dist directory
# debug-tools-boot.jar remote agent packagehttps://github.com/future0923/debug-tools/releaseshttps://gitee.com/future94/debug-tools/releases