Editing Documentation/Maemo Eclipse Tutorial/Installation Methods

Warning: You are not logged in. Your IP address will be recorded in this page's edit history.
The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.
Latest revision Your text
Line 1: Line 1:
-
== PC Connectivity ==
+
 
 +
= 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.
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 [http://pc-connectivity.garage.maemo.org/ PC Connectivity project web site] and [[Documentation/Maemo PC Connectivity Tutorial|Maemo PC Connectivity tutorial]].
+
Find the complete description and installation instructions on the [http://pc-connectivity.garage.maemo.org/ PC Connectivity project web site] and ''Maemo PC Connectivity Tutorial'' <ref name=r2>Maemo PC Connectivity Tutorial. http://library.maemodocs.nokia.com</ref>.
-
=== Maemo PC Connectivity ===
+
== 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).
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).
-
[[Image:dialog-information.png|frame|center|alt=unknown|'''Note:'''  You can update your Maemo device operating system using the '''File &gt; New &gt; Other &gt; Maemo Installers &gt; Flash Images to Device''' Eclipse IDE wizard or Maemo Flasher-3.5 command line tool.]]
+
{|
 +
|-
 +
| [[Image:dialog-information.png]]
 +
| '''Note:'''  You can update your Maemo device operating system using the '''File &gt; New &gt; Other &gt; Maemo Installers &gt; 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.
Install the Maemo PC Connectivity on the Mameo device before installing Maemo ESbox or PluThon Eclipse IDE environments.
-
=== Host PC Connectivity ===
+
== 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.
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.
Line 19: Line 26:
Install the Host PC Connectivity on the host PC before installing Maemo ESbox or PluThon Eclipse IDE environments.
Install the Host PC Connectivity on the host PC before installing Maemo ESbox or PluThon Eclipse IDE environments.
-
== Installation via Product Archives ==
+
= 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 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.
Line 27: Line 34:
The installation from product archives is upgradeable to new versions using Maemo Update Site.
The installation from product archives is upgradeable to new versions using Maemo Update Site.
-
=== Product Archives ===
+
== Product Archives ==
For ESbox download archives from [https://garage.maemo.org/frs/?group_id=192 ESbox Garage project download] page.
For ESbox download archives from [https://garage.maemo.org/frs/?group_id=192 ESbox Garage project download] page.
Line 33: Line 40:
For PluThon download archives from [https://garage.maemo.org/frs/?group_id=247 PluThon Garage project download] page.
For PluThon download archives from [https://garage.maemo.org/frs/?group_id=247 PluThon Garage project download] page.
-
==== Linux/x86 ====
+
=== Linux/x86 ===
ESbox archives:
ESbox archives:
-
* <code>esbox_2.0.0-R20091216-common.zip</code>
+
* <span><font face="monospace">esbox_2.0.0-R20091216-common.zip</font></span>
-
* <code>esbox_2.0.0-R20091216-linux.gtk.x86.zip</code>
+
* <span><font face="monospace">esbox_2.0.0-R20091216-linux.gtk.x86.zip</font></span>
PluThon archives:
PluThon archives:
-
* <code>pluthon_2.0.0-R20091216-common.zip</code>
+
* <span><font face="monospace">pluthon_2.0.0-R20091216-common.zip</font></span>
-
* <code>pluthon_2.0.0-R20091216-linux.gtk.x86.zip</code>
+
* <span><font face="monospace">pluthon_2.0.0-R20091216-linux.gtk.x86.zip</font></span>
-
[[Image:dialog-information.png|frame|center|alt=unknown|'''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 <code>esbox.sh</code> and PluThon with the script <code>pluthon.sh</code> included in the archives. Otherwise, Eclipse will fail to start and/or will have erratic UI. See [http://mou.me.uk/2009/10/31/fixing-eclipse-in-ubuntu-9-10-karmic-koala/ this post for GTK+ details] and [http://mou.me.uk/2009/10/31/fixing-eclipse-in-ubuntu-9-10-karmic-koala/ this bug for xulrunner information].]]
+
{|
 +
|-
 +
| [[Image:dialog-information.png]]
 +
| '''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 <span><font face="monospace">esbox.sh</font></span> and PluThon with the script <span><font face="monospace">pluthon.sh</font></span> included in the archives. Otherwise, Eclipse will fail to start and/or will have erratic UI. See [http://mou.me.uk/2009/10/31/fixing-eclipse-in-ubuntu-9-10-karmic-koala/ this post for GTK+ details] and [http://mou.me.uk/2009/10/31/fixing-eclipse-in-ubuntu-9-10-karmic-koala/ this bug for xulrunner information].
 +
|}
-
==== Windows/x86 ====
+
=== Windows/x86 ===
ESbox archives:
ESbox archives:
-
* <code>esbox_2.0.0-R20091216-common.zip</code>
+
* <span><font face="monospace">esbox_2.0.0-R20091216-common.zip</font></span>
-
* <code>esbox_2.0.0-R20091216-win32.win32.x86.zip</code>
+
* <span><font face="monospace">esbox_2.0.0-R20091216-win32.win32.x86.zip</font></span>
PluThon archives:
PluThon archives:
-
* <code>pluthon_2.0.0-R20091216-common.zip</code>
+
* pluthon_2.0.0-R20091216-common.zip
-
* <code>pluthon_2.0.0-R20091216-win32.win32.x86.zip</code>
+
* <span><font face="monospace">pluthon_2.0.0-R20091216-win32.win32.x86.zip</font></span>
-
==== Mac OS X/Intel ====
+
=== Mac OS X/Intel ===
ESbox archives:
ESbox archives:
-
* <code>esbox_2.0.0-R20091216-common.zip</code>
+
* <span><font face="monospace">esbox_2.0.0-R20091216-common.zip</font></span>
-
* <code>esbox_2.0.0-R20091216-macosx.carbon.x86.zip</code>
+
* <span><font face="monospace">esbox_2.0.0-R20091216-macosx.carbon.x86.zip</font></span>
PluThon archives:
PluThon archives:
-
* <code>pluthon_2.0.0-R20091216-common.zip</code>
+
* pluthon_2.0.0-R20091216-common.zip
-
* <code>pluthon_2.0.0-R20091216-macosx.carbon.x86.zip</code>
+
* <span><font face="monospace">pluthon_2.0.0-R20091216-macosx.carbon.x86.zip</font></span>
-
=== Installing and Running ===
+
== Installing and Running ==
-
Extract and install the archives for your operating system: Unzip the <code>*-common.zip</code> and <code>*-&lt;host OS&gt;.zip</code> archive into the same directory of your choice.
+
Extract and install the archives for your operating system: Unzip the <span><font face="monospace"><nowiki>*-common.zip</nowiki></font></span> and <span><font face="monospace"><nowiki>*-&lt;host OS&gt;.zip</nowiki></font></span> archive into the same directory of your choice.
-
If you use a Sun Java JRE, you can edit <code>esbox.ini</code> or <code>pluthon.ini</code> to adjust maximum memory usage (<code>-Xmx</code>, <code>-XX:MaxPermSize</code>).
+
If you use a Sun Java JRE, you can edit <span><font face="monospace">esbox.ini</font></span> or <span><font face="monospace">pluthon.ini</font></span> to adjust maximum memory usage (<span><font face="monospace">-Xmx</font></span>, <span><font face="monospace">-XX:MaxPermSize</font></span>).
Run the main executable or script:
Run the main executable or script:
; '''Linux'''
; '''Linux'''
-
: <code>./esbox.sh</code> or <code>./pluthon.sh</code>
+
: <span><font face="monospace">./esbox.sh</font></span> or <span><font face="monospace">./pluthon.sh</font></span>
; '''Win32'''
; '''Win32'''
-
: <code>./esbox.exe</code> or <code>./pluthon.exe</code>
+
: <span><font face="monospace">./esbox.exe</font></span> or <span><font face="monospace">./pluthon.exe</font></span>
; '''Mac OS X'''
; '''Mac OS X'''
: <span><font face="monospace">./esbox.app/Contents/MacOS/esbox</font></span> or <span><font face="monospace">./pluthon.app/Contents/MacOS/esbox</font></span>
: <span><font face="monospace">./esbox.app/Contents/MacOS/esbox</font></span> or <span><font face="monospace">./pluthon.app/Contents/MacOS/esbox</font></span>
-
== Installation via Maemo Update Site ==
+
= 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.
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 ===
+
== Eclipse Installation ==
If you do not yet have Eclipse IDE installed, follow these instructions.
If you do not yet have Eclipse IDE installed, follow these instructions.
Line 101: Line 112:
* ...or visit the [http://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/ganymede/SR2/ Eclipse Ganymede SR2 Build page]. You must use Eclipse 3.4.2.
* ...or visit the [http://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/ganymede/SR2/ 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.
* 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 [[Documentation/Maemo 5 Developer Guide/Development Environment/Maemo SDK Virtual Images|Maemo SDK Virtual Image]] to run Maemo Eclipse development environment.
+
* 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 <code>/home/user</code> on Linux).
+
Extract the archive somewhere on your machine (for example <span><font face="monospace">/home/user</font></span> on Linux).
For Linux or Mac OS X:
For Linux or Mac OS X:
  $ cd /home/user
  $ cd /home/user
-
$ tar xvzf eclipse-cpp-ganymede-SR2-host-windowsystem.tar.gz
+
  $ tar xvzf eclipse-cpp-ganymede-SR2-host-windowsystem.tar.gz
or, for Win32, use Winzip or another zip utility to extract the archive.
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 <code>eclipse</code>, and is located in the <code>eclipse</code> sub-directory of the install:
+
Start Eclipse by running the Eclipse executable included with the release. The executable file is called <span><font face="monospace">eclipse</font></span>, and is located in the <span><font face="monospace">eclipse</font></span> sub-directory of the install:
  $ /home/user/eclipse/eclipse
  $ /home/user/eclipse/eclipse
Line 122: Line 133:
  $ GDK_NATIVE_WINDOWS=true /home/user/eclipse/eclipse -vmargs -Dorg.eclipse.swt.browser.XULRunnerPath=path...
  $ GDK_NATIVE_WINDOWS=true /home/user/eclipse/eclipse -vmargs -Dorg.eclipse.swt.browser.XULRunnerPath=path...
-
where <code>path...</code> is the path to xulrunner 1.8, usually under <code>/usr/lib/xulrunner/xulrunner</code> or <code>/usr/bin/xulrunner</code>. In Ubuntu this package is named <code>xulrunner</code>.
+
where <span><font face="monospace">path...</font></span> is the path to xulrunner 1.8, usually under <span><font face="monospace">/usr/lib/xulrunner/xulrunner</font></span> or <span><font face="monospace">/usr/bin/xulrunner</font></span>. In Ubuntu this package is named <span><font face="monospace">xulrunner</font></span>.
See [http://mou.me.uk/2009/10/31/fixing-eclipse-in-ubuntu-9-10-karmic-koala/ this post for GTK+ details] and [https://garage.maemo.org/tracker/index.php?func=detail&aid=4689&group_id=192&atid=1420 this bug for xulrunner information].
See [http://mou.me.uk/2009/10/31/fixing-eclipse-in-ubuntu-9-10-karmic-koala/ this post for GTK+ details] and [https://garage.maemo.org/tracker/index.php?func=detail&aid=4689&group_id=192&atid=1420 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 [https://garage.maemo.org/svn/mica/build/continuous_integration/esbox.sh this] <code>esbox.sh</code> script and for PluThon, use [https://garage.maemo.org/svn/mica/build/continuous_integration/pluthon.sh this] <code>pluthon.sh</code> script to launch Eclipse IDE.
+
For the sake of convenience, there are ready made scripts available to use for ESbox and PluThon that implement this workaround. For ESbox, use [https://garage.maemo.org/svn/mica/build/continuous_integration/esbox.sh this] <span><font face="monospace">esbox.sh</font></span> script and for PluThon, use [https://garage.maemo.org/svn/mica/build/continuous_integration/pluthon.sh this] <span><font face="monospace">pluthon.sh</font></span> script to launch Eclipse IDE.
For more detailed information about Eclipse 3.4 environment, see the [http://www.eclipse.org/eclipse/development/readme_eclipse_3.4.2.html Eclipse 3.4.2 Project Release Notes].
For more detailed information about Eclipse 3.4 environment, see the [http://www.eclipse.org/eclipse/development/readme_eclipse_3.4.2.html Eclipse 3.4.2 Project Release Notes].
-
=== ESbox and PluThon Installation ===
+
== ESbox and PluThon Installation ==
Verify that your network proxy is configured (if needed) in '''Window &gt; Preferences &gt; General &gt; Network Connections'''.
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 [[#fig-esbox_update_menu|3.1]].
+
Select '''Help &gt; Software Updates...''' from the main menu bar, figure [[#fig:update_site_update_menu|3.1]].
These instructions given are for ESbox installation through the Maemo Update Site, but can also be applied for the PluThon installation.
These instructions given are for ESbox installation through the Maemo Update Site, but can also be applied for the PluThon installation.
-
<div id="fig-esbox_update_menu">
+
 
-
[[Image:esbox-update-menu.png|frame|center|alt=unknown|'''Figure 3.1:''' Software Updates]]
+
 
-
</div>
+
{| summary="Software Updates"
 +
|+ align="BOTTOM" |'''Figure 3.1:''' Software Updates
 +
|-
 +
|
 +
[[Image:esbox-update-menu.png|Image esbox-update-menu]]
 +
|}
 +
 
 +
 
Select the '''Available Software''' tab, figure [[#fig:update_site_update_available|3.2]].
Select the '''Available Software''' tab, figure [[#fig:update_site_update_available|3.2]].
-
<div id="fig-esbox_update_available">
+
 
-
[[Image:esbox-update-available.png|frame|center|alt=unknown|'''Figure 3.2:''' Software Updates and Add-ons]]
+
 
-
</div>
+
{| summary="Software Updates and Add-ons"
 +
|+ align="BOTTOM" |'''Figure 3.2:''' Software Updates and Add-ons
 +
|-
 +
|
 +
[[Image:esbox-update-available.png|Image esbox-update-available]]
 +
|}
 +
 
 +
 
Add three update sites via '''Add site....'''
Add three update sites via '''Add site....'''
-
* ESbox update site is: http://maemoide.nokia.com/updates/2.0/esbox figure [[#fig-update_site_add_esbox|3.3]].
+
* ESbox update site is: <span><font face="monospace">http://maemoide.nokia.com/updates/2.0/esbox</font></span>, figure [[#fig:update_site_add_esbox|3.3]].
-
* PluThon update site is: http://maemoide.nokia.com/updates/2.0/pluthon
+
* PluThon update site is: <span><font face="monospace">http://maemoide.nokia.com/updates/2.0/pluthon</font></span>.
-
* Mica update site is: http://maemoide.nokia.com/updates/2.0/mica figure [[#fig:update_site_add_mica|3.4]].
+
* Mica update site is: <span><font face="monospace">http://maemoide.nokia.com/updates/2.0/mica</font></span>, figure [[#fig:update_site_add_mica|3.4]].
Example how to add ESbox update site:
Example how to add ESbox update site:
-
<div id="fig-update_site_add_esbox">
+
 
-
[[Image:esbox-update-site-add-esbox.png|frame|center|alt=unknown|'''Figure 3.3:''' Update Site, Add ESbox]]
+
 
-
</div>
+
{| summary="Update Site, Add ESbox"
 +
|+ align="BOTTOM" |'''Figure 3.3:''' Update Site, Add ESbox
 +
|-
 +
|
 +
[[Image:esbox-update-site-add-esbox.png|Image esbox-update-site-add-esbox]]
 +
|}
 +
 
 +
 
Example how to add Mica update site:
Example how to add Mica update site:
-
<div id="fig-update_site_add_mica">
+
 
-
[[Image:esbox-update-site-add-mica.png|frame|center|alt=unknown|'''Figure 3.4:''' Update Site, Add Mica]]
+
 
-
</div>
+
{| summary="Update Site, Add Mica"
 +
|+ align="BOTTOM" |'''Figure 3.4:''' Update Site, Add Mica
 +
|-
 +
|
 +
[[Image:esbox-update-site-add-mica.png|Image esbox-update-site-add-mica]]
 +
|}
 +
 
 +
 
Mica is a generic framework named Maemo IDE Common Architecture underneath the ESbox and PluThon products.
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 [[#fig-update_site_selection|3.5]].
+
Open the '''ESbox''' (or '''PluThon''') tree and select '''ESbox 2nd Edition''' (or '''PluThon 2nd Edition''') inside, then click '''Install''', figure [[#fig:update_site_selection|3.5]].
 +
 
 +
 
 +
 
 +
{| summary="Software Updates and Add-ons, ESbox 2nd Edition"
 +
|+ align="BOTTOM" |'''Figure 3.5:''' Software Updates and Add-ons, ESbox 2nd Edition
 +
|-
 +
|
 +
[[Image:esbox-update-selection.png|Image esbox-update-selection]]
 +
|}
 +
 
-
<div id="fig-update_site_selection">
 
-
[[Image:esbox-update-selection.png|frame|center|alt=unknown|'''Figure 3.5:''' Software Updates and Add-ons, ESbox 2nd Edition]]
 
-
</div>
 
You can select the '''ESbox 2nd Edition Source''', '''PluThon 2nd Edition Source''' and '''Mica 2nd Edition Source''' as well as following the [http://mica.garage.maemo.org/2nd_edition/setup.html Mica development setup instructions] if you want to develop against ESbox or PluThon.
You can select the '''ESbox 2nd Edition Source''', '''PluThon 2nd Edition Source''' and '''Mica 2nd Edition Source''' as well as following the [http://mica.garage.maemo.org/2nd_edition/setup.html Mica development setup instructions] if you want to develop against ESbox or PluThon.
-
Verify the installed items, then click '''Next''', figure [[#fig-update_site_install|3.6]].
+
Verify the installed items, then click '''Next''', figure [[#fig:update_site_install|3.6]].
-
<div id="fig-update_site_install">
 
-
[[Image:esbox-update-install.png|frame|center|alt=unknown|'''Figure 3.6:''' Install]]
 
-
</div>
 
-
Review the licenses, then click '''Next''', figure [[#fig-update_site_install_licenses|3.7]].
 
-
<div id="fig-update_site_install_licenses">
+
{| summary="Install"
 +
|+ align="BOTTOM" |'''Figure 3.6:''' Install
 +
|-
 +
|
 +
[[Image:esbox-update-install.png|Image esbox-update-install]]
 +
|}
 +
 
 +
 
 +
 
 +
Review the licenses, then click '''Next''', figure [[#fig:update_site_install_licenses|3.7]].
 +
 
 +
 
 +
 
 +
{| summary="Review licenses"
 +
|+ align="BOTTOM" |'''Figure 3.7:''' Review licenses
 +
|-
 +
|
[[Image:esbox-update-install-licenses.png|Image esbox-update-install-licenses]]
[[Image:esbox-update-install-licenses.png|Image esbox-update-install-licenses]]
-
</div>
+
|}
 +
 
 +
 
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.
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 [[#fig-update_site_restart|3.8]].
+
Click '''Finish''' and the installation will be performed. Accept the offer to restart Eclipse, figure [[#fig:update_site_restart|3.8]].
 +
 
 +
 
 +
 
 +
{| summary="Restart Eclipse"
 +
|+ align="BOTTOM" |'''Figure 3.8:''' Restart Eclipse
 +
|-
 +
|
 +
[[Image:esbox-update-restart.png|Image esbox-update-restart]]
 +
|}
 +
 
-
<div id="fig-update_site_restart">
 
-
[[Image:esbox-update-restart.png|frame|center|alt=unknown|'''Figure 3.8:''' Restart Eclipse]]
 
-
</div>
 
-
=== Updating from an earlier than R2.0.0 release ===
+
== 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.
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 [[#fig-update_site_update_menu_2|3.9]].
+
Select '''Help &gt; Software Updates...''' from the main menu bar, figure [[#fig:update_site_update_menu_2|3.9]].
-
<div id="fig-update_site_update_menu_2">
 
-
[[Image:esbox-update-menu.png|frame|center|alt=unknown|'''Figure 3.9:''' Software Updates]]
 
-
</div>
 
-
If you installed directly from a repository archive (<code>*.zip</code>) file, rather than from the web, follow the below steps first:
+
 
 +
{| summary="Software Updates"
 +
|+ align="BOTTOM" |'''Figure 3.9:''' Software Updates
 +
|-
 +
|
 +
[[Image:esbox-update-menu.png|Image esbox-update-menu]]
 +
|}
 +
 
 +
 
 +
 
 +
If you installed directly from a repository archive (<span><font face="monospace"><nowiki>*.zip</nowiki></font></span>) file, rather than from the web, follow the below steps first:
# Select the '''Available Software''' tab.
# Select the '''Available Software''' tab.
# Click the '''Manage Repositories...''' button.
# Click the '''Manage Repositories...''' button.
-
# Remove the old archive entries (<code>esbox-repository*.zip</code>, <code>pluthon-repository*.zip</code>, <code>mica-repository*.zip</code>)
+
# Remove the old archive entries (<span><font face="monospace">esbox-repository*.zip</font></span>, <span><font face="monospace">pluthon-repository*.zip</font></span>, <span><font face="monospace">mica-repository*.zip</font></span>)
# Add new update sites through '''Add site...''' pointing to the new repository archives.
# Add new update sites through '''Add site...''' pointing to the new repository archives.
-
Select the '''Installed Software''' tab, figure [[#fig-update_site_update_installed|3.10]].
+
Select the '''Installed Software''' tab, figure [[#fig:update_site_update_installed|3.10]].
 +
 
 +
 
 +
 
 +
{| summary="Installed Software"
 +
|+ align="BOTTOM" |'''Figure 3.10:''' Installed Software
 +
|-
 +
|
 +
[[Image:esbox-update-installed.png|Image esbox-update-installed]]
 +
|}
 +
 
-
<div id="fig-update_site_update_installed">
 
-
[[Image:esbox-update-installed.png|frame|center|alt=unknown|'''Figure 3.10:''' Installed Software]]
 
-
</div>
 
Click the '''Update...''' button.
Click the '''Update...''' button.
Line 223: Line 304:
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).
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 [[#fig-update_site_update_available_2|3.11]].
+
Verify that ESbox, PluThon and Mica features are listed and checked, then click '''Next''', figure [[#fig:update_site_update_available_2|3.11]].
-
<div id="fig-update_site_update_available_2">
 
-
[[Image:esbox-update-available-2.png|frame|center|alt=unknown|'''Figure 3.11:''' Available Updates]]
 
-
</div>
 
-
Review the licenses, then click '''Next''', figure [[#fig-update_site_update_licenses|3.12]].
 
-
<div id="fig-update_site_update_licenses">
+
{| summary="Available Updates"
-
[[Image:esbox-update-install-licenses.png|frame|center|alt=unknown|'''Figure 3.12:''' Review licenses]]
+
|+ align="BOTTOM" |'''Figure 3.11:''' Available Updates
-
</div>
+
|-
 +
|
 +
[[Image:esbox-update-available-2.png|Image esbox-update-available-2]]
 +
|}
-
Click '''Finish''' and the update is performed. Accept the offer to restart Eclipse, figure [[#fig-update_site_restart_2|3.13]].
 
-
<div id="fig-update_site_restart_2">
 
-
[[Image:esbox-update-restart.png|'''Figure 3.13:''' Restart Eclipse]]
 
-
</div>
 
-
=== Troubleshooting ===
+
Review the licenses, then click '''Next''', figure [[#fig:update_site_update_licenses|3.12]].
 +
 
 +
 
 +
 
 +
{| summary="Review licenses"
 +
|+ align="BOTTOM" |'''Figure 3.12:''' Review licenses
 +
|-
 +
|
 +
[[Image:esbox-update-install-licenses.png|Image esbox-update-install-licenses]]
 +
|}
 +
 
 +
 
 +
 
 +
Click '''Finish''' and the update is performed. Accept the offer to restart Eclipse, figure [[#fig:update_site_restart_2|3.13]].
 +
 
 +
 
 +
 
 +
{| summary="Restart Eclipse"
 +
|+ align="BOTTOM" |'''Figure 3.13:''' Restart Eclipse
 +
|-
 +
|
 +
[[Image:esbox-update-restart.png|Image esbox-update-restart]]
 +
|}
 +
 
 +
 
 +
 
 +
== Troubleshooting ==
 +
 
 +
If you see this dialog: figure [[#fig:update_site_can_not_complete|3.14]]
 +
 
 +
 
 +
 
 +
{| summary="Cannot complete the request"
 +
|+ align="BOTTOM" |'''Figure 3.14:''' Cannot complete the request
 +
|-
 +
|
 +
[[Image:esbox-update-cannot-complete.png|Image esbox-update-cannot-complete]]
 +
|}
-
If you see this dialog: figure [[#fig-update_site_cannot_complete|3.14]]
 
-
<div id="fig-update_site_cannot_complete">
 
-
[[Image:esbox-update-cannot-complete.png|frame|center|alt=unknown|'''Figure 3.14:''' Cannot complete the request]]
 
-
</div>
 
followed by this dialog: figure [[#fig:update_site_already_installed|3.15]]
followed by this dialog: figure [[#fig:update_site_already_installed|3.15]]
-
<div id="fig-update_site_already_installed">
+
 
-
[[Image:esbox-update-already-installed.png|'''Figure 3.15:''' Cannot complete the request, details]]
+
 
-
</div>
+
{| summary="Cannot complete the request, details"
 +
|+ align="BOTTOM" |'''Figure 3.15:''' Cannot complete the request, details
 +
|-
 +
|
 +
[[Image:esbox-update-already-installed.png|Image esbox-update-already-installed]]
 +
|}
 +
 
 +
 
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.
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.
Line 263: Line 379:
until Eclipse is reinstalled from the current location.
until Eclipse is reinstalled from the current location.
-
== Installing Help Content ==
+
= 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.
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 ===
+
== 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 [http://maemoide.nokia.com/ Maemo Info Center service].
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 [http://maemoide.nokia.com/ Maemo Info Center service].
Line 275: Line 391:
You need to configure the Maemo Info Center to use the Maemo 5 Fremantle SDK help inside Eclipse:
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 [[#fig-update_site_help_infocenter_prefs|3.16]].
+
Open the '''Help &gt; Content''' preference page, figure [[#fig:update_site_help_infocenter_prefs|3.16]].
-
<div id="fig-update_site_help_infocenter_prefs">
 
-
[[Image:help-infocenter-prefs.png|frame|center|alt=unknown|'''Figure 3.16:''' Help Content Preferences]]
 
-
</div>
 
-
Add a Maemo Info Center site, noting to update the host (no <code>http://</code> prefix) and the path, which is Maemo platform specific (<code>/fremantle</code> for Maemo 5 Fremantle release), figure [[#fig-update_site_help_infocenter_prefs_add|3.17]].
 
-
<div id="fig-update_site_help_infocenter_prefs_add">
+
{| summary="Help Content Preferences"
-
[[Image:help-infocenter-prefs-add.png|frame|center|alt=unknown|'''Figure 3.17:''' Edit Maemo Docs Library Information]]
+
|+ align="BOTTOM" |'''Figure 3.16:''' Help Content Preferences
-
</div>
+
|-
 +
|
 +
[[Image:help-infocenter-prefs.png|Image help-infocenter-prefs]]
 +
|}
 +
 
 +
 
 +
 
 +
Add a Maemo Info Center site, noting to update the host (no <span><font face="monospace">http://</font></span> prefix) and the path, which is Maemo platform specific (<span><font face="monospace">/fremantle</font></span> for Maemo 5 Fremantle release), figure [[#fig:update_site_help_infocenter_prefs_add|3.17]].
 +
 
 +
 
 +
 
 +
{| summary="Edit Maemo Docs Library Information"
 +
|+ align="BOTTOM" |'''Figure 3.17:''' Edit Maemo Docs Library Information
 +
|-
 +
|
 +
[[Image:help-infocenter-prefs-add.png|Image help-infocenter-prefs-add]]
 +
|}
 +
 
 +
 
Then, use '''Help &gt; Content''' and you will see the entries under '''Maemo 5''' categories.
Then, use '''Help &gt; Content''' and you will see the entries under '''Maemo 5''' categories.
-
=== Local Content ===
+
== 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.
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.
Line 299: Line 429:
Verify that your network proxy is configured (if needed) in '''Window &gt; Preferences &gt; General &gt; Network Connections'''.
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 [[#fig-update_site_help_pluthon_update_menu|3.18]].
+
Select '''Help &gt; Software Updates...''' from the main menu bar, figure [[#fig:update_site_help_pluthon_update_menu|3.18]].
-
<div id="fig-update_site_help_pluthon_update_menu">
 
-
[[Image:pluthon-update-menu.png|frame|center|alt=unknown|'''Figure 3.18:''' Software Updates...]]
 
-
</div>
 
-
Select the '''Available Software''' tab, figure [[#fig-update_site_help_update_available|3.19]].
 
-
<div id="fig-update_site_help_update_available">
+
{| summary="Software Updates..."
-
[[Image:help-update-available.png|frame|center|alt=unknown|'''Figure 3.19:''' Software Updates and Add-ons]]
+
|+ align="BOTTOM" |'''Figure 3.18:''' Software Updates...
-
</div>
+
|-
 +
|
 +
[[Image:pluthon-update-menu.png|Image pluthon-update-menu]]
 +
|}
-
Add a Documentation update site via '''Add site....'''. Maemo Fremantle documentation update site is http://maemoide.nokia.com/downloads/fremantle/ figure [[#fig-update_site_help_update_site_add|3.20]].
 
-
<div id="fig-update_site_help_update_site_add">
 
-
[[Image:help-update-site-add.png|'''Figure 3.20:''' Update Site - Add Documentation]]
 
-
</div>
 
-
Select one or more of the '''Maemo ... Help''' features and then click ''''''Install, figure [[#fig-update_site_help_update_selection|3.21]].
+
Select the '''Available Software''' tab, figure [[#fig:update_site_help_update_available|3.19]].
-
<div id="fig-update_site_help_update_selection">
 
-
[[Image:help-update-selection.png|frame|center|alt=unknown|'''Figure 3.21:''' Software Updates and Add-Ons, Selection]]
 
-
</div>
 
-
Verify the installed items, then click '''Next''', figure [[#fig-update_site_help_update_install|3.22]].
 
-
<div id="fig-update_site_help_update_install">
+
{| summary="Software Updates and Add-ons"
-
[[Image:help-update-install.png|frame|center|alt=unknown|'''Figure 3.22:''' Confirm Installation]]
+
|+ align="BOTTOM" |'''Figure 3.19:''' Software Updates and Add-ons
-
</div>
+
|-
 +
|
 +
[[Image:help-update-available.png|Image help-update-available]]
 +
|}
 +
 
 +
 
 +
 
 +
Add a Documentation update site via '''Add site....'''. Maemo Fremantle documentation update site is <span><font face="monospace">http://maemoide.nokia.com/downloads/fremantle/</font></span>, figure [[#fig:update_site_help_update_site_add|3.20]].
 +
 
 +
 
 +
 
 +
{| summary="Update Site - Add Documentation"
 +
|+ align="BOTTOM" |'''Figure 3.20:''' Update Site - Add Documentation
 +
|-
 +
|
 +
[[Image:help-update-site-add.png|Image help-update-site-add]]
 +
|}
 +
 
 +
 
 +
 
 +
Select one or more of the '''Maemo ... Help''' features and then click ''''''Install, figure [[#fig:update_site_help_update_selection|3.21]].
 +
 
 +
 
 +
 
 +
{| summary="Software Updates and Add-Ons, Selection"
 +
|+ align="BOTTOM" |'''Figure 3.21:''' Software Updates and Add-Ons, Selection
 +
|-
 +
|
 +
[[Image:help-update-selection.png|Image help-update-selection]]
 +
|}
 +
 
 +
 
 +
 
 +
Verify the installed items, then click '''Next''', figure [[#fig:update_site_help_update_install|3.22]].
 +
 
 +
 
 +
 
 +
{| summary="Confirm Installation"
 +
|+ align="BOTTOM" |'''Figure 3.22:''' Confirm Installation
 +
|-
 +
|
 +
[[Image:help-update-install.png|Image help-update-install]]
 +
|}
 +
 
 +
 
Review the licenses, then click '''Next''', figure [[#fig:update_site_help_update_install_licenses|3.23]].
Review the licenses, then click '''Next''', figure [[#fig:update_site_help_update_install_licenses|3.23]].
 +
 +
{| summary="Accept Licenses"
{| summary="Accept Licenses"
Line 338: Line 505:
|}
|}
-
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 [[#fig-update_site_help_pluthon_update_restart|3.24]].
 
-
<div id="fig-update_site_help_pluthon_update_restart">
 
-
[[Image:pluthon-update-restart.png|frame|center|alt=unknown|'''Figure 3.24:''' Apply Changes Or Restart]]
 
-
</div>
 
-
[[Category:Documentation]]
+
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 [[#fig:update_site_help_pluthon_update_restart|3.24]].
-
[[Category:Eclipse]]
+
 
 +
 
 +
 
 +
{| summary="Apply Changes Or Restart"
 +
|+ align="BOTTOM" |'''Figure 3.24:''' Apply Changes Or Restart
 +
|-
 +
|
 +
[[Image:pluthon-update-restart.png|Image pluthon-update-restart]]
 +
|}
 +
 
 +
 
 +
== References ==
 +
<references />

Learn more about Contributing to the wiki.


Please note that all contributions to maemo.org wiki may be edited, altered, or removed by other contributors. If you do not want your writing to be edited mercilessly, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource (see maemo.org wiki:Copyrights for details). Do not submit copyrighted work without permission!


Cancel | Editing help (opens in new window)