Documentation/Maemo Eclipse Tutorial/Installation Methods

= Installation Methods =

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

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

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

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.

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

Product Archives
For ESbox download archives from ESbox Garage project download page.

For PluThon download archives from PluThon Garage project download page.

Linux/x86
ESbox archives:


 * esbox_2.0.0-R20091216-common.zip
 * esbox_2.0.0-R20091216-linux.gtk.x86.zip

PluThon archives:


 * pluthon_2.0.0-R20091216-common.zip
 * pluthon_2.0.0-R20091216-linux.gtk.x86.zip

Windows/x86
ESbox archives:


 * esbox_2.0.0-R20091216-common.zip
 * esbox_2.0.0-R20091216-win32.win32.x86.zip

PluThon archives:


 * pluthon_2.0.0-R20091216-common.zip
 * pluthon_2.0.0-R20091216-win32.win32.x86.zip

Mac OS X/Intel
ESbox archives:


 * esbox_2.0.0-R20091216-common.zip
 * esbox_2.0.0-R20091216-macosx.carbon.x86.zip

PluThon archives:


 * pluthon_2.0.0-R20091216-common.zip
 * pluthon_2.0.0-R20091216-macosx.carbon.x86.zip

Installing and Running
Extract and install the archives for your operating system: Unzip the *-common.zip and *-&lt;host OS&gt;.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:


 * Linux
 * ./esbox.sh or ./pluthon.sh


 * Win32
 * ./esbox.exe or ./pluthon.exe


 * Mac OS X
 * ./esbox.app/Contents/MacOS/esbox or ./pluthon.app/Contents/MacOS/esbox

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

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 esbox.sh script and for PluThon, use this pluthon.sh script to launch Eclipse IDE.

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

ESbox and PluThon Installation
Verify that your network proxy is configured (if needed) in Window &gt; Preferences &gt; General &gt; Network Connections.

Select Help &gt; 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.

Select the Available Software tab, figure 3.2.

Add three update sites via Add site....


 * ESbox update site is: http://maemoide.nokia.com/updates/2.0/esbox, figure 3.3.
 * PluThon update site is: http://maemoide.nokia.com/updates/2.0/pluthon.
 * Mica update site is: http://maemoide.nokia.com/updates/2.0/mica, figure 3.4.

Example how to add ESbox update site:

Example how to add Mica update site:

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.

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.

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.

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 &gt; Software Updates... from the main menu bar, figure 3.9.

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.

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.

Review the licenses, then click Next, figure 3.12.

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

Troubleshooting
If you see this dialog: figure 3.14

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... &gt; Installed Software &gt; Update... instead.

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

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

until Eclipse is reinstalled from the current location.

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

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 &gt; 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 &gt; Content preference page, figure 3.16.

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.

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

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 &gt; Preferences &gt; General &gt; Network Connections.

Select Help &gt; Software Updates... from the main menu bar, figure 3.18.

Select the Available Software tab, figure 3.19.

Add a Documentation update site via Add site..... Maemo Fremantle documentation update site is http://maemoide.nokia.com/downloads/fremantle/, figure 3.20.

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

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

Review the licenses, then click Next, figure 3.23.

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.