1.1.2 How do I do that?
Download a binary release of Ant from
. Scroll down to find the current release of Ant, and download the archive in a format that's convenient for you to work with. Pick an appropriate place for it to live, and expand the archive there. The directory into which you've expanded the archive is referred to as
. Let's say you've expanded the archive into the directory
; you may want to create a symbolic link to make it easier to work with, and to avoid the need to change any environment configuration when you upgrade to a
ln -s apache-ant-1.5.1 ant
Once Ant is situated, you need to do a couple of things to make it work right. You need to add its
directory in the distribution (in our example,
) to your command
. You also need to set the environment variable
to the top-level directory you installed (in this example,
). Details about how to perform these steps under different operating systems can be found in the Ant manual,
, if you need them.
Of course, we're also assuming you've got a Java SDK. Because some of Hibernate's features are available only in Java 1.4, you'd be best off upgrading to the latest 1.4 SDK. It's also possible to use most of Hibernate with Java 1.3, but you may have to rebuild the Hibernate JAR file using your 1.3 compiler. Our examples are written
you've got Java 1.4, and they will need tweaking if you don't.
Once you've got this set up, you should be able to fire up Ant for a test run and verify that everything's right:
Apache Ant version 1.5.1 compiled on February 7 2003
1.1.3 What just
Well, not much just yet, but you're now in a position where you'll be able to try out the examples we provide later on, and use them as a starting point for your actual Hibernate projects.
If you're new to Ant, it wouldn't be a bad idea to read the manual a little bit to get a sense of how it works and what it can do for you; this will help make sense of the
files we start working with in our examples. If you decide (or already know) you like Ant, and want to dig deeper, you can pick up O'Reilly's
Ant: The Definitive Guide
(after you finish
book, of course)!
1.1.4 What about...
...Eclipse, JBuilder, Sun ONE Studio (Forte for Java), or some other Java IDE? Well, you can
use these, but you're on your own as far as what you need to do to get Ant integrated into the build process. (Several already use Ant, so you might be starting out ahead; for the others you might have to jump through some hoops.) If all else fails, you can use the IDE to develop your own code, but invoke Ant from the command line when you need to use one of our build scripts.