Wiki source code of Java Support Strategy
Last modified by Thomas Mortagne on 2026/01/20 13:53
Hide last authors
| author | version | line-number | content |
|---|---|---|---|
 |
8.2 | 1 | {{box cssClass="floatinginfobox" title="**Contents**"}} |
| 2 | {{toc/}} | ||
| 3 | {{/box}} | ||
| 4 | |||
 |
20.2 | 5 | There are lots of Java versions out there and supporting all of them is just too hard to be done in a quality manner. Thus, we only support a subset. |
| |
1.1 | 6 | |
| 7 | By "supported versions" we mean: | ||
| 8 | |||
| |
3.1 | 9 | * XWiki runs fine on that Java version. |
| |
1.1 | 10 | * Issues created for these versions of Java in JIRA are not closed as won't fix and we make a best effort to fix them. |
| 11 | * We include these versions in our tests (be them automated or manual). | ||
| 12 | |||
| 13 | = Supported Java Versions = | ||
| 14 | |||
 |
21.1 | 15 | == By XWiki Versions == |
| 16 | |||
| |
22.1 | 17 | Terminology: |
| 18 | |||
| 19 | * "source level": This is the Java syntax used in the source of XWiki. From a user point of view, this can be considered as the minimal Java version that can be used to run XWiki. | ||
| 20 | |||
| |
21.1 | 21 | |=XWiki Versions|=Java Version supported|=Source Level |
| 22 | |XWiki < 6.0|Java 6|Java 6 | ||
| 23 | |XWiki < 8.1|Java 7|Java 7 | ||
| 24 | |XWiki < 11.3|Java 8|Java 8 | ||
| |
31.1 | 25 | |XWiki >= 11.3|Java 8 and 11|Java 8 |
| |
21.1 | 26 | |XWiki >= 14.0 & < 15.3|Java 11|Java 11 |
| |
30.1 | 27 | |XWiki >= 14.10.9/15.3|Java 11 and 17|Java 11 |
| 28 | |XWiki >= 16.0.0|Java 17 and 21|Java 17 | ||
| |
34.1 | 29 | |XWiki >= 17.10.1|Java 17 and 21|Java 17 |
| 30 | |XWiki >= 17.10.3|Java 17, 21 and 25|Java 17 | ||
| |
30.1 | 31 | |XWiki >= 18.0.0|Java 21 and 25|Java 21 |
| |
21.1 | 32 | |
| |
14.1 | 33 | {{info}} |
| 34 | Since Java 17+, you need to have the following Java switches to run XWiki: | ||
| 35 | |||
| |
12.1 | 36 | {{code language="none"}} |
| |
12.2 | 37 | --add-opens java.base/java.lang=ALL-UNNAMED --add-opens java.base/java.io=ALL-UNNAMED --add-opens java.base/java.util=ALL-UNNAMED --add-opens java.base/java.util.concurrent=ALL-UNNAMED |
| |
12.1 | 38 | {{/code}} |
| |
14.1 | 39 | {{/info}} |
| |
12.1 | 40 | |
| |
14.1 | 41 | {{error}} |
| |
33.1 | 42 | List of issues related to Java support: |
| |
12.1 | 43 | |
| |
29.2 | 44 | {{jira id="xwikiorg" source="jql" fields="priority, type, status, key, summary"}} |
| |
32.1 | 45 | labels = java and resolution = Unresolved ORDER BY priority |
| |
6.1 | 46 | {{/jira}} |
| |
14.2 | 47 | {{/error}} |
| |
1.1 | 48 | |
| |
23.1 | 49 | == Rules == |
| |
2.1 | 50 | |
| |
23.1 | 51 | * As a general rule we follow the Java LTS release cadence (currently every 2 years), which means that at the beginning of every 2 XWiki cycles, we drop the oldest Java version that we were supporting and start supporting the latest Java LTS (and at the source level we upgrade it by one version too). Examples: |
| 52 | ** In XWiki 16.0 (2024), we drop the support of Java 11, continue to support Java 17 (which becomes the new source level), and work as fast as possible to support Java 21 in 16.x. We continue to support Java 11 & 17 for XWiki 15.10.x (XWiki LTS). | ||
| 53 | ** In XWiki 17.0 (2025), we continue to support Java 17 & 21. We also continue to support Java 17 & 21 for XWiki 16.10.x (XWiki LTS). | ||
| 54 | ** Java 25 is out in September 2025 | ||
| 55 | ** In XWiki 18.0 (2026), we drop support for Java 17, continue to support Java 21 (which becomes the new source level), and add support for Java 25 as soon as possible for 18.x. We continue to support Java 17 & 21 for XWiki 17.10.x (XWiki LTS). | ||
| 56 | * As a best effort, we also try to support more recent Java versions whenever we can. | ||
| 57 | ** For example, in XWiki 14.10.x we added support for Java 17 | ||
| |
2.1 | 58 | |
| |
20.2 | 59 | = Things to do when increasing the minimum supported Java version in the current branch = |
| |
19.1 | 60 | |
| 61 | * add a row to [[the table above>>||anchor="HByXWikiVersions"]] | ||
| 62 | * update ##<xwiki.java.version>## Maven property in [[xwiki-commons root pom>>https://github.com/xwiki/xwiki-commons/]] | ||
| |
24.1 | 63 | * install the new Java version on [[the release agent>>https://github.com/xwiki/xwiki-docker-build/blob/master/build/Dockerfile]] (and also check the version of the jenkins image while you are at it) |
| |
19.1 | 64 | * update the automatic switch mapping in the [[release script>>https://github.com/xwiki/xwiki-dev-tools/blob/master/xwiki-release-scripts/maven-release.sh]] |
| 65 | * update the automatic java version switch mapping in the [[Jenkins pipeline>>https://github.com/xwiki/xwiki-jenkins-pipeline/blob/master/vars/configureJavaTool.groovy]] |
