Skip to content

Commit

Permalink
Merge branch 'master' of scm.dev.nokia.troll.no:qt/qt-doc-staging int…
Browse files Browse the repository at this point in the history 
…o master-integration

* 'master' of scm.dev.nokia.troll.no:qt/qt-doc-staging:
  Doc updates to Qt for Symbian installation instructions and platform notes.
  Doc updates to platform notes document.
  Doc updates to platform notes of Qt 4.8 doc.
  Doc updates to Qt 4.8 platform notes documentation.
  • Loading branch information
Qt Continuous Integration System committed Sep 28, 2011
2 parents c75aabb + 99c2bdc commit 1f459f4
Show file tree
Hide file tree
Showing 2 changed files with 93 additions and 36 deletions.
58 changes: 41 additions & 17 deletions doc/src/getting-started/installation.qdoc
View file
Original file line number Diff line number Diff line change
Expand Up @@ -510,7 +510,10 @@ in the \l{Qt for the Symbian platform Requirements} document.

\section1 Step 1: Install Qt

Run \c{qt-symbian-opensource-%VERSION%.exe} and follow the instructions.
Download the \c {Qt libraries 4.x for Windows} package (for \c minGW or \c {VS 2008})
from the \l {http://qt.nokia.com/downloads#qt-lib}{downloads} page.

Run the downloaded package and follow the instructions.

\note Qt must be installed on the same drive as the Symbian SDK you are
using, and the install path must not contain any spaces.
Expand Down Expand Up @@ -652,23 +655,39 @@ Binary Package} document.
Congratulations, Qt is now ready to use.

\section1 Step 7: Installing Qt Libraries on the Device

To run a Qt application on a device, it must have Qt libraries installed.

Symbian devices have a pre-installed Qt as follows:
\list
\o Symbian Anna devices have the pre-installed Qt, Qt Mobility, and Qt Webkit.
\o Symbian Belle and later devices have the pre-installed Qt on the device firmware.
\endlist

