【问题标题】:maven 3 javadoc plugin ignores configurationmaven 3 javadoc插件忽略配置
【发布时间】:2012-01-13 13:44:54
【问题描述】:

我使用 maven 3 并根据新的 maven 3 siteplugin+javadoc 配置配置我的 javadoc。然而,我所有的 javadoc 配置参数似乎都被忽略了。所以没有包分组,没有源链接等。

我的项目是多模块项目,我使用的命令是:mvn3 clean package javadoc:aggregate

这是我的根 pom 的相关部分。:

<build>
    <!-- Memory management properties for jenkins build. -->
    <pluginManagement>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-surefire-plugin</artifactId>
                <version>2.11</version>
                <configuration>
                    <argLine>-Xmn8m -Xms32m -Xmx96m -XX:PermSize=32m
                        -XX:MaxPermSize=128m</argLine>
                </configuration>
            </plugin>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-site-plugin</artifactId>
                <version>3.0-beta-3</version>
                <configuration>
                    <reportPlugins>
                        <plugin>
                            <groupId>org.apache.maven.plugins</groupId>
                            <artifactId>maven-javadoc-plugin</artifactId>
                            <version>2.8</version>
                            <configuration>
                                <verbose>true</verbose>
                                <groups>
                                    <group>
                                        <title>Hypercube</title>
                                        <packages>org.hypercube*</packages>
                                    </group>
                                    <group>
                                        <title>Hyperdrive</title>
                                        <packages>org.hyperdrive*</packages>
                                    </group>
                                    <group>
                                        <title>Hydrogen</title>
                                        <packages>org.hydrogen*</packages>
                                    </group>
                                    <group>
                                        <title>Fusion-X11</title>
                                        <packages>org.fusion.x11*</packages>
                                    </group>
                                    <group>
                                        <title>Fusion-Qt</title>
                                        <packages>org.fusion.qt*</packages>
                                    </group>
                                </groups>
                                <linksource>true</linksource>
                                <minmemory>16m</minmemory>
                                <maxmemory>128m</maxmemory>
                            </configuration>
                        </plugin>
                    </reportPlugins>
                </configuration>
            </plugin>
        </plugins>
    </pluginManagement>
</build>

【问题讨论】:

    标签: maven javadoc maven-3 maven-site-plugin maven-javadoc-plugin


    【解决方案1】:

    这是因为 Maven 在 site-plugin 的配置中将 plugins 的 plugin-config 和 reportplugins 分开了。您发布的 sn-p 只会在运行 mvn site 时采取行动,而不是直接运行 javadoc 目标。此行为影响所有插件。 Afaik 是将配置复制到“正常”插件配置的唯一方法,如下所示:

    <build>
        <!-- Memory management properties for jenkins build. -->
        <pluginManagement>
            <plugins>
                <plugin>
                    <groupId>org.apache.maven.plugins</groupId>
                    <artifactId>maven-surefire-plugin</artifactId>
                    <version>2.11</version>
                    <configuration>
                        <argLine>-Xmn8m -Xms32m -Xmx96m -XX:PermSize=32m
                            -XX:MaxPermSize=128m</argLine>
                    </configuration>
                </plugin>
                <plugin>
                    <groupId>org.apache.maven.plugins</groupId>
                    <artifactId>maven-site-plugin</artifactId>
                    <version>3.0-beta-3</version>
                    <configuration>
                        <reportPlugins>
                            <plugin>
                                <groupId>org.apache.maven.plugins</groupId>
                                <artifactId>maven-javadoc-plugin</artifactId>
                                <version>2.8</version>
                                <configuration>
                                    <verbose>true</verbose>
                                    <groups>
                                        <group>
                                            <title>Hypercube</title>
                                            <packages>org.hypercube*</packages>
                                        </group>
                                        <group>
                                            <title>Hyperdrive</title>
                                            <packages>org.hyperdrive*</packages>
                                        </group>
                                        <group>
                                            <title>Hydrogen</title>
                                            <packages>org.hydrogen*</packages>
                                        </group>
                                        <group>
                                            <title>Fusion-X11</title>
                                            <packages>org.fusion.x11*</packages>
                                        </group>
                                        <group>
                                            <title>Fusion-Qt</title>
                                            <packages>org.fusion.qt*</packages>
                                        </group>
                                    </groups>
                                    <linksource>true</linksource>
                                    <minmemory>16m</minmemory>
                                    <maxmemory>128m</maxmemory>
                                </configuration>
                            </plugin>
                        </reportPlugins>
                    </configuration>
                </plugin>
                <plugin>
                  <groupId>org.apache.maven.plugins</groupId>
                  <artifactId>maven-javadoc-plugin</artifactId>
                  <version>2.8</version>
                  <configuration>
                  <verbose>true</verbose>
                  <groups>
                    <group>
                        <title>Hypercube</title>
                        <packages>org.hypercube*</packages>
                    </group>
                    <group>
                        <title>Hyperdrive</title>
                        <packages>org.hyperdrive*</packages>
                    </group>
                    <group>
                        <title>Hydrogen</title>
                        <packages>org.hydrogen*</packages>
                    </group>
                    <group>
                        <title>Fusion-X11</title>
                        <packages>org.fusion.x11*</packages>
                    </group>
                    <group>
                        <title>Fusion-Qt</title>
                        <packages>org.fusion.qt*</packages>
                    </group>
                  </groups>
                  <linksource>true</linksource>
                  <minmemory>16m</minmemory>
                  <maxmemory>128m</maxmemory>
                  </configuration>
                </plugin>
            </plugins>
        </pluginManagement>
    </build>
    

    【讨论】:

    • 只是不要指望这个“设计”很快就会被修复,报告的错误很多,而且变化的速度也不是很快。
    猜你喜欢
    • 2013-07-14
    • 1970-01-01
    • 1970-01-01
    • 2021-06-19
    • 1970-01-01
    • 1970-01-01
    • 1970-01-01
    • 1970-01-01
    • 2013-07-15
    相关资源
    最近更新 更多