Eclipse integration/ReleaseNotes beta1

= Release Notes for Maemo Eclipse Integration Edition 2 Beta 1 release =

This Maemo Eclipse Integration Edition 2 Beta 1 release supports Maemo Diablo 4.1.2 development environment with N800, N810 and N810 Wimax Edition Internet Tablet devices and Maemo Fremantle 5.0 Beta development environment (with coming new devices).

Possible feedback can be sent to eclipse-integration@maemo.org.

Release Information
Project:   Maemo Eclipse Integration Edition 2 Version:   Beta 1 Baselines: Maemo Diablo 4.1.2 SDK Maemo Fremantle 5.0 SDK Beta (as installable addon) Date:      2009-05-22

General Information
Maemo Eclipse Integration includes the following parts:

1. Eclipse 3.4.2 IDE (Ganymede SP2) for C/C++ Developers (official release from eclipse.org) 2. Maemo PC Connectivity v0.X (Diablo extras-devel repository version) and Host PC Connectivity v0.6 for Linux, Windows and Mac OS X (PC Connectivity Garage project versions) 3. Maemo ESbox plugin for Eclipse v2.0.0M4 (Esbox Garage project version) 4. Maemo Pluthon plugin for Eclipse v2.0.0M4 (Pluthon Garage project version) 5. Maemo Mica plugin framework for Eclipse v2.0.0M4 (Mica Garage project version) 6. Maemo SDK Virtual Images v0.10 (to support other than Debian based Linuxes) 7. Maemo C/C++ and Python programming language support (Diablo extras repository versions) Detailed list of new features implemented to Maemo Eclipse Integration since previous Alpha 2 release together with feature plan for next Beta 2 release is here http://wiki.maemo.org/Eclipse_integration.

Known issues for Beta 1 release are here http://wiki.maemo.org/Eclipse_integration/Beta1KnownIssues.

This Release Notes file is here http://wiki.maemo.org/Eclipse_integration/ReleaseNotes_beta1.

Basic product information and installation instructions for all Beta 2 components can be found from their http://garage.maemo.org projects.

Operating Systems Supported

 * full support for same Linux Ubuntu distributions that Maemo SDK releases support (Hardy and Intrepid fully tested)
 * good support for Windows XP with SP3 and Vista with SP1, Cygwin used as Linux porting framework
 * initial support for Mac OS X (Leopard)
 * see instructions how to setup and configure different operating system support: http://pc-connectivity.garage.maemo.org/beta1/installation.html and http://esbox.garage.maemo.org/beta1/virtual_machines.html

Eclipse IDE for C/C++ Developers

 * product information: http://www.eclipse.org/
 * Eclipse download if separate download wanted: http://www.eclipse.org/downloads/
 * list of generic Eclipse components included: http://mica.garage.maemo.org/beta1/documentation.html
 * ESbox and Pluthon installation packages available from Garage include all needed Eclipse components for the release, including Eclipse 3.4.2 IDE itself (recommended installation method for Beta 1 release)
 * http://esbox.garage.maemo.org/beta1/installation_product.html
 * http://pluthon.garage.maemo.org/beta1/installation_product.html
 * for already installed Eclipse 3.4.2 IDE ESBox and Pluthon installation can be done using update site (not fully tested installation method for Beta 1 release)
 * http://esbox.garage.maemo.org/beta1/installation_update_site.html
 * http://pluthon.garage.maemo.org/beta1/installation_update_site.html

