How to build Qt for Symbian using the Linux makespec.

Prerequisites:

  - Working RVCT 2.2 native Linux compiler. The new publicly

    available RVCT 4.0 compiler may work, but it hasn't been tested

    yet.

  - A working GnuPoc environment. See this page for details:

    http://www.martin.st/symbian/

    Download the latest version, unpack it and run the 'install_eka2_tools' script as

    described in the last part under the EKA2 part. The part about the your own gcc

    are not needed as we use the rvct compiler.

    Make sure you do the part about Wine setup as well.

  - Anderson Lizardo's patches for GnuPoc. Look for the

    qt_s60_gnupoc_v10.patch on this page:

    http://lizardo.wordpress.com/2009/09/24/installing-qt-for-s60-daily-snapshots-on-linux/

    and carry out the instructions under point 8: Installing Open C.

Compiling:

 1. First a few environment variables need to be set:

        export RVCT22LIB=<rvct-dir>/lib/armlib

        export EPOCROOT=<s60-root>

        export PATH=$PATH:<s60-root>/epoc32/tools:<rvctInstallDir>/bin

        export PATH=$PATH:<qt-root>/bin

    Replace the s60-root with the installation directory of your SDK,

    and the qt-root with the root of your Qt repository.

    These are good candidates for putting in a script somewhere.

 2. Run configure. It needs a bit more switches than usual, so here's

    the full line:

        ./configure -developer-build -platform linux-g++ -xplatform \

            symbian/linux-armcc -little-endian -host-little-endian \

            -arch symbian

 3. Compile Qt

        cd src

        make

    and then wait for a while.

 4. Package and install Qt

        cd s60installs

    Edit Qt_template.pkg and change the first 0x2xxxxxxx to

    0xExxxxxxx. Then execute:

        makesis Qt_template.pkg

        signsis Qt_template.sis Qt_template.sisx selfsigned.cer selfsigned.key

    Then put Qt_template.sisx on a memory card and install it from

    the phone file manager.

    Alternatively, you can use the runonphone tool found in the tools

    directory of Qt. To build, this requires a separately configured

    Qt installation for Linux, unfortunately. To use it, you also

    need have App TRK running on the phone. At the time of writing,

    only bleeding edge Linux kernels are able to autodetect the USB

    serial port on the phone, but you can force detection by running:

        modprobe usbserial vendor=0xXXXX product=0xXXXX

    The XXXXs should be replaced with the two values listed for your

    device when executing "lsusb". In most distributions, this will

    lead to the creation of two devices: /dev/ttyUSB0 and

    /dev/ttyUSB1. The latter is usually the one that App TRK responds

    to. Then execute:

        runonphone -p /dev/ttyUSB1 -s Qt_template.sisx dummy.exe

    The dummy.exe argument is irrelevant, since we are not executing

    anything yet.

 5. Compile some helloworld application (I leave the details to you

    ;-)

        qmake

        make

 6. Package, install and run application.

        makesis helloworld_template.pkg

        signsis helloworld_template.sis helloworld_template.sisx \

            <QTDIR>/src/s60installs/selfsigned.cer \

            <QTDIR>/src/s60installs/selfsigned.key

    Then either install by memory card, or install and run like this:

        runonphone -p /dev/ttyUSB1 -s helloworld_template.sisx \

            helloworld.exe

 7. Enjoy "hello world" on the phone!