<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en_US" lang="en_US">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<!-- installation.qdoc -->
<title>Qt 4.8: Installing Qt for the Symbian Platform</title>
<link rel="stylesheet" type="text/css" href="style/style.css" />
<script src="scripts/jquery.js" type="text/javascript"></script>
<script src="scripts/functions.js" type="text/javascript"></script>
<link rel="stylesheet" type="text/css" href="style/superfish.css" />
<link rel="stylesheet" type="text/css" href="style/narrow.css" />
<!--[if IE]>
<meta name="MSSmartTagsPreventParsing" content="true">
<meta http-equiv="imagetoolbar" content="no">
<![endif]-->
<!--[if lt IE 7]>
<link rel="stylesheet" type="text/css" href="style/style_ie6.css">
<![endif]-->
<!--[if IE 7]>
<link rel="stylesheet" type="text/css" href="style/style_ie7.css">
<![endif]-->
<!--[if IE 8]>
<link rel="stylesheet" type="text/css" href="style/style_ie8.css">
<![endif]-->
<script src="scripts/superfish.js" type="text/javascript"></script>
<script src="scripts/narrow.js" type="text/javascript"></script>
</head>
<body class="" onload="CheckEmptyAndLoadList();">
<div class="header" id="qtdocheader">
<div class="content">
<div id="nav-logo">
<a href="index.html">Home</a></div>
<a href="index.html" class="qtref"><span>Qt Reference Documentation</span></a>
<div id="narrowsearch"></div>
<div id="nav-topright">
<ul>
<li class="nav-topright-home"><a href="http://qt.digia.com/">Qt HOME</a></li>
<li class="nav-topright-dev"><a href="http://qt-project.org/">DEV</a></li>
<li class="nav-topright-doc nav-topright-doc-active"><a href="http://qt-project.org/doc/">
DOC</a></li>
<li class="nav-topright-blog"><a href="http://blog.qt.digia.com/">BLOG</a></li>
</ul>
</div>
<div id="shortCut">
<ul>
<li class="shortCut-topleft-inactive"><span><a href="index.html">Qt 4.8</a></span></li>
<li class="shortCut-topleft-active"><a href="http://qt-project.org/doc/">ALL VERSIONS </a></li>
</ul>
</div>
<ul class="sf-menu" id="narrowmenu">
<li><a href="#">API Lookup</a>
<ul>
<li><a href="classes.html">Class index</a></li>
<li><a href="functions.html">Function index</a></li>
<li><a href="modules.html">Modules</a></li>
<li><a href="namespaces.html">Namespaces</a></li>
<li><a href="qtglobal.html">Global Declarations</a></li>
<li><a href="qdeclarativeelements.html">QML elements</a></li>
</ul>
</li>
<li><a href="#">Qt Topics</a>
<ul>
<li><a href="qt-basic-concepts.html">Programming with Qt</a></li>
<li><a href="qtquick.html">Device UIs & Qt Quick</a></li>
<li><a href="qt-gui-concepts.html">UI Design with Qt</a></li>
<li><a href="supported-platforms.html">Supported Platforms</a></li>
<li><a href="technology-apis.html">Qt and Key Technologies</a></li>
<li><a href="best-practices.html">How-To's and Best Practices</a></li>
</ul>
</li>
<li><a href="#">Examples</a>
<ul>
<li><a href="all-examples.html">Examples</a></li>
<li><a href="tutorials.html">Tutorials</a></li>
<li><a href="demos.html">Demos</a></li>
<li><a href="qdeclarativeexamples.html">QML Examples</a></li>
</ul>
</li>
</ul>
</div>
</div>
<div class="wrapper">
<div class="hd">
<span></span>
</div>
<div class="bd group">
<div class="sidebar">
<div class="searchlabel">
Search index:</div>
<div class="search" id="sidebarsearch">
<form id="qtdocsearch" action="" onsubmit="return false;">
<fieldset>
<input type="text" name="searchstring" id="pageType" value="" />
<div id="resultdialog">
<a href="#" id="resultclose">Close</a>
<p id="resultlinks" class="all"><a href="#" id="showallresults">All</a> | <a href="#" id="showapiresults">API</a> | <a href="#" id="showarticleresults">Articles</a> | <a href="#" id="showexampleresults">Examples</a></p>
<p id="searchcount" class="all"><span id="resultcount"></span><span id="apicount"></span><span id="articlecount"></span><span id="examplecount"></span> results:</p>
<ul id="resultlist" class="all">
</ul>
</div>
</fieldset>
</form>
</div>
<div class="box first bottombar" id="lookup">
<h2 title="API Lookup"><span></span>
API Lookup</h2>
<div id="list001" class="list">
<ul id="ul001" >
<li class="defaultLink"><a href="classes.html">Class index</a></li>
<li class="defaultLink"><a href="functions.html">Function index</a></li>
<li class="defaultLink"><a href="modules.html">Modules</a></li>
<li class="defaultLink"><a href="namespaces.html">Namespaces</a></li>
<li class="defaultLink"><a href="qtglobal.html">Global Declarations</a></li>
<li class="defaultLink"><a href="qdeclarativeelements.html">QML elements</a></li>
</ul>
</div>
</div>
<div class="box bottombar" id="topics">
<h2 title="Qt Topics"><span></span>
Qt Topics</h2>
<div id="list002" class="list">
<ul id="ul002" >
<li class="defaultLink"><a href="qt-basic-concepts.html">Programming with Qt</a></li>
<li class="defaultLink"><a href="qtquick.html">Device UIs & Qt Quick</a></li>
<li class="defaultLink"><a href="qt-gui-concepts.html">UI Design with Qt</a></li>
<li class="defaultLink"><a href="supported-platforms.html">Supported Platforms</a></li>
<li class="defaultLink"><a href="technology-apis.html">Qt and Key Technologies</a></li>
<li class="defaultLink"><a href="best-practices.html">How-To's and Best Practices</a></li>
</ul>
</div>
</div>
<div class="box" id="examples">
<h2 title="Examples"><span></span>
Examples</h2>
<div id="list003" class="list">
<ul id="ul003">
<li class="defaultLink"><a href="all-examples.html">Examples</a></li>
<li class="defaultLink"><a href="tutorials.html">Tutorials</a></li>
<li class="defaultLink"><a href="demos.html">Demos</a></li>
<li class="defaultLink"><a href="qdeclarativeexamples.html">QML Examples</a></li>
</ul>
</div>
</div>
</div>
<div class="wrap">
<div class="toolbar">
<div class="breadcrumb toolblock">
<ul>
<li class="first"><a href="index.html">Home</a></li>
<!-- Breadcrumbs go here -->
<li>Installing Qt for the Symbian Platform</li>
</ul>
</div>
<div class="toolbuttons toolblock">
<ul>
<li id="smallA" class="t_button">A</li>
<li id="medA" class="t_button active">A</li>
<li id="bigA" class="t_button">A</li>
<li id="print" class="t_button"><a href="javascript:this.print();">
<span>Print</span></a></li>
</ul>
</div>
</div>
<div class="content mainContent">
<link rel="prev" href="installation.html" />
<p class="naviNextPrevious headerNavi">
<a class="prevPage" href="installation.html">Installation</a>
</p><p/>
<div class="toc">
<h3><a name="toc">Contents</a></h3>
<ul>
<li class="level1"><a href="#step-1-set-up-the-development-environment">Step 1: Set Up the Development Environment</a></li>
<li class="level1"><a href="#step-2-install-qt">Step 2: Install Qt</a></li>
<li class="level1"><a href="#step-3-set-the-environment-variables">Step 3: Set the Environment variables</a></li>
<li class="level1"><a href="#step-4-configure-qt">Step 4: Configure Qt</a></li>
<li class="level1"><a href="#step-5-build-qt">Step 5: Build Qt</a></li>
<li class="level1"><a href="#step-7-installing-qt-libraries-on-the-device">Step 7: Installing Qt Libraries on the Device</a></li>
<li class="level1"><a href="#running-qt-demos">Running Qt demos</a></li>
</ul>
</div>
<h1 class="title">Installing Qt for the Symbian Platform</h1>
<span class="subtitle"></span>
<!-- $$$install-Symbian.html-description -->
<div class="descr"> <a name="details"></a>
<p><a href="http://qt.nokia.com/downloads">Qt SDK</a> 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.</p>
<p>Qt for the Symbian platform has some requirements that are given in more detail in the <a href="requirements-symbian.html">Qt for the Symbian platform Requirements</a> document.</p>
<p>This document describes how to install and configure Qt for the Symbian platform from scratch.</p>
<a name="step-1-set-up-the-development-environment"></a>
<h2>Step 1: Set Up the Development Environment</h2>
<p>Make sure your Symbian development environment is correctly installed and patched as explained in the <a href="requirements-symbian.html">Qt for the Symbian platform Requirements</a> document.</p>
<p>After you have finished the Symbian development environment setup, it is good to verify that environment is functional for example by compiling one of the pure Symbian examples for both emulator and HW. This can be done from command prompt as follows:</p>
<pre class="cpp"> cd <Your SDK path>\S60CppExamples\Note\group
bldmake bldfiles
abld build winscw udeb
abld build gcce urel</pre>
<p>If all steps pass without errors your Symbian development environment is very likely installed correctly.</p>
<a name="step-2-install-qt"></a>
<h2>Step 2: Install Qt</h2>
<p>Uncompress the <a href="http://qt.nokia.com/downloads">downloaded</a> source package into the directory you want Qt installed, e.g. <tt>C:\Qt\4.8.5</tt>.</p>
<p><b>Note:</b> Qt must be installed on the same drive as the Symbian SDK you are using, and the install path must not contain any spaces.</p>
<a name="step-3-set-the-environment-variables"></a>
<h2>Step 3: Set the Environment variables</h2>
<p>In order to build and use Qt, the <tt>PATH</tt> environment variable needs to be extended:</p>
<pre class="cpp"> PATH - to locate qmake, moc and other Qt tools</pre>
<p>This is done by adding <tt>c:\Qt\4.8.5\bin</tt> to the <tt>PATH</tt> variable.</p>
<p>On Windows the<tt>PATH</tt> can be extended by navigating to "Control Panel->System->Advanced->Environment variables".</p>
<p>In addition, you must configure the environment for use with the Symbian emulator. This is done by locating the Carbide.c++ submenu on the Start menu, and choosing "Configure environment for WINSCW command line".</p>
<p>If you are planning to use <tt>abld</tt> (the default build system that comes with the S60 SDK) to build Qt, you will also need to set the following environment variable:</p>
<pre class="cpp"> SYMBIANBUILD_DEPENDENCYOFF=1</pre>
<p>This is not necessary for other applications, only when building Qt.</p>
<a name="step-4-configure-qt"></a>
<h2>Step 4: Configure Qt</h2>
<p>To configure Qt for the Symbian platform, do:</p>
<pre class="cpp"> cd \Qt\4.8.5
configure -platform win32-g++ -xplatform symbian-abld</pre>
<p>(to build the tools using MinGW, and the libraries using abld)</p>
<p><b>or</b></p>
<pre class="cpp"> cd \Qt\4.8.5
configure -platform win32-g++ -xplatform symbian-sbsv2</pre>
<p>(to build the tools using MinGW, and the libraries using SBSv2)</p>
<p>Type <tt>./configure -help</tt> to get a list of all available options. The <a href="configure-options.html">Configuration Options for Qt</a> page gives a brief overview of these.</p>
<p>SBSv2 (also known as <a href="http://projects.developer.nokia.com/raptor/wiki">Raptor</a>) is a next-generation Symbian build system. SBSv2 is not officially supported by any of the S60 SDKs currently available from Forum Nokia.</p>
<a name="step-5-build-qt"></a>
<h2>Step 5: Build Qt</h2>
<p>To build Qt for the emulator, type:</p>
<pre class="cpp"> make debug-winscw</pre>
<p>To build Qt for the device, type:</p>
<pre class="cpp"> make release-armv5</pre>
<p>Congratulations, Qt is now ready to use.</p>
<a name="step-7-installing-qt-libraries-on-the-device"></a>
<h2>Step 7: Installing Qt Libraries on the Device</h2>
<p>To run a Qt application on a device, it must have Qt libraries installed.</p>
<p>Symbian devices have a pre-installed Qt as follows:</p>
<ul>
<li>Symbian Anna devices have the pre-installed Qt, Qt Mobility, and Qt Webkit.</li>
<li>Symbian Belle and later devices have the pre-installed Qt on the device firmware.</li>
</ul>
<p><a href="http://www.developer.nokia.com/Community/Wiki/Nokia_Smart_Installer_for_Symbian">Nokia Smart Installer for Symbian</a> deploys the required Qt libraries to supported S60 and Symbian devices if the libraries are not pre-installed.</p>
<p>Nokia Developer site's <a href="http://www.developer.nokia.com/Devices/Device_specifications/?filter1=qt">Device specifications</a> provide information on which devices have a pre-installed Qt and the used Qt version.</p>
<p>To create your own Qt installation package, do as follows:</p>
<pre class="cpp"> cd src\s60installs
make sis QT_SIS_OPTIONS=-i QT_SIS_CERTIFICATE=<certificate file> QT_SIS_KEY=<certificate key file>
cd ..\3rdparty\webkit\WebCore
make sis QT_SIS_OPTIONS=-i QT_SIS_CERTIFICATE=<certificate file> QT_SIS_KEY=<certificate key file></pre>
<p>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:</p>
<ul>
<li>If you have no certificate, build a self-signed Qt:<pre class="cpp"> cd src\s60installs
make sis QT_SIS_OPTIONS=-i
cd ..\3rdparty\webkit\WebCore
make sis QT_SIS_OPTIONS=-i</pre>
</li>
<li>If you have a symbian-signed developer certificate, specify the capabilities you can sign for, for example:<pre class="cpp"> cd src\s60installs
patch_capabilities.pl Qt_template.pkg release-armv5 "ALL -Tcb -AllFiles -DRM"
make sis QT_SIS_OPTIONS=-i QT_SIS_CERTIFICATE=<certificate file> QT_SIS_KEY=<certificate key file>
cd ..\3rdparty\webkit\WebCore
patch_capabilities.pl QtWebKit_template.pkg release-armv5 "ALL -Tcb -AllFiles -DRM"
make sis QT_SIS_OPTIONS=-i QT_SIS_CERTIFICATE=<certificate file> QT_SIS_KEY=<certificate key file></pre>
</li>
</ul>
<a name="running-qt-demos"></a>
<h2>Running Qt demos</h2>
<p>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.</p>
<p>Similarly, install fluidlauncher to the device:</p>
<pre class="cpp"> cd demos\embedded\fluidlauncher
make sis QT_SIS_OPTIONS=-i</pre>
<p>This will create a self-signed <tt>fluidlauncher.sis</tt> and install it to your device.</p>
<p>To run the demos on the emulator simply navigate to the directory of the demo you want to see and run:</p>
<pre class="cpp"> make run</pre>
<p>For more information about building and running Qt programs on the Symbian platform, see <a href="symbian-with-qt-introduction.html">The Symbian platform - Introduction to Qt</a>. We hope you will enjoy using Qt.</p>
</div>
<!-- @@@install-Symbian.html -->
<p class="naviNextPrevious footerNavi">
<a class="prevPage" href="installation.html">Installation</a>
</p>
</div>
</div>
</div>
<div class="ft">
<span></span>
</div>
</div>
<div class="footer">
<p>
<acronym title="Copyright">©</acronym> 2013 Digia Plc and/or its
subsidiaries. Documentation contributions included herein are the copyrights of
their respective owners.</p>
<br />
<p>
The documentation provided herein is licensed under the terms of the
<a href="http://www.gnu.org/licenses/fdl.html">GNU Free Documentation
License version 1.3</a> as published by the Free Software Foundation.</p>
<p>
Documentation sources may be obtained from <a href="http://www.qt-project.org">
www.qt-project.org</a>.</p>
<br />
<p>
Digia, Qt and their respective logos are trademarks of Digia Plc
in Finland and/or other countries worldwide. All other trademarks are property
of their respective owners. <a title="Privacy Policy"
href="http://en.gitorious.org/privacy_policy/">Privacy Policy</a></p>
</div>
<script src="scripts/functions.js" type="text/javascript"></script>
</body>
</html>
