Java, Eclipse, Ant, JUnit, Hudson, SVN, native libraries; can they all coexist

build-processcontinuous integrationjava

What is the most proper way to accomplish all of the following:

  • Create a project in Eclipse
  • With an Apache Ant buildfile
  • That Hudson (or another more recommended CI system?) uses
  • And support for JUnit tests that are run by both Ant/Hudson and Eclipse
  • And check the proper folder structure into SVN so that future developers can replicate the build, and Hudson can automatically grab from SVN and run the Ant file to build/test/deploy the project
  • And the project has native libraries, if that makes any difference (I've already written an Ant task that can download and unzip the proper library files depending on the OS)

I already have my project with some source files and an Ant file, but I've been having trouble integrating it with Eclipse in an organized manner, so I would really love to start from a fresh Eclipse project, set it up correctly, and then copy my Ant file and my source files piece-by-piece into the project in the most Eclipse-compatible way.

I will be continuing to play around with everything in an attempt to get it working as I like it. But if you have experience with this sort of thing, perhaps at your workplace, please give as much information as you can.

My main goal here is to learn this once and use it in my future projects. For now, I am developing a client-server application consisting of a JOGL applet frontend (using JNLP files) and an unattended server app. Up until now I've been doing it all by hand: writing and building in Eclipse, dragging the applet jar into my FTP client, SSHing the server jar and restarting it by hand, and all with no testing process. I'm hoping that by the end, the build process will be something like this: test locally on my machine with a copy of the native libraries; commit code changes to SVN; Hudson svn updates, uses the Ant buildfile to compile and run all JUnit tests; if all the tests pass, it proceeds to copy the server jar to my dedicated server and restart the running server instance, and then copy the client jar to my web server.

Best Answer

When I start a new project, I generally take the following steps:

  1. Create a new Java project in Eclipse, using the Java project wizard and opting to keep source and class files in separate directories ('src' and 'class')
  2. Set up the project in Eclipse with the package structure you want
  3. Create a new repository (or folder in your repository) for the project, with the normal /trunk/ /branches/ /tags/ set up
  4. Using your SVN client, import the contents of the project folder Eclipse made for the project (at the level where the 'src' and 'class' directories are) into the trunk of the repository
  5. Confirm everything is in Subversion correctly (check the trunk out to a new location)
  6. Using Eclipse, delete the project (and the files on disk)
  7. Create a new project using the 'Checkout projects from SVN' wizard, using the trunk of the repository
  8. Create your Ant script, ensure the project builds correctly, and add the Ant script to the repository

Now, from Hudson:

  1. Create a new job and set the Subversion URL to the root of the repository
  2. Add a build set that will use Ant (I've always had to install my own version of Ant and ensure it's configured correctly to have this work) and will call the Ant script you
  3. Use 'Build Now' to see if the job will build correctly

You can invoke your JUnit tests from Ant in the build script (first compile them with the javac task, then run them with the junit task). Hudson will track the test results if you ask it to.

You can use a shell script build step to copy your server jar to where it's needed, and restart the server instance. Like Mnementh said, it sounds like you've got the native libraries sorted...

Related Topic