Generazione jar sorgente e Javadoc

Question

Penso che la mia domanda sia facile. Tuttavia è sorprendente che non ho trovato alcuna soluzione facile.

Sto sviluppando un progetto di libreria Java open source su Netbeans e come molti altri voglio rilasciarlo come binary.jar, source.jar e javadoc.jar.

C'è un modo per generarli automaticamente su Netbeans? So che il maven può farlo. Ma la curva di apprendimento sembra troppo lunga.

C'è una domanda simile, ma l'unica risposta che non ha funzionato: Automatically generating source and doc jars in Netbeans

Answer 1

Ecco la soluzione che ho trovato alla fine. Usa Ant e genera javadoc e jar sorgente. Quindi archivia binario jar, javadoc, source.jar, licenza e file readme in un file zip pronto per il rilascio.

<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> 

aperto build.xml in NetBeans rispetto tasto destro del mouse -> bersaglio eseguire -> [altri obiettivi] -> package_for_release

Script ottiene il numero di versione di un file di proprietà. Ho ottenuto questa soluzione da here.

Answer 2

Prova formica http://ant.apache.org/. È più facile da imparare rispetto a Maven e puoi compilare il codice.

Answer 3

Maven plugin potrebbe essere si risponde

<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 4

Con ant si può facilmente generare il javadoc, compilare, creare vasi e file zip. È meglio che farlo in netbeans, perché se qualcuno vuole contribuire potrebbe farlo con il suo IDE preferito.

Answer 5

Se si sta sviluppando una libreria che altri potrebbero aiutare a sviluppare, si dovrebbe pensare all'utilizzo di Maven.

In questo modo si progetto sarà indipendente dal vostro IDE e dipendenze anche, test e distribuzione saranno presi cura di centrale, al posto di sempre collaboratore di rotolamento loro own.m

Answer 6

tutto questo è l'esperto di configurazione è necessario collegare source e javadoc automaticamente alla build:

<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> 

Non è troppo orribile, vero?