Java Maven程序集:捆绑文档和源JAR

Java Maven程序集:捆绑文档和源JAR,java,maven,Java,Maven,我有一个多模块maven项目。每个库模块生成自己的jar输出: Parent (Pom) | Library_01 (jar) | output: | | | lib1.jar | | | lib1-docs.jar | | | lib1-sources.jar | Library_02 (jar) | output: | | | lib2.

我有一个多模块maven项目。每个库模块生成自己的jar输出:

Parent (Pom)
   |
   Library_01 (jar)
   |   output:
   |     |
   |     lib1.jar
   |     |
   |     lib1-docs.jar
   |     |
   |     lib1-sources.jar
   |
   Library_02 (jar)
   |   output:
   |     |
   |     lib2.jar
   |     |
   |     lib2-docs.jar
   |     |
   |     lib2-sources.jar
   |
   Distribution (pom) // uses assembly plug-in to assemble outputs of other modules here
       output:
         |
         lib1.jar
         |
         lib2.jar
我正在分发模块中组装其他模块的二进制文件,正如
maven汇编插件
中所解释的那样。我的POM的外观与教程中的完全相同

它的工作方式如文档所示。在包阶段,组装插件在分发模块中收集其他模块的JAR。但正如您所看到的,其他库模块也被配置为生成文档和源jar

  • 如何配置assembly插件来收集其他模块的文档和源JAR

  • 考虑到分发,上述设置似乎不合适。我最终还是得到了一堆不同库的jar。所有其他模块的类、源和文档是否都可以组合成一个jar文件?。基本上,我希望分发3个全局JAR(二进制、文档和源代码)。如何做到这一点

  • 比如:


    我不是专家,但我在多模块项目中也做过类似的事情。 这是家长的pom部分,其中指定插件和文档:

    <pluginManagement>
            <plugins>
                <plugin>
                    <groupId>org.apache.maven.plugins</groupId>
                    <artifactId>maven-source-plugin</artifactId>
                    <inherited>true</inherited>
                    <executions>
                        <execution>
                            <id>attach-sources</id>
                            <phase>verify</phase>
                            <goals>
                                <goal>jar</goal>
                                <goal>test-jar</goal>
                            </goals>
                        </execution>
                    </executions>
                </plugin>
                <plugin>
                    <groupId>org.apache.maven.plugins</groupId>
                    <artifactId>maven-surefire-plugin</artifactId>
                    <inherited>true</inherited>
                    <configuration>
                        <properties>
                            <property>
                                <name>outputDirectory</name>
                                <value>${project.build.outputDirectory}</value>
                            </property>
                        </properties>
                        <systemProperties>
                            <property>
                                <name>user.language</name>
                                <value>ca</value>
                            </property>
                            <property>
                                <name>user.country</name>
                                <value>ES</value>
                            </property>
                        </systemProperties>
                    </configuration>
                </plugin>
                <plugin>
                    <groupId>org.apache.maven.plugins</groupId>
                    <artifactId>maven-site-plugin</artifactId>
                    <version>3.0</version>
                    <inherited>false</inherited>
                </plugin>
                <plugin>
                    <groupId>org.apache.maven.plugins</groupId>
                    <artifactId>maven-compiler-plugin</artifactId>
                    <inherited>true</inherited>
                    <configuration>
                        <executable>javac</executable>
                        <source>1.6</source>
                        <target>1.6</target>
                        <encoding>ISO-8859-15</encoding>
                    </configuration>
                </plugin>
                <plugin>
                    <groupId>org.apache.maven.plugins</groupId>
                    <artifactId>maven-javadoc-plugin</artifactId>
                    <version>2.8</version>
                    <inherited>true</inherited>
                    <configuration>
                        <detectLinks>true</detectLinks>
                    </configuration>
                    <executions>
                        <execution>
                            <id>aggregate</id>
                            <goals>
                                <goal>aggregate</goal>
                            </goals>
                            <phase>site</phase>
                        </execution>
                    </executions>
                </plugin>
                <plugin>
                    <groupId>org.apache.maven.plugins</groupId>
                    <artifactId>maven-resources-plugin</artifactId>
                    <inherited>true</inherited>
                    <configuration>
                        <encoding>ISO-8859-15</encoding>
                    </configuration>
                </plugin>
                <plugin>
                    <groupId>org.apache.maven.plugins</groupId>
                    <artifactId>maven-ejb-plugin</artifactId>
                    <version>2.2.1</version>
                    <inherited>true</inherited>
                    <configuration>
                        <ejbVersion>3.0</ejbVersion>
                        <archive>
                            <addMavenDescriptor>false</addMavenDescriptor>
                            <manifest>
                                <addClasspath>true</addClasspath>
                                <useUniqueVersions>false</useUniqueVersions>
                            </manifest>
                        </archive>
                        <generateClient>false</generateClient>
                    </configuration>
                </plugin>
                <plugin>
                    <groupId>org.apache.maven.plugins</groupId>
                    <artifactId>maven-jar-plugin</artifactId>
                    <inherited>true</inherited>
                    <configuration>
                        <archive>
                            <addMavenDescriptor>false</addMavenDescriptor>
                        </archive>
                    </configuration>
                    <executions>
                        <execution>
                            <goals>
                                <goal>test-jar</goal>
                            </goals>
                        </execution>
                    </executions>
                </plugin>
            </plugins>
        </pluginManagement>
        <extensions>
            <extension>
                <groupId>org.apache.maven.wagon</groupId>
                <artifactId>wagon-ssh</artifactId>
                <version>2.0</version>
            </extension>
        </extensions>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-javadoc-plugin</artifactId>
                <!-- <configuration> <links> <link>http://download.oracle.com/javase/6/docs/api/</link> 
                    <link>http://download.oracle.com/javaee/1.4/api/</link> <link>http://static.springsource.org/spring/docs/2.5.x/api/</link> 
                    <link>http://docs.jboss.org/hibernate/core/3.2/api/</link> <link>http://www.easymock.org/api/easymock/2.5.2/</link> 
                    <link>http://testng.org/javadocs/</link> <link>http://www.bouncycastle.org/docs/docs1.6/</link> 
                    <link>http://www.bouncycastle.org/docs/mdocs1.6/</link> <link>http://www.bouncycastle.org/docs/pgdocs1.6/</link> 
                    <link>http://www.bouncycastle.org/docs/tspdocs1.6/</link> </links> </configuration> -->
                <executions>
                    <execution>
                        <id>agregar</id>
                        <goals>
                            <goal>aggregate</goal>
                        </goals>
                        <phase>pre-site</phase>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>
    <reporting>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-project-info-reports-plugin</artifactId>
                <version>2.1.1</version>
            </plugin>
        </plugins>
    </reporting>
    
    
    org.apache.maven.plugins
    maven源插件
    真的
    附加来源
    验证
    罐子
    试验罐
    org.apache.maven.plugins
    maven surefire插件
    真的
    输出目录
    ${project.build.outputDirectory}
    用户语言
    ca
    用户国家
    锿
    org.apache.maven.plugins
    maven站点插件
    3
    假的
    org.apache.maven.plugins
    maven编译器插件
    真的
    爪哇语
    1.6
    1.6
    ISO-8859-15
    org.apache.maven.plugins
    maven javadoc插件
    2.8
    真的
    真的
    总数的
    总数的
    网站
    org.apache.maven.plugins
    maven资源插件
    真的
    ISO-8859-15
    org.apache.maven.plugins
    maven ejb插件
    2.2.1
    真的
    3
    假的
    真的
    假的
    假的
    org.apache.maven.plugins
    maven jar插件
    真的
    假的
    试验罐
    org.apache.maven.wagen
    马车ssh
    2
    org.apache.maven.plugins
    maven javadoc插件
    阿格雷戈
    总数的
    现场前
    org.apache.maven.plugins
    maven项目信息报告插件
    2.1.1
    
    好的,我已经完成了以下选项:

  • :构建组合二进制文件,也可能是源文件,但没有Javadoc。而且非常复杂
  • :构建组合二进制文件和源代码非常容易,但没有Javadoc。而且,源文件名很难控制
  • 因此,我采取的简单方法如下:

    确保所有模块都生成源jar。这可以通过在父pom中启用源插件来实现,该插件由所有模块继承:

    <build>
        <plugins>
            <plugin>
                <inherited>true</inherited>
                <artifactId>maven-source-plugin</artifactId>
                <executions>
                    <execution>
                        <id>attach-sources</id>
                        <goals>
                            <goal>jar</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>
    

    现在,构建模块像任何其他项目一样编译,生成所有必需的JAR。

    您定义了两次javadoc插件吗?
    <build>
        <plugins>
            <plugin>
                <inherited>true</inherited>
                <artifactId>maven-source-plugin</artifactId>
                <executions>
                    <execution>
                        <id>attach-sources</id>
                        <goals>
                            <goal>jar</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>
    
    <?xml version="1.0" encoding="UTF-8"?>
    <project xmlns="http://maven.apache.org/POM/4.0.0"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
        <modelVersion>4.0.0</modelVersion>
    
        <parent>
            <artifactId>parent</artifactId>
            <groupId>com.example.product</groupId>
            <version>1.0-SNAPSHOT</version>
        </parent>
    
        <artifactId>build</artifactId>
        <packaging>jar</packaging>
        <name>Build</name>
    
        <properties>
            <!--add comma separated artifact names from dependencies, to be included in unpacking-->
            <project.build.unpack_includes>sub-product</project.build.unpack_includes>
        </properties>
    
        <dependencies>
            <dependency>
                <groupId>${project.groupId}</groupId>
                <artifactId>sub-product</artifactId>
                <version>${project.version}</version>
            </dependency>
        </dependencies>
    
        <build>
            <finalName>${parent.artifactId}</finalName>
            <plugins>
                <plugin>
                    <artifactId>maven-dependency-plugin</artifactId>
                    <executions>
                        <execution>
                            <id>unpack-sources</id>
                            <phase>generate-sources</phase>
                            <goals>
                                <goal>unpack-dependencies</goal>
                            </goals>
                        </execution>
                    </executions>
                    <configuration>
                        <classifier>sources</classifier>
                        <type>jar</type>
                        <outputDirectory>${project.build.sourceDirectory}</outputDirectory>
                        <includeArtifactIds>${project.build.unpack_includes}</includeArtifactIds>
                        <includes>**\/*.java</includes>
                        <overWriteSnapshots>true</overWriteSnapshots>
                    </configuration>
                </plugin>
                <plugin>
                    <artifactId>maven-javadoc-plugin</artifactId>
                    <executions>
                        <execution>
                            <id>attach-javadocs</id>
                            <goals>
                                <goal>jar</goal>
                            </goals>
                        </execution>
                    </executions>
                </plugin>
            </plugins>
        </build>
    
    </project>