Maemo PC Connectivity
Internet Tablet
 * product information: http://pc-connectivity.garage.maemo.org/beta1
 * installation instructions for Internet Tablet and Linux, Windows and Mac OS X host PCs: http://pc-connectivity.garage.maemo.org/beta1/installation.html
 * documentation and configuration instructions: http://pc-onnectivity.garage.maemo.org/beta1/documentation.html
 * main features:
 * support for Linux (Debian based), Windows (XP and Vista) and Mac OS X (Leopard)
 * full connectivity support with USB, BlueTooth and WLAN for Linux, Windows and Mac OS X
 * full ssh, sftp, vnc and disk mount support for Linux, Windows and Mac OS X host PCs
 * support for both Diablo and Fremantle SDK
 * full support for VNC clients (native and Eclipse VNC plugin support)
 * full support for Internet Tablet configuration with control panel applet and status bar plugin
 * native SBRSH (Scratchbox Remote Shell) support for Linux, Win32 and Mac OS X to launch applications from SDK to run on
 * SBRSH supports session based sandbox option
 * SFTP support to access Internet Tablet file system with native host PC GUI clients
 * support for installing Host PC Connectivity components for Linux, Win32 and Mac OS X host PCs
 * sbrsh (Scratchbox Remote Shell) support to start applications on SDK to run on Internet Tablet
 * easy installation using single click installation or apt-tool in Internet Tablet to install from Maemo Diablo extras-devel repository
 * Tablet configuration applet allows easy configuration of sbrsh, vnc, unfs3, etc.
 * Tablet configuration applet supports several configuration environments that store configuration infrormation for many services and connectin types
 * status bar plugin can be used to easily switch between predefined environments
 * PC Connectivity functionality is independent from Eclipse IDE e.g. usable also without installing Eclipse IDE

Maemo ESBox plugin for Eclipse

 * product information: http://esbox.garage.maemo.org/beta1
 * installation and configuration instructions for Internet Tablet and Linux, Windows and Mac OS X host PCs: http://esbox.garage.maemo.org/beta1/installation.html
 * main features:
 * easy PC-Tablet connectivity with Maemo PC Connectivity
 * C, C++ and Python programming language support
 * templates for the most common type of Maemo applications
 * full support for Linux and good support for Win32 host PCs
 * initial support for Mac OS X host PC (works and documented but not fully tested)
 * full connectivity support for Internet Tablet with SSH, RSE and SBRSH from Linux, Windows and Mac OS X
 * support for both Diablo and Fremantle SDK
 * import Eclipse projects from Maemo SDK and Debian packages
 * C/C++ debug/optimized configuration support
 * support for P2 update site for ESbox
 * installation wizard for Scratchbox, Diablo SDK and Fremantle SDK
 * installation wizard for Maemo SDK development environments (like for Python and C++)
 * build application with x86 target
 * launch and test application on x86 target
 * debug application on x86 target
 * search for memory leaks using Valgrind on x86 target
 * cross-compile application with ARMEL target
 * debug application on the Internet Tablet using GDB or GDB Server
 * performance test on Internet Tablets using OProfile
 * Maemo installation package creation wizard
 * Maemo flsher tool wizard

Maemo Pluthon plugin for Eclipse

 * product information: http://pluthon.garage.maemo.org/beta1
 * installation and configuration instructions for Internet Tablet and Linux, Windows and Mac OS X host PCs: http://pluthon.garage.maemo.org/beta1/installation.html
 * main features:
 * easy PC-Tablet connectivity with Maemo PC Connectivity
 * Python programming language support
 * templates for the most common type of Maemo applications
 * develop application directly on the Internet Tablet
 * debug application on the Internet Tablet using pyDev
 * full support for Linux and Win32 host PCs
 * initial support for Mac OS X host PC
 * full connectivity support for Internet Tablet with SSH, RSE and SBRSH from Linux, Windows and Mac OS X
 * support for P2 update site for Pluthon
 * installation wizard to setup Python development environment for host PC and Internet Tablet
 * Maemo installation package creation wizard

