diff options
Diffstat (limited to 'doc/src/installation.qdoc')
| -rw-r--r-- | doc/src/installation.qdoc | 110 |
1 files changed, 110 insertions, 0 deletions
diff --git a/doc/src/installation.qdoc b/doc/src/installation.qdoc index 925a195..85ea20c 100644 --- a/doc/src/installation.qdoc +++ b/doc/src/installation.qdoc @@ -499,6 +499,116 @@ in the \l{Qt for Windows CE Requirements} document. We hope you will enjoy using Qt. Good luck! */ +/*! \page install-S60.html + +\title Installing Qt on S60 +\ingroup installation +\ingroup qts60 +\brief How to install Qt on S60. + +\list 1 + \o Install needed IDE and SDKs + + Make sure you have the following installed: + \list + \o \l{http://www.forum.nokia.com/main/resources/tools_and_sdks/carbide_cpp/}{Carbide.c++ v2.0.0 or higher} + \o \l{http://www.forum.nokia.com/main/resources/tools_and_sdks/S60SDK/}{S60 Platform SDK 3rd Edition FP1 or higher} + \o \l{http://www.forum.nokia.com/main/resources/technologies/openc_cpp/}{Open C/C++ for S60 3rd Edition} (automatically included in 3.2 and higher) + \endlist + + These instructions assume the above tools are installed and + that the enviroment variables for your compiler are set correctly. + + \note Users of \bold{S60 Platform SDK 3rd Edition FP1} also need special updates. The update can be found + \l{http://pepper.troll.no/s60prereleases/patches/}{here}. + + \note The wsini.ini provided with the \bold{S60 Platform SDK 5th Edition v0.9} + needs to be updated for correct font rendering in the emulator. The update can be found + \l{http://pepper.troll.no/s60prereleases/patches/}{here}. + + \o Install Qt + + Uncompress the package into the directory you want Qt installed, + e.g. \c{C:\Qt\%VERSION%}. + + \note Qt must be installed on the same drive as the S60 SDK you are + using, and the install path must not contain any spaces. + + \o Environment variables + + In order to build and use Qt, the \c PATH environment variable needs + to be extended: + + \snippet doc/src/snippets/code/doc_src_installation.qdoc 18 + + This is done by adding \c{c:\Qt\%VERSION%\bin} to the \c PATH variable. + + On Windows the PATH can be extended by navigating to + "Control Panel->System->Advanced->Environment variables". + + In addition, you must configure the environment for use with the S60 + emulator. This is done by locating the Carbide.c++ submenu on the Start + menu, and choosing "Configure environment for WINSCW command line". + + \o Configure Qt + + To configure Qt for S60, do: + + \snippet doc/src/snippets/code/doc_src_installation.qdoc 23 + + For other options, type \c{configure -help} to get a list of all available + options. + + \o Build Qt + + The Qt libraries comes pre-built for real devices. + If you are using a 3.x S60 SDK, install \c{qts60binaries\3.x\qtlibs-%VERSION%.exe} + into the S60 SDK root directory. For example: \c{C:\Symbian\9.2\S60_3rd_FP1_2\} + If you are using a 5.0 S60 SDK, install \c{qts60binaries\5.0\qtlibs-%VERSION%.exe} + into the S60 SDK root directory. For example: \c{C:\S60\devices\S60_5th_Edition_SDK_v0.9\} + + To build Qt for the emulator, type: + + \snippet doc/src/snippets/code/doc_src_installation.qdoc 24 + + Congratulations, Qt is now ready to use. + + \o Running Qt demos + + We've included a subset of the Qt demos in this package for you + to try out. An excellent starting point is the "fluidlauncher" + demo. To run the demo on a real device, you first have to install + the Qt libraries on the device. + For 3.x devices install \c{qts60binaries\3.x\qt_libs_armv5_udeb.sisx} + For 5.0 devices install \c{qts60binaries\5.0\qt_libs_armv5_udeb.sisx} + included in this package to the device. Then type: + + \snippet doc/src/snippets/code/doc_src_installation.qdoc 25 + + This will create a self-signed \c fluidlauncher_gcce_udeb.sisx and + install it to your device. + + \note You can specify your own certificate and key files as additional parameters to + \c createpackage if default ones are not suitable. + + To run the demos on the emulator simply run: + + \snippet doc/src/snippets/code/doc_src_installation.qdoc 27 + + Or, if you need to supply arguments to the program, navigate to + \c{%EPOCROOT%\Epoc32\release\winscw\udeb\} and start any of the + Qt demos located there, for example: + + \snippet doc/src/snippets/code/doc_src_installation.qdoc 26 + + For more information about building and running Qt programs on S60, + see \l{S60 - Introduction to using Qt}. + + We hope you will enjoy using Qt. + +\endlist + +*/ /*! \page requirements.html \title General Qt Requirements |