Maven Source Plugin: Difference between revisions

From NovaOrdis Knowledge Base
Jump to navigation Jump to search
 
(4 intermediate revisions by the same user not shown)
Line 15: 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 32: Line 33:


<blockquote style="background-color: Gold; border: solid thin Goldenrod;">
<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.<br><br>
:<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>
</blockquote>


Line 40: Line 41:
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