(Please enable word-wrap when viewing this file) This is the readme for the JIDE Common Layer Open Source Project. Contents =============== The contents of the distributions are: build.properties build.xml docs the Developer Guide examples examples for JIDE Common Layer (contains only a README file to redirect you to JIDE product demo) libs external jars used by JIDE Common Layer LICENSE.txt the license statement oss-test-project the test project based on Maven pom.xml the config file for Maven properties localized properties files README.txt this file src the source code test the test classes JIDE Common Layer.iml the module file for IntelliJ IDEA JIDE Common Layer.ipr the JIDE Common Layer project for IntelliJ IDEA Build ===== We have migrated our code base from java.net to github, and changed our build method to Maven. We suggest you to build JIDE Common Layer project by Maven too. However the ant way to build the project is still available. Build using Maven --------------- Assuming you have JDK6+ installed. JDK5 may not work because we used JDK6 only methods in the source code. Please also install Maven from http://maven.apache.org/download.html. After installation you should add a system environment variable M2_HOME which link to where Maven been installed, and add the %M2_HOME%\bin to PATH environment variable as well. Finally, you come to the JIDE Common Layer directory, use Maven command to compile and package the project. mvn compile compile the source, classes output to directory "target/classes" mvn clean clean previous build mvn package compile the source and package jars to sub directory "target" Build using Ant --------------- You can use your favorite Java IDE to build this project. But to make it easy, we provided ant script (build.xml) to build the project. You can download ant from http://ant.apache.org/. Once you install it, you can run "ant" or "ant dist" to build the whole source code and produce the jar file you need for your application. All available targets in build.xml are: init clean compile jar javadoc source dist (default) Configure Your Own POM ====================== If you just want to use JIDE Common Layer in your project which used Maven, you don't need to build the project unless you modified it locally. All you need to do is to add the following dependency to your pom.xml. <dependency> <groupId>com.jidesoft</groupId> <artifactId>jide-oss</artifactId> <version>3.7.4</version> </dependency> You can specify different versions if you want to use that version. You can find all available version numbers at http://search.maven.org by searching jide-oss.