\l {http://www.developer.nokia.com/Community/Wiki/Nokia_Smart_Installer_for_Symbian}
{Nokia Smart Installer for Symbian} deploys the required Qt libraries to supported S60
and Symbian devices if the libraries are not pre-installed.

Nokia Developer site's \l {http://www.developer.nokia.com/Devices/Device_specifications/?filter1=qt}
{Device specifications} provide information on which devices have a
pre-installed Qt and the used Qt version.

To create your own Qt installation package, do as follows:

\snippet doc/src/snippets/code/doc_src_installation.qdoc 29

The Qt libraries are built with "All -Tcb" capability, so they can support
all types of applications. If you don't have a suitable certificate, you can
patch the binaries in either of the following ways:

\list
\o If you have no certificate, build a self-signed Qt:
\snippet doc/src/snippets/code/doc_src_installation.qdoc 34

To run the demo on a real device, you first have to install
the Qt libraries on the device:

\snippet doc/src/snippets/code/doc_src_installation.qdoc 29

The Qt libraries are built with "All -Tcb" capability, so that
they can support all types of application.
If you don't have a suitable certificate, it is possible to patch
the binaries as follows:

If you have no certificate, build a self signed Qt:
\snippet doc/src/snippets/code/doc_src_installation.qdoc 34

If you have a symbian-signed developer certificate, specify the
\o If you have a symbian-signed developer certificate, specify the
capabilities you can sign for, for example:
\snippet doc/src/snippets/code/doc_src_installation.qdoc 35
\snippet doc/src/snippets/code/doc_src_installation.qdoc 35
\endlist

\section1 Running Qt demos

Expand Down Expand Up @@ -1315,7 +1334,12 @@ We hope you will enjoy using Qt.
\brief Setting up the Symbian platform environment for Qt.
\previouspage General Qt Requirements

Qt for the Symbian platform requires the following software installed on your development PC:
\l {http://qt.nokia.com/downloads}{Qt SDK} provides all the necessary tools
and libraries for developing Qt applications. However, if you want to build
Qt itself for Symbian, follow the instructions below.

Qt for the Symbian platform requires the following software installed on
your development PC:
\list
\o \l{http://www.forum.nokia.com/Library/Tools_and_downloads/Other/Carbide.c++/}{Carbide.c++ v2.3.0 or higher recommended}.
\list
Expand Down
71 changes: 52 additions & 19 deletions doc/src/platforms/platform-notes.qdoc
View file
Original file line number Diff line number Diff line change
Expand Up @@ -685,9 +685,7 @@
\ingroup platform-specific
\brief Information about the state of support for the Symbian platform.

As with any port, the maturity for Qt for Symbian has not yet reached the
same level as other established Qt ports. This page documents the current
notes for the Symbian port.
This page documents the current notes for the Symbian port.

\section1 Source Compatibility

Expand All @@ -698,18 +696,39 @@

\section1 Binary Compatibility

As with every supported platform, we will strive to maintain
application behavior and binary compatibility throughout the lifetime of
the Qt 4.x series. However, due to the fact that Symbian support is newly
added in 4.6.0, there is a slight possibility that minor corrections to the
application binary interface (ABI) might be required in 4.6.1, in order to
ensure compatibility going forward. Any such change will be clearly
documented in the release notes for 4.6.1.
As with every supported platform, Qt strives to maintain application
behavior and binary compatibility throughout the lifetime of the Qt 4.x
major version and on the Symbian devices that support Qt. Symbian support in
Qt SDK and Ovi Store were introduced with Qt 4.6. Each Qt release contains
bug fixes that might change the API behavior and thereby affect application
compatibility.

In addition, Symbian devices have different input methods, such as different
keyboard styles or touch input, screen sizes, memory, and CPU and GPU
capabilities. Therefore, you must test applications on specific target
devices to ensure compatibility. In order to build applications that are
supported also on earlier devices, select the target in Qt SDK carefully.
Generally, an earlier target (such as S60 5th Edition) is supported on a
larger number of devices than a later target (such as Symbian Belle).

\section1 Supported Devices

See the list of supported devices at
http://wiki.forum.nokia.com/index.php/Nokia_Smart_Installer_for_Symbian#Supported_Devices
\l {http://www.developer.nokia.com/Community/Wiki/Nokia_Smart_Installer_for_Symbian#Supported_Devices}{Nokia Smart Installer for Symbian}
documentation lists supported devices.

Qt versions are supported by Symbian devices as follows:
\list
\o Qt 4.6 is supported by S60 3rd Edition feature pack 1 and newer devices
through \l {http://www.developer.nokia.com/Community/Wiki/Nokia_Smart_Installer_for_Symbian}{Smart Installer}.
\o Qt 4.7.3 is supported by S60 5th Edition and newer devices.
\endlist

Symbian devices have a pre-installed Qt support as follows:
\list
\o Symbian Anna: Qt 4.7.3 in C: drive.
\o Symbian Belle: Qt 4.7.4 in device firmware (ROM).
\endlist


\section1 Supported Functionality

Expand All @@ -729,17 +748,30 @@
\endtable

The following technologies have limited support:


\table
\header \o Technology
\o Note
\row \o QtSql
\o The only driver supported is SQLite.
\o The supported drivers are SQLite and QSYMSQL.
\row \o QtMultimedia
\o Although the module itself is supported, no backend for Symbian
is currently available. However, there is a backend available
for Phonon.
\o For support details see \l {Multimedia and Phonon Support} section.
\endtable

It is not recommended to use the following Qt widgets:
\list
\o QFileDialog with the \c DontUseNativeDialog option
\o QColorDialog with the \c DontUseNativeDialog option
\o QFontDialog
\o QWizard
\o QCalendarWidget
\o QDateTimeEdit
\o QMdiArea
\o QMdiSubWindow
\o QDockWidget
\o QPrintPreviewWidget
\endlist

\section1 Compiler Notes

Expand Down Expand Up @@ -796,6 +828,7 @@
For more information see the documentation of the individual Qt classes. If
a class does not mention Symbian capabilities, it requires none.

\target Multimedia and Phonon Support
\section1 Multimedia and Phonon Support

Qt provides a high-level API for multimedia functionality with
Expand All @@ -808,7 +841,7 @@

In this release the support is experimental. Video playback may show
artifacts when the video is moved or resized (for instance during
orientation flips). This problem is present on Symbian^1 and earlier
orientation flips). This problem is present on S60 5th Edition and earlier
versions, and on Symbian^3 systems.

The audio and video formats that Phonon supports depends on what support
Expand All @@ -822,7 +855,7 @@

\section1 Hardware Accelerated Rendering

The default graphics system on Symbian^3 is OpenVG, which uses OpenVG
The default graphics system on Symbian Anna is OpenVG, which uses OpenVG
hardware to accelerate \l QPainter functions. There are a few exceptions,
where Qt will use software rendering fallback.

Expand All @@ -839,7 +872,7 @@

\section1 QtOpenGL Support in Symbian

Qt 4.7 introduces the \l {QtOpenGL} module to Symbian^3. QtOpenGL is
Qt 4.7 introduces the \l {QtOpenGL} module. QtOpenGL is
supported on devices which support OpenGL ES 2.0. Symbian platforms prior
to Symbian^3 are not supported.

Expand Down

0 comments on commit 1f459f4

Please sign in to comment.