Building from the source is usually for the thick skinned, we try to keep our trunk stable but it's a development environment so we can never guarantee that everything will be smooth. If you rather work with something more stable or if you don't need the latest and greatest, using the latest official distribution is probably a better option.

Getting the source code

First you will have to make sure that you have Subversion. If you don't know what Subversion is or don't have it installed, check here. Once installed run:

Stable branch: (Use Buildr 1.2.10)

$> svn checkout http://svn.apache.org/repos/asf/ode/branches/APACHE_ODE_1.1 ode-1.1

Development branch: (Use Buildr 1.3.1+)

$> svn checkout http://svn.apache.org/repos/asf/ode/trunk ode-trunk

For more information or if you have any problem with Subversion (like being behind a proxy or a firewall) check the Source Code section.

Building With Buildr

If you already have Ruby installed on your machine (which is true for most Linux and Mac computers), you will probably find building with Buildr easier. You will need to following things:

  • Ruby 1.8.x with RubyGems 0.9 or later. As mentioned, you probably already have this installed. For Windows users using the Ruby One-Click Installer is the easiest (http://rubyforge.org/projects/rubyinstaller/). For Linux or Mac OS users, a Ruby interpreter is usually preinstalled. Just make sure to have the ruby-dev package (mkmf is needed for RJB).
  • Buildr. Install it by running 'gem install buildr -v 1.2.10' (stable branch) or 'gem install buildr -v 1.3.1' (development branch). You will need to have a proper JAVA_HOME environment variable. Make sure to choose either win32 or ruby platforms (don't choose java for Antwrap, that's JRuby).

Note that for now, even though ODE can run on JDK 1.6.x, building ODE only works with JDK 1.5.x. So before building, make sure you JAVA_HOME points to a JDK 1.5.x installation.

Building is then pretty simple. Open a command in the source root directory and run:

buildr _1.2.10_ TEST=no ode:package

Note: Replace "1.2.10" by "1.3.1" if you're building the trunk.

To try the test cases bundled with ODE:

buildr test

To generate Eclipse project files:

buildr eclipse

It just works! For more information about Buildr see http://buildr.rubyforge.org/.

Troubleshooting

  • At the moment the ODE build only supports buildr 1.2.10 so make sure that you have this version installed.
  • If you get a Zlib:BufError, that's because of your version of Rubygems, just upgrade RubyGems by typing: 
    gem update --system