JOGL Installation Instructions for OS X really suck

Could someone please add some better installation instructions to the user’s guide for installing JOGL on OS X?

While there are DIRE WARNINGS about dumping things into /System/Library/Java/Extensions/, it’s not exactly like the user’s guide provides a better alternative.

Exactly how should the CLASSPATH be adjusted? Is setting it via “export CLASSPATH=…” sufficient? Do we need -cp? Is there some Java Control Panel which needs to be used? Do both jar files have to be listed individually? Can we just use the directory? What about a wildcard?

Exactly how should DYLD_LIBRARY_PATH be changed?

I spent about an hour trying different combinations of CLASSPATH and DYLD_LIBRARY_PATH. Nothing seems to work. Yeah, I understand that it’s something stupid. However, it would be nice to list the stupid things you’re likely to do so you can avoid them.

However, if I just dump everything into /System/Library/Java/Extensions/, it all works great.

Are you using an IDE, such as Eclipse or Netbeans, that lets you setup the class paths in a user interface?

If you’re just using the command line, you need to modify the class path so that it includes pathes to jogl.jar and gluegen-rt.jar (and because they’re jars you have to include the jar file in the path, not just the directory).

Then you need to adjust your native library path (not DYLD_LIBRARY_PATH) to point to the jnilibs. In this case, you only have to specify the directory that holds onto those files.