Maven Source Plugin: Difference between revisions

From NovaOrdis Knowledge Base
Jump to navigation Jump to search
No edit summary
 
(10 intermediate revisions by the same user not shown)
Line 1: Line 1:
=External=
* https://maven.apache.org/plugins/maven-source-plugin/
=Internal=
=Internal=


Line 11: Line 15:
                 <groupId>org.apache.maven.plugins</groupId>
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-source-plugin</artifactId>
                 <artifactId>maven-source-plugin</artifactId>
                <version>${maven.source.version}</version>
                 <executions>
                 <executions>
                     <execution>
                     <execution>
Line 24: Line 29:
</build>
</build>
</pre>
</pre>


If the "maven-source-plugin" is active, maven install will also install the source jar.
If the "maven-source-plugin" is active, maven install will also install the source jar.


!!!Installing the source artifact in the repository post factum
<blockquote style="background-color: Gold; border: solid thin Goldenrod;">
:<br>'''Important''' Place the plugin in <tt><plugins></tt>, not in <tt><pluginManagement><plugins>...</plugins></pluginManagement></tt>, otherwise it will silently fail. For a project hierarchy, place the plugin at each level of the hierarchy where you want to publish sources.<br><br>
</blockquote>


=Installing the source artifact in the repository post factum=


<pre>
<pre>
mvn install:install-file -DgroupId=my.group -DartifactId=my-file -Dversion=1.0 \
mvn install:install-file -DgroupId=my.group -DartifactId=my-file -Dversion=1.0 \
   -Dpackaging=jar -Dclassifier=source -Dfile=./my-file-src.jar
   -Dpackaging=jar -Dclassifier=source -Dfile=./my-file-src.jar
</pre>
=Running from Command Line=
<pre>
mvn source:jar
</pre>
</pre>

Latest revision as of 00:00, 27 February 2020

External

Internal

Generating the source jar

<build>
     <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-source-plugin</artifactId>
                <version>${maven.source.version}</version>
                <executions>
                    <execution>
                        <id>attach-sources</id>
                        <phase>package</phase>
                        <goals>
                            <goal>jar</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
     </plugins>
</build>

If the "maven-source-plugin" is active, maven install will also install the source jar.


Important Place the plugin in <plugins>, not in <pluginManagement><plugins>...</plugins></pluginManagement>, otherwise it will silently fail. For a project hierarchy, place the plugin at each level of the hierarchy where you want to publish sources.

Installing the source artifact in the repository post factum

mvn install:install-file -DgroupId=my.group -DartifactId=my-file -Dversion=1.0 \
  -Dpackaging=jar -Dclassifier=source -Dfile=./my-file-src.jar

Running from Command Line

mvn source:jar