Dear Wiki user, You have subscribed to a wiki page or wiki category on "Struts Wiki" for change notification.
The following page has been changed by CraigMcClanahan: http://wiki.apache.org/struts/BuildingShale The comment on the change is: Clean up section headers, no content change ------------------------------------------------------------------------------ + ##language:en + #pragma section-numbers on + = Building Shale = + This page describes the process for downloading and building Shale from the Apache Subversion repository and then the wrinkles in building it for various IDEs + - == The Basics == + == The Basics == - === Pulling Shale from SVN === + === Pulling Shale from SVN === + Assuming that you already have a Subversion client installed such as [http://tortoisesvn.tigris.org/ TortoiseSVN]. You need to checkout from the following repository URL http://svn.apache.org/repos/asf/struts/shale/trunk/, or from the command line use '''svn checkout''' with that same URL + - === Dependencies === + === Dependencies === + Shale needs the following libraries, if you are building without an IDE you'll need to have these available. If you are using an IDE to inspect and build the Shale code, then some of these libraries may already be available for you. (See below) ||'''Library'''||'''Version'''|| @@ -17, +25 @@ ||Commons Logging||1.0.4|| ||JUnit||3.1.8|| You will also need Ant installed. + - === Building From The Command Line === + === Building From The Command Line === + To build the core Shale libraries follow these steps. 1. svn checkout the shale trunk from the url above 1. Change to the /core-library directory and copy '''build.properties.sample''' to '''build.properties''' 1. Edit the build.properties to point to the various libraries as above 1. From the command prompt simply run '''ant''', the default target is ''library'' which will build the core jar file into ''core-library/target/lib/shale.jar'' - = IDEs = + == IDEs == + - == JDeveloper 10.1.3 == + === JDeveloper 10.1.3 === + To get the Ant compile to run successfully in JDeveloper a some extra settings have to be added to the build.properties to override locations defined in the build.xml ''if'' you want to use the JSF RI as shipped with JDeveloper and the OC4J servlet API JARs rather than downloading a separate JSF RI and Tomcat. This assumes the use of JDeveloper 10.1.3 developer preview (J2EE edition). Note the versions of the various Jakarta Commons libraries shipped in the JDeveloper install are lower than those needed for Shale, so you should separately download ''beanutils'', ''chain'', ''digester'' and ''logging'' and update your build.properties with the appropriate locations. + - === General JDeveloper Setup === + ==== General JDeveloper Setup ==== + Set up JDeveloper to exclude the '''.svn''' sub-directories from the source view in the navigator. to do this: 1. From the menu ''Tools'' > ''Properties'' 1. Choose ''Global Ignore List'' in the properties tree @@ -40, +54 @@ Next, if you want to compile Shale through the normal workspace make/compile rather than Ant, create user libraries to point at the updated versions of the various commons libraries mentioned above. Use the ''Tools'' > ''Manage Libraries'' menu option. It's probably worth doing this in any case, even if you intend to use Ant for building, just so that code insight and so on will work correctly if you want to change the source. - === Creating a Base Project for Shale === + ==== Creating a Base Project for Shale ==== + JDeveloper 10.1.3 does not come with an SVN plugin yet so you'll have to pull the source tree from the command line or from a tool like TortoiseSVN. Once you've done this, go ahead and do the following to create a project with the Shale core source. 1. Create a new workspace. Call this something like '''Shale''' and put it in the root shale directory created by the svn checkout. @@ -54, +69 @@ * Commons Digester 1.6 * Commons Beanutils 1.7.0 1.#5 Finally copy the build.properties.sample file to build.properties and make the changes outlined in the next section. + - === build.properties Settings === + ==== build.properties Settings ==== + * The JSF RI jars are in %JDEV_HOME%/jsf-ri * The servet and JSP API jars are in %JDEV_HOME%/j2ee/home/lib and have different names from the Tomcat jars * The correct version of JUnit is available in %JDEV_HOME%/jdev/extensions/oracle.jdeveloper.junit.10.1.3/junit3.8.1 @@ -63, +80 @@ ||jsf-impl.jar||%JDEV_HOME%/jsf-ri/jsf-impl.jar|| ||jsp-api.jar||%JDEV_HOME%/j2ee/home/lib/ojsp.jar|| ||servlet-api.jar||%JDEV_HOME%/j2ee/home/lib/servlet.jar|| + - === Building Shale in JDeveloper === + ==== Building Shale in JDeveloper ==== To build you can simply use the defined Ant targets. Select the build.xml and in the structure pane you'll see the various targets. Either choose run on the build.xml as a whole to run the default '''library''' target or right mouse click on the required target inside the structure pane and choose run. + - == Eclipse 3.0.1 == + === Eclipse 3.0.1 === + - === General Eclipse Setup === + ==== General Eclipse Setup ==== + To make the checkout from the Struts subversion repository simpler it's worth installing the Eclipse Subversion plug-in [Subclipse http://subclipse.tigris.org/] if you don't already have it. 1. Choose ''Help'' > ''Software Updates'' > ''Find and Install'' 1. Choose ''Search for new features to install'' in the Install wizard dialog. @@ -81, +102 @@ * Commons Digester 1.6 * Commons Beanutils 1.7.0 - === Creating a Base Project for Shale === + ==== Creating a Base Project for Shale ==== + Follow these steps: 1. Switch to the SVN repository exploring perspective 1. Right mouse click on the Repository navigator and choose ''New'' > ''Repository Location'' or click the ''Add SVN Repository'' button @@ -93, +115 @@ 1. In the same dialog set ''Default output folder'' to '''core-library/target/classes''' 1. Also in the properties dialog, with the ''Java Build Path'' node selected, click on the ''libraries'' tab and define libraries for the various packages as defined above. 1. Finally copy the build.properties.sample file to build.properties and make the changes outlined in the next section. + - === build.properties settings === + ==== build.properties settings ==== + Update the build.properties to point at the homes of the various packages downloaded as above. The one exception is JUnit which is shipped in the Eclipse Install: ||junit.home||%ECLIPSE_HOME%/plugins/org.junit_3.8.1|| + - === Building Shale in Eclipse === + ==== Building Shale in Eclipse ==== To build carry out the following steps. 1. Use ''Window'' > ''Show View'' > ''Ant'' 1. In the Ant Window right mouse click or use the icon to add a build file. Select '''build.xml''' @@ -107, +132 @@ - - --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
