Build instructions

These instructions assume a clean Windows 7 environment. You should use Windows 7 build 7100 or newer. The instructions will guide you through building QtWebKit with Starlight extensions. You may choose to skip some of the steps if you already have the necessary tools installed or for example Qt compiled.

Installing Multitouch drivers

Download and install Windows 7 multitouch drivers:

• Dell Latitude XT and XT2
• HP Touchsmart IQ500, IQ800, and DX9000 Series

Setting up Development Environment

• Download and install Microsoft Visual C++ 2008 Express Edition
• Download and install Microsoft Visual C++ 2008 SP1 Redistributable
• Download and install Win32OpenSSL

Install everything with the default options. Restart your computer, when required

Building Qt

• Download Qt 4.6.0 beta1
• Extract qt-everywhere-opensource-src-4.6.0-beta1.zip to C:\qt (You may choose a different folder, but the instructions below assume that the folder is C:\qt)
• Start Microsoft Visual Studio 2008 Command prompt and type:

 set QTDIR=C:\qt
 set PATH=%QTDIR%\bin;%QTDIR%\lib;%PATH%
 set QMAKESPEC=win32-msvc2008
 cd %QTDIR%
 configure.exe -platform win32-msvc -opensource -debug-and-release -I "c:\OpenSSL\include" -L "c:\OpenSSL\lib" -qt-zlib -qt-libmng -qt-libtiff -qt-libjpeg -fast -openssl -no-webkit -ltcg
 nmake

N.B. Building Qt may take several hours.

Getting Starlight WebKit

• Download and install git
• Start Git Bash (for example from the Start menu) and type:

 cd c:
 git clone git://gitorious.org/+qtwebkit-starlight-developers/qtwebkit/qtwebkit-starlight-integration.git

N.B. The time this takes depends on your Internet connection speed, and it may take a long time on a slow connection. And then still on git to get the experimental 3d transformations patch included (optional):

cd qtwebkit-starlight-integration
git pull --no-commit origin 3dtransformation

Building Starlight WebKit

• Download and install ActivePerl
• The following external GNU tools are needed from the GnuWin32 Project. Download and install them to C:\GnuWin32:
  • Bison
  • GPerf
  • Flex
  • M4

IMPORTANT NOTE: The tools should not be installed in the "Program files" folder since the whitespace in the name of the folder causes compilation issues !

• Ensure that you have folder c:\tmp. The WebKit build relies on the existence of c:\tmp, when building in Windows. If no such folder exists, please create it before continuing.
• Start Microsoft Visual Studio 2008 Command prompt and type:

 set QTDIR=C:\qt
 set WEBKITDIR=C:\qtwebkit-starlight-integration
 set GNUWIN32BIN=C:\GnuWin32\bin
 set PATH=%QTDIR%\bin;%QTDIR%\lib;%WEBKITDIR%\WebKitBuild\Release\lib;%GNUWIN32BIN%;%PATH%
 set QMAKESPEC=win32-msvc2008
 set TMP=c:\tmp
 set TMPDIR=c:\tmp
 set TEMP=c:\tmp
 cd %WEBKITDIR%

For some reason, the build command is unable to create the WebKitBuild\Release folders by itself on some computers. In that case, you need to type the following:

 mkdir WebKitBuild
 mkdir WebKitBuild\Release

before building. Finally start building WebKit by typing:

 perl WebKitTools\Scripts\build-webkit --qt --release --qmakearg="DEFINES+=ENABLE_TOUCH_GESTURES=1" --qmakearg="DEFINES+=ENABLE_VIDEO=1" --qmakearg="DEFINES+=ENABLE_PLUGIN_PACKAGE_SIMPLE_HASH=0"

N.B. This may take a long time.

If WebKit was built successfully you should have QtLauncher.exe and QtWebKit4.dll in
C:\qtwebkit-starlight-integration\WebKitBuild\Release\bin\
You can test it by running QtLauncher:

 cd C:\qtwebkit-starlight-integration\WebKitBuild\Release\bin
 QtLauncher.exe http://www.opensource.nokia.com/Starlight

Building Starlight Browser

• Extract browser.zip to c:\browser (You may choose a different folder, but the instructions below assume that the folder is c:\browser)
• Start Microsoft Visual Studio 2008 Command prompt and type:

 set QTDIR=C:\qt
 set WEBKITDIR=C:\qtwebkit-starlight-integration
 set GNUWIN32BIN=C:\GnuWin32\bin
 set PATH=%QTDIR%\bin;%QTDIR%\lib;%WEBKITDIR%\WebKitBuild\Release\lib;%PATH%
 set QMAKESPEC=win32-msvc2008
 c:\browser
 qmake
 nmake

Now you have browser.exe built in c:\browser\release\ Run it by typing:

 cd c:\browser\release
 browser

N.B. In order to run the Starlight Browser, these DLL files must either be in the same folder with browser.exe, or in path:

• QtWebKit4.dll
• QtCore4.dll
• QtGui4.dll
• QtNetwork.dll
• QtXml4.dll
• phonon4.dll
• libeay32.dll
• libssl32.dll
• ssleay32.dll

You also need to have Microsoft Visual C++ 2008 SP1 runtime DLL:s. These are installed in the Microsoft Visual C++ 2008 SP1 Redistributable Package.

Feedback

We would very much appreciate any feedback you can give us related to this work. Either use the add new comment link below or send your comments directly to

-->