Setting up the development environment

The development environment for the SPAN project involves:

• A Wireless Toolkit: Either from Sony Ericsson (windows-only) or from SUN (Linux or Windows)
• Subversion, additionally the Subclipse Eclipse plugin
• Eclipse, version 3.1.x
• EclipseME

Already included in the subversion checkout will be

• Avetana JSR 82, or at least the Java sources thereof. For running Java code that establishes a direct Bluetooth connection you'll also need a Bluetooth stack that is supported by Avetana and the corresponding native library (libavetanaBT.so for Linux).
• kXML 2
• Bouncy Castle lightweight cryptography API

I'll assume that you want to set up the Sony Ericsson kit on Windows and the SUN kit on linux.

Installation for Windows

You need: Windows 2000/XP, (local) administrative rights, additionally a normal user for everyday work

1. Become (local) administrator
2. (optional, if needed) Get J2SE SDK 1.4.x from [1]
3. (optional, if needed) Get DirectX 8.1 or later from [2] (there is a "runtime" quick link to the right)
4. Get Eclipse 3.1.x from [3]
5. Unpack Eclipse to the hard drive (e.g. in c:\eclipse)
6. optional: create a start menu item for c:\eclipse\eclipse.exe
7. Adjust the rights on c:\eclipse to Everybody: Read, Execute (make sure these are inherited to all files and folders below)
8. Run Eclipse and install EclipseME per these installation instructions (Note: the correct update site is http://www.eclipseme.org/updates/ and not http://eclipseme.sourceforge.net/updates/ which erroneously is shown in the screenshots.) Don't bother with the configuration instructions yet.
9. Exit Eclipse.
10. Install the Sony-Ericsson J2ME SDK from [4], for example to C:\SonyEricsson
11. Adjust the rights on C:\SonyEricsson to Everybody: Read, Execute plus Full Access for your normal user (most of the programs in the SDK want to write in that directory)
12. (optional, if needed) Disable the "Windows Firewall", because it interferes with emulator-emulator connections and is generally not needed on a properly configured system. If your Windows is not hardened yet you might want to do that now: http://www.ntsvcfg.de/
13. Become your normal user.
14. Start Eclipse.
15. Follow the configuration hints from [5] (the root of the Wireless Toolkit is C:\SonyEricsson)

You're done. For information on how to start developing look at file:///C:/SonyEricsson/J2ME_SDK/PC_Emulation/WTK2/docs/UserGuide-html/demonstrations.html, and [6].