Quassel IRC

h1. Building Quassel on Windows

{{toc}}

h2. Software Requirements

* Windows
* "Visual C++ 2008 Express":http://www.microsoft.com/germany/express/download/webdownload.aspx
* "Visual C++ 2008 Redistributables":http://www.microsoft.com/downloads/details.aspx?displaylang=de&FamilyID=9b2da534-3e03-4391-8a4d-074b9f2bc1bf
* "Platform SDK":http://www.microsoft.com/downloads/details.aspx?displaylang=en&FamilyID=e6e1c3df-a74f-4207-8586-711ebe331cdc
* "DirectX SDK":http://www.microsoft.com/downloads/details.aspx?displaylang=en&FamilyID=b66e14b8-8505-4b17-bf80-edb2df5abad4
* "OpenSSL":http://www.slproweb.com/products/Win32OpenSSL.html
* "msysgit":http://code.google.com/p/msysgit/downloads/list (>= 1.6.0.2)
* "CMake":http://www.cmake.org/cmake/resources/software.html
* "Qt for Open Source C++ development on Windows":http://trolltech.com/downloads/opensource/appdev/windows-cpp *(not MinGW)* (>= 4.5.3)
* "PostgreSQL":http://www.enterprisedb.com/products/pgdownload.do#windows (Optional for PostgreSQL-Support)

h2. Installation

h3. Step 1: Install Visual C++ 2008 Express

h3. Step 2: Install Visual C++ 2008 Redistributables.

These will be needed for OpenSSL.

h3. Step 3: Install Platform SDK

h3. Step 4: Install DirectX SDK

h3. Step 5: Install OpenSSL

The first error message can be ignored as the Redistributables were installed.

Now you have to copy the "C:\OpenSSL\lib\VC\ssleay32MT.lib" file to "C:\OpenSSL\lib\VC\ssleay32.lib".

Do the same with "C:\OpenSSL\lib\VC\static\ssleay32MT.lib" to "C:\OpenSSL\lib\VC\static\ssleay32.lib".

h3. Step 6: Install Git

h3. Step 7: Install CMake

h3. Step 8: Update the environment variables

Go to the system settings (Start => Control Panel => System), go to the "Advanced" tab and click on Environment Variables.

First you'll have to edit the "Path" variable. Append the following to the current value:
<pre>C:\Program Files\Microsoft SDKs\Windows\v6.1\Bin;C:\Program Files\Git\bin;C:\OpenSSL\bin</pre>

Next, create the following new system variables:

* LIB:
<pre>C:\Program Files\Microsoft SDKs\Windows\v6.1\Lib;C:\OpenSSL\lib\VC\static;C:\OpenSSL\lib</pre>
C:\Programme\Microsoft SDKs\Windows\v6.1\Lib;C:\Programme\Microsoft DirectX SDK (March 2009)\Lib;C:\OpenSSL\lib\VC\static;C:\OpenSSL\lib\VC;C:\OpenSSL\lib
* INCLUDE:
<pre>C:\Program Files\Microsoft SDKs\Windows\v6.1\Include;C:\OpenSSL\include</pre>
C:\Programme\Microsoft SDKs\Windows\v6.1\Include;C:\Programme\Microsoft DirectX SDK (March 2009)\Include;C:\OpenSSL\include
* QMAKESPEC:
<pre>win32-msvc2008</pre>

h3. Step 9: (Optional Install PostgreSQL and an Update the environment variables)

Install PostgreSQL and edit the "Path","LIB" and "INCLUDE" variable. Append the following to the current value:
* Path
<pre>;C:\Programme\PostgreSQL\8.4\bin</pre>

* LIB:
<pre>;C:\Programme\PostgreSQL\8.4\lib</pre>

* INCLUDE:
<pre>;C:\Programme\PostgreSQL\8.4\include</pre>

h3. Step 10: Compile and Install Qt

Create a directory (e.g. C:\dev\) and unpack Qt.

Open C:\dev\qt-win-opensource-src-4.5.3\demos\demos.pro and C:\dev\qt-win-opensource-src-4.5.3\examples\examples.pro with a Editor and replace all with:
<pre>TEMPLATE = subdirs
SUBDIRS =</pre>

Now open the Visual Studio 2008 command line.

And cd to the directory containing Qt. Now you can configure the Qt installation with the following command:
* Static without PostgreSQL-Support:
<pre>configure.exe -platform win32-msvc2008 -static -release -qt-sql-sqlite -no-qt3support -qt-zlib -qt-gif -qt-libpng -qt-libmng -qt-libtiff -qt-libjpeg -openssl-linked -confirm-license -opensource -no-phonon -no-dbus -prefix C:\dev\qt-win-opensource-src-4.5.3</pre>
* Shared with PostgreSQL-Support:
<pre>configure.exe -platform win32-msvc2008 -shared -release -qt-sql-sqlite -qt-sql-psql -no-qt3support -qt-zlib -qt-gif -qt-libpng -qt-libmng -qt-libtiff -qt-libjpeg -openssl-linked -confirm-license -opensource -phonon -phonon-backend -prefix C:\dev\qt-win-opensource-src-4.5.3</pre>

Then you can compiled Qt with these commands:
<pre>
nmake
</pre>

You can close the prompt after this.

h3. Step 11: Update the environment variables again

After installing Qt, you will have to append the following:

* Path
<pre>;C:\dev\qt-win-opensource-src-4.5.3\bin</pre>

* LIB:
<pre>;C:\dev\qt-win-opensource-src-4.5.3\lib</pre>

* INCLUDE:
<pre>;C:\dev\qt-win-opensource-src-4.5.3\include</pre>

h3. Step 12: Compile Quassel

Open a new Visual Studio 2008 command line and go to the "C:\dev" directory again. Use git to download the Quassel source code.
<pre>git clone git://git.quassel-irc.org/quassel.git</pre>

This will create a new directory "quassel" containing the source. When you want to update Quassel later, you just have to go to this directory (C:\dev\quassel) and do a "git pull" to update the source code.

Next, create a new directory in "C:\dev" in which Quassel will be built. In our case, we will simply call it "build". Change to this directory and enter the following command to configure Quassel:
<pre>cmake -G"NMake Makefiles" C:\dev\quassel -DSTATIC=1 -DWANT_CORE=ON -DWANT_QTCLIENT=ON -DWANT_MONO=ON -DWITH_PHONON=OFF -DCMAKE_BUILD_TYPE=Release -DLINK_EXTRA=dwmapi,Version,shlwapi</pre>

And after that:
<pre>nmake</pre>

This will build Quasselcore, Quasselclient and Quasselmonolithic which can be found in the "C:\dev\build" directory.

h2. Related links

* "German tutorial by Datafreak":http://www.datafreak.eu/2008/11/build-qt-and-quassel-under-windows/