Building The Regression Test Harness for the OpenJDK (jtreg) from Source
Published:
Build JTREG
As in February 2026, to build jtreg from source, we need to use JDK 25.
git clone https://github.com/openjdk/jtreg/
cd jtreg
## Use JDK 25 (e.g., Oracle JDK). We can use sdkman to
## obtain the desired JDK version
sdk use java 25.0.1-oracle
## Build jtreg
sh ./make/build.sh
## Check
$ ./build/images/jtreg/bin/jtreg -version
jtreg 8.3-dev+0
Installed in /home/juan/bin/jtreg/build/images/jtreg/lib/jtreg.jar
Running on platform version 25.0.1 from /home/juan/.sdkman/candidates/java/25.0.1-oracle.
Built with Java(TM) 2 SDK, Version 25.0.1+8-LTS-27 on February 04, 2026.
JT Harness, version 6.0 ea b24 (January 21, 2026)
Java Assembler Tools, version 9.1 ea 01 (January 21, 2026)
TestNG: testng-7.3.0.jar, guice-5.1.0.jar, jcommander-1.82.jar
JUnit: junit-platform-console-standalone-1.14.2.jar
To make jtreg easily accessible, it is convenient to declare the JTREG_HOME and update your PATH variable.
#JTREG_HOME
export JTREG_HOME=<path-to>/jtreg/build/images/jtreg
export PATH=<path-to>/jtreg/build/images/jtreg/bin:$PATH
Build IDEA Plugin for JTREG
The jtreg repository also contains source code for an IntelliJ IDEA plugin.
cd ./plugins/idea
Update the file gradle.properties with the jtregHome path pointing to the JTREG_HOME we just built.
jtregHome = ../../build/images/jtreg
To build the plugin, we need JDK 21.
sdk use java 21.0.9-oracle
sh gradlew clean build
The plugin is located at plugins/idea/build/distributions/jtreg-plugin-1.19.zip.
To install it in IntelliJ IDEA:
- Go to Settings > Plugins.
- Click the Gear Icon ⚙️ and select “Install Plugin from Disk…”.
- Select the generated .zip file.
- Restart your IDE.