You are viewing a plain text version of this content. The canonical link for it is here.
Posted to general@logging.apache.org by ps...@apache.org on 2007/06/04 03:01:05 UTC

svn commit: r544025 - in /logging/chainsaw/trunk: HOWTOBUILD.txt pom.xml src/jnlp/resources/template.vm src/jnlp/template.vm

Author: psmith
Date: Sun Jun  3 18:01:04 2007
New Revision: 544025

URL: http://svn.apache.org/viewvc?view=rev&rev=544025
Log:
Added webstart distribution steps, first cut at HOWTOBUILD.txt for general users.



Added:
    logging/chainsaw/trunk/src/jnlp/template.vm
      - copied, changed from r544007, logging/chainsaw/trunk/src/jnlp/resources/template.vm
Removed:
    logging/chainsaw/trunk/src/jnlp/resources/template.vm
Modified:
    logging/chainsaw/trunk/HOWTOBUILD.txt
    logging/chainsaw/trunk/pom.xml

Modified: logging/chainsaw/trunk/HOWTOBUILD.txt
URL: http://svn.apache.org/viewvc/logging/chainsaw/trunk/HOWTOBUILD.txt?view=diff&rev=544025&r1=544024&r2=544025
==============================================================================
--- logging/chainsaw/trunk/HOWTOBUILD.txt (original)
+++ logging/chainsaw/trunk/HOWTOBUILD.txt Sun Jun  3 18:01:04 2007
@@ -1,57 +1,34 @@
 HOWTOBUILD.txt
 ==============
 
-This document outlines the steps required to build and run log4j Chainsaw v2.
+For General Users
+=================
+Firstly, you'll need maven 2.0.4+ to build Chainsaw:
 
-Comments/Changes/Bugs for this document and build process: 
-  * Log4j Developers list (log4j-dev@logging.apache.org)
+http://maven.apache.org
 
+Once setup, 
 
