You are viewing an old version of this page. View the current version.
Compare with Current ·
View Page History
Prerequisites
Java Developer Kit (JDK)
You will need a JDK 1.4.2+ (J2SE 1.4.2+) or compatible JDK to build Groovy.
Apache Ant
To execute the build process you need to have Apache Ant version 1.7.0 (or newer) installed.
Subversion Client
To fetch the source code for the server, you will need to have a Subversion client version 1.2 (or newer, 1.4 is recommended) installed.
 |
If you are using a source archive from the distribution site site, then you do not need to have a Subversion client installed. |
Fetch the Groovy Source Code
From Subversion
There are many different protocols available to access the Groovy source code. For the complete list see the source repository details for the project.
svn co https://svn.codehaus.org/groovy/trunk/groovy/groovy-core
From a Source Archive
Select one of the *-src.* archives from the distribution site site and unzip it.
For example, to use the source from the Groovy 1.1-beta-2 release:
wget http://dist.groovy.codehaus.org/distributions/groovy-src-1.1-beta-2.zip unzip groovy-src-1.1-beta-2.zip
Preparing to Build for the First Time
If you are behind a proxy firewall, you may need to set up proxy information in a ~/.ant/settings.xml or ~/.m2/settings.xml file:
If you will need to publish artifacts then you will need to have appropriate permissions with codehaus and ensure that you have stored your credentials in a ~/.ant/settings.xml or ~/.m2/settings.xml file of the form:
Building
To build everything, run tests and create a complete installation in target/install, run:
ant install
After this finished successfully, then you can try out the distribution that was just built. For example to play with groovysh you can run:
./target/install/bin/groovysh
Sometimes its desirable to skip the test execution for faster turn around. To turn off tests set the skipTests property, as in:
ant install -DskipTests=true
Distribution Archives
To build a Groovy distribution archive:
ant distribution
This will build everything, generate documentation and create distribution archives under target/dist:
groovy-binary-VERSION.zipgroovy-docs-VERSION.zipgroovy-src-VERSION.zip
| NOTE As you might have guessed VERSION will be the version of the project you are building, like |
Publishing Artifacts
To publish artifacts to the Maven 2 repository, run:
ant deploy
This will either publish to the release repository or the snapshot repository based on whether the POM version contains SNAPSHOT or not.
If deploy is failing, then check Installing the UserTrust CA into the Java JDK.