===================================================================== RELEASE NOTES FOR Maemo 5 SDK Update 7 25.10.2010 ===================================================================== The Maemo 5 Final SDK has its seventh update, which corresponds to the sixth product software update, being version 20.2010.36-2. Existing Update 3 or later SDK installations can be upgraded easily using the apt package management tool found inside scratchbox. The suggested way to upgrade is running: "fakeroot apt-get update" and then "fakeroot apt-get install maemo-sdk-opt" and finally "fakeroot apt-get dist-upgrade" What's new in this release? --------------------------- Details of the content update can be found as follows: - SDK content updates (http://repository.maemo.org/stable/fremantle/ maemo5.0_update6_vs_maemo5.0_update7_content_changes.html) - Tools content updates (http://repository.maemo.org/stable/fremantle/ maemo5.0_update6_vs_maemo5.0_update7_tools_content_changes.html) - The updated packages are found in the the final SDK repository itself. - Qt Mobility API 1.0.2, which is now integrated into the device software. The Qt Mobility API provides interface continuity onwards to future platform versions. Qt Mobility API will be extended with additional functionality in the future releases. More information available at: http://qt.nokia.com/developer/new-qt-apis. - Qt Core libraries updated to 4.7.0 version. This release includes: - X86 development environment for compiling and running applications. - Armel environment for cross compilation only. - Maemo Scratchbox installer (http://repository.maemo.org/stable/5.0/ maemo-scratchbox-install_5.0.sh). - Maemo SDK installer (http://repository.maemo.org/stable/ 5.0/maemo-sdk-install_5.0.sh). - Maemo SDK GUI installer (http://repository.maemo.org/stable/ fremantle/maemo-sdk-install-wizard_5.0.py ) - Nokia proprietary binary packages. - Source code of open source packages (http://repository.maemo.org/ pool/maemo5.0/free). - Content comparison between 5.0update6 and 5.0update7 (http://repository.maemo.org/stable/fremantle/ maemo5.0_update6_vs_maemo5.0_update7_content_comparison.html) SDK content ----------- This SDK contains the headers, libraries, and tools required to write Maemo 5 applications, which are installed inside the Scratchbox cross compilation environment. The SDK delivers two Scratchbox targets for different architectures and purposes: - X86 : The X86 target is used during the software development phase. The majority of development work is done inside this target. - Armel: The armel target is used for cross compiling the software for the Nokia N900 mobile computer, with Fremantle software. The SDK consists of the following components: Hildon application framework subsystem: - UI framework libraries. - Hildon Desktop. - Hildon Home. - Hildon Status Menu. - Hildon Application Manager. - Hildon Input Method Framework. - Hildon Control Panel. - Clutter. - Tracker. - Matchbox library. - Games Wrapper library. Multimedia subsystem: - PulseAudio. - libcanberra. - Speex audio codec library. - GUPnP. - GStreamer. - Media Application Framework. - FM Transmitter API[*]. Connectivity subsystem: - BlueZ. - WLAN library. - GW OBEX library. - wireless-tools library. Real time communications subsystem: - Glib Telepathy connection manager library. - Farsight2 library. - libnice library. - AddressBook API[*]. - Accounts API[*]. - Event Logger API[*]. System software subsystem: - HAL library. - Battery query interface API[*]. - Vibra service API[*]. - Device orientation API[*]. Core subsystem: - X Window system library. - Linux Kernel. - Open GL ES drivers[*]. Application Interfaces: - Calendar API[*]. - CityInfo API[*]. - Location API[*]. - Time API[*]. - Email Interface API. - Sharing Plugin API[*]. Full package management, apt support: - Required tools included. - Qt 4.7.0 - Qt Mobility API 1.0.2 [[*]] are provided by Nokia closed binaries. System requirements ------------------- Basic requirements Maemo 5 SDK uses Scratchbox cross compilation environment and requires the minimum system requirements for Scratchbox only. Requirements for using Scratchbox are: - Linux distribution installed on the host. - Debian GNU/Linux recommended. - x86 platform. - For multiple users using Scratchbox on the same host a dual CPU machine or Hyper-Threading capable processor is recommended. - 512 MB of memory. - For multiple users using Scratchbox on the same host at least 1 GB is recommended. - Full Scratchbox installation requires 1 GB of hard disk space, but at least 1 GB extra space should be reserved for each Scratchbox user. - For heavy development a minimum of 10 GB of space may be needed. - The kernel must have the binfmt_misc module, which is required by the CPU-transparency feature. On most Linux distributions it is available by default (however, this in not the case on RedHat Enterprise Linux 3). Recommended requirements for using Scratchbox are: - Working networking environment. Additional software Xephyr X11 server software is needed on the host machine before any applications can be run in the Maemo 5 SDK. It is an X11 server that provides a device screen for the Maemo application windows and visuals to be displayed on the host machine. This software is not included in the SDK because it is available on most Linux distributions. On Debian based Linux systems, Xephyr can be installed outside the Scratchbox environment using apt with root permission: $ sudo apt-get install xserver-xephyr For more information see: http://wiki.maemo.org/Documentation/Maemo_5_Final_SDK_Installation#Starting.2FShutting_down_the_SDK_UI Known issues and deficiencies in this release --------------------------------------------- - Unnecessary warnings and debugging messages are printed out when the hildon application framework is started. - Armel target does not bring up the UI framework. - It has been noted that Xephyr crashed when the application framework is closed. The crash in question might even be Xephyr related since the application framework behaves differently with different versions and builds of Xephyr. - Running Xephyr with -kb option disables entry of @ symbol. However, removing -kb option disables cursor keys. - Running Xephyr with -host-cursor is causing Xephyr to crash in Ubuntu Lucid, Maverick and Debian Squeeze when the Hildon Application Framework is closed. - Xephyr in Ubuntu Lucid and later Ubuntues does not support the -kb option anymore. It can be replaced by "-keybd ephyr,,,xkbmodel=evdev,xkblayout=fi" and that will enable the Finnish keyboard layout. - In order to run ARMEL binaries in scratchbox the mmap_min_address needs to be set to 4096. Normally the SDK installer warns about that, but in Ubuntu Lucid default installation the /proc entry is visible only to root, so the SDK installer can not see it. https://bugs.launchpad.net/ubuntu/+source/linux/+bug/568844 It is fixed in the 2.6.32-24 kernel update for Ubuntu Lucid. - With Ubuntu/Kubuntu Karmic and later Ubuntu versions, it has been noted that sound does not work inside scratchbox. The pulseaudio server running on the host side refuses to work with the pulseaudio client in the scratchbox that contains Maemo specific protocol extensions.