Generiere Javadoc-Jar für ein Maven-basiertes Projekt

Generieren Sie Javadoc-Jar für Maven-basierte Projekte

Das Plugin "http://maven.apache.org/plugins/maven-javadoc-plugin/[maven-javadoc]" verwendet den Befehl "JDKin\javadoc.exe", umjavadocs zu generieren, in eine JAR-Datei zu packen und bereitzustellen zusammen mit Ihrem Projekt.

1. Maven JavaDoc Plugin

Fügen Sie das Plugin "maven-javadoc" in Ihre Datei "pom.xml" ein.

Datei: pom.xml


    4.0.0
    com.example
    examplecore
    jar
    1.0
    examplecore project
    http://maven.apache.org
    
    
        
            org.apache.maven.plugins
            maven-javadoc-plugin
            
                
                    attach-javadocs
                    
                        jar
                    
                
            
        
    
    

2. Stellen Sie es bereit

Wenn Sie „mvn install“ ausgeben, wird Javadoc generiert, Ihr Projekt verpackt und im lokalen Repository bereitgestellt.

D:\exampleweb-core>mvn install
[INFO] Scanning for projects...
[INFO] ------------------------------------------------------------------------
[INFO] Building examplecore project
[INFO]    task-segment: [install]
[INFO] ------------------------------------------------------------------------
//...
Loading source files for package com.example.core...
Constructing Javadoc information...
Standard Doclet version 1.6.0_13
Building tree for all the packages and classes...
Generating D:/exampleweb-core/target/apidocs\com/example/core/\App.html...
Generating D:/exampleweb-core/target/apidocs\com/example/core/\package-frame.html...
Generating D:/exampleweb-core/target/apidocs\com/example/core/\package-summary.html...
Generating D:/exampleweb-core/target/apidocs\com/example/core/\package-tree.html...
Generating D:/exampleweb-core/target/apidocs\constant-values.html...
Generating D:/exampleweb-core/target/apidocs\com/example/core/\class-use\App.html...
Generating D:/exampleweb-core/target/apidocs\com/example/core/\package-use.html...
Building index for all the packages and classes...
Generating D:/exampleweb-core/target/apidocs\overview-tree.html...
Generating D:/exampleweb-core/target/apidocs\index-all.html...
Generating D:/exampleweb-core/target/apidocs\deprecated-list.html...
Building index for all classes...
Generating D:/exampleweb-core/target/apidocs\allclasses-frame.html...
Generating D:/exampleweb-core/target/apidocs\allclasses-noframe.html...
Generating D:/exampleweb-core/target/apidocs\index.html...
Generating D:/exampleweb-core/target/apidocs\help-doc.html...
Generating D:/exampleweb-core/target/apidocs\stylesheet.css...
[INFO] Building jar: D:\exampleweb-core\target\examplecore-1.0-javadoc.jar
[INFO] [install:install {execution: default-install}]
[INFO] Installing D:\exampleweb-core\target\examplecore-1.0.jar to D:\maven\repo\com\mky
ong\examplecore\1.0\examplecore-1.0.jar
[INFO] Installing D:\exampleweb-core\target\examplecore-1.0-javadoc.jar to D:\maven\repo
\com\example\examplecore\1.0\examplecore-1.0-javadoc.jar
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESSFUL

3. Ausgabe

Navigieren Sie zu Ihrem lokalen Repository. Es werden 2 JAR-Dateien erstellt:

  1. examplecore-1.0.jar (classes)

  2. examplecore-1.0-javadoc.jar (javadoc)

generate javadoc with Maven