Milestone/Milestone-20240222
Milestone
Milestone 2024-02-22
Early migration guide for the 0.6.0 SDK and 0.2.0 IntelliJ plugin compatibility break.
This guide matters only for projects that existed before the February 22, 2024 compatibility break.
This was an incompatible upgrade. Older SDK and IDE plugin versions were not compatible with the new line.
What Changed
This release introduced the early structural migration that later ApiHug releases built on.
Two important requirements were:
- move to the newer SDK / plugin line
- align the project with Spring Boot
3.2+
Upgrade Steps
Project Version
Update {PROJECT}/gradle/libs.versions.toml:
apihug = "0.6.0-RELEASE"
IntelliJ Plugin
Install or upgrade the ApiHug IntelliJ plugin to 0.2.0+.
Spring Compatibility
Check that the project uses Spring Boot 3.2+ and review any third-party library compatibility, especially Spring Cloud and data-access dependencies.
Proto Syntax Migration
Two early syntax shifts in this release were:
google.protobuf.BoolValuemoved towardhope.common.BoolTypeauthorization_structwas renamed torbac
Example bool migration:
empty: false;
Example authorization migration:
rbac: {
authorities: "PLATFORM_MEMBER_OPERATE";
combinator: OR;
predefined_role_checker: PLATFORM_MANAGER
}
Result
After this migration, the project is aligned with the newer SDK / plugin line and can continue following later milestone guides instead of staying on the pre-0.6 compatibility branch.