Building Project Wonderland on Mac OS X

It is possible to build and run Project Wonderland on Mac OS X, using Apple's developer preview of Java SE 6 (for the 2008-0_3_0 (v0.3) stable build and daily builds) and Java SE 5 for the daily builds. Here are the necessary steps:

1. Download Java SE 6

If you plan to use the v0.3 stable build of Project Wonderland, you will need to install the Java SE 6 Developer Preview from Apple. It is available to Apple Developer Connection members here: http://developer.apple.com/java/. If you are not a member of the Apple Developer Connection, you can sign up for a free account. Once you sign in, download and install the developer preview.

2. Remove old versions of Java 3D

Apple ships Java with a very old version of Java3D (both with Java SE 5 and Java SE 6). You must remove this version to build and run Wonderland. To remove Java3D, do the following in a new Terminal:

   
   # cd /System/Library/Java/Extensions
   # sudo mkdir j3d-old
   # sudo mv j3d* libJ3D* vecmath.jar j3d-old

3. Set JAVA_HOME environment variable

Before you build with ant, you must set the JAVA_HOME environment variable to point to the correct version of Java. You can do this from the terminal you are going to build in using the following command:

   export JAVA_HOME=/System/Library/Frameworks/JavaVM.framework/Versions/1.6/Home

if you are using Java SE 6 (v0.3 stable release, daily builds) and

   export JAVA_HOME=/System/Library/Frameworks/JavaVM.framework/Versions/1.5/Home

for Java SE 5 (daily builds).

You can also do the same thing permanently by adding this command to your ~/.profile file.

4. Check out project Wonderland sources

Follow the normal instructions here to check out sources from CVS.

https://lg3d-wonderland.dev.java.net/#building

5. Change garbage collector

Due to a bug in Apple's Java 6 developer preview, the default garbage collector for Wonderland does not work on the Mac. You can still run Wonderland with the default garbage collector.

• open up lg3d-wonderland/build.xml in a text editor.
• find the ant target name run (it should be around line 149)
• you should see the line:

     <jvmarg value="-Xincgc"/>
     

• comment that line out:

     <!-- <jvmarg value="-Xincgc"/> -->
     

6. Build Wonderland

Now you should be able to build Wonderland using ant, as specified here: https://lg3d-wonderland.dev.java.net/#building

7. Run Wonderland

You should now be able to run Wonderland normally, using ant run-sgs and ant run