=====================================================================
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.