[[PageOutline]]

= Building the Qt port on MeeGo 1.2 Harmattan with Qt 5 =

See also [wiki:BuildingQtOnLinux Building QtWebKit on Linux]

This page as well as the attempt of achieving this build is work in progress. It's also our TODO list to get there.

== Goal ==

The goal is to get WebKit trunk running on the N9/N950, to a state where it can be developed sensibly.

== Assumptions ==

   * Working Scratchbox setup.  Instructions are here: http://www.developer.nokia.com/Community/Wiki/Harmattan:Platform_Guide/Getting_started_with_Harmattan_Platform_SDK/Installing_Harmattan_Platform_SDK
   * Running N950/N9 with root, security disabled and scratchbox home directory mounted via NFS

== Installing Build Dependencies ==

Inside Scratchbox:

   * Basic build deps, shared between Qt 5/4 and WebKit stuff: {{{fakeroot apt-get build-dep qt4-x11 libgrob-qtwebkit}}}   ('''Yes, the libgrob-qtwebkit part is intentional''')
   * Dependencies needed for XCB back-end: {{{fakeroot apt-get install libxcb1 libxcb1-dev libx11-xcb1 libx11-xcb-dev libxcb-keysyms1 libxcb-keysyms1-dev libxcb-image0 libxcb-image0-dev libxcb-shm0 libxcb-shm0-dev libxcb-icccm1 libxcb-icccm1-dev libxcb-sync0 libxcb-sync0-dev libxcb-xfixes0-dev}}}
   * Ensure the render packages are gone: {{{fakeroot apt-get remove --purge libxcb-render-util0 libxcb-render-util0-dev}}}

== Getting the Qt sources ==

Outside Scratchbox:

   * {{{git clone git://gitorious.org/qt/qt5.git qt5}}}
   * {{{cd qt5}}}
   * Check out the current qt5 revision used by the bot to run tests: {{{git checkout 90f7cf110710bb59c2993d6d1848223baeb9642b}}}
   * Initialize & Clone the sub-modules needed: {{{./init-repository --module-subset=qtbase,qtxmlpatterns,qtscript,qtdeclarative}}}
   * Apply (temporary) patch to prevent crashes on ARM ( http://codereview.qt-project.org/#change,7617 ):
      * {{{cd qt5/qtdeclarative && git fetch http://codereview.qt-project.org/p/qt/qtdeclarative refs/changes/17/7617/1 && git cherry-pick FETCH_HEAD}}}

Note: '''Use the following commands to update from a previous check-out''':
   * {{{cd qt5}}}
   * {{{git fetch --recurse-submodules}}}
   * {{{git checkout 90f7cf110710bb59c2993d6d1848223baeb9642b}}}
   * {{{git submodule update --recursive}}}
   * Apply (temporary) patch to prevent crashes on ARM ( http://codereview.qt-project.org/#change,7617 ):
      * {{{cd qt5/qtdeclarative && git fetch http://codereview.qt-project.org/p/qt/qtdeclarative refs/changes/17/7617/1 && git cherry-pick FETCH_HEAD}}}

If you'd like to clean out everything(!), you can use the following sequence of commands:
   * {{{cd qt5}}}
   * {{{git submodule foreach git clean -fdx}}}
   * {{{git clean -fdx}}}
   * {{{./configure ......}}}

Note: '''DO NOT USE SHADOW BUILDS OF QT (MODULES) AT THE MOMENT'''.

== Build Instructions for Qt ==

Inside Scratchbox:
   * '''unset QTDIR'''
   * Run configure in the qt5 directory: {{{./configure -nokia-developer -fast -platform unsupported/linux-host-g++ -xplatform linux-g++-maemo -force-pkg-config -nomake tests -nomake examples}}}
   * And run {{{make}}} from the toplevel qt5 directory to build all modules in one shot.
   * Ensure your PATH is up-to-date: {{{export PATH=$PWD/qtbase/bin:$PATH}}}

== Build WebKit ==

   * {{{perl Tools/Scripts/build-webkit -2 --qt --release --no-3d-canvas --qmakearg="CONFIG+=use_qt_mobile_theme"}}}

Note: The build error referring to a missing listBoxSelectItem function should be fixed after r98557.

== Install dependencies on the device ==

   * Some packages are not in the device apt repositories and therefore need to be transfered from scratchbox.
       * Execute the following lines inside scratchbox:
         {{{
fakeroot apt-get -d install libxcb-image0 libxcb-keysyms1 libxcb-icccm1 libxcb-aux0 libxcb-event1 libxcb-property1
mkdir ~/swork/packages && cd ~/swork/packages
cp /var/cache/apt/archives/libxcb-image0_* . 
cp /var/cache/apt/archives/libxcb-keysyms1_* .
cp /var/cache/apt/archives/libxcb-icccm1_* .
cp /var/cache/apt/archives/libxcb-aux0_* .
cp /var/cache/apt/archives/libxcb-event1_* .
cp /var/cache/apt/archives/libxcb-property1_* .
}}}
       * Now ssh to the device and change into your NFS mounted directory to install the previously downloaded packages
{{{
cd /your_nfs_mount/swork/packages/
dpkg -i *
}}}

== Current Issues / TODO ==

If you find any issues that you're working on, just add them below :)

   * Support for synthetic mouse clicks when tapping. Needed to activate links and transfer focus (for any input method related work)

=== Done ===
   * Qt 5 TODOs:
      * Build issue with the -platform/-xplatform switch and fontconfig/freetype (Simon).
      * No interaction with page possible when launching MiniBrowser with -touch. Due to broken touch mocking. (Simon)
      * Text is funny mis-rendered in MiniBrowser -touch. (Fixed, pending review/inclusion in qtbase. Patch at http://paste.kde.org/134605/ )
      * Touch Input (xi2) support in Qt 5 for Harmattan (Jocelyn. Fixed in qtbase master)
      * Input method support in Qt 5 for Harmattan
   * Most obvious WebKit issues:
      * MiniBrowser doesn't show any web content on Harmattan (Jocelyn. Fixed in qtbase master)
   * Rewrite MiniBrowser in QML
   * Figure out "kinetic" scrolling (pending QScroller decision)