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

Quick installation walkthrough

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. Copy the Device Explorer eclipse plugin from C:\SonyEricsson\J2ME_SDK\OnDeviceDebug\lib\devexp\plugins\com.sonyericsson.sdkme.deviceexplorer_2.2.3 to C:\Eclipse\plugins\
12. 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)
13. (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/
14. Become your normal user.
15. Start Eclipse.
16. 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].

In Eclipse you must first create a new midlet suite (File -> New -> Other -> J2ME -> J2ME midlet suite) before you can create a new midlet (File -> New -> Other -> J2ME -> J2ME midlet). When you want to run/debug your midlet in the emulator you must make sure that "Sony Ericsson J2ME SDK 2.2.x MIDP 2.0 Platform" is selected for the "J2ME Platform Definition" in the J2ME properties of the project, otherwise you won't be able to choose "SonyEricsson_W800_Emu" for the "Device" on the "Emulation" tab in the run dialog.