[Esbox-commits] r2425 - www/2nd_edition
eswartz at garage.maemo.org
eswartz at garage.maemo.org
Thu Nov 19 07:09:23 EET 2009
Author: eswartz
Date: 2009-11-19 07:09:13 +0200 (Thu, 19 Nov 2009)
New Revision: 2425
Modified:
www/2nd_edition/installation.html
Log:
Move JRE installation to top of installation instructions
Modified: www/2nd_edition/installation.html
===================================================================
--- www/2nd_edition/installation.html 2009-11-19 04:49:04 UTC (rev 2424)
+++ www/2nd_edition/installation.html 2009-11-19 05:09:13 UTC (rev 2425)
@@ -1,697 +1,544 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml"><head>
-
-
-
-
- <script></script>
-
-
-
-
-
-
-
-
- <meta http-equiv="content-type" content="text/html; charset=utf-8"><title>Installation</title>
-
-
-
-
-
-
-
-
-
-
-
-
- <meta name="description" content="">
-
-
-
-
-
-
-
-
- <meta name="keywords" content="esbox installation">
-
-
-
-
-
-
-
-
- <link href="css/main.css" rel="stylesheet" type="text/css">
-
-
-
-
-
-
-
-
- <link rel="shortcut icon" href="images/favicon.ico"></head><body>
-
-<script type="text/javascript">
- var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
- document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
- </script>
-
-<script type="text/javascript">
- var pageTracker = _gat._getTracker("UA-2565700-2");
- pageTracker._initData();
- pageTracker._trackPageview();
- </script>
-
-<div id="header">
- <span id="img"><a href="index.html"><img src="images/marca.jpg" alt="logo"></a></span>
- <ul id="menu">
- <li><a href="index.html">home</a></li>
- <li><a href="features.html">features</a></li>
- <li><a href="releases.html">releases</a></li>
- <li><a href="documentation.html">documentation</a></li>
- <li class="active"><a href="#">installation</a></li>
- <li><a href="contributing.html">contributing</a></li>
- </ul>
- </div>
-
-
-
-
-
-<div id="banner">
- <div class="wrap">
- <div id="box">
- </div>
- </div>
- </div>
-
-
-
-
-
-<div class="wrap">
-
-<div id="container">
-<div id="content">
-
-<div style="float: right;">
-ESbox is part of <a href="http://maemo.org/development/documentation/ide_integration/" target="_blank">Maemo IDE Integration</a>
-</div>
-
-<h2 id="installation">INSTALLATION</h2>
-<div style="font-size: 14px;">
-<ul>
- <li><a href="#overview">Overview</a></li>
-
- <li><a href="#supported">Supported environments</a></li>
-<li><a href="#getting">Installing ESbox IDE<br>
-</a></li>
-
-<li><a href="#devenv">Development Environment</a>
- <ul>
- <li><a href="#devenv_vm">Virtual machine images</a></li>
- <li><a href="#devenv_maemosdk">Scratchbox and Maemo SDK</a></li>
- <li><a href="#devenv_xserver">X Server</a></li>
- </ul>
- </li>
-<li><a href="#pcconn">PC Connectivity</a></li>
- <li><a href="#sdkdocs">Maemo SDK Help Content</a><br>
- </li>
-
-</ul>
-</div>
-<p>
-</p>
-
-
-
-<p id="overview">
-</p>
-<div id="group">
-
-<h3 id="heading">Overview
-</h3>
-<p>
-ESbox is an <a href="http://www.eclipse.org/">Eclipse-based</a>
-IDE.
-It is based on Eclipse Ganymede (3.4.2) and provides C/C++ and Python
-support, source editing, project building, run/debug/profiling, and
-Debian package deployment. ESbox communicates transparently with
-Scratchbox and one or more Maemo SDKs, available separately, to let you
-develop Maemo applications. ESbox can also update the image on
-your Maemo devices and communicate with them using the various network
-clients and servers available
-with the PC Connectivity project.<br>
-</p>
-<p>With ESbox, Scratchbox, Maemo SDK(s), and PC Connectivity installed,
-you can run, debug, and profile locally under emulator running in an X
-server, and also deploy the application to a Maemo device (N800, N810)
-to run, debug, and profile on hardware.
-</p>
-
-
-<h3>ESbox IDE</h3>
-
-<p>ESbox may be installed completely from an archive or added to
-an existing Eclipse 3.4.2 installation from our update sites.
-</p>
-<p>
-ESbox may be installed in a variety of hosts. The "Supported Environments"
-sections describes these. The "Installing ESbox IDE" section describes
-how to find and install ESbox.</p>
-
-<h3>Virtual machine
-
-</h3>
-
-<p>Only Linux/x86 hosts natively run Scratchbox and Maemo SDKs.
-In other hosts, you must run Scratchbox and the Maemo SDK inside a
-Linux/x86 virtual machine. ESbox supports using virtual machines
-in this manner.
-</p>
-<p>The "Supported Environments"
-sections describes the VM engines supported.
-</p>
-<p>In ESbox, you can install a server virtual image using <strong>File > New > Other > Maemo Installers > Maemo SDK Virtual Image</strong>.</p>
-
-
-<h3>Development Environment
-</h3>
-<p>The development environment consists of Scratchbox and one or more
-Maemo SDKs. These are essential to Maemo development environment
-and ESbox is useless without them. </p>
-<p>ESbox does not ship with Scratchbox or any Maemo SDK, but<span style="font-style: italic;"> </span>it includes wizards that allow you to install them. See <strong>File > New > Other > Maemo Installers > Scratchbox 1 </strong>and<strong> ... > Scratchbox 1 Targets</strong>. <br>
-</p>
-<p>If you want to install these yourself, see <a href="http://maemo.org/development/sdks/">the Maemo SDK site</a> for more information.</p>
-<p>For Python development, you need an Python interpreter installed on the host machine in order to support the editor and
-the run/debug mechanism in PyDev. Typically you should use the same version of Python that is on the device,
-which is currently Python 2.5.
-See instructions at <a href="http://www.python.org/download/releases/2.5.4/" target="_blank">at Python 2.5.4 official release.</a> ESbox configures Pydev to read the host installation's library
-sources for code completion. If you're not concerned about differences here, a 2.4
-or 2.6 version may be installed on the host.
-
-</p>
-
-
-<h3>PC Connectivity</h3>
-<p>In order to re-flash your device or run, debug, profile, or install your
-application on device, use the PC Connectivity project. It provides
-convenient installation packages allowing you to use the Maemo flasher, ssh, sbrsh, NFS, rsync, avahi,
-etc. between your PC and your Maemo device. There is a host component (for the machine running Eclipse,
-and also for the virtual machine, if you have to use one) and a target
-component (for the device).
-</p>
-<p>The "Supported Environments"
-sections describes the Maemo releases and devices supported.
-</p>
-<p>Find the complete description and installation instructions on the
- <a href="http://pc-connectivity.garage.maemo.org/" target="_blank">PC connectivity project web site</a>.
-</p>
-
-</div>
-<p>
-</p>
-
-<p id="supported">
-</p>
-
-<div id="group">
-
-<h3 id="heading">Supported Environments
-</h3>
-
-<h3>Hosts supported</h3>
-
-<table style="border: 1px solid black; border-collapse: collapse; text-align: left; width: 100%;" cellpadding="2" cellspacing="2">
- <tbody>
- <tr style="border: 1px solid black; padding: 2px; background-color: rgb(238, 238, 136);">
- <th style="vertical-align: top;">Host
- </th>
- <th style="vertical-align: top;">Virtual Machine Required
- </th>
- <th style="vertical-align: top;">Supported?
- </th>
- <th style="vertical-align: top;">Tested?
- </th>
- </tr>
- <tr style="border: 1px solid black; padding: 2px; background-color: rgb(204, 255, 204);">
- <td style="vertical-align: top;">Ubuntu 8.04 Hardy, 8.10 Intrepid, 9.04 Jaunty (x86)
- </td>
- <td style="vertical-align: top;">No [3]
- </td>
- <td style="vertical-align: top;">Yes
- </td>
- <td style="vertical-align: top;">Yes
- </td>
- </tr>
- <tr style="border: 1px solid black; padding: 2px;">
- <td style="vertical-align: top;">Ubuntu 9.10 Karmic (x86) or other Linux/x86 distros
- </td>
- <td style="vertical-align: top;">No [3]
- </td>
- <td style="vertical-align: top;">Mostly [1] [5]
- </td>
- <td style="vertical-align: top;">Partially
- </td>
- </tr>
- <tr style="border: 1px solid black; padding: 2px;">
- <td style="vertical-align: top;">Other Linux
- </td>
- <td style="vertical-align: top;">Yes
- </td>
- <td style="vertical-align: top;">Maybe [2] [5]
- </td>
- <td style="vertical-align: top;">No
- </td>
- </tr>
- <tr style="border: 1px solid black; padding: 2px; background-color: rgb(204, 255, 204);">
- <td style="vertical-align: top;">Windows XP
- </td>
- <td style="vertical-align: top;">Yes
- </td>
- <td style="vertical-align: top;">Yes
-</td>
- <td style="vertical-align: top;">Yes
- </td>
- </tr>
- <tr style="border: 1px solid black; padding: 2px;">
- <td style="vertical-align: top;">Windows Vista/7
- </td>
- <td style="vertical-align: top;">Yes
- </td>
- <td style="vertical-align: top;">Yes
- </td>
- <td style="vertical-align: top;">Yes
- </td>
- </tr>
- <tr style="border: 1px solid black; padding: 2px; background-color: rgb(204, 255, 204);">
- <td style="vertical-align: top;">Mac OS X Intel
- </td>
- <td style="vertical-align: top;">Yes
- </td>
- <td style="vertical-align: top;">Yes
-</td>
- <td style="vertical-align: top;">Yes
- </td>
- </tr>
- <tr style="border: 1px solid black; padding: 2px;">
- <td style="vertical-align: top;">Mac OS X PPC
- </td>
- <td style="vertical-align: top;">Yes
- </td>
- <td style="vertical-align: top;">Maybe [2] [4]
- </td>
- <td style="vertical-align: top;">No
- </td>
- </tr>
- </tbody>
-</table>
-<p>
-[1] If the Scratchbox 1 and Maemo SDKs run properly, and Eclipse runs properly, then ESbox should work.
-</p>
-<p>
-[2] If Eclipse runs properly and virtual machine software runs properly, then ESbox should work.
-Note that gcj has a lot of problems with Eclipse, so we recommend using a Sun or IBM
-Java virtual machine.
-</p>
-<p>
-[3] But you may use a virtual machine, if you want.
-</p>
-<p>
-[4] The Host components of PC Connectivity have not been fully ported to this host.
-</p>
-<p>
-[5] On newer Linux distributions, some components like GTK+ and xulrunner have changed in ways that
-make Eclipse difficult to launch.
-Please use the provided <b><tt>esbox.sh</tt></b> script to launch ESbox and work around the issues.
-</p>
-
-<h3>Virtual machine engines supported</h3>
-
-<ul>
-<li>VMware Workstation / Server / Player
- <ul>
- <li>Workstation or Server recommended for easiest
-configuration. Otherwise you need to hand-edit *.vmx files and
-cannot use VMware Tools to accelerate the machine.
- </li>
- </ul>
-</li>
-<li>Sun VirtualBox 2.2 or newer
- <ul>
- <li>Performance is reasonable and configuration is easy, but it is not as fast as VMware.
- </li>
- </ul>
-</li>
-<li>QEMU system emulation
- <ul>
- <li>Not recommended, since even with Kqemu acceleration on
-Windows, the performance is quite slow. Without it, performance
-is awful.</li>
- </ul>
-</li>
-</ul>
-
-
-<h3>Maemo Releases supported</h3>
-
-
-<p>
-The <a href="http://tablets-dev.nokia.com/" target="_blank">Maemo releases</a> supported are:
-</p>
-
-<ul>
-<li>OS2008 Diablo</li><li>Maemo 5 Fremantle</li>
- <li class="note">Older releases may work, but PC Connectivity 2nd Edition is not supported on them;
- you must manually set up networking, SSH, and SBRSH.
- </li>
-</ul>
-
-
-
-<p>
-</p>
-
-</div>
-<p>
-</p>
-
-<p id="getting">
-</p>
-
-<div id="group">
-
-<h3 id="heading">Installing ESbox IDE<br>
-
-</h3>
-<h3><a href="installation_product.html">Method 1: Full Product Archive (recommended)</a></h3>
-
-
-
-
-<ul>
-<li>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.
-</li><li>Download it, extract it, and get started!
-<a href="installation_product.html">Follow these instructions</a>.
- </li>
-</ul>
-
-
-
-
-<p>
-
-</p>
-
-
-<h3><a href="installation_update_site.html">Method 2: Eclipse Update Site</a></h3>
-
-
-
-
-<ul>
-<li>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 Mica and ESbox from the Internet. <br>
-</li>
- <li>Newer versions of Eclipse are not supported due to hard dependencies on the CDT tooling being used.<br>
- </li>
- <li>Follow <a href="installation_update_site.html">these instructions</a>.</li>
-
-</ul>
-
-
-<p>
-
-
-<strong>NOTE: Both the installation via the Full Product Archive and
-the Eclipse Update Site can be upgraded using Eclipse's Software
-Updates.</strong>
-
-</p>
-
-<h3>Java runtime
-</h3>
-<p>
-ESbox is an Eclipse application, which needs Java to run.
-</p>
-
- <b>Eclipse 3.4.2 needs Java 1.5 or newer:</b>
- <ul>
- <li><a href="http://java.sun.com/javase/downloads/index_jdk5.jsp">Sun Java 5.0</a>
- or <a href="http://java.sun.com/javase/downloads/index.jsp">Sun Java 6</a>
- </li>
- <li><a href="http://www.ibm.com/developerworks/java/jdk/index.html">IBM JRE 5.0+</a></li>
- <li><a href="http://openjdk.java.net/">OpenJDK 6+</a></li>
- <li class="warning">GNU gcj is not supported</li>
- </ul>
-
- <p>
- You can find these JREs as packages in your distribution or download them directly from their
- websites.
- </p>
-
-</div>
-
-<p id="devenv">
-
-</p><div id="group">
-
-<h3 id="heading">Development Environment<br>
-</h3>
-
-
-<h3 id="devenv_vm">Virtual machine images (non-Linux)</h3>
-
-<p>If you are running ESbox outside of Linux/x86, you install the Scratchbox and Maemo components
-on a Linux/x86 virtual machine.
-</p>
-<p>
-The Maemo Eclipse Integration project provides Linux/x86 images suitable for use
-with VMware, VirtualBox, and QEMU.
-See the <a href="http://maemovmware.garage.maemo.org">Maemo SDK VM Image project page</a> for more information on configuring and installing virtual machines.
-</p>
-
-<div id="group"><ul>
-<li class="note">ESbox can install a Maemo SDK VM image for you
-using the wizard <strong>File > New > Other > Maemo Installers > Maemo SDK VM Image</strong>.
-</li></ul></div>
-
-
-<p>You will need to <a href="virtual_machines.html">configure ESbox to use the virtual machine</a> so that ESbox
-knows where to find or install Scratchbox and the Maemo SDKS.
-</p>
-
-<h3 id="devenv_maemosdk">Scratchbox and Maemo SDK</h3>
-<p>To build and run C/C++ or Python applications you will need to
-install the Maemo development environment in a Linux/x86 machine
-(either your host or a VM).
- </p>
-
-<ul>
-
- <li>Scratchbox
- <p>Scratchbox enables building and emulating programs
- in a transparent cross-compilation and cross-execution environment.
- </p>
- <ul>
- <li>Scratchbox 1 is the primary cross environment for Maemo development</li>
- <li class="note">Scratchbox 2 is a newer cross environment which overcomes several issues
- with Scratchbox 1, but it is not officially supported or tested in ESbox.</li>
- </ul>
-
- </li>
-
-
- <li>Maemo SDKs
-
-
- <ul><li>Maemo 4.1.x Diablo</li>
- <li>Maemo 5.0.x Fremantle
- <ul>
- <li><span style="font-weight: bold;">NOTE: </span>Fremantle SDKs require the Nokia closed binaries to function properly.
- </li>
- </ul>
- </li>
- <li class="note">Older SDKs (for either variant of Scratchbox) may work but are not supported.</li>
-
- </ul>
- </li>
-
- <li>Nokia closed binaries
- <p>Maemo SDKs are open-source, but some components installed on the device and available to the SDK are closed-source.
- These <b>must</b> be installed for Fremantle SDKs to operate properly under emulation.
- </p>
- </li>
-</ul>
-
-
-
-<div id="group"><ul>
-<li class="note">ESbox can install Scratchbox 1, Diablo/Fremantle
-Maemo SDKs, and Nokia closed binaries using wizards under <strong>File > New > Other > Maemo Installers</strong>.
-</li></ul></div>
-
-<h3 id="devenv_xserver">X Server</h3>
-
-<p>When running or debugging locally during development, an X11 server runs on the Eclipse host
-and displays your programs in the Maemo Application Framework
-(Maemo AF). </p>
-
-<p><b>NOTE:</b> X servers are available on all platforms, but the Fremantle SDK imposes some high
-requirements on the X server.
-Linux-on-Linux development will yield the best results (quality and performance).
-On other hosts, there are workarounds for known issues.
-</p>
-
-<ul>
-<li>Linux
- <ul>
- <li>The Xephyr nested server is recommended.</li>
- <li>In Debian Linux: <tt>sudo apt-get install xserver-xephyr</tt></li>
- <li>In Fedora Linux: <tt>sudo yum install xorg-x11-xserver-Xephyr</tt></li>
-</ul>
-</li>
-<li>Windows
-<ul>
- <li>We recommend using the X server from the Cygwin/X project.
- </li>
- <li>
-See <a href="installation_x_setup_windows.html">setup instructions here</a>.
- </li>
-</ul>
-</li>
-
-<li>Mac OS X
- <ul>
- <li>The Xephyr server is recommended. This runs natively in Quartz.</li>
- <li>
-See <a href="installation_x_setup_osx.html">setup instructions here</a>.
- </li>
- </ul>
-</li>
-</ul>
-
-</div>
-
-<p id="pcconn">
-</p>
-<div id="group">
-
-<h3 id="heading">PC Connectivity
-</h3>
-<p>
-In
-order to communicate with your Maemo device, a set of daemons and
-utilities are needed on the host and target to fully communicate with the Maemo device.
-</p>
-<h3>Host PC Connectivity</h3>
-<p>
-Host PC connectivity provides host-side software, like ssh
-and sbrsh clients, the Maemo flasher, rsync, FTP client, and the
-tightvnc viewer. These are packaged together conveniently for installation on Linux/x86,
-Windows, and Mac OS X Intel. </p>
-<p>
-
-Install the Host PC Connectivity
-package on the machine running Eclipse.
-</p>
-<p>
-<b>NOTE:</b> for non-Linux installations, you also need to install Host PC connectivity <span style="font-style: italic;">inside the VM</span> to use sbrsh.
-</p>
-
-<p>
- Find the complete details for both on the
- <a href="http://pc-connectivity.garage.maemo.org/" target="_blank">PC connectivity project web site</a>.
-</p>
-<p>
-</p>
-
-<h3>Target (Maemo) PC Connectivity
-</h3>
-<p>
-On the Maemo device, you need the other half of PC Connectivity, containing the servers that match the clients installed
-on the host side. The PC Connectivity requires either a Diablo and Fremantle release.
-</p>
-<div id="group"><ul><li class="note">ESbox can flash OS images onto your device using the <em>File > New > Other > Maemo Installers > Flash Images to Device</em>
-wizard.
-</li></ul></div>
-<p>Find the complete description and installation instructions on the
- <a href="http://pc-connectivity.garage.maemo.org" target="_blank">PC connectivity project web site</a>.
- </p>
-
- <p>
-
-</p>
-
-</div>
-
-
-
-
-
-
-<p id="sdkdocs">
-</p>
-<div id="group">
-
-<h3 id="heading">Maemo SDK Help Content</h3>
-
-<p>
-To finish the installation, see
-<a href="installation_help.html">instructions on installing the Maemo SDK documentation and offline hover help support</a>.
-</p>
-
-</div>
-
-
-
-<p>
-
-</p></div>
-
-<p>
-
-</p></div>
-
-
-<p style="text-align: right;"><a href="index.html" target="_parent"><img src="images/li_back.jpg" alt="back" title="back"></a></p>
-</div>
-
-
-
-
-
-
-
-<div id="footer">
- <div class="part">
- <table style="" cellspacing="5" width="100%">
- <tbody><tr class="white">
- <td><a href="http://esbox.garage.maemo.org" target="_blank"><img src="images/ma_es.jpg" alt="esbox" title="esbox"></a></td>
- <td valign="middle">is a part of</td>
- <td><a href="http://wiki.percomp.org" target="_blank"><img src="images/ma_pe.jpg" alt="percomp" title="percomp"></a></td>
- <td valign="middle">developed by</td>
- <td><a href="http://embedded.ufcg.edu.br" target="_blank"><img src="images/ma_emb.jpg" alt="embedded" title="embedded"></a></td>
- <td valign="middle">in cooperation with</td>
- <td><a href="http://www.indt.org.br/" target="_blank"><img src="images/ma_indt.jpg" alt="indt" title="indt"></a></td>
- <td valign="middle">and</td>
- <td><a href="http://maemo.org/" target="_blank"><img src="images/ma_ma.jpg" alt="maemo.org" title="maemo.org"></a></td>
- </tr>
- </tbody></table>
- </div>
- <p class="right">© Copyright 2007 - 2009, INdT, 2008 - 2009 Nokia</p>
- </div>
-
-
-
-
-
-</body></html>
\ No newline at end of file
+<html xmlns="http://www.w3.org/1999/xhtml">
+<head>
+ <script></script>
+ <meta http-equiv="content-type" content="text/html; charset=utf-8">
+ <title>Installation</title>
+ <meta name="description" content="">
+ <meta name="keywords" content="esbox installation">
+ <link href="css/main.css" rel="stylesheet" type="text/css">
+ <link rel="shortcut icon" href="images/favicon.ico">
+</head>
+<body>
+<script type="text/javascript">
+ var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
+ document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
+ </script>
+<script type="text/javascript">
+ var pageTracker = _gat._getTracker("UA-2565700-2");
+ pageTracker._initData();
+ pageTracker._trackPageview();
+ </script>
+<div id="header"> <span id="img"><a href="index.html"><img
+ src="images/marca.jpg" alt="logo"></a></span>
+<ul id="menu">
+ <li><a href="index.html">home</a></li>
+ <li><a href="features.html">features</a></li>
+ <li><a href="releases.html">releases</a></li>
+ <li><a href="documentation.html">documentation</a></li>
+ <li class="active"><a href="#">installation</a></li>
+ <li><a href="contributing.html">contributing</a></li>
+</ul>
+</div>
+<div id="banner">
+<div class="wrap">
+<div id="box"> </div>
+</div>
+</div>
+<div class="wrap">
+<div id="container">
+<div id="content">
+<div style="float: right;">ESbox is part of <a
+ href="http://maemo.org/development/documentation/ide_integration/"
+ target="_blank">Maemo IDE Integration</a>
+</div>
+<h2 id="installation">INSTALLATION</h2>
+<div style="font-size: 14px;">
+<ul>
+ <li><a href="#overview">Overview</a></li>
+ <li><a href="#supported">Supported environments</a></li>
+ <li><a href="#getting">Installing ESbox IDE<br>
+ </a></li>
+ <li><a href="#devenv">Development Environment</a>
+ <ul>
+ <li><a href="#devenv_vm">Virtual machine images</a></li>
+ <li><a href="#devenv_maemosdk">Scratchbox and Maemo SDK</a></li>
+ <li><a href="#devenv_xserver">X Server</a></li>
+ </ul>
+ </li>
+ <li><a href="#pcconn">PC Connectivity</a></li>
+ <li><a href="#sdkdocs">Maemo SDK Help Content</a><br>
+ </li>
+</ul>
+</div>
+<p>
+</p>
+<p id="overview">
+</p>
+<div id="group">
+<h3 id="heading">Overview
+</h3>
+<p>
+ESbox is an <a href="http://www.eclipse.org/">Eclipse-based</a>
+IDE.
+It is based on Eclipse Ganymede (3.4.2) and provides C/C++ and Python
+support, source editing, project building, run/debug/profiling, and
+Debian package deployment. ESbox communicates transparently with
+Scratchbox and one or more Maemo SDKs, available separately, to let you
+develop Maemo applications. ESbox can also update the image on
+your Maemo devices and communicate with them using the various network
+clients and servers available
+with the PC Connectivity project.<br>
+</p>
+<p>With ESbox, Scratchbox, Maemo SDK(s), and PC Connectivity installed,
+you can run, debug, and profile locally under emulator running in an X
+server, and also deploy the application to a Maemo device (N800, N810)
+to run, debug, and profile on hardware.
+</p>
+<h3>ESbox IDE</h3>
+<p>ESbox may be installed completely from an archive or added to
+an existing Eclipse 3.4.2 installation from our update sites.
+</p>
+<p>
+ESbox may be installed in a variety of hosts. The "Supported
+Environments" sections describes these. The "Installing ESbox IDE"
+section describes
+how to find and install ESbox.</p>
+<h3>Virtual machine
+</h3>
+<p>Only Linux/x86 hosts natively run Scratchbox and Maemo SDKs.
+In other hosts, you must run Scratchbox and the Maemo SDK inside a
+Linux/x86 virtual machine. ESbox supports using virtual machines
+in this manner.
+</p>
+<p>The "Supported Environments" sections describes the VM engines
+supported.
+</p>
+<p>In ESbox, you can install a server virtual image using <strong>File
+> New > Other > Maemo Installers > Maemo SDK Virtual Image</strong>.</p>
+<h3>Development Environment
+</h3>
+<p>The development environment consists of Scratchbox and one or more
+Maemo SDKs. These are essential to Maemo development environment
+and ESbox is useless without them. </p>
+<p>ESbox does not ship with Scratchbox or any Maemo SDK, but<span
+ style="font-style: italic;"> </span>it includes wizards that allow
+you to install them. See <strong>File > New > Other >
+Maemo Installers > Scratchbox 1 </strong>and<strong> ... >
+Scratchbox 1 Targets</strong>. <br>
+</p>
+<p>If you want to install these yourself, see <a
+ href="http://maemo.org/development/sdks/">the Maemo SDK site</a> for
+more information.</p>
+<p>For Python development, you need an Python interpreter installed on
+the host machine in order to support the editor and
+the run/debug mechanism in PyDev. Typically you should use the
+same version of Python that is on the device,
+which is currently Python 2.5.
+See instructions at <a
+ href="http://www.python.org/download/releases/2.5.4/" target="_blank">at
+Python 2.5.4 official release.</a> ESbox configures Pydev to read
+the host installation's library
+sources for code completion. If you're not concerned about
+differences here, a 2.4
+or 2.6 version may be installed on the host. </p>
+<h3>PC Connectivity</h3>
+<p>In order to re-flash your device or run, debug, profile, or install
+your
+application on device, use the PC Connectivity project. It
+provides
+convenient installation packages allowing you to use the Maemo flasher,
+ssh, sbrsh, NFS, rsync, avahi,
+etc. between your PC and your Maemo device. There is a host
+component (for the machine running Eclipse,
+and also for the virtual machine, if you have to use one) and a target
+component (for the device).
+</p>
+<p>The "Supported Environments" sections describes the Maemo releases
+and devices supported.
+</p>
+<p>Find the complete description and installation instructions on the <a
+ href="http://pc-connectivity.garage.maemo.org/" target="_blank">PC
+connectivity project web site</a>.
+</p>
+</div>
+<p>
+</p>
+<p id="supported">
+</p>
+<div id="group">
+<h3 id="heading">Supported Environments
+</h3>
+<h3>Hosts supported</h3>
+<table
+ style="border: 1px solid black; border-collapse: collapse; text-align: left; width: 100%;"
+ cellpadding="2" cellspacing="2">
+ <tbody>
+ <tr
+ style="border: 1px solid black; padding: 2px; background-color: rgb(238, 238, 136);">
+ <th style="vertical-align: top;">Host </th>
+ <th style="vertical-align: top;">Virtual Machine Required </th>
+ <th style="vertical-align: top;">Supported? </th>
+ <th style="vertical-align: top;">Tested? </th>
+ </tr>
+ <tr
+ style="border: 1px solid black; padding: 2px; background-color: rgb(204, 255, 204);">
+ <td style="vertical-align: top;">Ubuntu 8.04 Hardy, 8.10
+Intrepid, 9.04 Jaunty (x86) </td>
+ <td style="vertical-align: top;">No [3] </td>
+ <td style="vertical-align: top;">Yes </td>
+ <td style="vertical-align: top;">Yes </td>
+ </tr>
+ <tr style="border: 1px solid black; padding: 2px;">
+ <td style="vertical-align: top;">Ubuntu 9.10 Karmic (x86) or
+other Linux/x86 distros </td>
+ <td style="vertical-align: top;">No [3] </td>
+ <td style="vertical-align: top;">Mostly [1] [5] </td>
+ <td style="vertical-align: top;">Partially </td>
+ </tr>
+ <tr style="border: 1px solid black; padding: 2px;">
+ <td style="vertical-align: top;">Other Linux </td>
+ <td style="vertical-align: top;">Yes </td>
+ <td style="vertical-align: top;">Maybe [2] [5] </td>
+ <td style="vertical-align: top;">No </td>
+ </tr>
+ <tr
+ style="border: 1px solid black; padding: 2px; background-color: rgb(204, 255, 204);">
+ <td style="vertical-align: top;">Windows XP </td>
+ <td style="vertical-align: top;">Yes </td>
+ <td style="vertical-align: top;">Yes
+ </td>
+ <td style="vertical-align: top;">Yes </td>
+ </tr>
+ <tr style="border: 1px solid black; padding: 2px;">
+ <td style="vertical-align: top;">Windows Vista/7 </td>
+ <td style="vertical-align: top;">Yes </td>
+ <td style="vertical-align: top;">Yes </td>
+ <td style="vertical-align: top;">Yes </td>
+ </tr>
+ <tr
+ style="border: 1px solid black; padding: 2px; background-color: rgb(204, 255, 204);">
+ <td style="vertical-align: top;">Mac OS X Intel </td>
+ <td style="vertical-align: top;">Yes </td>
+ <td style="vertical-align: top;">Yes
+ </td>
+ <td style="vertical-align: top;">Yes </td>
+ </tr>
+ <tr style="border: 1px solid black; padding: 2px;">
+ <td style="vertical-align: top;">Mac OS X PPC </td>
+ <td style="vertical-align: top;">Yes </td>
+ <td style="vertical-align: top;">Maybe [2] [4] </td>
+ <td style="vertical-align: top;">No </td>
+ </tr>
+ </tbody>
+</table>
+<p>
+[1] If the Scratchbox 1 and Maemo SDKs run properly, and Eclipse runs
+properly, then ESbox should work.
+</p>
+<p>
+[2] If Eclipse runs properly and virtual machine software runs
+properly, then ESbox should work.
+Note that gcj has a lot of problems with Eclipse, so we recommend using
+a Sun or IBM
+Java virtual machine. </p>
+<p>
+[3] But you may use a virtual machine, if you want.
+</p>
+<p>
+[4] The Host components of PC Connectivity have not been fully ported
+to this host.
+</p>
+<p>
+[5] On newer Linux distributions, some components like GTK+ and
+xulrunner have changed in ways that
+make Eclipse difficult to launch.
+Please use the provided <b><tt>esbox.sh</tt></b> script to launch
+ESbox and work around the issues.
+</p>
+<h3>Virtual machine engines supported</h3>
+<ul>
+ <li>VMware Workstation / Server / Player
+ <ul>
+ <li>Workstation or Server recommended for easiest
+configuration. Otherwise you need to hand-edit *.vmx files and
+cannot use VMware Tools to accelerate the machine. </li>
+ </ul>
+ </li>
+ <li>Sun VirtualBox 2.2 or newer
+ <ul>
+ <li>Performance is reasonable and configuration is easy, but it
+is not as fast as VMware. </li>
+ </ul>
+ </li>
+ <li>QEMU system emulation
+ <ul>
+ <li>Not recommended, since even with Kqemu acceleration on
+Windows, the performance is quite slow. Without it, performance
+is awful.</li>
+ </ul>
+ </li>
+</ul>
+<h3>Maemo Releases supported</h3>
+<p>
+The <a href="http://tablets-dev.nokia.com/" target="_blank">Maemo
+releases</a> supported are: </p>
+<ul>
+ <li>OS2008 Diablo</li>
+ <li>Maemo 5 Fremantle</li>
+ <li class="note">Older releases may work, but PC Connectivity 2nd
+Edition is not supported on them; you must manually set up networking,
+SSH, and SBRSH. </li>
+</ul>
+<p></p>
+</div>
+<p>
+</p>
+<p id="getting">
+</p>
+<div id="group">
+<h3 id="heading">Installing ESbox IDE<br>
+</h3>
+<h3>Java runtime
+</h3>
+<p>
+ESbox is an Eclipse application, which needs Java to run.
+</p>
+<b>Eclipse 3.4.2 needs Java 1.5 or newer:</b>
+<ul>
+ <li><a href="http://java.sun.com/javase/downloads/index_jdk5.jsp">Sun
+Java 5.0</a> or <a
+ href="http://java.sun.com/javase/downloads/index.jsp">Sun Java 6</a> </li>
+ <li><a href="http://www.ibm.com/developerworks/java/jdk/index.html">IBM
+JRE 5.0+</a></li>
+ <li><a href="http://openjdk.java.net/">OpenJDK 6+</a></li>
+ <li class="warning">GNU gcj is not supported</li>
+</ul>
+<p> You can find these JREs as packages in your distribution or
+download them directly from their websites. </p>
+<h3><a href="installation_product.html">Method 1: Full Product Archive
+(recommended)</a></h3>
+<ul>
+ <li>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.
+ </li>
+ <li>Download it, extract it, and get started!
+ <a href="installation_product.html">Follow these instructions</a>. </li>
+</ul>
+<p>
+</p>
+<h3><a href="installation_update_site.html">Method 2: Eclipse Update
+Site</a></h3>
+<ul>
+ <li>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 Mica and ESbox from the Internet. <br>
+ </li>
+ <li>Newer versions of Eclipse are not supported due to hard
+dependencies on the CDT tooling being used.<br>
+ </li>
+ <li>Follow <a href="installation_update_site.html">these instructions</a>.</li>
+</ul>
+<p>
+<strong>NOTE: Both the installation via the Full Product Archive and
+the Eclipse Update Site can be upgraded using Eclipse's Software
+Updates.</strong><br>
+</p>
+</div>
+<p id="devenv">
+</p>
+<div id="group">
+<h3 id="heading">Development Environment<br>
+</h3>
+<h3 id="devenv_vm">Virtual machine images (non-Linux)</h3>
+<p>If you are running ESbox outside of Linux/x86, you install the
+Scratchbox and Maemo components
+on a Linux/x86 virtual machine.
+</p>
+<p>
+The Maemo Eclipse Integration project provides Linux/x86 images
+suitable for use
+with VMware, VirtualBox, and QEMU.
+See the <a href="http://maemovmware.garage.maemo.org">Maemo SDK VM
+Image project page</a> for more information on configuring and
+installing virtual machines.
+</p>
+<div id="group">
+<ul>
+ <li class="note">ESbox can install a Maemo SDK VM image for you
+using the wizard <strong>File > New > Other > Maemo
+Installers > Maemo SDK VM Image</strong>.
+ </li>
+</ul>
+</div>
+<p>You will need to <a href="virtual_machines.html">configure ESbox to
+use the virtual machine</a> so that ESbox
+knows where to find or install Scratchbox and the Maemo SDKS.
+</p>
+<h3 id="devenv_maemosdk">Scratchbox and Maemo SDK</h3>
+<p>To build and run C/C++ or Python applications you will need to
+install the Maemo development environment in a Linux/x86 machine
+(either your host or a VM). </p>
+<ul>
+ <li>Scratchbox
+ <p>Scratchbox enables building and emulating programs in a
+transparent cross-compilation and cross-execution environment. </p>
+ <ul>
+ <li>Scratchbox 1 is the primary cross environment for Maemo
+development</li>
+ <li class="note">Scratchbox 2 is a newer cross environment which
+overcomes several issues with Scratchbox 1, but it is not officially
+supported or tested in ESbox.</li>
+ </ul>
+ </li>
+ <li>Maemo SDKs
+ <ul>
+ <li>Maemo 4.1.x Diablo</li>
+ <li>Maemo 5.0.x Fremantle
+ <ul>
+ <li><span style="font-weight: bold;">NOTE: </span>Fremantle
+SDKs require the Nokia closed binaries to function properly. </li>
+ </ul>
+ </li>
+ <li class="note">Older SDKs (for either variant of Scratchbox)
+may work but are not supported.</li>
+ </ul>
+ </li>
+ <li>Nokia closed binaries
+ <p>Maemo SDKs are open-source, but some components installed on the
+device and available to the SDK are closed-source. These <b>must</b>
+be installed for Fremantle SDKs to operate properly under emulation. </p>
+ </li>
+</ul>
+<div id="group">
+<ul>
+ <li class="note">ESbox can install Scratchbox 1, Diablo/Fremantle
+Maemo SDKs, and Nokia closed binaries using wizards under <strong>File
+> New > Other > Maemo Installers</strong>.
+ </li>
+</ul>
+</div>
+<h3 id="devenv_xserver">X Server</h3>
+<p>When running or debugging locally during development, an X11 server
+runs on the Eclipse host
+and displays your programs in the Maemo Application Framework
+(Maemo AF). </p>
+<p><b>NOTE:</b> X servers are available on all platforms, but the
+Fremantle SDK imposes some high
+requirements on the X server. Linux-on-Linux development will yield the
+best results (quality and performance). On other hosts, there are
+workarounds for known issues. </p>
+<ul>
+ <li>Linux
+ <ul>
+ <li>The Xephyr nested server is recommended.</li>
+ <li>In Debian Linux: <tt>sudo apt-get install xserver-xephyr</tt></li>
+ <li>In Fedora Linux: <tt>sudo yum install xorg-x11-xserver-Xephyr</tt></li>
+ </ul>
+ </li>
+ <li>Windows
+ <ul>
+ <li>We recommend using the X server from the Cygwin/X project. </li>
+ <li>See <a href="installation_x_setup_windows.html">setup
+instructions here</a>. </li>
+ </ul>
+ </li>
+ <li>Mac OS X
+ <ul>
+ <li>The Xephyr server is recommended. This runs natively in
+Quartz.</li>
+ <li>See <a href="installation_x_setup_osx.html">setup
+instructions here</a>. </li>
+ </ul>
+ </li>
+</ul>
+</div>
+<p id="pcconn">
+</p>
+<div id="group">
+<h3 id="heading">PC Connectivity
+</h3>
+<p>
+In
+order to communicate with your Maemo device, a set of daemons and
+utilities are needed on the host and target to fully communicate with
+the Maemo device. </p>
+<h3>Host PC Connectivity</h3>
+<p>
+Host PC connectivity provides host-side software, like ssh
+and sbrsh clients, the Maemo flasher, rsync, FTP client, and the
+tightvnc viewer. These are packaged together conveniently for
+installation on Linux/x86,
+Windows, and Mac OS X Intel. </p>
+<p>
+Install the Host PC Connectivity
+package on the machine running Eclipse.
+</p>
+<p>
+<b>NOTE:</b> for non-Linux installations, you also need to install Host
+PC connectivity <span style="font-style: italic;">inside the VM</span>
+to use sbrsh.
+</p>
+<p> Find the complete details for both on the <a
+ href="http://pc-connectivity.garage.maemo.org/" target="_blank">PC
+connectivity project web site</a>.
+</p>
+<p> </p>
+<h3>Target (Maemo) PC Connectivity
+</h3>
+<p>
+On the Maemo device, you need the other half of PC Connectivity,
+containing the servers that match the clients installed
+on the host side. The PC Connectivity requires either a Diablo and
+Fremantle release. </p>
+<div id="group">
+<ul>
+ <li class="note">ESbox can flash OS images onto your device using
+the <em>File > New > Other > Maemo Installers > Flash Images to Device</em>
+wizard.
+ </li>
+</ul>
+</div>
+<p>Find the complete description and installation instructions on the <a
+ href="http://pc-connectivity.garage.maemo.org" target="_blank">PC
+connectivity project web site</a>. </p>
+<p> </p>
+</div>
+<p id="sdkdocs">
+</p>
+<div id="group">
+<h3 id="heading">Maemo SDK Help Content</h3>
+<p>
+To finish the installation, see
+<a href="installation_help.html">instructions on installing the Maemo
+SDK documentation and offline hover help support</a>.
+</p>
+</div>
+<p>
+</p>
+</div>
+<p>
+</p>
+</div>
+<p style="text-align: right;"><a href="index.html" target="_parent"><img
+ src="images/li_back.jpg" alt="back" title="back"></a></p>
+</div>
+<div id="footer">
+<div class="part">
+<table style="" cellspacing="5" width="100%">
+ <tbody>
+ <tr class="white">
+ <td><a href="http://esbox.garage.maemo.org" target="_blank"><img
+ src="images/ma_es.jpg" alt="esbox" title="esbox"></a></td>
+ <td valign="middle">is a part of</td>
+ <td><a href="http://wiki.percomp.org" target="_blank"><img
+ src="images/ma_pe.jpg" alt="percomp" title="percomp"></a></td>
+ <td valign="middle">developed by</td>
+ <td><a href="http://embedded.ufcg.edu.br" target="_blank"><img
+ src="images/ma_emb.jpg" alt="embedded" title="embedded"></a></td>
+ <td valign="middle">in cooperation with</td>
+ <td><a href="http://www.indt.org.br/" target="_blank"><img
+ src="images/ma_indt.jpg" alt="indt" title="indt"></a></td>
+ <td valign="middle">and</td>
+ <td><a href="http://maemo.org/" target="_blank"><img
+ src="images/ma_ma.jpg" alt="maemo.org" title="maemo.org"></a></td>
+ </tr>
+ </tbody>
+</table>
+</div>
+<p class="right">© Copyright 2007 - 2009, INdT, 2008 - 2009 Nokia</p>
+</div>
+</body>
+</html>
More information about the Esbox-commits
mailing list