-Assumptions
-===========
-* Familiar with Ant, and have it installed (http://ant.apache.org/) 
-  (requires the 1.5.x series of Ant, including Conditions support)
+mvn install
 
-Dependencies
-============
+This will automatically build and assemble the Chainsaw distribution which includes a .sh & .bat shell script to run Chainsaw:
 
-Chainsaw requires:
+[*nix]
+sh target/appassembler/bin/chainsaw
 
-* log4j1.3 full jar
-* jakarata ORO 2.0.6+
-* XStream (http://xstream.codehaus.org)
+[Windows]
+target/appassembler/bin/chainsaw.bat
 
-Optionally, you can add Jakarta Commons VFS, and it's dependencies to have extra features inside Chainsaw
-See http://jakarta.apache.org/commons/sandbox/vfs/ for more information
+[OSX]
+You can use the *nix steps above, or go one extra step for a nicer OSX experience
 
-Simply placing all the dependant jars inside the directory specified by the 'deps.dir' build property (lib by default)
-will get you going.
+mvn package appbundler:bundle
 
+This will create an OSX distribution, look inside the target folder for the packaged OSX applicationd and .dmg distribution.  You can drag the application to your /Applications folder, or just double click it from the target folder.
 
-Step-by-Step to build Chainsaw
-======================================
+For log4j developers
+====================
 
-1. Download logging-chainsaw (you've probably already done this if you're reading
-   this...)
 
-2. Copy the build.properties.sample file -> build.properties
 
-3. Edit the build.properties file and modify to suit your needs.  
 
-4. Download and install the dependancies and place the jars in the directory specified by the 'deps.dir' in 
-   the build.properties file.
-   
-## NOT CURRENTLY IMPLEMENTED
-##4. If you haven't downloaded the required dependencies outlined in the build.properties file
-##   there is an ant target to help you:
-##   
-##   ant getdeps
-##   
-##   This will download all the required jars for Chainsaw v2 and place them in the directory
-##   specified in build.properties (it's the deps.dir property, usually ./lib)
-   
-5. After you have all the dependencies From the logging-log4j root directory, type:
-
-      ant chainsaw
-    
-   That's it ;)
\ No newline at end of file

Modified: logging/chainsaw/trunk/pom.xml
URL: http://svn.apache.org/viewvc/logging/chainsaw/trunk/pom.xml?view=diff&rev=544025&r1=544024&r2=544025
==============================================================================
--- logging/chainsaw/trunk/pom.xml (original)
+++ logging/chainsaw/trunk/pom.xml Sun Jun  3 18:01:04 2007
@@ -75,6 +75,63 @@
 				</executions>
 -->
 			</plugin>
+			
+      <plugin>
+        <groupId>org.codehaus.mojo</groupId>
+        <artifactId>webstart-maven-plugin</artifactId>
+        <version>1.0-SNAPSHOT</version>
+<!-- Not everyone needs to create the webstart package by default
+        <executions>
+           <execution>
+           	  <phase>package</phase>
+              <goals>
+                 <goal>jnlp</goal>
+              </goals>
+           </execution>
+        </executions>
+-->
+        <configuration>
+
+           <!-- JNLP generation -->
+           <jnlp>
+             <!-- default values -->
+             <!--resources>${project.basedir}/src/main/jnlp</resources-->
+             <!--inputTemplateResourcePath>${project.basedir}</inputTemplateResourcePath-->
+             <!--inputTemplate>src/jnlp/template.vm</inputTemplate--> <!-- relative to inputTemplateResourcePath -->
+             <outputFile>webstart.jnlp</outputFile> <!-- defaults to launch.jnlp -->
+
+             <!-- used to automatically identify the jar containing the main class. -->
+             <!-- this is perhaps going to change -->
+             <mainClass>${chainsaw.mainclass}</mainClass>
+           </jnlp>
+
+
+           <!-- SIGNING -->
+           <!-- defining this will automatically sign the jar and its dependencies, if necessary -->
+           <sign>
+             <keystore>${chainsaw.webstart.keystore}</keystore>
+             <keypass>${chainsaw.webstart.keypass}</keypass> 
+             <storepass>${chainsaw.webstart.storepass}</storepass> 
+             <storetype></storetype>
+             <alias>${chainsaw.webstart.alias}</alias>
+             <validity></validity>
+
+             <dnameCn></dnameCn>
+             <dnameOu></dnameOu>
+             <dnameO></dnameO>
+             <dnameL></dnameL>
+             <dnameSt></dnameSt>
+             <dnameC></dnameC>
+
+             <verify>false</verify>
+           </sign>
+
+           <!--install>false</install--> <!-- not yet supported -->
+           <verbose>true</verbose>
+
+        </configuration>
+      </plugin>
+
 		</plugins>
   </build>
   <dependencies>

Copied: logging/chainsaw/trunk/src/jnlp/template.vm (from r544007, logging/chainsaw/trunk/src/jnlp/resources/template.vm)
URL: http://svn.apache.org/viewvc/logging/chainsaw/trunk/src/jnlp/template.vm?view=diff&rev=544025&p1=logging/chainsaw/trunk/src/jnlp/resources/template.vm&r1=544007&p2=logging/chainsaw/trunk/src/jnlp/template.vm&r2=544025
==============================================================================
--- logging/chainsaw/trunk/src/jnlp/resources/template.vm (original)
+++ logging/chainsaw/trunk/src/jnlp/template.vm Sun Jun  3 18:01:04 2007
@@ -20,8 +20,8 @@
   <resources> 
     <j2se version="1.4+" max-heap-size="256m"/> 
     <j2se version="1.3+" max-heap-size="256m"/> 
-@JARS@
+	${dependencies}
 	<property name="org.apache.commons.logging.Log" value="org.apache.commons.logging.impl.Log4JLogger"/>
   </resources> 
-  <application-desc main-class="org.apache.log4j.chainsaw.LogUI"/> 
+  <application-desc main-class="$mainClass"/>
 </jnlp>