Maemo Mica plugin framework for Eclipse

 * product information: http://mica.garage.maemo.org/beta1/
 * documentation for developers who want to develop their own Maemo plugins using Mica: http://mica.garage.maemo.org/beta1/documentation.html
 * NOTICE Mica is still under extensive development and stability of current interfaces cannot be quaranteed (actually many interfaces are quaranteed to be changed for Beta 2 release)
 * main features:
 * general framework for Maemo Eclipse plugin development
 * uses latest stable Eclipse components (compatible with Eclipse Ganymede SR2)
 * Scratchbox 1 installer wizard and SDK installer wizard
 * support for both Diablo and Fremantle SDK
 * supports SSH, RSE and SBRSH for Linux, Windows and Mac OS X
 * flasher wizard for flashing Internet Tablet from Eclipse IDE
 * support for P2 update site for Mica
 * Mica Garage site documentation and services released for 2nd Edition

Maemo SDK Virtual Image

 * product information: http://maemovmware.garage.maemo.org/beta1
 * installation and configuration instructions: http://maemovmware.garage.maemo.org/beta1/installation.html
 * images can be downloaded from here: http://tablets-dev.nokia.com/maemo-dev-env-downloads.php
 * main features:
 * Ubuntu Intrepid Server based Maemo SDK Virtual Image for Linux, Windows and Mac OS X
 * full support for VMWare and QEMU virtualizatin technologies
 * do-it-yourself support for VirtualBox
 * server image includes basic Ubuntu Intrepid Server and Host PC Connectivity environment prefonfigured and Maemo Diablo and Fremantle Development Environments can be installed with Eclipse installation wizard automatically
 * Ubuntu Intrepid Desktop based Maemo SDK Virtual Image for Linux, Windows and Mac OS X
 * out-of-the-box ready Ubuntu Intrepid Desktop based image
 * desktop image includes fully configured Maemo Diablo Development Environment for Eclkipse and Fremantle Development Environment can be installed with Eclipse installation wizard automatically
 * desktop image includes installers for GuestAdditions (for VirtualBox) and OpenVMTools (for VMWare)
 * installer/tool to configure Maemo SDK Virtual Images for VirtualBox usage
 * instructions how to use SDK Virtual Images with Eclipse IDE on different operating systems: http://esbox.garage.maemo.org/beta1/virtual_machines.html

Maemo C++ and Python programming language support

 * product information: http://maemo.org/development/documentation/programming_languages/
 * C++ documentation: http://maemomm.garage.maemo.org/docs/
 * Python documentation: http://pymaemo.garage.maemo.org/

By default, the Maemo development environment supports the C programming language but you may add support for other programming languages. Instructions how to install Maemo support for C++ and Python application development can be found from here http://maemo.org/development/documentation/programming_languages/.

The Maemo development environment defines helpful meta packages that install all the components and tools for C++ and Python development for the for Maemo SDK and Internet Tablet. Maemo Eclipse Integration will install these meta packages automatically into your environment if you have not done it already when you create your first C++ or Python project.

Known Issues
target http://maemo.org/development/tools/). device (http://maemo.org/development/tools/).
 * latest version for Beta 1 known issues is here http://wiki.maemo.org/Eclipse_integration/Beta1KnownIssues (feel free to update this wiki page)
 * for USB Networking to work between Internet Tablet running Diablo platform and host PC running Microsoft Windows, Internet Tablet kernel needs to be reflashed. Kernel patch (together with new flashable kernel image) for Diablo is available from Maemo development environment download page http://tablets-dev.nokia.com/maemo-dev-env-downloads.php
 * to search memory leaks Valgrind needs to be installed manually to the x86
 * to make performance profiling OProfile needs to be installed manually to the

Notices
Notice 1: If only Maemo Pluthon plugin for Eclipse is used for Python on device development it does not reguire Maemo SDK installation on host PC.

Notice 2: All Eclipse components can be installed from ESbox or Pluthon garage projects, PC Connectivity from Diablo extras-devel repository and SDK Virtual Images from maemo development environment download page http://tablets-dev.nokia.com/maemo-dev-env-downloads.php

Notice 3: Eclipse 3.4.2 IDE for C/C++ Developers and all needed generic Eclipse plugins and ESbox and Pluthon plugins themselvs can be installed together with installation packages available from ESbox and Pluthon garage projects.

Feedback can be sent to eclipse-integration@maemo.org