Update the documentation for Qt for Symbian support.

Reviewed-by: Robert Loehning
This commit is contained in:
con
2009-11-12 18:42:08 +01:00
parent 9f2940297f
commit 0a69836488
10 changed files with 25 additions and 19 deletions

Binary file not shown.

Before

Width:  |  Height:  |  Size: 32 KiB

After

Width:  |  Height:  |  Size: 49 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 31 KiB

After

Width:  |  Height:  |  Size: 48 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 58 KiB

After

Width:  |  Height:  |  Size: 51 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 39 KiB

After

Width:  |  Height:  |  Size: 52 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 16 KiB

After

Width:  |  Height:  |  Size: 12 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 7.5 KiB

After

Width:  |  Height:  |  Size: 8.4 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 6.5 KiB

After

Width:  |  Height:  |  Size: 6.5 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 3.9 KiB

After

Width:  |  Height:  |  Size: 3.5 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 11 KiB

After

Width:  |  Height:  |  Size: 13 KiB

View File

@@ -397,7 +397,7 @@
Qt Creator automatically detects if \c qmake is in the environment variable Qt Creator automatically detects if \c qmake is in the environment variable
\c PATH. This \l{glossary-system-qt}{version of Qt} is referred to as \c PATH. This \l{glossary-system-qt}{version of Qt} is referred to as
\bold{Auto-detected Qt}. If you intend to use only one version of Qt - it is \bold{Qt in PATH}. If you intend to use only one version of Qt - it is
already in your path and correctly set up for command line usage - you do already in your path and correctly set up for command line usage - you do
not need to manually configure your Qt version. not need to manually configure your Qt version.
@@ -413,7 +413,8 @@
\i \image qtcreator-qt4-qtversions.png \i \image qtcreator-qt4-qtversions.png
On Linux and Mac OS X, simply set the \gui{Path to QMake} On Linux and Mac OS X, simply set the \gui{Path to QMake}
to the \c qmake binary of the Qt installation. If a Qt is to the \c qmake binary of the Qt installation. If a Qt is
found in the \c PATH environment variable, it will show up. found in the \c PATH environment variable, it will show up
automatically as \gui{Qt in PATH}.
On both platforms, the platforms Gnu Compiler Collection (GCC) On both platforms, the platforms Gnu Compiler Collection (GCC)
is used to compile Qt. On Mac OS, the GCC compiler is part of XCode. is used to compile Qt. On Mac OS, the GCC compiler is part of XCode.
@@ -445,13 +446,20 @@
\row \row
\i \image qtcreator-qt4-qtversions-win-symbian.png \i \image qtcreator-qt4-qtversions-win-symbian.png
If you are using Qt for Symbian and your S60 SDK is registered If you are using Qt for Symbian and your S60 SDK is registered
with \c devices.exe, Qt Creator will detect the Qt version automatically. with \c devices.exe, Qt Creator will detect the Qt version
A known issue is that you cannot just point Creator to \c qmake.exe of Qt for Symbian. automatically. These are shown in the \bold{Auto-detected}
You can add the path to the Metrowerks Compiler (\gui {MWC Directory}) section in the options dialog.
if you want to use to build for the emulator. This requires Carbide 2.0 You can also manually add Qt for Symbian versions. In this case
to be installed. the MWC directory should then point to the directory you need to tell Qt Creator the path to the S60 SDK
of your Carbide installation. However, this not needed for compiling for it is supposed to use with these Qt installations.
the device. Add the path to your Carbide C++ install, version 2.0
or later, if you want to build for the emulator
(\c WINSCW tool chain).
If you want to use \c GCCE to build for your device,
you might need to add the path to the
\c{CSL Arm Toolchain} directory (\gui{CSL/GCCE Directory}),
if the compiler is not found in the \c PATH environment
variable.
\endtable \endtable
\note By default projects are compiled with the \note By default projects are compiled with the
@@ -1600,19 +1608,17 @@
For each detected S60 SDK with Qt, a special entry is made in the Qt Version Management settings For each detected S60 SDK with Qt, a special entry is made in the Qt Version Management settings
\gui{Tools -> Options... -> Qt4 -> Qt Versions}. \gui{Tools -> Options... -> Qt4 -> Qt Versions}.
\e{Note that you must use one of these special Qt version entries for building projects \e{Note that if you manually add a Qt version for Symbian, you must
for the emulator or devices. You can not just point Qt Creator to the qmake executable also manually specify the S60 SDK to use for this version.}
like you would do for a desktop version of Qt.}
\image qtcreator-qt4-qtversions-win-symbian.png \image qtcreator-qt4-qtversions-win-symbian.png
If you want to run your applications in the Symbian Emulator, you need to point Qt Creator If you want to run your applications in the Symbian Emulator, you need to point Qt Creator
to the Metrowerks Compiler that you want to use, by setting the \gui{MWC Directory} to the Metrowerks Compiler that you want to use, by setting the \gui{Carbide Directory}
of the Qt version to the corresponding Carbide.c++ installation directory. of the Qt version to the corresponding Carbide.c++ installation directory.
You can check what S60 SDKs and corresponding Qt versions are found in the You can check what S60 SDKs and corresponding Qt versions are found in the
\gui{Tools -> Options... -> Qt4 -> S60 SDKs} preference page. \gui{Tools -> Options... -> Qt4 -> S60 SDKs} preference page.
At the moment it is not possible to override the autodetected settings.
\image qtcreator-qt4-s60sdks.png \image qtcreator-qt4-s60sdks.png
@@ -1667,12 +1673,11 @@
When something goes wrong check the following things: When something goes wrong check the following things:
\list \list
\o Is the device run configuration selected as the active run configuration? \o Is the device run configuration selected as the active run configuration?
\o Did you build your application with one of the special Qt versions created for the
S60 SDKs?
\o Is the device connected via USB in \e{PC Suite} mode? \o Is the device connected via USB in \e{PC Suite} mode?
\o Is App TRK running on the device, using the USB connection, and does it have status \o Is App TRK running on the device, using the USB connection, and does it have status
\e{connected}? \e{connected}?
\o Is your device detected and selected in the run configuration details? \o Is your device detected and selected in the run configuration details?
\o Are the settings for the Qt version you use to build your project correct? Check the path to the S60 SDK, and if you need to specify the path to your compiler tool chain.
\endlist \endlist
If neither of this helps to solve your problem, search the qt-creator@trolltech.com If neither of this helps to solve your problem, search the qt-creator@trolltech.com
@@ -1887,11 +1892,12 @@
\row \row
\o \o
\raw HTML \raw HTML
Auto-detected Qt Qt in PATH
\endraw \endraw
\target glossary-system-qt \target glossary-system-qt
\o The version of Qt installed on your system. This is the Qt \o This is the Qt
version for the \c qmake command found in your \c PATH. version for the \c qmake command found in your \c PATH
environment variable.
\row \row
\o \o