|
| 1 | +--- |
| 2 | +layout: post |
| 3 | +title: "Java Toolchains in Liberty Build Plugins in 26.0.0.2" |
| 4 | +# Do NOT change the categories section |
| 5 | +categories: blog |
| 6 | +author_picture: https://avatars3.githubusercontent.com/navaneethsnair1 |
| 7 | +author_github: https://github.com/navaneethsnair1 |
| 8 | +seo-title: Java Toolchains in Liberty Build Plugins in 26.0.0.2- OpenLiberty.io |
| 9 | +seo-description: This release introduces Java Toolchains support, enabling developers to decouple the JDK used to run build tools from the JDK used to run the Liberty server. |
| 10 | +blog_description: This release introduces Java Toolchains support, enabling developers to decouple the JDK used to run build tools from the JDK used to run the Liberty server. |
| 11 | +open-graph-image: https://openliberty.io/img/twitter_card.jpg |
| 12 | +open-graph-image-alt: Open Liberty Logo |
| 13 | +--- |
| 14 | += Java Toolchains in Liberty Build Plugins in 26.0.0.2 |
| 15 | +Navaneeth S Nair <https://github.com/navaneethsnair1> |
| 16 | +:imagesdir: / |
| 17 | +:url-prefix: |
| 18 | +:url-about: / |
| 19 | +//Blank line here is necessary before starting the body of the post. |
| 20 | + |
| 21 | +// // // // // // // // |
| 22 | +// In the preceding section: |
| 23 | +// Do not insert any blank lines between any of the lines. |
| 24 | +// Do not remove or edit the variables on the lines beneath the author name. |
| 25 | +// |
| 26 | +// "open-graph-image" is set to OL logo. Whenever possible update this to a more appropriate/specific image (For example if present a image that is being used in the post). However, it |
| 27 | +// can be left empty which will set it to the default |
| 28 | +// |
| 29 | +// "open-graph-image-alt" is a description of what is in the image (not a caption). When changing "open-graph-image" to |
| 30 | +// a custom picture, you must provide a custom string for "open-graph-image-alt". |
| 31 | +// |
| 32 | +// Replace TITLE with the blog post title eg: MicroProfile 3.3 is now available on Open Liberty 20.0.0.4 |
| 33 | +// Replace navaneethsnair1 with your GitHub username eg: lauracowen |
| 34 | +// Replace DESCRIPTION with a short summary (~60 words) of the release (a more succinct version of the first paragraph of the post). |
| 35 | +// Replace Navaneeth S Nair with your name as you'd like it to be displayed, eg: Laura Cowen |
| 36 | +// |
| 37 | +// Example post: 2020-04-09-microprofile-3-3-open-liberty-20004.adoc |
| 38 | +// |
| 39 | +// If adding image into the post add : |
| 40 | +// ------------------------- |
| 41 | +// [.img_border_light] |
| 42 | +// image::img/blog/FILE_NAME[IMAGE CAPTION ,width=70%,align="center"] |
| 43 | +// ------------------------- |
| 44 | +// "[.img_border_light]" = This adds a faint grey border around the image to make its edges sharper. Use it around screenshots but not |
| 45 | +// around diagrams. Then double check how it looks. |
| 46 | +// There is also a "[.img_border_dark]" class which tends to work best with screenshots that are taken on dark |
| 47 | +// backgrounds. |
| 48 | +// Change "FILE_NAME" to the name of the image file. Also make sure to put the image into the right folder which is: img/blog |
| 49 | +// change the "IMAGE CAPTION" to a couple words of what the image is |
| 50 | +// // // // // // // // |
| 51 | + |
| 52 | +This release introduces Java Toolchains support, enabling developers to decouple the JDK used to run build tools from the JDK used to run the Liberty server. |
| 53 | + |
| 54 | +// // // // // // // // |
| 55 | +// In the preceding section: |
| 56 | +// Leave any instances of `tag::xxxx[]` or `end:xxxx[]` as they are. |
| 57 | +// |
| 58 | +// Replace RELEASE_SUMMARY with a short paragraph that summarises the release. Start with the lead feature but also summarise what else is new in the release. You will agree which will be the lead feature with the reviewers so you can just leave a placeholder here until after the initial review. |
| 59 | +// // // // // // // // |
| 60 | + |
| 61 | +// // // // // // // // |
| 62 | +// Replace the following throughout the document: |
| 63 | +// Replace 26.0.0.2 with the version number of Open Liberty, eg: 22.0.0.2 |
| 64 | +// Replace 26001 with the version number of Open Liberty wihtout the periods, eg: 22002 |
| 65 | +// // // // // // // // |
| 66 | + |
| 67 | +In link:{url-about}[Open Liberty] 26.0.0.2: |
| 68 | + |
| 69 | +* <<java_toolchains, Java Toolchains in Liberty Build Plugins>> |
| 70 | +* <<bugs, Notable bug fixes>> |
| 71 | + |
| 72 | +View the list of fixed bugs in link:https://github.com/OpenLiberty/open-liberty/issues?q=label%3Arelease%3A26002+label%3A%22release+bug%22[26.0.0.2]. |
| 73 | + |
| 74 | +Check out link:{url-prefix}/blog/?search=release&search!=beta[previous Open Liberty GA release blog posts]. |
| 75 | + |
| 76 | + |
| 77 | +[#run] |
| 78 | + |
| 79 | +// // // // // // // // |
| 80 | +// LINKS |
| 81 | +// |
| 82 | +// OpenLiberty.io site links: |
| 83 | +// link:{url-prefix}/guides/maven-intro.html[Maven] |
| 84 | +// |
| 85 | +// Off-site links: |
| 86 | +//link:https://openapi-generator.tech/docs/installation#jar[Download Instructions] |
| 87 | +// |
| 88 | +// IMAGES |
| 89 | +// |
| 90 | +// Place images in ./img/blog/ |
| 91 | +// Use the syntax: |
| 92 | +// image::/img/blog/log4j-rhocp-diagrams/current-problem.png[Logging problem diagram,width=70%,align="center"] |
| 93 | +// // // // // // // // |
| 94 | + |
| 95 | +== Develop and run your apps using 26.0.0.2 |
| 96 | + |
| 97 | +If you're using link:{url-prefix}/guides/maven-intro.html[Maven], include the following in your `pom.xml` file: |
| 98 | + |
| 99 | +[source,xml] |
| 100 | +---- |
| 101 | +<plugin> |
| 102 | + <groupId>io.openliberty.tools</groupId> |
| 103 | + <artifactId>liberty-maven-plugin</artifactId> |
| 104 | + <version>3.12.0</version> |
| 105 | +</plugin> |
| 106 | +---- |
| 107 | + |
| 108 | +Or for link:{url-prefix}/guides/gradle-intro.html[Gradle], include the following in your `build.gradle` file: |
| 109 | + |
| 110 | +[source,gradle] |
| 111 | +---- |
| 112 | +buildscript { |
| 113 | + repositories { |
| 114 | + mavenCentral() |
| 115 | + } |
| 116 | + dependencies { |
| 117 | + classpath 'io.openliberty.tools:liberty-gradle-plugin:3.10.0' |
| 118 | + } |
| 119 | +} |
| 120 | +apply plugin: 'liberty' |
| 121 | +---- |
| 122 | +// // // // // // // // |
| 123 | +// In the preceding section: |
| 124 | +// Replace the Maven `3.11.5` with the latest version of the plugin: https://search.maven.org/artifact/io.openliberty.tools/liberty-maven-plugin |
| 125 | +// Replace the Gradle `3.9.5` with the latest version of the plugin: https://search.maven.org/artifact/io.openliberty.tools/liberty-gradle-plugin |
| 126 | +// TODO: Update GHA to automatically do the above. If the maven.org is problematic, then could fallback to using the GH Releases for the plugins |
| 127 | +// // // // // // // // |
| 128 | + |
| 129 | +Or if you're using link:{url-prefix}/docs/latest/container-images.html[container images]: |
| 130 | + |
| 131 | +[source] |
| 132 | +---- |
| 133 | +FROM icr.io/appcafe/open-liberty |
| 134 | +---- |
| 135 | + |
| 136 | +Or take a look at our link:{url-prefix}/start/[Downloads page]. |
| 137 | + |
| 138 | +If you're using link:https://plugins.jetbrains.com/plugin/14856-liberty-tools[IntelliJ IDEA], link:https://marketplace.visualstudio.com/items?itemName=Open-Liberty.liberty-dev-vscode-ext[Visual Studio Code] or link:https://marketplace.eclipse.org/content/liberty-tools[Eclipse IDE], you can also take advantage of our open source link:https://openliberty.io/docs/latest/develop-liberty-tools.html[Liberty developer tools] to enable effective development, testing, debugging and application management all from within your IDE. |
| 139 | + |
| 140 | +[link=https://stackoverflow.com/tags/open-liberty] |
| 141 | +image::img/blog/blog_btn_stack.svg[Ask a question on Stack Overflow, align="center"] |
| 142 | + |
| 143 | +// // // // DO NOT MODIFY THIS COMMENT BLOCK <GHA-BLOG-TOPIC> // // // // |
| 144 | +// Blog issue: https://github.com/OpenLiberty/open-liberty/issues/34101 |
| 145 | +// Contact/Reviewer: venmanyarun |
| 146 | +// // // // // // // // |
| 147 | +[#java_toolchains] |
| 148 | +== Java Toolchains in Liberty Build Plugins |
| 149 | + |
| 150 | +In the latest release of the Liberty build plugins, support has been added for Java Toolchains. This enhancement enables developers to decouple the JDK used to run their build tools(Maven or Gradle) from the JDK used to run the Liberty server and their applications. This provides greater flexibility and environmental consistency. |
| 151 | + |
| 152 | +=== Java Toolchains support |
| 153 | + |
| 154 | +The Liberty build plugins now support the standard Java Toolchain mechanism. |
| 155 | +Previously, Liberty plugins were restricted to using the same Java version that was running Maven or Gradle. |
| 156 | +This prevented developers from using more recent JDK versions for their build process if their applications required a specific older JDK version. |
| 157 | + |
| 158 | +With Java Toolchains, you can now run your build tool on a modern JDK (for example, Java 25). At the same time, Liberty server and all server operations can execute using a different, configured JDK (for example, Java 8). |
| 159 | + |
| 160 | +=== Maven Plugin integration |
| 161 | + |
| 162 | +The Liberty Maven plugin now integrates seamlessly with the maven-toolchain-plugin. To use this feature, define your available JDKs in your `~/.m2/toolchains.xml` file. The plugin automatically detects and uses the toolchain that is specified in your project's `pom.xml` file. |
| 163 | +The Liberty Maven Plugin now integrates seamlessly with the maven-toolchain-plugin as of version 3.12.0. |
| 164 | +To use this feature, define your available JDKs in your `~/.m2/toolchains.xml` file and then configure `<jdkToolchain>` tag in `<configuration>`. |
| 165 | + |
| 166 | +The plugin automatically detects and uses the toolchain specified in your project’s `pom.xml` file. |
| 167 | +For detailed configuration steps and parameters, see the link:https://github.com/OpenLiberty/ci.maven/blob/main/docs/toolchain.md[Liberty Maven Plugin Toolchain documentation]. |
| 168 | + |
| 169 | +The plugin acknowledges the JDK vendor and version constraints that are defined in your Maven profiles, helping to ensure that your server environment remains consistent across different developer machines and CI/CD pipelines. |
| 170 | + |
| 171 | +=== Gradle Plugin integration |
| 172 | + |
| 173 | +The Liberty Gradle plugin now recognizes the native `java { toolchain { ... } }` configuration block as of version 3.10.0. This configuration provides a unified way to manage Java versions across multi-project builds, where different services might have different runtime requirements. |
| 174 | + |
| 175 | +For detailed configuration steps and parameters, see the link:https://github.com/OpenLiberty/ci.gradle/blob/main/docs/toolchain.md[Liberty Gradle Plugin Toolchain documentation]. |
| 176 | + |
| 177 | +When a toolchain is configured in your `build.gradle`, the Liberty plugin uses that specific Java runtime for all server-related tasks(for example, `libertyDev` and `libertyStart`). |
| 178 | + |
| 179 | +=== Try it now |
| 180 | + |
| 181 | +To start using Java Toolchains, update your build tools to the latest versions of the Liberty Maven or Gradle plugins. |
| 182 | + |
| 183 | +*For Maven:* |
| 184 | + |
| 185 | +[source,xml] |
| 186 | +---- |
| 187 | +<plugin> |
| 188 | + <groupId>io.openliberty.tools</groupId> |
| 189 | + <artifactId>liberty-maven-plugin</artifactId> |
| 190 | + <version>3.12.0</version> |
| 191 | + <configuration> |
| 192 | + <jdkToolchain> |
| 193 | + <version>11</version> |
| 194 | + <!-- Optional: include vendor if you need to distinguish between toolchains --> |
| 195 | + <!-- <vendor>ibm</vendor> --> |
| 196 | + </jdkToolchain> |
| 197 | + </configuration> |
| 198 | +</plugin> |
| 199 | +---- |
| 200 | + |
| 201 | +*For Gradle:* |
| 202 | + |
| 203 | +[source,gradle] |
| 204 | +---- |
| 205 | +buildscript { |
| 206 | + repositories { |
| 207 | + mavenCentral() |
| 208 | + } |
| 209 | + dependencies { |
| 210 | + classpath 'io.openliberty.tools:liberty-gradle-plugin:3.10.0' |
| 211 | + } |
| 212 | +} |
| 213 | +apply plugin: 'liberty' |
| 214 | +
|
| 215 | +
|
| 216 | +java { |
| 217 | + toolchain { |
| 218 | + languageVersion = JavaLanguageVersion.of(17) |
| 219 | + // Optional: specify vendor |
| 220 | + // vendor = JvmVendorSpec.ADOPTIUM |
| 221 | + } |
| 222 | +} |
| 223 | +---- |
| 224 | + |
| 225 | +// DO NOT MODIFY THIS LINE. </GHA-BLOG-TOPIC> |
| 226 | + |
| 227 | +[#bugs] |
| 228 | +== Notable bugs fixed in this release |
| 229 | + |
| 230 | + |
| 231 | +We’ve spent some time fixing bugs. The following sections describe the issues resolved in this release. If you’re interested, here’s the link:https://github.com/OpenLiberty/open-liberty/issues?q=label%3Arelease%3A26002+label%3A%22release+bug%22[full list of bugs fixed in 26.0.0.2]. |
| 232 | + |
| 233 | +* link:https://github.com/OpenLiberty/open-liberty/issues/33927[IBM WebSphere Application Server Liberty is affected by a remote code execution vulnerability (CVE-2025-14914 CVSS 7.6)] |
| 234 | +* link:https://github.com/OpenLiberty/open-liberty/issues/32996["WARNING: package sun.security.action not in java.base" shows up in console.log starting in Java 24] |
| 235 | + |
| 236 | +// // // // // // // // |
| 237 | +// In the preceding section: |
| 238 | +// For this section ask either Michal Broz or Tom Evans or the #openliberty-release-blog channel for Notable bug fixes in this release. |
| 239 | +// Present them as a list in the order as provided, linking to the issue and providing a short description of the bug and the resolution. |
| 240 | +// If the issue on Github is missing any information, leave a comment in the issue along the lines of: |
| 241 | +// "@[issue_owner(s)] please update the description of this `release bug` using the [bug report template](https://github.com/OpenLiberty/open-liberty/issues/new?assignees=&labels=release+bug&template=bug_report.md&title=)" |
| 242 | +// Feel free to message the owner(s) directly as well, especially if no action has been taken by them. |
| 243 | +// For inspiration about how to write this section look at previous blogs e.g- 20.0.0.10 or 21.0.0.12 (https://openliberty.io/blog/2021/11/26/jakarta-ee-9.1.html#bugs) |
| 244 | +// // // // // // // // |
| 245 | + |
| 246 | +== Get Open Liberty 26.0.0.2 now |
| 247 | + |
| 248 | +Available through <<run,Maven, Gradle, Docker, and as a downloadable archive>>. |
0 commit comments