Responder al comentario

Cuando gestionamos nuestros proyectos de software con Maven tenemos la posibilidad de instalar en el repositorio no sólo la distribución binaria

mvn install

También podemos configurar el POM para instalar los fuentes y los javadocs del proyecto.

Configuración para agregar los fuentes

...
  <build>
    <plugins>
      <plugin>
      	<groupId>org.apache.maven.plugins</groupId>
      	<artifactId>maven-source-plugin</artifactId>
      	<version>2.1.2</version>
        <executions>
          <execution>
            <id>pack-sources</id>
            <phase>verify</phase>
            <goals>
              <goal>jar</goal>
            </goals>
          </execution>
        </executions>
      </plugin>
    </plugins>
  </build>
...

Configuración para agregar los javadocs

...
  <build>
    <plugins>
      <plugin>
      	<groupId>org.apache.maven.plugins</groupId>
      	<artifactId>maven-javadoc-plugin</artifactId>
      	<version>2.1.2</version>
        <executions>
          <execution>
            <id>pack-javadocs</id>
            <phase>verify</phase>
            <goals>
              <goal>jar</goal>
            </goals>
          </execution>
        </executions>
      </plugin>
    </plugins>
  </build>
...

Con esta configuración la próxima vez que instalemos nuestro proyecto, se creara un jar con todos los fuentes y un jar con los javadocs. Un punto importante a tomar en cuenta es el incremento de tiempo que lleva implícito el agregar estas tareas en el proceso de construcción, especialmente en el caso de javadocs. Una buena alternativa es generar perfiles específicos.

Configuración para agregar fuentes por perfil

...
<profiles>
  <profile>
    <id>install-sources</id>
    <build>
      <plugins>
        <plugin>
        	<groupId>org.apache.maven.plugins</groupId>
        	<artifactId>maven-source-plugin</artifactId>
        	<version>2.1.2</version>
          <executions>
            <execution>
              <id>pack-sources</id>
              <phase>verify</phase>
              <goals>
                <goal>jar</goal>
              </goals>
            </execution>
          </executions>
        </plugin>
      </plugins>
    </build>
  </profile>
</profiles>
...

Activamos el perfil de la siguiente manera.

mvn package -P install-sources

Configuración para agregar javadocs por perfil

...
<profiles>
  <profile>
    <id>install-javadocs</id>
    <build>
      <plugins>
        <plugin>
        	<groupId>org.apache.maven.plugins</groupId>
        	<artifactId>maven-javadoc-plugin</artifactId>
        	<version>2.1.2</version>
          <executions>
            <execution>
              <id>pack-javadocs</id>
              <phase>verify</phase>
              <goals>
                <goal>jar</goal>
              </goals>
            </execution>
          </executions>
        </plugin>
      </plugins>
    </build>
  </profile>
</profiles>
...

Activamos el perfil de la siguiente manera.

mvn package -P install-javadocs