Installation

  1. Before you begin
  2. Install the Wireless Toolkit(s)
  3. Install the Plug-In
  4. Configure the Plug-In's Wireless Toolkit Settings
  5. Change Eclipse's Debug Settings
  6. Configure ProGuard (Optional)

0. Before you begin

Please make sure you have all the prerequisites.

1. Install the Wireless Toolkit(s)

Install any of the wireless toolkits you want to use. When you do this, make note of the base directory into which each is installed, as you will need this information in Step 3.

2. Install the Plug-In

The EclipseME distribution is provided as a ZIP archive. Simply unzip the plug-in binaries into your Eclipse "plugins" directory and restart Eclipse. For instance, if your Eclipse installation is held in c:\software\Eclipse, EclipseME should be installed to c:\software\Eclipse\plugins.

If the plug-in is properly installed, there will be a J2ME entry in the Preferences dialog.
screenshot

3. Configure the Plug-In's Wireless Toolkit Settings

In order to use the plug-in, you must configure at least one Wireless Toolkit. In order to do this, perform the following steps:

  1. Select the Properties menu item from Eclipse's Window menu.
  2. Expand the J2ME item in the pane to the left and click on Platform Components.
    screenshot
  3. Right-click on Wireless Toolkits and select Add Wireless Toolkit.
  4. In the resulting dialog, select the root directory of the wireless toolkit installation.
    screenshot
  5. When you have completed the operation, you should be able to expand the Wireless Toolkits and other items in the right-hand pane and see the toolkits, definitions, profiles and configurations that are installed.
    screenshot

4. Change Eclipse's Debug Settings

Because of some quirks in the wireless toolkits, Sun's in particular, if you are going to debug your MIDlet using Eclipse, you must change several of the default debug settings. To do this:

  1. Select the Properties menu item from Eclipse's Window menu.
  2. Expand the Java item in the left pane and click on the Debug entry.
  3. Ensure that both Suspend execution on uncaught exceptions and Suspend execution on compilation errors near the top of the dialog are NOT checked.
  4. Increase the Debugger timeout near the bottom of the dialog to at least 15000 ms.
  5. The resulting settings should look something like this:
    screenshot

If you do not make these changes you will get errors when you try to run your MIDlet.

5. Configure ProGuard (Optional)

If you will be using ProGuard to produce obfuscated packages, you will need to configure it into the plug-in. To do this:

  1. Select the Properties menu item from Eclipse's Window menu.
  2. Expand the J2ME item in the left pane and click on the Obfuscation entry.
  3. Configure the ProGuard Root Directory near the top of the dialog.
  4. Configure any other ProGuard-specific settings that you need. For more information on ProGuard, see the ProGuard SourceForge site.

At this point, you are ready to use EclipseME to create MIDlet suites.