This document outlines the steps to setting up and building a PhoneGap Qt project for the Symbian platform.

 

1. Download and install ActivePerl.

 

2. Download and install Carbide C++.

 

     Note: Carbide C++ is required if you wish to build for the S60 Device Emulator, as the appropriate build tools are packaged with Carbide C++. However, the Device compiler is included in the S60 SDK, so if you wish to only build for devices, then Carbide C++ may not be necessary (PhoneGap untested).

 

3. Download and install your S60 SDK, depending on the devices you wish to target. I have only worked with the S60 5th Edition SDK. However you may wish to try an older version, such as S60 3rd Edition FP1 SDK or S60 3rd Edition FP2 SDK. All can be found at one of these two locations:

 

     http://www.forum.nokia.com/info/sw.nokia.com/id/ec866fab-4b76-49f6-b5a5-af0631419e9c/S60_All_in_One_SDKs.html

     http://www.forum.nokia.com/info/sw.nokia.com/id/4a7149a5-95a5-4726-913a-3c6f21eb65a5/S60-SDK-0616-3.0-mr.html

 

     Notes:

          a. If you are running Windows Vista, you must install the vista patch, located at S60_SDK_install_dir/plugins/vistapatch/Env.bat. The S60 SDK installer should prompt you at the end to do so.

          b. You should also be prompted that you do not have the CSL Arm Toolchain installed, and asked to install. Do so.

 

4. Download and install Qt for Symbian.

 

5. Download and install the Open C/C++ Plugin.

 

6. Configure the command line tools for building for the emulator, by running Start -> Programs -> Nokia -> Carbide.c++ -> Configure environment for WINSCW command line (assuming you plan to build for the S60 Emulator). Only has to be done once.

 

7. Download / clone the PhoneGap Qt source code:

 

     a. Clone with git:

 

          git clone http://github.com/wildabeast/phonegap-symbian.qt.git phonegap-qt

 

          the default phonegap application, located in framework/www, is my phonegap-demo application (as a git submodule). to get this:

               cd phonegap-qt

               git submodule init

               git submodule update

          or populate the www folder with your own PhoneGap web application

 

     b. Download the source:

          click the "Download Source" button on http://github.com/wildabeast/phonegap-symbian.qt

          extract the downloaded archive

          to use my phonegap-demo app, go to http://github.com/wildabeast/phonegap-demo and click the "Download Source" button

          extract the archive into the phonegap-symbian.qt/framework/www directory

          otherwise populate the www folder with your own PhoneGap web application

 

 

8. Build the project, and deploy your application:

 

     Run Start -> Programs -> Qt for Symbian -> Qt for Symbian Command Prompt

 

     Navigate in the command prompt to the root of the phonegap-qt repo    

 

     To build and run on the emulator, run

          make run

 

     To build a sis for the device, run

          make build

 

     Notes:

           a. To run a PhoneGap Qt application on your device, you'll need to install Qt (and its prerequisites), and QtWebkit, on your device:

               http://wiki.forum.nokia.com/index.php/Installing_Qt_on_Symbian#Running__Qt_applications_on_a_S60_device

               After installing the above, install qtwebkit.sis from the root folder of your Qt installation (i.e. C:\Qt\4.6.2\qtwebkit.sis).

          b. To install the sis file, you'll need to sign it. Visit www.symbiansigned.com, and use the Open Signed Online option, or explore the other certificate options there.