Using the CoreMedia Blueprint Maven Plugin

This section describes how to use the CoreMedia Blueprint Maven Plugin to apply the extension configuration to your project and how to manage extensions.

Update Extensions

Whenever extensions have been added or removed to/from the project or have been enabled/disabled, an update has to be performed by running the update goal. This goal updates the dependencies in the extension-config modules in order to stay conform with the currently enabled and disabled extensions. If an extension has been disabled the dependencies will be removed from the extension-config modules, if an extension has been enabled, it's dependencies will be added.

 mvn com.coremedia.maven:coremedia-blueprint-maven-plugin:update-extensions

Activate and Deactivate Extensions

As described in the Etension Concepts section an extension is activated by importing the Extension Descriptor of the extension (i.e. the BOM POM) in the project's root POM. When this import is removed, the extension is disabled.

 <dependency>
     <groupId>com.coremedia</groupId>
     <artifactId>A-bom</artifactId>
     <version>${project.version}</version>
     <type>pom</type>
     <scope>import</scope>
 </dependency>

This plugin supports this process by performing this step automatically. To disable an extension call

 mvn com.coremedia.maven:coremedia-blueprint-maven-plugin:disable-extensions -Dcoremedia.project.extensions=my-extension-descriptor-bom

The parameter coremedia.project.extensions describes the extensions to disable identified by the Maven coordinates of their extension descriptor, e.g. -Dcoremedia.project.extensions=com.coremedia.blueprint:es-bom:7.5.1. If groupId and version correspond to your project they can be skipped, e.g. -Dcoremedia.project.extensions=es-bom.

Remove Extensions

If you do not require a shipped extension in you project, it can be completely removed from the workspace my calling

 mvn com.coremedia.maven:coremedia-blueprint-maven-plugin:remove-extensions -Dcoremedia.project.extensions=<my-extension-descriptor-bom>