Skip to content

fix: lower Sonar Plugin API baseline to 11.1.0.2693 for broader compa…#20

Merged
SebastianDT1 merged 1 commit into
mainfrom
fix/sonar-plugin-api-compatibility
Jun 9, 2026
Merged

fix: lower Sonar Plugin API baseline to 11.1.0.2693 for broader compa…#20
SebastianDT1 merged 1 commit into
mainfrom
fix/sonar-plugin-api-compatibility

Conversation

@rafael-goterris

Copy link
Copy Markdown
Contributor

Pull request type

Please check the type of change your PR introduces:

  • Bugfix
  • Feature
  • Code style update (formatting, renaming)
  • Refactoring (no functional changes, no api changes)
  • Build related changes
  • Documentation content changes
  • Other (please describe):

What is the current behavior?

The plugin is compiled against Sonar Plugin API 13.5.0.4319, so the JAR manifest requires the SonarQube server to provide API >= 13.5. On servers running an older API, the plugin is rejected at startup:

Plugin AsyncAPI Custom [asyncapicustom] requires at least Sonar Plugin API version 13.5.0.4319 (current: 13.0.0.3026) ​

This prevents the plugin from loading on SonarQube Server 2025.1.x LTA (Plugin API 11.x), e.g. Enterprise Edition 2025.1.3.

Issue Number: N/A

What is the new behavior?

  • Lowers the Sonar Plugin API baseline from 13.5.0.4319 to 11.1.0.2693 (the 2025.1.0 LTA baseline), so the plugin loads on the whole 2025.1.x LTA line (Plugin API 11.x) and also on newer Community Builds (25.8/25.9, Plugin API 13.x) thanks to backward compatibility.
  • Aligns sonar-plugin-api-impl (test scope) to 25.2.0.102705, the Community Build that pairs with API 11.1, so the test harness matches the new baseline.
  • Bumps the version 2.0.02.0.1 across all modules and adds the CHANGELOG entry.

Other information

Verification performed:

  • mvn clean test → BUILD SUCCESS, all tests pass.
  • The generated JAR manifest reports Sonar-Version: 11.1.0.2693.
  • The code compiles against API 11.x (no APIs exclusive to 12.x/13.x are used). sonar-analyzer-commons (shaded) verified working on API 11.x in the tests.
  • Dependency tree with no version conflicts; sonar-plugin-api resolves uniquely to 11.1.0.2693.

Compatibility rule applied: plugin's required API ≤ API provided by the server. Building against the oldest API that still compiles maximizes compatibility without losing functionality (the plugin did not use anything newer than 11.1).

…tibility

The plugin was compiled against Sonar Plugin API 13.5.0.4319, so its
manifest required SonarQube to provide API >= 13.5. This prevented it
from loading on SonarQube Server 2025.1.x LTA (Plugin API 11.x), e.g.
Enterprise Edition 2025.1.3.

Lower the API baseline to 11.1.0.2693 (the 2025.1.0 LTA baseline) so the
plugin loads on the whole 2025.1.x LTA line as well as newer Community
Build releases (e.g. 25.9, Plugin API 13.x). Align the test-scoped
sonar-plugin-api-impl to 25.2.0.102705 to match. Bump version to 2.0.1.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@rafael-goterris rafael-goterris self-assigned this Jun 9, 2026
@sonarqubecloud

sonarqubecloud Bot commented Jun 9, 2026

Copy link
Copy Markdown

@SebastianDT1 SebastianDT1 merged commit 3ba11ed into main Jun 9, 2026
2 checks passed
@SebastianDT1 SebastianDT1 deleted the fix/sonar-plugin-api-compatibility branch June 9, 2026 18:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants