Skip to content

Add warning about cds-services-archetype and JDK 26 #2708

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
renejeglinsky merged 3 commits into from
Jul 3, 2026
Merged

Add warning about cds-services-archetype and JDK 26 #2708

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
ad2f78c
Update migration.md
mofterdinger Jul 3, 2026
e5350a2
docs: Clarify JDK compatibility and Homebrew installation notes in mi…
mofterdinger Jul 3, 2026
6770cbf
fix: use jdk 25
renejeglinsky Jul 3, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 2 additions & 1 deletion get-started/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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]
Expand Down
5 changes: 5 additions & 0 deletions java/migration.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -184,6 +184,11 @@ 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` 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.
Comment thread
renejeglinsky marked this conversation as resolved.
:::

### 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:
Expand Down
Loading