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.

J2ME programming tools

In my experience, these are the tools required for developing mobile applications (midlets).

Eclipse IDE. The latest is Eclipse Galileo. I use Eclipse Ganymede.
Mobile Java Tools plugin for Eclipse.
Sun Java Wireless Toolkit The latest is Java ME SDK 3.0, but I use WTK 2.5.2 separately
Antenna Preprocessor

In another post, I ll be talking about how to use these tools to develop and application.

Update - MJT experience :(
Recent experience with Mobile Java Tools was not good. I faced problems with unnecessary NoClassDefFound errors on inner classes, probably something to do with the preverifier and obfuscator (proguard). So I decided to switch back to the tried and tested EclipseME 1.7.9 Plugin

Update - More tools:
Proguard (latest is v4.4) - Obfuscator, preverifier etc to safeguard and optimize the code
JMUnit - for unit testing (my research tells me that JMUnit is better than j2meunit, also at sourceforge)

Reinstall Windows on existing Linux partition

What I wanted to do:

- Remove logical partitions

- Cleanly reinstall Windows XP

- Resize and merge existing logical partitions

- Make sure Ubuntu is unaffected (Grub)

Note #1. Partition magic will not help, if you attempt to resize/move an existing partition due to the presence of the linux partition.

Note #2. Grub is my boot loader. I did not note down the partition on which my linux is installed and kind of regretted later. Note down the partition information when you attempt to boot into Ubuntu ..something like 'Booting from hd (0,5)' etc

Here is what I did.

Task #1: Remove logical partition

As I said earlier, Partition magic will not help in this regard due to the presence of the Linux partition.

I booted using the Windows XP setup CD and using the partition utility, removed the logical partitions that I did not want.

Task #2: Install Windows

After the partitions were removed, I proceeded to install Windows XP on my newly formatted partition. Note, my Linux partition was untouched all this while.

Now, once XP was installed, the XP boot manager takes over and I could not see my Linux boot options. Now the task was to restore Grub as the boot manager.

Task #3: Resize partitions

Now I restarted the PC and booted using the Live CD.

Ubuntu has a Partition manager that ships with the Live CD.

Using that, I was able to resize the partitions

Task #4: Restore Grub

Once inside, In a terminal window, I used the following commands:

a. sudo grub

b. root hd(0,5)

(you may have noticed where Grub loads from as mentioned in Note#2 above)

if not, here is what can be done to find where Grub was previously installed

b1. find /boot/grub/stage1

c. setup hd(0)

d. quit

All done!

I now restarted the PC without the Live CD and was able to see the Grub menu with Ubuntu and Windows XP OS choices.