How do I generate and deploy a javadoc jar file for my project?
Author: Deron Eriksson
Description: This maven tutorial describes how to generate a javadoc jar file for a project using the maven-javadoc-plugin plugin.
Tutorial created using:
Windows Vista || JDK 1.6.0_04 || Eclipse Web Tools Platform 2.0.1 (Eclipse 3.3.1)
(Continued from page 1) Now I'll build and deploy the aforementioned project jarW files to my ArchivaS repository via "mvn clean deploy". The console output of "mvn clean deploy" is shown here: Console output for 'mvn clean deploy' on 'aproject' project[INFO] Scanning for projects... WAGON_VERSION: 1.0-beta-2 [INFO] ------------------------------------------------------------------------ [INFO] Building aproject [INFO] task-segment: [clean, deploy] [INFO] ------------------------------------------------------------------------ [INFO] [clean:clean] [INFO] Deleting directory C:\dev\workspace\aproject\target [INFO] [resources:resources] [INFO] Using default encoding to copy filtered resources. [INFO] [compiler:compile] [INFO] Compiling 1 source file to C:\dev\workspace\aproject\target\classes [INFO] [resources:testResources] [INFO] Using default encoding to copy filtered resources. [INFO] [compiler:testCompile] [INFO] Compiling 1 source file to C:\dev\workspace\aproject\target\test-classes [INFO] [surefire:test] [INFO] Surefire report directory: C:\dev\workspace\aproject\target\surefire-reports ------------------------------------------------------- T E S T S ------------------------------------------------------- Running com.maventest.AppTest Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.038 sec Results : Tests run: 1, Failures: 0, Errors: 0, Skipped: 0 [INFO] [jar:jar] [INFO] Building jar: C:\dev\workspace\aproject\target\aproject-1.2.jar [INFO] Preparing source:jar [WARNING] Removing: jar from forked lifecycle, to prevent recursive invocation. [INFO] No goals needed for project - skipping [INFO] [source:jar {execution: attach-sources}] [INFO] Building jar: C:\dev\workspace\aproject\target\aproject-1.2-sources.jar [INFO] Preparing javadoc:jar [INFO] ------------------------------------------------------------------------ [INFO] Building aproject [INFO] ------------------------------------------------------------------------ [WARNING] Removing: jar from forked lifecycle, to prevent recursive invocation. [WARNING] Removing: jar from forked lifecycle, to prevent recursive invocation. [INFO] No goals needed for project - skipping [INFO] [javadoc:jar {execution: attach-javadocs}] Loading source files for package com.maventest... Constructing Javadoc information... Standard Doclet version 1.6.0_04 Building tree for all the packages and classes... Generating C:/dev/workspace/aproject/target/apidocs\com/maventest/\App.html... Generating C:/dev/workspace/aproject/target/apidocs\com/maventest/\package-frame.html... Generating C:/dev/workspace/aproject/target/apidocs\com/maventest/\package-summary.html... Generating C:/dev/workspace/aproject/target/apidocs\com/maventest/\package-tree.html... Generating C:/dev/workspace/aproject/target/apidocs\constant-values.html... Generating C:/dev/workspace/aproject/target/apidocs\com/maventest/\class-use\App.html... Generating C:/dev/workspace/aproject/target/apidocs\com/maventest/\package-use.html... Building index for all the packages and classes... Generating C:/dev/workspace/aproject/target/apidocs\overview-tree.html... Generating C:/dev/workspace/aproject/target/apidocs\index-all.html... Generating C:/dev/workspace/aproject/target/apidocs\deprecated-list.html... Building index for all classes... Generating C:/dev/workspace/aproject/target/apidocs\allclasses-frame.html... Generating C:/dev/workspace/aproject/target/apidocs\allclasses-noframe.html... Generating C:/dev/workspace/aproject/target/apidocs\index.html... Generating C:/dev/workspace/aproject/target/apidocs\help-doc.html... Generating C:/dev/workspace/aproject/target/apidocs\stylesheet.css... [INFO] Building jar: C:\dev\workspace\aproject\target\aproject-1.2-javadoc.jar [INFO] [install:install] [INFO] Installing C:\dev\workspace\aproject\target\aproject-1.2.jar to \dev\m2repo\com\maventest\aproject\1.2\aproject-1.2.jar [INFO] Installing C:\dev\workspace\aproject\target\aproject-1.2-sources.jar to \dev\m2repo\com\maventest\aproject\1.2\aproject-1.2-sources.jar [INFO] Installing C:\dev\workspace\aproject\target\aproject-1.2-javadoc.jar to \dev\m2repo\com\maventest\aproject\1.2\aproject-1.2-javadoc.jar [INFO] [deploy:deploy] altDeploymentRepository = null Uploading: http://192.168.1.7:8081/archiva/repository/internal/com/maventest/aproject/1.2/aproject-1.2.jar 2446/? [INFO] Retrieving previous metadata from archiva.internal [INFO] Uploading project information for aproject 1.2 [INFO] Retrieving previous metadata from archiva.internal [INFO] Uploading repository metadata for: 'artifact com.maventest:aproject' Uploading: http://192.168.1.7:8081/archiva/repository/internal/com/maventest/aproject/1.2/aproject-1.2-sources.jar 770/? Uploading: http://192.168.1.7:8081/archiva/repository/internal/com/maventest/aproject/1.2/aproject-1.2-javadoc.jar 4096/? 8192/? 12288/? 16384/? 20480/? 21036/? [INFO] ------------------------------------------------------------------------ [INFO] BUILD SUCCESSFUL [INFO] ------------------------------------------------------------------------ [INFO] Total time: 10 seconds [INFO] Finished at: Tue Feb 19 21:28:25 PST 2008 [INFO] Final Memory: 16M/28M [INFO] ------------------------------------------------------------------------ If we examine the Archiva internal repository, we can see it now contains the jar artifact, the source jar, and the javadoc jar. |