Second Life Wiki - User contributions [en]

Qt Webkit OSX Build Instructions

2009-11-19T21:43:17Z

Rick Linden:

{{KBcaution|For a more recent version of the Qt/WebKit rendering library (LLQtWebKit) please go to [https://wiki.secondlife.com/wiki/LLQtWebKit this] page }}

1) Get Qt and set environment variables.

Download Qt from trolltech.com

Extract it somewhere such as
$HOME/dev/qt-4.5/

Then set the environment variable QTDIR to point to that location.
cd $HOME/dev/qt-4.5/
export QTDIR=`pwd`
export PATH=$PATH:$QTDIR/bin

2) Get llmozlib and checkout the qtwebkit branch

cd $HOME/dev
# note if you hasve write access and want to make changes,
# use git+ssh://git@code.staikos.net/srv/git/llmozlib
git clone git://code.staikos.net/llmozlib
git checkout -b qtwebkit origin/qtwebkit

3) Apply locally maintained Qt patches

cd $QTDIR

# the patch files are numbered in the order they should be applied, so this should do the right thing
for patchfile in /path/to/llmozlib/llmozlib2/qt_patches/[0-9]* /path/to/llmozlib/llmozlib2/qt_patches/qtwebkit-[0-9]* ; do
echo applying "$patchfile"
patch -p1 <"$patchfile"
done

4) Compile Qt

cd $QTDIR
./configure -opensource -no-framework -fast -no-qt3support -prefix $PWD -static -release -no-xmlpatterns -no-phonon -universal -sdk /Developer/SDKs/MacOSX10.4u.sdk/
make

If you have a multi-core machine, you can speed the make up substantially by using the '-j' argument. On a 4-core machine, I use 'make -j4'.

For some reason, this doesn't seem to build libJavaScriptCore.a. I also had to do the following:

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

5) build llmozlib2.dylib with XCode:

cd $HOME/dev/llmozlib/llmozlib2/

Create a symlink to QTDIR in the same directory as llmozlib2.xcodeproj (this allows the xcode project to find it easily):

ln -s $QTDIR QTDIR

build the "llwebkitlib" configuration of the "llmozlib2" target
(note especially: the default configuration is "Release". Be sure
to specify "llwebkitlib" as the configuration):

xcodebuild -project llmozlib2.xcodeproj -target llmozlib2 -configuration llwebkitlib

6) build ubrowser with xcode:

Get the GLUI Framework (the one tested to work is at http://lukecyca.com/wp-content/uploads/2008/12/GLUI-Framework-2.35.tgz)

run "update-mac-symbols.sh"

./update-mac-symbols.sh

build the "Release" configuration of the "llmozlib2" target:

xcodebuild -project llmozlib2.xcodeproj -target llmozlib2 -configuration Release

now build ubrowser

cd tests/ubrowser
xcodebuild -project ubrowser.xcodeproj -target ubrowser -configuration Release
open build/Release/ubrowser.app

Qt Webkit OSX Build Instructions

2009-11-18T23:42:53Z

Rick Linden:

1) Get Qt and set environment variables.

Download Qt from trolltech.com

Extract it somewhere such as
$HOME/dev/qt-4.5/

Then set the environment variable QTDIR to point to that location.
cd $HOME/dev/qt-4.5/
export QTDIR=`pwd`
export PATH=$PATH:$QTDIR/bin

2) Get llmozlib and checkout the qtwebkit branch

cd $HOME/dev
# note if you hasve write access and want to make changes,
# use git+ssh://git@code.staikos.net/srv/git/llmozlib
git clone git://code.staikos.net/llmozlib
git checkout -b qtwebkit origin/qtwebkit

3) Apply locally maintained Qt patches

cd $QTDIR

# the patch files are numbered in the order they should be applied, so this should do the right thing
for patchfile in /path/to/llmozlib/llmozlib2/qt_patches/[0-9]* /path/to/llmozlib/llmozlib2/qt_patches/qtwebkit-[0-9]* ; do
echo applying "$patchfile"
patch -p1 <"$patchfile"
done

4) Compile Qt

