Eclipse integration/ReleaseNotes alpha2

= Release Notes for Maemo Eclipse Integration 2nd Edition Alpha 2 release =

This maemo Eclipse Integration Edition 2 Alpha 2 release supports maemo Diablo 4.1.2 development environment and N800, N810 and N810 Wimax Edition Internet Tablet devices.

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

Release Information

 * Project:   Maemo Eclipse Integration 2nd Edition
 * Version:   Alpha 2
 * Baseline:  maemo 4.1.2 Diablo SDK
 * Date:      2009-02-27

General Information
Maemo Eclipse Integration includes the following parts:

Detailed list of new features implemented to Maemo Eclipse Integration since Alpha 1 release together with feature plan for next Alpha 3 and Beta 1 releases is here http://wiki.maemo.org/Eclipse_integration
 * Eclipse 3.4.1 IDE for C/C++ Developers (official release from eclipse.org)
 * maemo PC Connectivity v0.4.1 (Diablo extras-devel repository version)
 * maemo ESbox plugin for Eclipse v2.0.0M2 (Esbox Garage project version)
 * maemo Pluthon plugin for Eclipse v2.0.0M2 (Pluthon Garage project version)
 * maemo C/C++ and Python programming language support (Diablo extras repository versions)
 * maemo Virtual SDK Images (to support other than Debian based Linuxes)

Detailed description of functionality and installation instructions for all Alpha 2 components can be found from http://garage.maemo.org projects.

Eclipse 3.4.1 IDE for C/C++ Developers

 * Project main page: http://www.eclipse.org/
 * Eclipse download if separate download wanted: http://www.eclipse.org/downloads/
 * List of generic Eclipse components included: https://garage.maemo.org/xxxxx

PC Connectivity

 * Project main page: http://pc-connectivity.garage.maemo.org
 * PC Connectivity wiki front page: https://garage.maemo.org/plugins/wiki/index.php?id=247&type=g
 * Installation instructions: http://pc-connectivity.garage.maemo.org/installation.html
 * Configuration instructions: http://pc-connectivity.garage.maemo.org/documentation.html
 * Instructions for Windows support: https://garage.maemo.org/xxxxx

Maemo ESbox plugin for Eclipse

 * Project main page: http://esbox.garage.maemo.org
 * ESbox wiki front page: https://garage.maemo.org/plugins/wiki/index.php?id=192&type=g
 * Installation and configuration instructions for Linux (steps are same as for earlier Edition 1 release): http://esbox.garage.maemo.org/installation.html
 * Installation and configuration instructions for Windows: https://garage.maemo.org/plugins/wiki/index.php?ESboxNonLinuxHosted&id=192&type=g

Maemo Pluthon plugin for Eclipse

 * Project main page: http://pluthon.garage.maemo.org/
 * Pluthon wiki front page: https://garage.maemo.org/plugins/wiki/index.php?id=247&type=g
 * Installation and configuration instructions for Linux: http://pluthon.garage.maemo.org/installation.html (use tab Linux)
 * Installation and configuration instructions for Windows: http://pluthon.garage.maemo.org/installation.html (use tab Windows)

C/C++ and Python programming language support (http://maemo.org/development/documentation/programming_languages/)

 * C++ documentation: http://maemomm.garage.maemo.org/docs/
 * Python documentation: http://pymaemo.garage.maemo.org/

Virtual SDK Images for Maemo Eclipse Integration (http://maemovmware.garage.maemo.org/)

 * Virtual SDK Images can be dowloaded from here: http://tablets-dev.nokia.com/maemo-dev-env-downloads.php
 * Ubuntu Gutsy Server based image is recommended for Windows host PC
 * Ubuntu Hardy Server based image is recommended for other operating systems
 * both Ubuntu Server based images support VMWare Player and Qemu virtualization
 * instructions how to use Virtual SDK Images with Eclipse IDE on different operating systems: https://garage.maemo.org/plugins/wiki/index.php?ESboxNonLinuxHosted&id=192&type=g

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

Notice 2: Eclipse 3.4.1 IDE for C/C++ Developers and all needed generic Eclipse plugins and ESbox and Pluthon plugins will be installed together with installation packages available from ESbox and Pluthon garage projects.

Notice 3: For USB Networking to work between Internet Tablet running Diablo platform and host PC running Microsoft Windows, Internet Tablet kernel needs to be fixed. Kernel patch (together with new kernel image) for Diablo is available from maemo development environment download page http://tablets-dev.nokia.com/maemo-dev-env-downloads.php

Operating System Support
Supported operating systems:
 * maemo Eclipse Integration supports fully same latest Linux Ubuntu distribution that maemo SDK releases support
 * maemo Eclipse Integration has initial level support for Windows XP for PC Connectivity, ESbox and Pluthon plugins
 * see instructions how to setup and configure Windows host PC from here: http://xxxx

Eclipse IDE for C/C++ Developers
Both ESbox and Pluthon installation packages from garage include all needed Eclipse components for the releae, including Eclipse IDE itself.

If only maemo Pluthon plugin for Eclipse is used it does not reguire maemo SDK installation on host PC.

Known issues:
 * xxxx

Maemo PC Connectivity
Main features:
 * Initial Windows support with Copssh (http://xxxx)
 * Open ssh used as basic connectivity framework between Internet tablet and host PC
 * sshfs and User Mode NFS support for mounts between host PC and Tablet
 * sbrsh (Scratchbox Remote Shell) support to start applications on SDK to run on Internet Tablet
 * X11VNC support with native clients and Eclipse plugin
 * Easy installation using single click installation or apt-tool in Internet Tablet to install from maemo Diablo extras-devel repository
 * Easy configuration and usage with Network Manager and Connection Switcher applets installed to Internet Tablet
 * Support for all three USB networking, wlan and Bluetooth connectivity types
 * All PC Connectivity functionality is independent from Eclipse IDE e.g. usable also without installing Eclipse IDE

Known issues
 * xxxx

Maemo ESBox plugin for Eclipse
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
 * 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

Known issues
 * xxxx

Maemo Pluthon plugin for Eclipse
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

Known issues
 * xxxx

Maemo C++ and Python programming language support
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
 * xxxx

Generic Known Issues

 * To search memory leaks Valgrind needs to be installed manually to the x86 target http://maemo.org/development/tools/).
 * To make performance profiling OProfile needs to be installed manually to the device (http://maemo.org/development/tools/).
 * ESbox Python installation...

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