Installation
- Before you begin
- Install the Wireless Toolkit(s)
- Install the Plug-In
- Configure the Plug-In's Wireless Toolkit Settings
- Change Eclipse's Debug Settings
- 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.
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:
-
Select the Properties menu item from
Eclipse's Window menu.
-
Expand the J2ME item in the pane to the left and click on
Platform Components.
-
Right-click on Wireless Toolkits and
select Add Wireless Toolkit.
-
In the resulting dialog, select the root directory of the
wireless toolkit installation.
-
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.
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:
-
Select the Properties menu item from
Eclipse's Window menu.
-
Expand the Java item in the left pane
and click on the Debug entry.
-
Ensure that both Suspend execution on uncaught
exceptions and Suspend execution on
compilation errors near the top of the dialog are
NOT checked.
-
Increase the Debugger timeout near the
bottom of the dialog to at least 15000 ms.
-
The resulting settings should look something like this:
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:
-
Select the Properties menu item from
Eclipse's Window menu.
-
Expand the J2ME item in the left pane
and click on the Obfuscation entry.
-
Configure the ProGuard Root Directory near the top of the dialog.
-
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.