jcabi-assembly - Shared Assembly Descriptor for Java Sources

07-May-2013 0.7.19

Shared Assembly Descriptor for Java Sources

You need it when you want to package a multi-module Maven project for Maven Central:

<plugin>
  <artifactId>maven-assembly-plugin</artifactId>
  <dependencies>
    <dependency>
      <groupId>com.jcabi</groupId>
      <artifactId>jcabi-assembly</artifactId>
      <version>0.7.19</version>
    </dependency>
  </dependencies>
  <executions>
    <execution>
      <phase>package</phase>
      <goals>
        <goal>single</goal>
      </goals>
      <configuration>
        <descriptorRefs>
          <descriptorRef>jcabi-sources</descriptorRef>
        </descriptorRefs>
      </configuration>
    </execution>
  </executions>
</plugin>

This configuration will produce -sources.jar file in every submodule of your multi-module project. This technique is called shared assembly descriptor. This jcabi-assembly module helps you to avoid creating a custom supplementary module.

For example, this module is used in com.jcabi:parent for sources packaging for Maven Central.