Editing Documentation/Maemo Eclipse Tutorial/Installing ESbox

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.

Learn more about Contributing to the wiki.

ESbox is an [http://www.eclipse.org/ Eclipse-based] IDE. It is based on Eclipse Ganymede (3.4.2) and CDT (Eclipse C/C++ Development Toolkit) and PyDev (Python IDE for Eclipse) and provides C/C++, Qt4 and Python support, source editing, project building, run/debug/profiling, and Debian installation package creation and deployment. ESbox communicates transparently with Scratchbox cross-compilation environment and one or more Maemo SDKs to let you develop Maemo applications. ESbox can also flash your Maemo devices and communicate with them using the various network clients and servers available with the PC Connectivity project.

With ESbox, Scratchbox, Maemo SDK(s), and PC Connectivity installed, you can flash your Maemo device, run, debug, and profile applications locally with Maemo SDK and remotely with Maemo device, create Debian installation packages for your application and install the application to 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>.

== ESbox IDE ==

ESbox may be installed completely from an archive or added to an existing Eclipse 3.4.2 installation from Maemo update sites.

ESbox may be installed in a variety of hosts. The "Supported Environments" chapter [[#Supported Environments]] describes these. The "Installing ESbox IDE" section [[#Installing ESbox IDE]] describes how to install ESbox.

=== Supported Maemo Releases ===

The supported [http://tablets-dev.nokia.com/ Maemo releases] are:

* Maemo 4.1.2 Diablo (OS2008) with N800, N810 and N810 WiMAX Edition devices
* Maemo 5.0 Fremantle (OS2009) with N900 device

{{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.
}}

==== Scratchbox and Maemo SDK ====

To build and run C/C++, Qt4 or Python applications you will need to install the Maemo SDK development environment for a Linux/x86 machine (either to your host PC or to the Maemo SDK Virtual Image).

Scratchbox enables building and running programs in a transparent cross-compilation and cross-execution environment. Scratchbox 1 is the primary cross environment for Maemo Fremantle and Diablo development.

{ambox
|text=Scratchbox 2 is a newer cross compilation environment but it is not officially supported or tested for Fremantle or ESbox.
}}

Maemo SDKs supported by ESbox and Scratchbox 1 are:

* Maemo 4.1.2 Diablo SDK
* Maemo 5.0.x Fremantle SDK

{{ambox
|text=Older Maemo SDKs may work but are not officially supported.
}}

Maemo SDKs are open-source, but some components installed on the Maemo device and available to the Maemo SDK rootstraps are closed-source. These Nokia closed binaries must be installed for Fremantle SDKs to operate properly under emulation.

ESbox can install Scratchbox 1, Diablo and Fremantle Maemo SDKs, and Nokia closed binaries for you for native Linux host PC or to the Ubuntu Server SDK Virtual Image using installation wizards under '''File &gt; New &gt; Other &gt; Maemo Installers'''.

=== ESbox Development Environment ===

The ESbox development environment consists of Eclipse IDE, Scratchbox, one or more Maemo SDKs and Maemo device. If host PC operating system is not able to run Scratchbox and Maemo SDK natively also Maemo SDK Virtual Image is needed. These are essential to ESbox development environment and ESbox is useless without them.

ESbox does not ship with Scratchbox or any Maemo SDK, but it includes installation wizards that allow you to install them. See '''File &gt; New &gt; Other &gt; Maemo Installers &gt; Scratchbox 1''' and '''... &gt; Scratchbox 1 Targets'''.

If you want to install Scratchbox and Maemo SDKs yourself, see [http://maemo.org/development/sdks/ the Maemo SDK site] for more information.

For C/C++, Qt4 and Python development, you need to install some Maemo C debugging tools and scripts, Maemo C++ bindings, Maemo Python runtime and bindings and Maemo Qt4 libraries to the Maemo SDK rootstraps and Maemo device.

ESbox provides a command via '''Project &gt; Validate Installed Packages''' menu which will do all needed installations for C/C++, Python and Qt4 development environemnts for you. This validation operation is done also automatically when you create a new C/C++, Python or Qt4 project.

==== Using Maemo SDK Virtual Image for non-Linux ====

Only Debian based Linux/x86 hosts are able to natively run Scratchbox and Maemo SDKs. In other hosts, you must run Scratchbox and the Maemo SDK inside a Maemo SDK Virtual Image. ESbox fully supports using Maemo virtual images and VMware, VirtualBox or QEMU virtualization technologies in this manner.

The Maemo Eclipse integration provides an empty Ubuntu Server based Maemo SDK Virtual Image suitable for use with VMware, VirtualBox, and QEMU. See the [http://maemovmware.garage.maemo.org/ Maemo SDK Virtual Image project page] for more information on configuring and installing Maemo SDK Virtual Images.

You will need to configure ESbox to use the chosen virtualization environment (see chapter [/node8.html#sec:esbox_installation_setting_up_esbox_using_a_virtual_machine 6.1]) so that ESbox knows where to install Scratchbox and the Maemo SDKs.

The "Supported Environments" chapter [[#Supported Environments]] describes the virtualization technologies supported. For ESbox, you can install a Ubuntu Server based Maemo SDK Virtual Image using installation wizard '''File &gt; New &gt; Other &gt; Maemo Installers &gt; Maemo SDK Virtual Image'''. Installation wizard will install the whole Maemo Development environment with Scratchbox and Maemo SDK for you.

== Supported Environments ==

=== Host Operating Systems Supported ===

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

{| class="wikitable"
|+ Table 5.1: Host Operating Systems Supported for ESbox
|-
! Host Operating System
! Officially Supported
! Virtual Image Required
! Tested
! Note
|-
| Ubuntu 8.04 Hardy
| Yes
| No
| Yes
|
|-
| Ubuntu 8.10 Intrepid
| Yes
| No
| Yes
|
|-
| Ubuntu 9.04 Jaunty
| Yes
| No
| Yes
|
|-
| Ubuntu 9.10 Karmic
| Yes
| No
| Yes
| 3
|-
| Fedora 11/12
| No
| Yes
| Yes
| 1,3
|-
| Other Linux distros
| No
| Yes
| No
| 1,2
|-
| Windows XP SP3
| Yes
| Yes
| Yes
|
|-
| Windows Vista SP2
| No
| Yes
| Yes
| 2
|-
| Windows 7
| No
| Yes
| Yes
| 2
|-
| Mac OS X x86 Leopard
| Yes
| Yes
| Yes
|
|-
| Mac OS X x86 Snow Leopard
| Yes
| Yes
| Yes
|
|-
| Mac OS X PPC Leopard
| No
| Yes
| No
| 1,2
|}

; '''Note 1'''
: ESbox should work if Eclipse IDE, Maemo SDK Virtual Image and Host PC Connectivity runs properly (there are known problems in this OS).
; '''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 esbox.sh 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.
}}

=== Virtual Image environments supported ===

Maemo SDK Virtual Images support VMware, VirtualBox and QEMU virtualization technologies to use to run images. You can use technology that is the best for your host PC configuration. The recommended technology is VMware because its performance is much better than QEMU and its licensing policy is better than VirtualBox with its PUEL license that allows only personal usage for evaluation purposes.

==== VMware Player / Workstation / Server ====

Workstation or Server recommended for easiest configuration. With VMware Player, if you want to reconfigure the memory size or change the disk assignments, you need to hand-edit <nowiki>*.vmx</nowiki> files. With Player, you may not be able to use official VMware Tools to accelerate the virtualization performance (because official VMware Tools may not be delivered together with the VMware Player installation) but you need to install Open VM Tools delivered together with the Maemo SDK Virtual Image.

Installation of official VMware tools or Open VM Tools (delivered with Maemo SDK Virtual Image) is recommended for better performance.

VMware Player 3.0 includes official VMware Tools and e.g. memory size can be configured without hand-editing <nowiki>*.vmx</nowiki> but it may have SSH connection problems. VMware Player version 2.5 is recommended over version 3.0 because 3.0 version may have problems also keeping SSH connection alive. For Mac OS X VMware Fusion must be used instead of VMware Player.

==== Sun VirtualBox 2.2 or Newer ====

VirtualBox performance is almost egual to VMware and configuration is easy, but VirtualBox Open Source version cannot be used because it does not have good enough support for USB and licensing of PUEL version restricts usage only for personal and evaluation purposes.

Installation of GuestAdditions (delivered with Maemo SDK Virtual Image) is recommended for better performance.

==== QEMU System Emulation ====

Works, but is not recommended. The performance is quite slow.

Installation of KQEMU QEMU Accelerator for QEMU is almost mandatory, if it is available for your operating system.

=== X Servers supported ===

When running or debugging locally during development, an X11 server runs on the Eclipse host PC and displays your programs in the Maemo Application Framework.

X servers are available on all supported operating systems, but the Fremantle SDK imposes some high requirements on the X server. Linux-on-Linux development will yield the best results (both quality and performance wise). On other operating systems, there are workarounds for known issues.

For Linux:

* The Xephyr X server is recommended.
* Installation for Debian Linux: sudo apt-get install xserver-xephyr
* Installation for Fedora Linux: sudo yum install xorg-x11-xserver-Xephyr

For Windows:

* The X server from the Cygwin/X project is recommended.
* See chapter [/node8.html#sec:esbox_installation_setting_up_x_server_on_windows 6.3.1] for more details.

For Mac OS X:

* The Xephyr X server is recommended. This runs natively in Quartz.
* See chapter [/node8.html#sec:esbox_installation_setting_up_x_server_on_mac_os_x 6.3.2] for more details.

== Installing ESbox IDE ==

=== Java Runtime ===

ESbox is an Eclipse application, which needs Java to run.

Eclipse 3.4.2 requires Java 1.5 or newer:

* [http://java.sun.com/javase/downloads/index_jdk5.jsp Sun Java 5.0] or [http://java.sun.com/javase/downloads/index.jsp Sun Java 6]
* [http://www.ibm.com/developerworks/java/jdk/index.html IBM JRE 5.0+]
* [http://openjdk.java.net/ OpenJDK 6+]

You can find these JREs as packages in your distribution or download them directly from their websites.

=== Method 1: Full Product Archive (recommended) ===

* ESbox is distributed as a full Eclipse product archive, which contains Eclipse, the Mica framework, and ESbox. This is the easiest way to ensure you have the right versions of the plugins and features.
* Download it, extract it, and get started! Follow these instructions [/node5.html#sec:eclipse_tutorial_installation_product_archives 3.2]

=== Method 2: Eclipse Update Site ===

* If you have a custom Eclipse 3.4.2 installation or want to build one, you can use the Eclipse Software Updates mechanism to download and install and upgrade ESbox and Mica from the Internet.
* Newer versions of Eclipse than 3.4.x are not supported due to hard dependencies for Eclipse packages being used.
* Follow these instructions [/node5.html#sec:eclipse_tutorial_installation_via_update_site 3.3]

{{ambox
|text=Both the installation via the Full Product Archive and the Eclipse Update Site can be upgraded using Eclipse's Software Updates.
}}

== References ==

[[Category:Documentation]]
[[Category:Eclipse]]

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!

Summary:

Cancel | Editing help (opens in new window)

Templates used on this page:

Template:Ambox (view source) (semi-protected)

Retrieved from "http://wiki.maemo.org/Documentation/Maemo_Eclipse_Tutorial/Installing_ESbox"

Personal tools

Navigation

Views

Editing Documentation/Maemo Eclipse Tutorial/Installing ESbox

@@ Line 3: / Line 3: @@
 With ESbox, Scratchbox, Maemo SDK(s), and PC Connectivity installed, you can flash your Maemo device, run, debug, and profile applications locally with Maemo SDK and remotely with Maemo device, create Debian installation packages for your application and install the application to 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 [[Documentation/Maemo PC Connectivity Tutorial|'Maemo PC Connectivity Tutorial]].
+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>.
 == ESbox IDE ==
@@ Line 9: / Line 9: @@
 ESbox may be installed completely from an archive or added to an existing Eclipse 3.4.2 installation from Maemo update sites.
-ESbox may be installed in a variety of hosts. The [[#Supported Environments|Supported Environments]] chapter describes these. The [[#Installing ESbox IDE|Installing ESbox IDE]] section describes how to install ESbox.
+ESbox may be installed in a variety of hosts. The "Supported Environments" chapter [[#Supported Environments]] describes these. The "Installing ESbox IDE" section [[#Installing ESbox IDE]] describes how to install ESbox.
 === Supported Maemo Releases ===
@@ Line 15: / Line 15: @@
 The supported [http://tablets-dev.nokia.com/ Maemo releases] are:
-* [[Open development/Maemo roadmap/Diablo|Maemo 4.1.2 Diablo]] (OS2008) with N800, N810 and N810 WiMAX Edition devices
+* Maemo 4.1.2 Diablo (OS2008) with N800, N810 and N810 WiMAX Edition devices
-* [[Open development/Maemo roadmap/Fremantle|Maemo 5.0 Fremantle]] (OS2009) with N900 device
+* Maemo 5.0 Fremantle (OS2009) with N900 device
 {{ambox
@@ Line 28: / Line 28: @@
 Scratchbox enables building and running programs in a transparent cross-compilation and cross-execution environment. Scratchbox 1 is the primary cross environment for Maemo Fremantle and Diablo development.
-{{ambox
+{ambox
 |text=Scratchbox 2 is a newer cross compilation environment but it is not officially supported or tested for Fremantle or ESbox.
 }}
@@ Line 63: / Line 63: @@
 The Maemo Eclipse integration provides an empty Ubuntu Server based Maemo SDK Virtual Image suitable for use with VMware, VirtualBox, and QEMU. See the [http://maemovmware.garage.maemo.org/ Maemo SDK Virtual Image project page] for more information on configuring and installing Maemo SDK Virtual Images.
-You will need to configure ESbox to use the chosen virtualization environment (see the chapter on [[Documentation/Maemo Eclipse Tutorial/Setting Up ESbox#Setting up Maemo SDK Virtual Image|setting up ESBox within a virtual machine]]) so that ESbox knows where to install Scratchbox and the Maemo SDKs.
+You will need to configure ESbox to use the chosen virtualization environment (see chapter [/node8.html#sec:esbox_installation_setting_up_esbox_using_a_virtual_machine 6.1]) so that ESbox knows where to install Scratchbox and the Maemo SDKs.
-The [[#Supported Environments|Supported Environments]] chapter  describes the virtualization technologies supported. For ESbox, you can install a Ubuntu Server based Maemo SDK Virtual Image using installation wizard '''File &gt; New &gt; Other &gt; Maemo Installers &gt; Maemo SDK Virtual Image'''. Installation wizard will install the whole Maemo Development environment with Scratchbox and Maemo SDK for you.
+The "Supported Environments" chapter [[#Supported Environments]] describes the virtualization technologies supported. For ESbox, you can install a Ubuntu Server based Maemo SDK Virtual Image using installation wizard '''File &gt; New &gt; Other &gt; Maemo Installers &gt; Maemo SDK Virtual Image'''. Installation wizard will install the whole Maemo Development environment with Scratchbox and Maemo SDK for you.
 == Supported Environments ==
@@ Line 71: / Line 71: @@
 === Host Operating Systems Supported ===
-Supported operating systems for host PC are listed in table 5.1. Only 32-bit operating systems are supported and tested, for example Maemo does not provide official support for any 64-bit operating system.
+Supported operating systems for host PC are listed in table 5.1. Only 32-bit operating systems are supported and tested, e.g. Maemo does not provide official support for any 64-bit operating system.
 {| class="wikitable"
@@ Line 172: / Line 172: @@
 ==== VMware Player / Workstation / Server ====
-Workstation or Server recommended for easiest configuration. With VMware Player, if you want to reconfigure the memory size or change the disk assignments, you need to hand-edit <codei>*.vmx</code> files. With Player, you may not be able to use official VMware Tools to accelerate the virtualization performance (because official VMware Tools may not be delivered together with the VMware Player installation) but you need to install Open VM Tools delivered together with the Maemo SDK Virtual Image.
+Workstation or Server recommended for easiest configuration. With VMware Player, if you want to reconfigure the memory size or change the disk assignments, you need to hand-edit <span><font face="monospace"><nowiki>*.vmx</nowiki></font></span> files. With Player, you may not be able to use official VMware Tools to accelerate the virtualization performance (because official VMware Tools may not be delivered together with the VMware Player installation) but you need to install Open VM Tools delivered together with the Maemo SDK Virtual Image.
 Installation of official VMware tools or Open VM Tools (delivered with Maemo SDK Virtual Image) is recommended for better performance.
-VMware Player 3.0 includes official VMware Tools and for example memory size can be configured without hand-editing <code>*.vmx</code> but it may have SSH connection problems. VMware Player version 2.5 is recommended over version 3.0 because 3.0 version may have problems also keeping SSH connection alive. For Mac OS X VMware Fusion must be used instead of VMware Player.
+VMware Player 3.0 includes official VMware Tools and e.g. memory size can be configured without hand-editing <span><font face="monospace"><nowiki>*.vmx</nowiki></font></span> but it may have SSH connection problems. VMware Player version 2.5 is recommended over version 3.0 because 3.0 version may have problems also keeping SSH connection alive. For Mac OS X VMware Fusion must be used instead of VMware Player.
 ==== Sun VirtualBox 2.2 or Newer ====
-VirtualBox performance is almost equal to VMware and configuration is easy, but VirtualBox Open Source version cannot be used because it does not have good enough support for USB and licensing of PUEL version restricts usage only for personal and evaluation purposes.
+VirtualBox performance is almost egual to VMware and configuration is easy, but VirtualBox Open Source version cannot be used because it does not have good enough support for USB and licensing of PUEL version restricts usage only for personal and evaluation purposes.
 Installation of GuestAdditions (delivered with Maemo SDK Virtual Image) is recommended for better performance.
@@ Line 199: / Line 199: @@
 * The Xephyr X server is recommended.
-* Installation for Debian Linux: <code>sudo apt-get install xserver-xephyr</code>
+* Installation for Debian Linux: <span><font face="monospace">sudo apt-get install xserver-xephyr</font></span>
-* Installation for Fedora Linux: <code>sudo yum install xorg-x11-xserver-Xephyr</code>
+* Installation for Fedora Linux: <span><font face="monospace">sudo yum install xorg-x11-xserver-Xephyr</font></span>
 For Windows:
@@ Line 233: / Line 233: @@
 * ESbox is distributed as a full Eclipse product archive, which contains Eclipse, the Mica framework, and ESbox. This is the easiest way to ensure you have the right versions of the plugins and features.
-* Download it, extract it, and get started! Follow the instructions for [[Documentation/Maemo Eclipse Tutorial/Installation Methods#Installation via Product Archives|installation via product archives]]
+* Download it, extract it, and get started! Follow these instructions [/node5.html#sec:eclipse_tutorial_installation_product_archives 3.2]
 === Method 2: Eclipse Update Site ===
@@ Line 239: / Line 239: @@
 * If you have a custom Eclipse 3.4.2 installation or want to build one, you can use the Eclipse Software Updates mechanism to download and install and upgrade ESbox and Mica from the Internet.
 * Newer versions of Eclipse than 3.4.x are not supported due to hard dependencies for Eclipse packages being used.
-* Follow the instructions for [[Documentation/Maemo Eclipse Tutorial/Installation Methods#Installation via Maemo Update Site|installation via the Maemo Update site]]
+* Follow these instructions [/node5.html#sec:eclipse_tutorial_installation_via_update_site 3.3]
 {{ambox
 |text=Both the installation via the Full Product Archive and the Eclipse Update Site can be upgraded using Eclipse's Software Updates.
 }}
+== References ==
+<references />
 [[Category:Documentation]]
 [[Category:Eclipse]]