Documentation/Maemo Eclipse Tutorial/Installation Methods


[edit] PC Connectivity

In order to communicate with your Maemo device, a set of daemons and utilities needs to be installed to the host PC and Maemo device.

Find the complete description and installation instructions on the PC Connectivity project web site and Maemo PC Connectivity tutorial.

[edit] Maemo PC Connectivity

On the Maemo device, you need the other half of PC Connectivity, Maemo PC Connectivity, containing the servers that match the clients installed on the host PC side with Host PC Connectivity. The Maemo PC Connectivity requires either Diablo or Fremantle based Maemo device (N800, N810 or N900).

Note: You can update your Maemo device operating system using the File > New > Other > Maemo Installers > Flash Images to Device Eclipse IDE wizard or Maemo Flasher-3.5 command line tool.

Install the Maemo PC Connectivity on the Mameo device before installing Maemo ESbox or PluThon Eclipse IDE environments.

[edit] Host PC Connectivity

Host PC Connectivity provides host-side software, like SSH and SBRSH clients, Rsync, FTP client, and the TightVNC viewer. These are packaged together conveniently for installation on Linux, Windows, and Mac OS X Intel.

Install the Host PC Connectivity on the host PC before installing Maemo ESbox or PluThon Eclipse IDE environments.

[edit] Installation via Product Archives

The Product Archives come in two parts: a common archive, containing the bulk of the installation, and an OS-specific archive. If your host OS is not represented, please use Maemo update sites installation for the best results.

The distributed archives can be extracted anywhere on your system to provide a full Eclipse Ganymede SR2 environment with ESbox or PluThon and all its dependencies pre-installed.

The installation from product archives is upgradeable to new versions using Maemo Update Site.

[edit] Product Archives

For ESbox download archives from ESbox Garage project download page.

For PluThon download archives from PluThon Garage project download page.

[edit] Linux/x86

ESbox archives:


PluThon archives:

Note: In Ubuntu 9.10, Fedora 11, or other platforms using GTK+ 2.18 and/or Mozilla xulrunner 1.19, you must launch ESbox with the script and PluThon with the script included in the archives. Otherwise, Eclipse will fail to start and/or will have erratic UI. See this post for GTK+ details and this bug for xulrunner information.

[edit] Windows/x86

ESbox archives:


PluThon archives:


[edit] Mac OS X/Intel

ESbox archives:


PluThon archives:


[edit] Installing and Running

Extract and install the archives for your operating system: Unzip the * and *-<host OS>.zip archive into the same directory of your choice.

If you use a Sun Java JRE, you can edit esbox.ini or pluthon.ini to adjust maximum memory usage (-Xmx, -XX:MaxPermSize).

Run the main executable or script:

./ or ./
./esbox.exe or ./pluthon.exe
Mac OS X
./ or ./

[edit] Installation via Maemo Update Site

When you install ESbox, PluThon and Mica components through the Maemo update site, all needed dependencies (like CDT, PyDev, RSE, DSF, etc.) are installed automatically.

[edit] Eclipse Installation

If you do not yet have Eclipse IDE installed, follow these instructions.

Download Eclipse Ganymede SR2 (3.4.2) for your host. We suggest a package bundled with CDT:

  • Win32
  • Linux 32-bit
  • Max OS X
  • ...or visit the Eclipse Ganymede SR2 Build page. You must use Eclipse 3.4.2.
  • The Maemo update site will ensure all needed additional packages are installed, so you can also start from a different Eclipse package.
  • Other hosts are not officially supported for Maemo development but you are welcome to try installation or trying to use the Maemo SDK Virtual Image to run Maemo Eclipse development environment.

Extract the archive somewhere on your machine (for example /home/user on Linux).

For Linux or Mac OS X:

$ cd /home/user
$ tar xvzf eclipse-cpp-ganymede-SR2-host-windowsystem.tar.gz

or, for Win32, use Winzip or another zip utility to extract the archive.

Start Eclipse by running the Eclipse executable included with the release. The executable file is called eclipse, and is located in the eclipse sub-directory of the install:

$ /home/user/eclipse/eclipse

In recent Linux distributions like Ubuntu 9.10 or Fedora 11, GTK+ 2.18 and Mozilla's xulrunner have changed in ways that cause problems with Eclipse. See more information about GTK+ issues from this email and xulrunner issue from this bug report.

If the xulrunner problem affects you, you will need to launch Eclipse as shown below:

$ GDK_NATIVE_WINDOWS=true /home/user/eclipse/eclipse -vmargs -Dorg.eclipse.swt.browser.XULRunnerPath=path...

where path... is the path to xulrunner 1.8, usually under /usr/lib/xulrunner/xulrunner or /usr/bin/xulrunner. In Ubuntu this package is named xulrunner.

See this post for GTK+ details and this bug for xulrunner information.

For the sake of convenience, there are ready made scripts available to use for ESbox and PluThon that implement this workaround. For ESbox, use this script and for PluThon, use this script to launch Eclipse IDE.

For more detailed information about Eclipse 3.4 environment, see the Eclipse 3.4.2 Project Release Notes.

[edit] ESbox and PluThon Installation

Verify that your network proxy is configured (if needed) in Window > Preferences > General > Network Connections.

Select Help > Software Updates... from the main menu bar, figure 3.1.

These instructions given are for ESbox installation through the Maemo Update Site, but can also be applied for the PluThon installation.

Figure 3.1: Software Updates

Select the Available Software tab, figure 3.2.

Figure 3.2: Software Updates and Add-ons

Add three update sites via Add site....

Example how to add ESbox update site:

