LLQtWebKit Mac OSX Build Instructions

Introduction

These are instructions for building the Qt/WebKit library (LLQtWebKit) on Mac OS X as well as the test applications (testGL and uBrowser). They have been tested using XCode 3.2.1 on Mac OS X 10.6.2.

Set up

Create a directory you'll use for the build. This can be anywhere you like, but for the purposes of the example I'll use ~/llqtwebkit.

Acquire LLQtWebKit source code

• In a Web browser, navigate to http://bitbucket.org/lindenlab/llqtwebkit/
• Select "get source->zip" from menu
• A zip file of the source code will be downloaded
• Extract the files in the zip into ~/llqtwebkit (this should create the directory ~/llqtwebkit/llqtwebkit

Build the open source version of Qt using XCode

Acquire the Qt 4.6 source with our patches

• Our clone of Qt is available here: http://gitorious.org/+lindenqt/qt/lindenqt
• Download the source by clicking on the "lindenqt" branch under "Branches" and then using the "download as tar.gz" link on the right hand side of the page
  • Alternately, if you prefer you can clone the repository with git using the "clone" link on the page -- details of this are left as an exercise to the reader
• Extract the tarball into ~/llqtwebkit
• This may take some as the archive contains a lot of files
• You should now have a directory ~/llqtwebkit/qt-lindenqt
• Open a terminal window and cd to ~/llqtwebkit/qt-lindenqt directory
• run the following commands (we'll use the QTDIR variable in later steps)

export QTDIR=`pwd`
export PATH=$QTDIR/bin:$PATH

Configure Qt

• In the terminal window, make sure you're still in the directory ~/llqtwebkit/qt-lindenqt
• Run the following command:

./configure -platform macx-g++40 -no-framework -fast -no-qt3support -prefix $PWD -static -release -no-xmlpatterns -no-phonon -universal -sdk /Developer/SDKs/MacOSX10.4u.sdk/ -nomake examples -nomake demos -nomake docs -nomake translations

• When you are asked if you want to use the Commercial or Open Source version type o to select Open Source and press <enter>
• When the license agreement appears, if you agree type yes <enter>
• This operation takes around 10-15 minutes on a typical development system

Note: you can also add -opensource -confirm-license to automatically select and accept the LGPL.

Build Qt

• In the terminal window, make sure you're still in the directory ~/llqtwebkit/qt-lindenqt
• Run this command:

make

• If you're on a multicore machine, you can speed up the build substantially by using the '-j' argument to make, which will cause it to build files in parallel. For example, on a 4-core system, I use:

make -j4

• This takes a little over an hour on a 4-core Mac Pro.
• After building Qt the built libraries will be in ~/llqtwebkit/qt-lindenqt/lib
• For me, the full build fails with "duplicate symbol _sqlite3_status", but at that point it has already built most of what we need.
• The one additional piece we need is the JavaScriptCore library in Webkit. To build that do the following:

cd $QTDIR/src/3rdparty/webkit/JavaScriptCore
make

Build LLQtWebKit

• In the terminal window, change to the directory ~/llqtwebkit/llqtwebkit
• Create a symlink to QTDIR in this directory (this allows the Xcode project to find it easily):

ln -s $QTDIR QTDIR

• Open the llqtwebkit.xcodeproj project with Xcode
• Build the "Release" configuration of the "llqtwebkit" target
• The output of the build is ~/llqtwebkit/llqtwebkit/build/Release/libllqtwebkit.dylib
  • to build the Second Life viewer, this library needs to be copied to {VIEWERSRC}/libraries/universal-darwin/lib_release/ and llqtwebkit.h needs to go in {VIEWERSRC}/libraries/include/

Optional: build testgl

testgl is a simple example that uses the OpenGL GLUT toolkit to open a window, and renders web pages to an OpenGL texture using llqtwebkit.

• First, build the llqtwebkit library as described above
• In Terminal, go into the tests/testgl/ directory
• Create a symlink to your built version of the llqtwebkit library:

ln -s ../../build/Release/libllqtwebkit.dylib

• run the following commands:

qmake
make

• this should create a 'testgl' binary, which you can run from the terminal window like so:

./testgl

Optional: build ubrowser

ubrowser is a more complex example that uses the GLUI toolkit to render web pages to OpenGL textures and apply them to various 3d models.

• First, build the llqtwebkit library as described above
• Open the Xcode project at tests/ubrowser/ubrowser.xcodeproj
• Build and run using the Xcode UI