All Implemented Interfaces and Traits:

Plugin<Project>

@groovy.transform.CompileStatic
class BomPropertyOverridesPlugin
extends java.lang.Object
implements Plugin<Project>

Gradle plugin that enables Maven-style property-based version overrides for platform() BOMs.

This is the BOM-agnostic replacement for the Spring Dependency Management plugin's property-override feature. The plugin is shipped as part of grails-gradle-plugins but can be applied to any project (Grails or otherwise) that consumes a BOM published with version property references in its <dependencyManagement> block:

 plugins {
     id 'org.apache.grails.gradle.bom-property-overrides'
 }

 dependencies {
     implementation platform('com.example:my-bom:1.0.0')
 }

 // gradle.properties or build.gradle
 ext['slf4j.version'] = '2.0.13'
 

How it works

1. Auto-detects all platform() / enforcedPlatform() dependencies declared on the project's configurations (configurable via BomPropertyOverridesExtension.autoDetect).
2. Resolves each BOM POM in a detached configuration, parses the <properties> block and the <dependencyManagement> entries, and recursively follows <scope>import</scope> BOMs.
3. Computes each managed artifact's version twice - once with the BOM's default properties and once with the project's property overrides (from gradle.properties or ext['property.name']) applied, including to imported-BOM selector versions. Any artifact whose effective version differs from its default version is recorded as an override.
4. Applies each override as a strict dependency constraint on the project's declarable configurations, so the override wins over the require constraints contributed by platform() even when it downgrades a managed version.

The plugin does not declare any platforms itself. Consumers (or other plugins like grails-app) remain responsible for declaring the platform() dependencies; this plugin only adds the property-override layer on top.

Since:

8.0

See Also:

BomManagedVersions

BomPropertyOverridesExtension