One of the very nice features of SuperWaba is that you are allowed - and encouraged - to add useful features to the Virtual Machine (the VM). You will need various tools to do this, such as Microsoft Visual C++ for the Windows version, and CodeWarrior V9.0 for the Palm version (GNU-compatible builds are under development). This page is a good place to put your own documentation and findings.

To help you configure CodeWarrior, here are images showing what your settings should look like when compiling the Native Methods and the SuperWaba.pdb files.

Microsoft Platform Builds

Guich has put together a few packages of files to help users rebuild the VM. If you wish to contribute a new version, do give it a new version number.

• proj_vmce.zip: Project for building the WinCE/PocketPC VM
  
• proj_vmpalm.zip: Project for building the Palm VM
  
• proj_vmwin32.zip: VC6 Project for building a native Windows VM
• VC7 Version: Improved version for VC7 users.

You will need to edit TargetPlatform.h in the "External Dependencies" folder. Your Project Settings will also need the output filename in the "Link" tab changed, and xplat_javalang.c needs to go in the source list.

The 4.0 Embedded Visual C++ toolkit can be obtained from Microsoft for free. It is recommended that the SP3 also be installed to fix numerous bugs and speed up the code. The SP3 is not in the main download page, but will be presented as an option when you attempt to download SP1 from here:

http://msdn.microsoft.com/mobility/prodtechinfo/devtools/eVisualc/howtoget/default.aspx

Note Microsoft recommend that you use the following CD key when installing this software:
TRT7H-KD36T-FRH8D-6QH8P-VFJHQ

You will need a platform SDK for the device(s) that you intend to develop for. These can be had from:

http://msdn.microsoft.com/mobility/downloads/sdks/default.aspx

The Windows CE: Standard Software Development Kit (SDK) is a recommended starting point.

This toolkit may run under WINE in Linux if you can figure out how to be an Administrator. Please ammend this page with instructions on how to do this if you figure it out!

Apache ANT Version

Current build files require ANT 1.6, so you might need to upgrade.
Older versions cause errors like:

BUILD FAILED
file:/home/vik/src/SuperWabaSDK/build.xml:144: The <filterchain> data type
doesn't support the nested "tokenfilter" element.

See the FAQ for details.

Updating CVS

• Go to http://superwaba.sourceforge.net/cgi-bin/twiki/view/Codev/ChangeLogs, and add a number in the current software version. e.g.:
  

"Changes in SuperWaba 4.21"....23. changed MultiEdit to set keyboard to none when not editable - vik"

• In the sources where the changes are made, put your mark on the same line as the change (does not need to be in all lines):
  

// vik@421_23: Blah blah...

• Commit your changes to cvs. First do an update, then a commit. This allows an easy way to identify changed things, specially for people that are not familiar with cvs.

-- VikOlliver - 06 Jul 2004