Documentation/Maemo Eclipse Tutorial/Installing PluThon

m (1 revision)
(wikify slightly, add links)
 
(3 intermediate revisions not shown)
Line 1: Line 1:
-
 
-
= Installing PluThon =
 
-
 
PluThon is an [http://www.eclipse.org Eclipse-based IDE] that provides Python development support, source editing, project building, on-device run/debug/profiling as well as on-device Debian installation package creation and deployment. It is based on Eclipse Ganymede (3.4.2) and PyDev (Python IDE for Eclipse). PluThon communicates with your Maemo device using the various network clients and servers that Maemo PC Connectivity project provides.
PluThon is an [http://www.eclipse.org Eclipse-based IDE] that provides Python development support, source editing, project building, on-device run/debug/profiling as well as on-device Debian installation package creation and deployment. It is based on Eclipse Ganymede (3.4.2) and PyDev (Python IDE for Eclipse). PluThon communicates with your Maemo device using the various network clients and servers that Maemo PC Connectivity project provides.
With PluThon and Maemo PC Connectivity installed, you can flash your Maemo device, run, debug, and profile Python applications on Maemo devices. You can also create Debian installation packages for your application and install the application on the Maemo device.
With PluThon and Maemo PC Connectivity installed, you can flash your Maemo device, run, debug, and profile Python applications on Maemo devices. You can also create Debian installation packages for your application and install the application on the Maemo device.
-
Maemo PC Connectivity must be installed to the Maemo device and host PC before all features provided by Maemo Eclipse IDE are usable. See more information from ''Maemo PC Connectivity Tutorial'' <ref name=r2>Maemo PC Connectivity Tutorial. http://library.maemodocs.nokia.com</ref>.
+
Maemo PC Connectivity must be installed to the Maemo device and host PC before all features provided by Maemo Eclipse IDE are usable. See more information from [[Documentation/Maemo PC Connectivity Tutorial|Maemo PC Connectivity Tutorial]].
-
= PluThon IDE =
+
== PluThon IDE ==
You can install PluThon completely from an archive or add it to an existing Eclipse 3.4.2 installation through Maemo update sites.
You can install PluThon completely from an archive or add it to an existing Eclipse 3.4.2 installation through Maemo update sites.
-
You can install PluThon on a variety of hosts. The "Supported Environments" section [[#Supported Environments]] describes the supported hosts. The "Installing PluThon IDE" section [[#Installing PluThon IDE]] describes how to install PluThon.
+
You can install PluThon on a variety of hosts. The [[#Supported Environments|Supported Environments]] section describes the supported hosts. The [[#Installing PluThon IDE|Installing PluThon IDE]] section  describes how to install PluThon.
-
== Supported Maemo Releases ==
+
=== Supported Maemo Releases ===
The supported [http://tablets-dev.nokia.com/ Maemo releases] are:
The supported [http://tablets-dev.nokia.com/ Maemo releases] are:
-
* Maemo 4.1.2 Diablo (OS2008) with N800, N810, and N810 WiMAX Edition
+
* [[Open development/Maemo roadmap/Diablo|Maemo 4.1.2 Diablo]] (OS2008) with N800, N810, and N810 WiMAX Edition
-
* Maemo 5.0 Fremantle (OS2009) with N900
+
* [[Open development/Maemo roadmap/Fremantle|Maemo 5.0 Fremantle]] (OS2009) with N900
-
{|
+
{{ambox
-
|-
+
|text=Older releases may work but Maemo PC Connectivity is not supported on them. If you use older releases, you must manually set up networking, SSH, and SBRSH.}}
-
| [[Image:dialog-information.png]]
+
-
| '''Note:'''  Older releases may work but Maemo PC Connectivity is not supported on them. If you use older releases, you must manually set up networking, SSH, and SBRSH.
+
-
|}
+
-
== PluThon Development Environment ==
+
=== PluThon Development Environment ===
The PluThon development environment consists of Eclipse IDE and a Maemo device. These are essential and you cannot use PluThon without them.
The PluThon development environment consists of Eclipse IDE and a Maemo device. These are essential and you cannot use PluThon without them.
Line 37: Line 31:
Python runtime and bindings libraries must be installed on the Maemo device. To install these, select '''Project &gt; Validate Installed Packages'''. This validation operation is also done automatically when you create a new Python project.
Python runtime and bindings libraries must be installed on the Maemo device. To install these, select '''Project &gt; Validate Installed Packages'''. This validation operation is also done automatically when you create a new Python project.
-
= Supported Environments =
+
== Supported Environments ==
-
== Host Operating Systems Supported ==
+
=== Host Operating Systems Supported ===
-
Supported operating systems for host PC are listed in table 4.1. Only 32-bit operating systems are supported and tested, e.g. Maemo does not provide official support for any 64-bit operating system.
+
Supported operating systems for host PC are listed in table [[#table-pluthon_supported_operating_systems|4.1]]. Only 32-bit operating systems are supported and tested, for example Maemo does not provide official support for any 64-bit operating system.
-
 
+
<div id="table-pluthon_supported_operating_systems">
-
 
+
{| class="wikitable"
-
 
+
|+ Table 4.1: Host Operating Systems Supported for Pluthon
-
 
+
-
{| border="1" cellpadding="3"
+
-
|+ '''Table 4.1:''' Host Operating Systems Supported for Pluthon
+
|-
|-
-
! width="200" align="LEFT" valign="TOP" | '''Host Operating System'''
+
! Host Operating System
-
! width="75" align="LEFT" valign="TOP" | '''Officially Supported'''
+
! Officially Supported
-
! width="50" align="LEFT" valign="TOP" | '''Tested'''
+
! Tested
-
! width="50" align="LEFT" valign="TOP" | '''Note'''
+
! Note
|-
|-
-
| width="200" align="LEFT" valign="TOP" | Ubuntu 8.04 Hardy
+
| Ubuntu 8.04 Hardy
-
| width="75" align="LEFT" valign="TOP" | Yes
+
| Yes
-
| width="50" align="LEFT" valign="TOP" | Yes
+
| Yes
-
| width="50" align="LEFT" valign="TOP" |
+
|
|-
|-
-
| width="200" align="LEFT" valign="TOP" | Ubuntu 8.10 Intrepid
+
| Ubuntu 8.10 Intrepid
-
| width="75" align="LEFT" valign="TOP" | Yes
+
| Yes
-
| width="50" align="LEFT" valign="TOP" | Yes
+
| Yes
-
| width="50" align="LEFT" valign="TOP" |
+
|
|-
|-
-
| width="200" align="LEFT" valign="TOP" | Ubuntu 9.04 Jaunty
+
| Ubuntu 9.04 Jaunty
-
| width="75" align="LEFT" valign="TOP" | Yes
+
| Yes
-
| width="50" align="LEFT" valign="TOP" | Yes
+
| Yes
-
| width="50" align="LEFT" valign="TOP" |
+
|
|-
|-
-
| width="200" align="LEFT" valign="TOP" | Ubuntu 9.10 Karmic
+
| Ubuntu 9.10 Karmic
-
| width="75" align="LEFT" valign="TOP" | Yes
+
| Yes
-
| width="50" align="LEFT" valign="TOP" | Yes
+
| Yes
-
| width="50" align="LEFT" valign="TOP" | 3
+
| 3
|-
|-
-
| width="200" align="LEFT" valign="TOP" | Fedora 11/12
+
| Fedora 11/12
-
| width="75" align="LEFT" valign="TOP" | No
+
| No
-
| width="50" align="LEFT" valign="TOP" | Yes
+
| Yes
-
| width="50" align="LEFT" valign="TOP" | 1,3
+
| 1,3
|-
|-
-
| width="200" align="LEFT" valign="TOP" | Other Linux distros
+
| Other Linux distros
-
| width="75" align="LEFT" valign="TOP" | No
+
| No
-
| width="50" align="LEFT" valign="TOP" | No
+
| No
-
| width="50" align="LEFT" valign="TOP" | 1,2
+
| 1,2
|-
|-
-
| width="200" align="LEFT" valign="TOP" | Windows XP SP3
+
| Windows XP SP3
-
| width="75" align="LEFT" valign="TOP" | Yes
+
| Yes
-
| width="50" align="LEFT" valign="TOP" | Yes
+
| Yes
-
| width="50" align="LEFT" valign="TOP" |
+
|
|-
|-
-
| width="200" align="LEFT" valign="TOP" | Windows Vista SP2
+
| Windows Vista SP2
-
| width="75" align="LEFT" valign="TOP" | No
+
| No
-
| width="50" align="LEFT" valign="TOP" | Yes
+
| Yes
-
| width="50" align="LEFT" valign="TOP" | 2
+
| 2
|-
|-
-
| width="200" align="LEFT" valign="TOP" | Windows 7
+
| Windows 7
-
| width="75" align="LEFT" valign="TOP" | No
+
| No
-
| width="50" align="LEFT" valign="TOP" | Yes
+
| Yes
-
| width="50" align="LEFT" valign="TOP" | 2
+
| 2
|-
|-
-
| width="200" align="LEFT" valign="TOP" | Mac OS X x86 Leopard
+
| Mac OS X x86 Leopard
-
| width="75" align="LEFT" valign="TOP" | Yes
+
| Yes
-
| width="50" align="LEFT" valign="TOP" | Yes
+
| Yes
-
| width="50" align="LEFT" valign="TOP" |
+
|
|-
|-
-
| width="200" align="LEFT" valign="TOP" | Mac OS X x86 Snow Leopard
+
| Mac OS X x86 Snow Leopard
-
| width="75" align="LEFT" valign="TOP" | Yes
+
| Yes
-
| width="50" align="LEFT" valign="TOP" | Yes
+
| Yes
-
| width="50" align="LEFT" valign="TOP" |
+
|
|-
|-
-
| width="200" align="LEFT" valign="TOP" | Mac OS X PPC Leopard
+
| Mac OS X PPC Leopard
-
| width="75" align="LEFT" valign="TOP" | No
+
| No
-
| width="50" align="LEFT" valign="TOP" | No
+
| No
-
| width="50" align="LEFT" valign="TOP" | 1,2
+
| 1,2
|}
|}
-
 
-
 
; '''Note 1'''
; '''Note 1'''
Line 123: Line 112:
: The Host PC Connectivity has not been fully ported to this OS causing restrictions to the supported functionality.
: The Host PC Connectivity has not been fully ported to this OS causing restrictions to the supported functionality.
; '''Note 3'''
; '''Note 3'''
-
: On newer Linux distributions, some components like GTK+ and xulrunner have changed in ways that make Eclipse difficult to launch. You need to use provided <span><font face="monospace">pluthon.sh</font></span> script to launch ESbox and work around the issues.
+
: On newer Linux distributions, some components like GTK+ and xulrunner have changed in ways that make Eclipse difficult to launch. You need to use provided <code>pluthon.sh</code> script to launch ESbox and work around the issues.
-
{|
+
{{ambox
-
|-
+
|text=Cygwin 1.5 is part of Host PC Connectivity for Windows and works fine in Maemo environment but supports only Windows XP. Cygwin 1.7 which supports also Windows 7 and Windows Vista has problems with X11 server preventing Maemo to fully supporting Windows 7 and Windows Vista operatring systems.
-
| [[Image:dialog-information.png]]
+
}}
-
| '''Note:'''  Cygwin 1.5 is part of Host PC Connectivity for Windows and works fine in Maemo environment but supports only Windows XP. Cygwin 1.7 which supports also Windows 7 and Windows Vista has problems with X11 server preventing Maemo to fully supporting Windows 7 and Windows Vista operatring systems.
+
-
|}
+
-
= Installing PluThon IDE =
+
== Installing PluThon IDE ==
-
== Java Runtime ==
+
=== Java Runtime ===
Eclipse 3.4.2 requires Java 1.5 or newer:
Eclipse 3.4.2 requires Java 1.5 or newer:
Line 141: Line 128:
* [http://openjdk.java.net/ OpenJDK 6+]
* [http://openjdk.java.net/ OpenJDK 6+]
-
{|
+
{{ambox
-
|-
+
|text=GNU gcj is not supported.
-
| [[Image:dialog-information.png]]
+
}}
-
| '''Note:'''  GNU gcj is not supported.
+
-
|}
+
These JREs are available as packages in your distribution or you can download them directly from the above websites.
These JREs are available as packages in your distribution or you can download them directly from the above websites.
-
== Method 1: Full Product Archive (Recommended) ==
+
=== Method 1: Full Product Archive (Recommended) ===
* PluThon is distributed as a full Eclipse product archive that contains Eclipse, the Mica framework, and PluThon. This is the easiest way to ensure you have the right versions of the plugins and features.
* PluThon is distributed as a full Eclipse product archive that contains Eclipse, the Mica framework, and PluThon. This is the easiest way to ensure you have the right versions of the plugins and features.
-
* Download the product archive, extract it, and get started. Follow these instructions [/node5.html#sec:eclipse_tutorial_installation_product_archives 3.2]
+
* Download the product archive, extract it, and get started. Follow the instructions for [[Documentation/Maemo Eclipse Tutorial/Installation Methods#Installation via Product Archives|installation via the Maemo Update site]]
-
== Method 2: Eclipse Update Site ==
+
=== Method 2: Eclipse Update Site ===
* If you already have a custom Eclipse 3.4.2 installation or want to build one, you can use the Eclipse Software Updates mechanism to download, install and upgrade PluThon and Mica from the Internet.
* If you already have a custom Eclipse 3.4.2 installation or want to build one, you can use the Eclipse Software Updates mechanism to download, install and upgrade PluThon and Mica from the Internet.
* Newer versions of Eclipse than 3.4.x are not supported because of the hard dependencies on the Eclipse packages used.
* Newer versions of Eclipse than 3.4.x are not supported because of the hard dependencies on the Eclipse packages used.
-
* Follow these instructions [/node5.html#sec:eclipse_tutorial_installation_via_update_site 3.3]
+
* Follow the instructions for [[Documentation/Maemo Eclipse Tutorial/Installation Methods#Installation via Maemo Update Site|installation via the Maemo Update site]]
-
 
+
-
{|
+
-
|-
+
-
| [[Image:dialog-information.png]]
+
-
| '''Note:'''  You can upgrade the installation (done either using Full Product Archive or the Eclipse Update Site) through Eclipse Software Updates.
+
-
|}
+
-
 
+
 +
{{ambox
 +
|text=You can upgrade the installation (done either using Full Product Archive or the Eclipse Update Site) through Eclipse Software Updates.
 +
}}
-
== References ==
+
[[Category:Documentation]]
-
<references />
+
[[Category:Eclipse]]

Latest revision as of 10:41, 15 September 2010

PluThon is an Eclipse-based IDE that provides Python development support, source editing, project building, on-device run/debug/profiling as well as on-device Debian installation package creation and deployment. It is based on Eclipse Ganymede (3.4.2) and PyDev (Python IDE for Eclipse). PluThon communicates with your Maemo device using the various network clients and servers that Maemo PC Connectivity project provides.

With PluThon and Maemo PC Connectivity installed, you can flash your Maemo device, run, debug, and profile Python applications on Maemo devices. You can also create Debian installation packages for your application and install the application on the Maemo device.

Maemo PC Connectivity must be installed to the Maemo device and host PC before all features provided by Maemo Eclipse IDE are usable. See more information from Maemo PC Connectivity Tutorial.

Contents

[edit] PluThon IDE

You can install PluThon completely from an archive or add it to an existing Eclipse 3.4.2 installation through Maemo update sites.

You can install PluThon on a variety of hosts. The Supported Environments section describes the supported hosts. The Installing PluThon IDE section describes how to install PluThon.

[edit] Supported Maemo Releases

The supported Maemo releases are:

Image:Ambox_notice.png
Older releases may work but Maemo PC Connectivity is not supported on them. If you use older releases, you must manually set up networking, SSH, and SBRSH.

[edit] PluThon Development Environment

The PluThon development environment consists of Eclipse IDE and a Maemo device. These are essential and you cannot use PluThon without them.

Even though PluThon deploys applications that run entirely on a device, you need a Python interpreter installed locally to support the editor and the run/debug mechanism in PyDev.

It is recommended that you use the same version of Python that is on the Maemo device, currently Python 2.5. For more information, see the instructions at Python 2.5.4 official release. PluThon configures PyDev to read the library sources of the host for code completion. If you are not concerned about differences, you can also install Python 2.4 or 2.6 on the host.

Python runtime and bindings libraries must be installed on the Maemo device. To install these, select Project > Validate Installed Packages. This validation operation is also done automatically when you create a new Python project.

[edit] Supported Environments

[edit] Host Operating Systems Supported

Supported operating systems for host PC are listed in table 4.1. Only 32-bit operating systems are supported and tested, for example Maemo does not provide official support for any 64-bit operating system.

Table 4.1: Host Operating Systems Supported for Pluthon
Host Operating System Officially Supported Tested Note
Ubuntu 8.04 Hardy Yes Yes
Ubuntu 8.10 Intrepid Yes Yes
Ubuntu 9.04 Jaunty Yes Yes
Ubuntu 9.10 Karmic Yes Yes 3
Fedora 11/12 No Yes 1,3
Other Linux distros No No 1,2
Windows XP SP3 Yes Yes
Windows Vista SP2 No Yes 2
Windows 7 No Yes 2
Mac OS X x86 Leopard Yes Yes
Mac OS X x86 Snow Leopard Yes Yes
Mac OS X PPC Leopard No No 1,2
Note 1
PluThon should work if Eclipse IDE and Host PC Connectivity runs properly.
Note 2
The Host PC Connectivity has not been fully ported to this OS causing restrictions to the supported functionality.
Note 3
On newer Linux distributions, some components like GTK+ and xulrunner have changed in ways that make Eclipse difficult to launch. You need to use provided pluthon.sh script to launch ESbox and work around the issues.
Image:Ambox_notice.png
Cygwin 1.5 is part of Host PC Connectivity for Windows and works fine in Maemo environment but supports only Windows XP. Cygwin 1.7 which supports also Windows 7 and Windows Vista has problems with X11 server preventing Maemo to fully supporting Windows 7 and Windows Vista operatring systems.

[edit] Installing PluThon IDE

[edit] Java Runtime

Eclipse 3.4.2 requires Java 1.5 or newer:

Image:Ambox_notice.png
GNU gcj is not supported.

These JREs are available as packages in your distribution or you can download them directly from the above websites.

[edit] Method 1: Full Product Archive (Recommended)

  • PluThon is distributed as a full Eclipse product archive that contains Eclipse, the Mica framework, and PluThon. This is the easiest way to ensure you have the right versions of the plugins and features.
  • Download the product archive, extract it, and get started. Follow the instructions for installation via the Maemo Update site

[edit] Method 2: Eclipse Update Site

  • If you already have a custom Eclipse 3.4.2 installation or want to build one, you can use the Eclipse Software Updates mechanism to download, install and upgrade PluThon and Mica from the Internet.
  • Newer versions of Eclipse than 3.4.x are not supported because of the hard dependencies on the Eclipse packages used.
  • Follow the instructions for installation via the Maemo Update site
Image:Ambox_notice.png
You can upgrade the installation (done either using Full Product Archive or the Eclipse Update Site) through Eclipse Software Updates.