Building Exupery on Unix


	links to this page:

Last updated at 1:16 pm UTC on 5 October 2008

Building Exupery from source just involves installing VMMaker and Exupery from SqueakMap, then finally compiling an Exupery VM. It's important to use the same version of VMMaker as Exupery, this is so that the overridden methods match between Exupery and VMMaker. Getting the wrong VMMaker version will cause your VM to crash.

This bit is optional, it's just to make surpe that you have a working VM building environment before adding Exupery to the mix.

Install VMMaker 3.8b3 from SqueakMap
Get the corresponding C support files. Place them somewhere where VMMaker can find them. Use "svn export http://squeakvm.org/svn/squeak/platforms" to get the correct sources. I built last with version 1921
Compile a VM just to make sure everything works.

Now we build the VM itself.

Get the Exupery C source files from http://www.kampjes.demon.co.uk/vms/exuperyVMFiles.tz and http://ftp.squeak.org/Exupery/vms/freetypeMakeFiles.tz
Untar the files and place them in:
- platforms/Cross/plugins/ExuperyPlugin/ExuperyPlugin.h
- platforms/unix/plugins/ExuperyPlugin/sqUnixExuperyPlugin.c
- The freeTuypeMakefiles should be untarred above platforms, they have the full paths from platforms down in the tar file.
- I guess the Windows file goes in the equivilent Windows directory.
Install Exupery and Exupery's VMMaker by loading exupery-dev from Universes, this will load all the packages needed to build the VM and for all the tests to pass. The current release on SqueakMap should be fairly stable but Exupery has a large test suite so the current dev version shouldn't be any worse. If you're not sure, then run all the tests, if they pass it's probably as good as what's on SqueakSource.
Build a VM
Run the tests in the class ExuperyStoryTests. If they all pass everything works.