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.

  1. Decide on your approach
  2. Installing via the EclipseME Update site
  3. Installing via a downloaded archive site

1. Decide on your approach

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:

  1. You can simply to use Eclipse's built-in updates feature to directly install or update via EclipseME's update site.
  2. You can download an archive site file manually, and then install from it.

2. Installing via the EclipseME Update site

  1. From the Eclipse Help menu, select Software Updates and then Find and install...

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

  3. You will next be presented with the following dialog:
    screenshot
    Press the New Remote Site... button.

  4. 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.
    screenshot

  5. The update site will now be listed in the Install dialog.
    screenshot
    Ensure that there is a check next to the EclipseME update site, then press Next.

  6. You will next be presented with the following dialog:
    screenshot
    Ensure that there is a check next to EclipseME. Other available features can be installed by checking them as well. Press Next.

  7. The installation process will next display the license agreement for EclipseME.
    screenshot
    Select I accept the terms of the license agreements and press Next.

  8. The next dialog that appears displays the possible locations into which you can install EclipseME. screenshot
    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.

  9. 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:
    screenshot
    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.

  10. 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 screenshot
    Updates screenshot

    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.
    screenshot

3. Installing via a downloaded archive site

The process of installing EclipseME via a downloaded archive file is very similar to that of installing it via the EclipseME update site.

  1. Download the latest archive site from the EclipseME downloads page.

  2. From the Eclipse Help menu, select Software Updates and then Find and install...

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

  4. You will next be presented with the following dialog:
    screenshot
    Press the New Archived Site... button.

  5. In the Select Local Site Archive dialog that appears, select the distribution ZIP file and press Open.
    screenshot

  6. The site archive file will now be listed in the Install dialog.
    screenshot
    Ensure that there is a check next to the distribution file, then press Next.

  7. You will next be presented with the following dialog:
    screenshot
    Ensure that there is a check next to EclipseME. Other available features can be installed by checking them as well. Press Next.

  8. The installation process will next display the license agreement for EclipseME.
    screenshot
    Select I accept the terms of the license agreements and press Next.

  9. The next dialog that appears displays the possible locations into which you can install EclipseME. screenshot
    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.

  10. 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:
    screenshot
    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.

  11. 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 screenshot
    Updates screenshot

    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.
    screenshot

Next Steps

Once you have completed the steps above, you are ready to configure EclipseME and Eclipse. Click here for instructions on how to to that.