Installing EclipseME itself
This document provides instructions on how to install or upgrade the EclipseME plugin/feature set. Before you follow the steps below, please make sure you have followed the prerequisite steps here. In addition, once you have finished the installation itself, you will need to configure EclipseME's settings (see here) as well as some Eclipse settings.
Beginning with version 0.5.5, EclipseME is provided as an Eclipse "archive site." With version 0.5.0 and earlier, one simply unzipped the distribution file into the Eclipse installation directory or plugin directory. This is no longer the installation procedure. Please follow the instructions below instead.
If you are updating EclipseME, you should also use the procedure below. New installations and updates follow the same series of steps.
There are two basic ways of installing or updating EclipseME:
From the Eclipse Help menu, select Software Updates and then Find and install...
You will be presented with the following dialog:

Select the Search for new features to install
radio button.
Press Next.
You will next be presented with the following dialog:

Press the New Remote Site... button.
In the New Update Site
dialog that appears, enter a name for the update site and
the URL http://www.eclipseme.org/updates/
and press
Open.
The update site will now be listed in the
Install dialog.

Ensure that there is a check next to the EclipseME update site, then
press Next.
You will next be presented with the following dialog:

Ensure that there is a check next to EclipseME.
Other available features can be installed by checking them as well.
Press Next.
The installation process will next display the license agreement for
EclipseME.

Select I accept the terms of the license agreements
and press Next.
The next dialog that appears displays the possible locations into which
you can install EclipseME.

In many cases, the only site that will be listed will be the main
Eclipse installation directory. If you have other plugins or features
installed, however, you may see additional sites.
Although you may install EclipseME elsewhere, we recommend that you install it in your main Eclipse installation directory.
Once you have selected a site, press Finish.
At present the EclipseME package is not digitally signed.
(Maintaining the keys required to digitally sign JAR files costs
$400+/year. If anyone is interested in funding EclipseME to this
extent, we'll be happy to sign the JAR files.)
As a result,
the following warning dialog will be displayed:

Presuming that you are certain that you obtained the EclipseME distribution
file from a reputable source (such as directly downloading it yourself
from SourceForge.net), it should be safe to trust the installation
package.
If you choose to continue, press the Install button.
At this point, Eclipse will begin to install EclipseME from the site archive file. When the installation is complete, you will see one of the following two dialogs:
| New installations | ![]() |
| Updates | ![]() |
Even though the dialog shown during new installations suggests that it may be possible to continue without restarting, you should definitely restart Eclipse at this point.
Once Eclipse restarts, the installation procedure is complete.
In the vast majority of the cases, the installation procedure above will properly handle updating a previous version of EclipseME.
Under some rare circumstances, even after Eclipse restarts, EclipseME will not end up properly "registered" inside Eclipse. This can generally be corrected by closing Eclipse and then restarting Eclipse adding the -clean parameter to the other parameters you normally use. Using the -clean option forces Eclipse to rescan and update all its plugin information.
If the plug-in is properly installed, there will be a
J2ME entry in the
Window / Preferences dialog.
The process of installing EclipseME via a downloaded archive file is very similar to that of installing it via the EclipseME update site.
Download the latest archive site from the EclipseME downloads page.
From the Eclipse Help menu, select Software Updates and then Find and install...
You will be presented with the following dialog:

Select the Search for new features to install
radio button. You should select this option even if you are updating
EclipseME.
Press Next.
You will next be presented with the following dialog:

Press the New Archived Site... button.
In the Select Local Site Archive
dialog that appears, select the distribution ZIP file and press
Open.
The site archive file will now be listed in the
Install dialog.

Ensure that there is a check next to the distribution file, then
press Next.
You will next be presented with the following dialog:

Ensure that there is a check next to EclipseME.
Other available features can be installed by checking them as well.
Press Next.
The installation process will next display the license agreement for
EclipseME.

Select I accept the terms of the license agreements
and press Next.
The next dialog that appears displays the possible locations into which
you can install EclipseME.

In many cases, the only site that will be listed will be the main
Eclipse installation directory. If you have other plugins or features
installed, however, you may see additional sites.
Although you may install EclipseME elsewhere, we recommend that you install it in your main Eclipse installation directory.
Once you have selected a site, press Finish.
At present the EclipseME package is not digitally signed.
(Maintaining the keys required to digitally sign JAR files costs
$400+/year. If anyone is interested in funding EclipseME to this
extent, we'll be happy to sign the JAR files.)
As a result,
the following warning dialog will be displayed:

Presuming that you are certain that you obtained the EclipseME distribution
file from a reputable source (such as directly downloading it yourself
from SourceForge.net), it should be safe to trust the installation
package.
If you choose to continue, press the Install button.
At this point, Eclipse will begin to install EclipseME from the site archive file. When the installation is complete, you will see one of the following two dialogs:
| New installations | ![]() |
| Updates | ![]() |
Even though the dialog shown during new installations suggests that it may be possible to continue without restarting, you should definitely restart Eclipse at this point.
Once Eclipse restarts, the installation procedure is complete.
In the vast majority of the cases, the installation procedure above will properly handle updating a previous version of EclipseME.
Under some rare circumstances, even after Eclipse restarts, EclipseME will not end up properly "registered" inside Eclipse. This can generally be corrected by closing Eclipse and then restarting Eclipse adding the -clean parameter to the other parameters you normally use. Using the -clean option forces Eclipse to rescan and update all its plugin information.
If the plug-in is properly installed, there will be a
J2ME entry in the
Window / Preferences dialog.
Once you have completed the steps above, you are ready to configure EclipseME and Eclipse. Click here for instructions on how to to that.