See Also:

These instructions assume you are building on an OSX system with Mac Ports installed.

Install the qt4-mac (4.7.1) port

sudo port install qt4-mac +debug
export QTDIR=/opt/local

Checkout the Code

You'll need to check out WebKit from SVN or QtWebKit from Git

svn checkout WebKit # WebKit SVN Trunk


git clone git:// # Git mirror

Build WebKit

First follow the instructions there to get the sources. The Qt port is part of the WebKit source tree, so you don't need anything extra.

If you are planning to build with video enabled, you must install qt-mobility as a pre-requisite. It's available in MacPorts, but can also be built from source if you need an up-to-date version:

git clone
git checkout 1.1
sudo make install

Finally, set the QTDIR environment variable to Qt 4.x's installation path and make sure Qt 4.x's qmake is the first qmake in your PATH (typically by running export PATH=$QTDIR/bin:$PATH). If your qmake binary has a different name, e.g. when using Debian, use the --qmake= option to specify the name.

If you also build other ports on the same machine, make sure to zap the build directories (WebKitBuild/) first. You can also override the build directory with the WEBKITOUTPUTDIR environment variable.

Build WebKit and the Qt test browser with

WebKit/Tools/Scripts/build-webkit --qt

build-webkit (see above) also supports special variable for specifying the OBJDIR directory, as well as some configure and build arguments

WEBKIT_OUTPUTDIR=`pwd`/qtbuild  WebKit/Tools/Scripts/build-webkit --qt --makeargs="-j20 -s" --no-video --debug

If there is a problem with include file, try to pass more arguments to the build-webkit script, e.g. (all in one line)


If the build fails with this error message:

Undefined symbols:
 "WebCore::CSSParser::lex()", referenced from:
     WebCore::CSSParser::lex(void*)in libwebcored.a(CSSParser.o)

chances are you are using MacPorts flex, which spews warnings about "the character range … is ambiguous in a case insensitive scanner" and doesn’t generate any output. Make sure /usr/bin/flex is used, perhaps by putting /usr/bin on your path before MacPorts’ /opt/local.

Finish Up and Run

Rerunning the build should recompile CSSParser.cpp and link correctly.

${WEBKITSRCDIR}/Tools/Scripts/build-webkit --qt --qmake=qmake-4.5 --makeargs="-j2" -spec macx-g++ --no-video --debug

Finally start the demo Qt browser:

${WEBKITSRCDIR}/Tools/Scripts/run-launcher --qt --debug # After this, check the dock and you'll see an icon for a Qt console app ...
Last modified 4 years ago Last modified on Jun 13, 2013 8:59:15 AM