Setting up the tools for J2ME app development

Aim: To setup tools and environment for J2ME application development
My OS: Ubuntu jaunty

JRE
1. Download and install JRE (Java Runtime Environment) using the Synaptic Package Manager. The JRE is required for Eclipse to run.

Eclipse
2. Download and install Eclipse. I use this Eclipse Ganymede package.
Make sure you are able to launch Eclipse after it has been downloaded and extracted.
If Eclipse won't start with messages like 'Widget disposed too early', try adding this line to eclipse.ini
-Dorg.eclipse.swt.browser.XULRunnerPath=/usr/lib/xulrunner
this worked for me! BTW, eclipse log is located at /.metadata/.log
.metadata is a hidden folder!

Sun WTK
3. Download and install the Wireless Tool Kit. Although, Sun now has a Java ME SDK 3.0, it is currently available only for Windows. I use the earlier Sun Java Wireless Toolkit 2.5.2. Extract the contents to a suitable directory.

EclipseME plugin
4. Next we proceed to download the plugin to help us develop the J2ME midlets. Although the EclipseME project has graduated and is now called Eclipse Mobile Tools for Java (MTJ), I did face some problems with it on my Ubuntu machine. Problems were especially related to Proguard not being able to find my inner classes and throwing NoClassDefFound errors during Obfuscation. Hence I decided to switch back to the tried and tested EclipseME 1.7.9 plugin.
To install, use Eclipse's Software Updates feature and add the site http://www.eclipseme.org/updates


Proceed with the installation. Restart Eclipse if asked to. After successful installation, you should be able to see a new 'J2ME' option under Eclipse -> Window -> Preferences

Proguard
5. This is a must if you wish to optimize the resulting jar and also make sure nobody copies your code (Obfuscate). I downloaded the latest Proguard4.4.tar.gz version. Extract it to a suitable directory.

Antenna Eclipse Plugin
6. Add the plugin update site http://antenna.sf.net/update via Eclipse's Software Updates feature and install it.


Proceed to install the plugin. Restart Eclipse if asked to.
Installation guide is here.

You can also download the Antenna Jar
This is required if you wish to build using Ant (build.xml) How to set it up and use it will be covered in another post.

Wiring it all!

Browse to Eclipse -> Window -> Preferences -> J2ME (Left side option)
Set the Antenna JAR and WTK Root properties
Antenna JAR (antenna.preprocessor.v2_1.7.7.jar) will be located under Eclipse/plugins directory
WTK Root is where you extracted the contents in Step 3 above.


Import the Sun WTK Emulation devices in Eclipse
Open Eclipse -> Window -> Preferences -> J2ME (Left side option) -> Device Management
Click Import
In the Import Devices dialog that pops up, browse for the WTK/bin directory.
Click Refresh. You should see this.

Click Finish

On Preferences screen, Click J2ME -> Packaging -> Obfuscation and set the Proguard Root Directory.
Set it to the path where you extracted Proguard contents in step 5 above. Mine is /media/sda5/Dev/proguard4.4

All Done!

Now import an existing project or create a dummy project.
Right click on the project and enable 'Antenna Preprocessor'.
Now if you see the Project Properties (Alt-Enter), you should see a new option 'Antenna preprocessor' under it.



JMUnit
If you wish to write Test cases, you should consider adding JMUnit jar to your project classpath.

A nice guide on using JMUnit is here

You are all set to start J2ME programming.
Next, I ll post on how to actually start using these tools and make the most out of it.