From ad2f78ccdb6bfe9dc330fad54fd4b966b57948db Mon Sep 17 00:00:00 2001 From: Markus Ofterdinger Date: Fri, 3 Jul 2026 09:20:27 +0200 Subject: [PATCH 1/3] Update migration.md --- java/migration.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/java/migration.md b/java/migration.md index 72b3dbfe1..7fc83e6f4 100644 --- a/java/migration.md +++ b/java/migration.md @@ -184,6 +184,10 @@ If your project uses Lombok, you must explicitly add its annotation processor to [Learn more about Maven setup with Lombok.](https://projectlombok.org/setup/maven){.learn-more} [Learn more about the change in the Java compiler.](https://bugs.java.com/bugdatabase/JDK-8321314/description){.learn-more} +::: warning +The `cds-services-archetype` and therefore also `cds init --java` is not working with JDK 26, because of an incompatibility of the generic `maven-archetype-plugin`. For project creation use JDK 21 or 25 to avoid creation issues. +::: + ### Removed Repackaged Olingo Dependencies { #removed-olingo-4-to-5 } The internal Maven modules `repackaged/odata-v4-lib` and `repackaged/odata-v2-lib` have been removed. If your project directly references these modules and does not compile after migrating to CAP Java 5.x, you have three options to maintain compatibility: From e5350a2f9bf1581502097daa151e9d8e2c0272ce Mon Sep 17 00:00:00 2001 From: Markus Ofterdinger Date: Fri, 3 Jul 2026 09:30:14 +0200 Subject: [PATCH 2/3] docs: Clarify JDK compatibility and Homebrew installation notes in migration guide --- java/migration.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/java/migration.md b/java/migration.md index 7fc83e6f4..2d676d743 100644 --- a/java/migration.md +++ b/java/migration.md @@ -185,7 +185,8 @@ If your project uses Lombok, you must explicitly add its annotation processor to [Learn more about the change in the Java compiler.](https://bugs.java.com/bugdatabase/JDK-8321314/description){.learn-more} ::: warning -The `cds-services-archetype` and therefore also `cds init --java` is not working with JDK 26, because of an incompatibility of the generic `maven-archetype-plugin`. For project creation use JDK 21 or 25 to avoid creation issues. +The `cds-services-archetype` and therefore also `cds init --java` is not working with JDK 26, because of an incompatibility of the generic `maven-archetype-plugin` with that Java version. For project creation use JDK 21 or 25 to avoid creation issues. +Using Homebrew on MacOS to install latest Maven version, will cause also the installation of a JDK 26. Ensure that the environment variable JAVA_HOME points to a JDK 21 or 25. ::: ### Removed Repackaged Olingo Dependencies { #removed-olingo-4-to-5 } From 6770cbf8cde68860da4f096c839ad5df0b6463dc Mon Sep 17 00:00:00 2001 From: Rene Jeglinsky Date: Fri, 3 Jul 2026 11:30:07 +0200 Subject: [PATCH 3/3] fix: use jdk 25 --- get-started/index.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/get-started/index.md b/get-started/index.md index 3ddb17f1c..75dc6c5f7 100644 --- a/get-started/index.md +++ b/get-started/index.md @@ -60,7 +60,8 @@ sqlite3 -version ::: code-group ```shell [macOS/Linux] -brew install sapmachine-jdk +brew tap sap/sapmachine +brew install sapmachine25-jdk brew install maven ``` ```PowerShell [Windows]