源代码和 Javadoc jar 生成

Question

我认为我的问题很简单。然而，令人惊讶的是，我找不到任何简单的解决方案。

我正在 Netbeans 上开发一个开源 Java 库项目，并且像许多其他人一样，我想将它作为 binary.jar、source.jar 和 javadoc.jar 发布。

有没有办法在 Netbeans 上自动生成它们？我知道maven可以做到。但是学习曲线似乎太长了。

有一个类似的问题，但唯一的答案没有用：Automatically generating source and doc jars in Netbeans

Answer 1

试试蚂蚁http://ant.apache.org/。它比 maven 更容易学习，并且可以进行代码编译。

Answer 2

Maven 插件可能是你的答案

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-javadoc-plugin</artifactId>
    <version>2.7</version>
    <executions>
        <execution>
            <goals>
                <goal>jar</goal>
            </goals>
            <phase>package</phase>
        </execution>
    </executions>
</plugin>
<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-source-plugin</artifactId>
    <version>2.0.4</version>
    <executions>
        <execution>
            <goals>
                <goal>jar</goal>
            </goals>
            <phase>package</phase>
        </execution>
    </executions>
</plugin>

Answer 3

使用ant，您可以轻松生成 javadoc、编译、创建 jar 和 zip 文件。 这比在 netbeans 中做要好，因为如果有人想贡献，他可以用他喜欢的 IDE 做。

Answer 4

如果您正在开发一个其他人可能会帮助开发的库，那么您应该考虑使用Maven。

这样您的项目将独立于您的 IDE，并且依赖项、测试和部署将集中处理，而不是贡献者自己滚动。m

Answer 5

这是您需要将源代码和 javadoc 自动附加到构建的所有 maven 配置：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-javadoc-plugin</artifactId>
            <version>2.7</version>
            <executions>
                <execution>
                    <id>attach-javadoc</id>
                    <goals>
                        <goal>jar</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-source-plugin</artifactId>
            <version>2.1.2</version>
            <executions>
                <execution>
                    <id>attach-source</id>
                    <goals>
                        <goal>jar</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

这还不算太糟糕吧？

Answer 6

这是我最后提出的解决方案。它使用 Ant 并生成 javadoc 和源 jar。然后它将二进制 jar、javadoc、source.jar、许可证和自述文件归档到一个准备发布的 zip 文件中。

 <target name="-pre-init">
    <property file="version.properties"/>
    <property name="dist.jar" value="dist/${ant.project.name}-${project.version}.jar"/>
</target>

<target description="bundle sources in a jar" name="package-sources">
    <jar basedir="src" destfile="build/release/${ant.project.name}-${project.version}-sources.jar"/>
</target>


<target name="package_for_release" depends="jar,javadoc, package-sources">
    <mkdir dir="build/release"/>
    <copy file="${dist.jar}" todir="build/release/"/>
    <copy file="licence.txt" todir="build/release/"/>
    <copy file="beni_oku.txt" todir="build/release/"/>
    <mkdir dir="build/release/doc"/>
    <copy todir="build/release/doc">
        <fileset dir="dist/javadoc" includes="**"/>
    </copy>

    <zip basedir="build/release/" includes="**" destfile="dist/${ant.project.name}-${project.version}.zip"/>
</target>

在 NetBeans 中打开 build.xml 而不是右键单击 -> 运行目标 -> [其他目标] -> package_for_release

脚本从属性文件中获取版本号。我从here 得到了这个解决方案。