cd $QTDIR
./configure -opensource -no-framework -fast -no-qt3support -prefix $PWD -static -release -no-xmlpatterns -no-phonon -universal -sdk /Developer/SDKs/MacOSX10.4u.sdk/
make

If you have a multi-core machine, you can speed the make up substantially by using the '-j' argument. On a 4-core machine, I use 'make -j4'.

For some reason, this doesn't seem to build libJavaScriptCore.a. I also had to do the following:

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

5) build llmozlib2.dylib with XCode:

cd $HOME/dev/llmozlib/llmozlib2/

Create a symlink to QTDIR in the same directory as llmozlib2.xcodeproj (this allows the xcode project to find it easily):

ln -s $QTDIR QTDIR

build the "llwebkitlib" configuration of the "llmozlib2" target
(note especially: the default configuration is "Release". Be sure
to specify "llwebkitlib" as the configuration):

xcodebuild -project llmozlib2.xcodeproj -target llmozlib2 -configuration llwebkitlib

6) build ubrowser with xcode:

Get the GLUI Framework (the one tested to work is at http://lukecyca.com/wp-content/uploads/2008/12/GLUI-Framework-2.35.tgz)

run "update-mac-symbols.sh"

./update-mac-symbols.sh

build the "Release" configuration of the "llmozlib2" target:

xcodebuild -project llmozlib2.xcodeproj -target llmozlib2 -configuration Release

now build ubrowser

cd tests/ubrowser
xcodebuild -project ubrowser.xcodeproj -target ubrowser -configuration Release
open build/Release/ubrowser.app

Talk:Qt Webkit Win32 Build Instructions

2009-06-11T22:48:31Z

Rick Linden: New page: ~~~~ said: Just documenting some problems I had when attempting this: - had problems building glui: the examples don't build for some reason LINK : fatal error LNK1104: cannot open file...

[[User:Rick Linden|Rick Linden]] 22:48, 11 June 2009 (UTC) said:

Just documenting some problems I had when attempting this:

- had problems building glui: the examples don't build for some reason
LINK : fatal error LNK1104: cannot open file 'glut32.lib'
(this might be user error...?)
- In step 4), had problems building testgl:
.\testgl.cpp(39) : fatal error C1083: Cannot open include file: 'unistd.h': No such file or directory
- Had to fix uBrowser: the APIs for user actions have changed (e.g. navigateBack(id) is now userAction(id, UA_NAVIGATE_BACK)
- Had to rebuild libglut from source to get debug symbols to work

----

Qt Webkit Win32 Build Instructions

2009-06-11T01:04:02Z

Rick Linden: changed b2 from "glut.h" to "glui.h"

These are instructions for building the Qt/WebKit library as well as testgl and
uBrowser demo apps using WebKit.

If you do not have git, you can download and install from:
http://code.google.com/p/msysgit/

Select the option (number 2 of 3) to add git to your path, but not all the unix
tools that ship with it.

0) Building the open source OpenSSL library with Visual Studio:
* You can build Qt without ssl support (and skip this step) by removing -openssl from the Qt configure options.
* Download the latest tarball from http://openssl.org/source/ (Currently it is openssl-0.9.8j.tar.gz)
* Copy to C:\ and extract the contents C:\openssl-0.9.8j
* The header files are symlinks to the real files, Microsoft's compiler doesn't seem to support NTFS sysmlinks so the real files have to be copied to the include directory. Below are steps to do that in cygwin's bash. Feel free to put the equivalent dos commands here as going into bash seems like a nasty hack.
Goto cd C:\openssl-0.9.8j and Launch bash and execute the following commands
rm include/openssl/*
cd crypto/
find ./ -name "*.h" -exec cp {} ../include/openssl/ \;
cd ../ssl/
find ./ -name "*.h" -exec cp {} ../include/openssl/ \;
cd ..
cp *.h include/openssl/
* Patch the OpenSSL distribution - it's broken out of the box. Copy the following lines into a file called <code>fix.patch</code> in the <code>C:\openssl-0.9.8j\util\</code> directory:
*** Source: http://marc.info/?l=openssl-dev&m=107628900919852&q=raw
*** openssl-0.9.7c/util/mk1mf.pl Fri Mar 14 17:29:18 2003
--- openssl-0.9.7c-miket/util/mk1mf.pl Sat Feb 7 21:58:57 2004
***************
*** 485,490 ****
--- 485,495 ----
chop;

($key,$val)=/^([^=]+)=(.*)/;
+
+ # On some Windows machines, $val has linefeeds at the end, which confuses
+ # subsequent code in this file. So we strip all whitespace at the end.
+ $val =~ s/\s+$//;
+
if ($key eq "RELATIVE_DIRECTORY")
{
if ($lib ne "")

then run this command from the <code>C:\openssl-0.9.8j\util\</code> directory:
patch mk1mf.pl -p0 < fix.patch

* Compile openssl
cd C:\openssl-0.9.8j
perl Configure VC-WIN32
ms\do_masm
nmake -f ms\ntdll.mak

* The libraries libeay32.dll ssleay32.dll have now been build, they should be copied to wherever the Qt libraries are located for the applications that use them.

1) Acquire llmozlib
* 1.1) Run "Qt Snapshot Command Prompt" and clone llmozlib in the C drive.
cd C:\
git clone git://code.staikos.net/llmozlib

* 1.2) Checkout the qtwebkit branch
cd C:\llmozlib
git checkout -f -b qtwebkit origin/qtwebkit

2) Building the open source Qt snapshot with Visual Studio:
* 2.1) Set up directories
* Start/All Programs/Microsoft Visual Studio 2005/Visual Studio Tools/Visual Studio 2005 Command Prompt
mkdir C:\Qt

* 2.2) Aquire the source for Qt
Download the 4.5.0 source which is found on the ftp server here:
ftp://ftp.qtsoftware.com/qt/source/qt-all-opensource-src-4.5.0.tar.gz

* 2.3) Unzip the tarball and extract the contents of Qt in C:\Qt using your favorite zip tool ''(Note: using Cygwin's tar commmand might not work. It results in an '''Access is Denied''' error when running configure below. Use WinZip or some other tool instead.)''.
You should now have a directory C:\Qt\qt-all-opensource-src-4.5.0

* 2.4) Apply patches
There are patches that can be found in llmozlib/llmozlib2/*.patch that should be applied to Qt

* 2.4) Configure Qt, takes about 10 minutes. Open a vs console
cd C:\Qt\qt-all-opensource-src-4.5.0
configure -debug-and-release -no-qt3support -prefix C:\Qt\qt-all-opensource-src-4.5.0 -qt-libjpeg -qt-libpng -openssl-linked -I C:\openssl-0.9.8j\include -L C:\openssl-0.9.8j\out32dll

* When the license agreement appears, if you agree type:
* y<enter>
* 2.5) Build Qt, without demos. This takes 1-2 hours.
nmake sub-src

* After building Qt the release and debug libraries will be in C:\Qt\qt-all-opensource-src-4.5.0\lib
* 2.8) Create the file C:\Qt\qt-all-opensource-src-4.5.0\bin\qt-vars.bat and put the following in it

@echo off
echo Setting up a Qt environment...
set QTDIR=C:\Qt\qt-all-opensource-src-4.5.0
set PATH=C:\Qt\qt-all-opensource-src-4.5.0\bin;%PATH%
set QMAKESPEC=win32-msvc2005
call "C:\Program Files\Microsoft Visual Studio 8\Common7\Tools\vsvars32.bat"

* 2.8) Make a shortcut to qt-vars.bat on your desktop
Right-click > Properties on the shortcut and set:
Target: %COMSPEC% /k "C:\Qt\qt-all-opensource-src-4.5.0\bin\qt-vars.bat"
Start in: C:\Qt\qt-all-opensource-src-4.5.0

Rename the command prompt shortcut to "Qt 4.5 Command Prompt".

You can test it by opening the prompt and typing
qmake --version
To make sure that the version shows 4.5.0

3) Build llmozlib

* Investigate: does 'git config core.safecrlf true' solve the windows line ending issue?

* 3.1) Launch the Qt command prompt, generate the makefile and build the library
cd C:\llmozlib\llmozlib2
qmake CONFIG-=debug
nmake

If you want to build the debug version of llmozlib run 'qmake CONFIG+=debug'

* Now llmozlib is built and can be used in the viewer. If you want to build the test applications follow the next steps:

4) Acquire the test application library dependencies; Glut and GLUI
* a. Glut: http://www.xmission.com/~nate/glut.html Grab the library and header zip.
glut-3.7.6-bin.zip
* a1. Extract the contents of the zip to a c:\llmozlib\llmozlib2\tests\GL
* b. Glui32: http://glui.sourceforge.net/
glui-2.35.zip
* b1. Extract the zip
* b2. Open glui\src\msvc\glui.vcproj. Allow Visual Studio to convert the project.
* b2. Edit src\include\GL\glui.h
* b3. Move "#include <cstdlib>" to the top of the file, just under #define GLUI_GLUI_H
(hence above #include <GL/glut.h>
* b4. See http://www.lighthouse3d.com/opengl/glut/ for details on this edit
* Copy the contents of c:\llmozlib\llmozlib2\tests\GL into glue\src\include\GL
* b5. Follow the instructions in the readme.txt to compile the library
Make sure to build a release library
* b6. Copy glui.h and from the include into C:\llmozlib\llmozlib2\tests\GL
* b7. Copy glui32.lib from msvc/lib into C:\llmozlib\llmozlib2\tests\GL

4) Build testgl and run it. Open the Qt Snapshot command prompt.
cd C:\llmozlib\llmozlib2\tests\testgl
qmake CONFIG-=debug
nmake
..\GL\testgl.exe

5) Build ubrowser and run it. Open the Qt Snapshot command prompt.
cd C:\llmozlib\llmozlib2\tests\ubrowser
qmake CONFIG-=debug
nmake
..\GL\ubrowser.exe

6) Build Second life
* [[Get_source_and_compile]]
* When grabbing the source use the webkit branch https://svn.secondlife.com/svn/linden/branches/2009/webkit
* Copy Qt libraries and ssl into C:\linden\webkit\libraries\i686-win32\lib\debug & release
* Copy Qt image plugins into C:\linden\webkit\indra\build-VC80\newview\relwithdebinfo\imageformats
* Copy llmozlib and header into C:\linden\webkit\libraries\i686-win32\*

Notes:
a. To generate a Visual studio vcproj file you have to use a Qt *commercial* command prompt and run the following:
qmake -tp vc

b. Make sure all libs and app are built as Multi-threaded Dll or Multi-threaded debug dll.
In Visual Studio this is in Properties->configuration->c/c++->code generation->runtime library

Troubleshooting:
1) If you see this, you need to reorder the <cstdlib> and <GL/glut.h> includes.

C:\Program Files\Microsoft Visual Studio 8\VC\include\stdlib.h(406) : error C2381: 'exit' : redefinition; __declspec(noreturn) differs
../include\GL/glut.h(146) : see declaration of 'exit'

2) uBrowser crashes on startup in stdlib (vc8crt.dll or similar)

This happens when you mix debug and release libraries. Make sure you are using
all "release" builds of GLUI and ubrowser.

Qt Webkit Win32 Build Instructions

2009-06-09T21:43:18Z

Rick Linden: Added warning about using Cygwin's 'tar' when expanding Qt's tarball.

These are instructions for building the Qt/WebKit library as well as testgl and
uBrowser demo apps using WebKit.

If you do not have git, you can download and install from:
http://code.google.com/p/msysgit/

Select the option (number 2 of 3) to add git to your path, but not all the unix
tools that ship with it.

0) Building the open source OpenSSL library with Visual Studio:
* You can build Qt without ssl support (and skip this step) by removing -openssl from the Qt configure options.
* Download the latest tarball from http://openssl.org/source/ (Currently it is openssl-0.9.8j.tar.gz)
* Copy to C:\ and extract the contents C:\openssl-0.9.8j
* The header files are symlinks to the real files, Microsoft's compiler doesn't seem to support NTFS sysmlinks so the real files have to be copied to the include directory. Below are steps to do that in cygwin's bash. Feel free to put the equivalent dos commands here as going into bash seems like a nasty hack.
Goto cd C:\openssl-0.9.8j and Launch bash and execute the following commands
rm include/openssl/*
cd crypto/
find ./ -name "*.h" -exec cp {} ../include/openssl/ \;
cd ../ssl/
find ./ -name "*.h" -exec cp {} ../include/openssl/ \;
cd ..
cp *.h include/openssl/
* Patch the OpenSSL distribution - it's broken out of the box. Copy the following lines into a file called <code>fix.patch</code> in the <code>C:\openssl-0.9.8j\util\</code> directory:
*** Source: http://marc.info/?l=openssl-dev&m=107628900919852&q=raw
*** openssl-0.9.7c/util/mk1mf.pl Fri Mar 14 17:29:18 2003
--- openssl-0.9.7c-miket/util/mk1mf.pl Sat Feb 7 21:58:57 2004
***************
*** 485,490 ****
--- 485,495 ----
chop;

($key,$val)=/^([^=]+)=(.*)/;
+
+ # On some Windows machines, $val has linefeeds at the end, which confuses
+ # subsequent code in this file. So we strip all whitespace at the end.
+ $val =~ s/\s+$//;
+
if ($key eq "RELATIVE_DIRECTORY")
{
if ($lib ne "")

then run this command from the <code>C:\openssl-0.9.8j\util\</code> directory:
patch mk1mf.pl -p0 < fix.patch

* Compile openssl
cd C:\openssl-0.9.8j
perl Configure VC-WIN32
ms\do_masm
nmake -f ms\ntdll.mak

* The libraries libeay32.dll ssleay32.dll have now been build, they should be copied to wherever the Qt libraries are located for the applications that use them.

1) Acquire llmozlib
* 1.1) Run "Qt Snapshot Command Prompt" and clone llmozlib in the C drive.
cd C:\
git clone git://code.staikos.net/llmozlib

* 1.2) Checkout the qtwebkit branch
cd C:\llmozlib
git checkout -f -b qtwebkit origin/qtwebkit

2) Building the open source Qt snapshot with Visual Studio:
* 2.1) Set up directories
* Start/All Programs/Microsoft Visual Studio 2005/Visual Studio Tools/Visual Studio 2005 Command Prompt
mkdir C:\Qt

* 2.2) Aquire the source for Qt
Download the 4.5.0 source which is found on the ftp server here:
ftp://ftp.qtsoftware.com/qt/source/qt-all-opensource-src-4.5.0.tar.gz

* 2.3) Unzip the tarball and extract the contents of Qt in C:\Qt using your favorite zip tool ''(Note: using Cygwin's tar commmand might not work. It results in an '''Access is Denied''' error when running configure below. Use WinZip or some other tool instead.)''.
You should now have a directory C:\Qt\qt-all-opensource-src-4.5.0

* 2.4) Apply patches
There are patches that can be found in llmozlib/llmozlib2/*.patch that should be applied to Qt

* 2.4) Configure Qt, takes about 10 minutes. Open a vs console
cd C:\Qt\qt-all-opensource-src-4.5.0
configure -debug-and-release -no-qt3support -prefix C:\Qt\qt-all-opensource-src-4.5.0 -qt-libjpeg -qt-libpng -openssl-linked -I C:\openssl-0.9.8j\include -L C:\openssl-0.9.8j\out32dll

* When the license agreement appears, if you agree type:
* y<enter>
* 2.5) Build Qt, without demos. This takes 1-2 hours.
nmake sub-src

* After building Qt the release and debug libraries will be in C:\Qt\qt-all-opensource-src-4.5.0\lib
* 2.8) Create the file C:\Qt\qt-all-opensource-src-4.5.0\bin\qt-vars.bat and put the following in it

@echo off
echo Setting up a Qt environment...
set QTDIR=C:\Qt\qt-all-opensource-src-4.5.0
set PATH=C:\Qt\qt-all-opensource-src-4.5.0\bin;%PATH%
set QMAKESPEC=win32-msvc2005
call "C:\Program Files\Microsoft Visual Studio 8\Common7\Tools\vsvars32.bat"

* 2.8) Make a shortcut to qt-vars.bat on your desktop
Right-click > Properties on the shortcut and set:
Target: %COMSPEC% /k "C:\Qt\qt-all-opensource-src-4.5.0\bin\qt-vars.bat"
Start in: C:\Qt\qt-all-opensource-src-4.5.0

Rename the command prompt shortcut to "Qt 4.5 Command Prompt".

You can test it by opening the prompt and typing
qmake --version
To make sure that the version shows 4.5.0

3) Build llmozlib

* Investigate: does 'git config core.safecrlf true' solve the windows line ending issue?

* 3.1) Launch the Qt command prompt, generate the makefile and build the library
cd C:\llmozlib\llmozlib2
qmake CONFIG-=debug
nmake

If you want to build the debug version of llmozlib run 'qmake CONFIG+=debug'

* Now llmozlib is built and can be used in the viewer. If you want to build the test applications follow the next steps:

4) Acquire the test application library dependencies; Glut and GLUI
* a. Glut: http://www.xmission.com/~nate/glut.html Grab the library and header zip.
glut-3.7.6-bin.zip
* a1. Extract the contents of the zip to a c:\llmozlib\llmozlib2\tests\GL
* b. Glui32: http://glui.sourceforge.net/
glui-2.35.zip
* b1. Extract the zip
* b2. Open glui\src\msvc\glui.vcproj. Allow Visual Studio to convert the project.
* b2. Edit src\include\GL\glut.h
* b3. Move "#include <cstdlib>" to the top of the file, just under #define GLUI_GLUI_H
(hence above #include <GL/glut.h>
* b4. See http://www.lighthouse3d.com/opengl/glut/ for details on this edit
* Copy the contents of c:\llmozlib\llmozlib2\tests\GL into glue\src\include\GL
* b5. Follow the instructions in the readme.txt to compile the library
Make sure to build a release library
* b6. Copy glui.h and from the include into C:\llmozlib\llmozlib2\tests\GL
* b7. Copy glui32.lib from msvc/lib into C:\llmozlib\llmozlib2\tests\GL

4) Build testgl and run it. Open the Qt Snapshot command prompt.
cd C:\llmozlib\llmozlib2\tests\testgl
qmake CONFIG-=debug
nmake
..\GL\testgl.exe

5) Build ubrowser and run it. Open the Qt Snapshot command prompt.
cd C:\llmozlib\llmozlib2\tests\ubrowser
qmake CONFIG-=debug
nmake
..\GL\ubrowser.exe

6) Build Second life
* [[Get_source_and_compile]]
* When grabbing the source use the webkit branch https://svn.secondlife.com/svn/linden/branches/2009/webkit
* Copy Qt libraries and ssl into C:\linden\webkit\libraries\i686-win32\lib\debug & release
* Copy Qt image plugins into C:\linden\webkit\indra\build-VC80\newview\relwithdebinfo\imageformats
* Copy llmozlib and header into C:\linden\webkit\libraries\i686-win32\*

Notes:
a. To generate a Visual studio vcproj file you have to use a Qt *commercial* command prompt and run the following:
qmake -tp vc

b. Make sure all libs and app are built as Multi-threaded Dll or Multi-threaded debug dll.
In Visual Studio this is in Properties->configuration->c/c++->code generation->runtime library

Troubleshooting:
1) If you see this, you need to reorder the <cstdlib> and <GL/glut.h> includes.

C:\Program Files\Microsoft Visual Studio 8\VC\include\stdlib.h(406) : error C2381: 'exit' : redefinition; __declspec(noreturn) differs
../include\GL/glut.h(146) : see declaration of 'exit'

2) uBrowser crashes on startup in stdlib (vc8crt.dll or similar)

This happens when you mix debug and release libraries. Make sure you are using
all "release" builds of GLUI and ubrowser.