Figure 3.3: Update Site, Add ESbox

Example how to add Mica update site:

Figure 3.4: Update Site, Add Mica

Mica is a generic framework named Maemo IDE Common Architecture underneath the ESbox and PluThon products.

Open the ESbox (or PluThon) tree and select ESbox 2nd Edition (or PluThon 2nd Edition) inside, then click Install, figure 3.5.

Figure 3.5: Software Updates and Add-ons, ESbox 2nd Edition

You can select the ESbox 2nd Edition Source, PluThon 2nd Edition Source and Mica 2nd Edition Source as well as following the Mica development setup instructions if you want to develop against ESbox or PluThon.

Verify the installed items, then click Next, figure 3.6.

Figure 3.6: Install

Review the licenses, then click Next, figure 3.7.

The ESbox 2nd Edition selection brings in everything from ESbox and Mica, and the PluThon 2nd Edition selection brings in everything from PluThon and Mica. You can individually select the items under the ESbox, PluThon and Mica nodes on the Available Software page, if you desire. This will make it easier to uninstall individual components later.

Click Finish and the installation will be performed. Accept the offer to restart Eclipse, figure 3.8.

Figure 3.8: Restart Eclipse

[edit] Updating from an earlier than R2.0.0 release

If you used the archive files for installation, you can follow the instructions below to update your installation to the latest ESbox or PluThon version.

Select Help > Software Updates... from the main menu bar, figure 3.9.

Figure 3.9: Software Updates

If you installed directly from a repository archive (*.zip) file, rather than from the web, follow the below steps first:

  1. Select the Available Software tab.
  2. Click the Manage Repositories... button.
  3. Remove the old archive entries (esbox-repository*.zip, pluthon-repository*.zip, mica-repository*.zip)
  4. Add new update sites through Add site... pointing to the new repository archives.

Select the Installed Software tab, figure 3.10.

Figure 3.10: Installed Software

Click the Update... button.

Eclipse should display an Operation in progress... dialog and take a little time to query the configured update sites and should find the new versions of ESbox, PluThon and Mica features (as well as possibly other installed features).

Verify that ESbox, PluThon and Mica features are listed and checked, then click Next, figure 3.11.

Figure 3.11: Available Updates

Review the licenses, then click Next, figure 3.12.

Figure 3.12: Review licenses

Click Finish and the update is performed. Accept the offer to restart Eclipse, figure 3.13.

[edit] Troubleshooting

If you see this dialog: figure 3.14

Figure 3.14: Cannot complete the request

followed by this dialog: figure 3.15

Messages about Cannot find a solution... usually means the given features or plugins are already installed, or that older versions were installed from a different site. Try using Software Updates... > Installed Software > Update... instead.

If you have an older ESbox or PluThon installation with features and plugins installed from another URL, use Software Updates... > Installed Software > Uninstall... to remove the ESbox or PluThon installation. This may make Eclipse unlaunchable - if so, launch Eclipse as shown below:

$ ./ -application org.eclipse.sdk.ide

until Eclipse is reinstalled from the current location.

[edit] Installing Help Content

Both ESbox and PluThon support the use of Maemo release documentation from the Eclipse IDE, both remotely and locally. You can configure the Eclipse environment to access Maemo online release documentation from the Maemo Info Center service. The same documentation available from the Maemo Info Center can also be downloaded to the host PC and installed locally on the Eclipse help system.

[edit] Remote Help Content

The Mica framework included in ESbox and PluThon can use the Eclipse hover remote help system to access online documentation. For Maemo platform releases, the online documentation for each release is available from Maemo Info Center service.

For more information about Hover help, see the ESbox or the PluThon Help topic Getting Started > Using Hover Help for Maemo API Libraries.

You need to configure the Maemo Info Center to use the Maemo 5 Fremantle SDK help inside Eclipse:

Open the Help > Content preference page, figure 3.16.

Figure 3.16: Help Content Preferences

Add a Maemo Info Center site, noting to update the host (no http:// prefix) and the path, which is Maemo platform specific (/fremantle for Maemo 5 Fremantle release), figure 3.17.

Figure 3.17: Edit Maemo Docs Library Information

Then, use Help > Content and you will see the entries under Maemo 5 categories.

[edit] Local Content

If you prefer, you may also install all Maemo release documentation locally so that no network connection is needed when accessing Maemo documentation. Locally installed documentation is also faster to access and search than online documentation from the Maemo Info Center.

This content is only available from the Maemo update site. You can also install Maemo release documentation locally in case you installed ESbox or PluThon from a full-product archive instead of Maemo update site.

These instructions assume you have already installed the Eclipse ESBox or PluThon product using either Maemo Eclipse product archives or update sites.

Verify that your network proxy is configured (if needed) in Window > Preferences > General > Network Connections.

Select Help > Software Updates... from the main menu bar, figure 3.18.

Figure 3.18: Software Updates...

Select the Available Software tab, figure 3.19.

Figure 3.19: Software Updates and Add-ons

Add a Documentation update site via Add site..... Maemo Fremantle documentation update site is figure 3.20.

Select one or more of the Maemo ... Help' features and then click 'Install, figure 3.21.

Figure 3.21: Software Updates and Add-Ons, Selection

Verify the installed items, then click Next, figure 3.22.

Figure 3.22: Confirm Installation

Review the licenses, then click Next, figure 3.23.

Figure 3.23: Accept Licenses


Click Finish and the installation is performed. You may be able to Apply Changes if you have not already opened help or turned on hover help. Otherwise accept the offer to restart Eclipse, figure 3.24.

Figure 3.24: Apply Changes Or Restart