Differences

This shows you the differences between two versions of the page.

--- compile_instructions [2014/03/04 18:59] – created thooge
+++ compile_instructions [2016/12/25 15:03] (current) – [Distribution Specific Notes] thooge
@@ Line 6: / Line 6: @@
 Please read all of your platform's sections before starting. Any questions regarding this can be directed to our Support Forums at the [[http://www.hoogi.de/wolfpack/|main website]].
+Compile with:
+[[compile_bsd|BSD]] --
+[[compile_linux|Linux]] --
+[[compile_macos|MacOS]] --
+[[compile_windows|Windows]]
 ===== Windows =====
+Wolfpack requires Python and the Qt library.
+If you wish to use MySQL, you will also need to download MySQL.
+For detailled instructions see: [[compile_windows|Compiling with Windows]]
+===== Linux =====
 ==== Requirements ====
-Wolfpack requires Python 2.4.x or Python 2.6.x and Nokia's Qt 4.1.x or later (4.6.1 is recommended)
+Wolfpack requires Python 2.x and Trolltech's QT 4.x. Please note that many Linux distributions split the forementioned software into several packages. tou will need the "development" packages in additional to the "standard" ones, if that's the case in your specific distribution. Please refer to Distribution Specific Notes for details.
-If you wish to use MySQL, you will also need to download MySQL itself before compiling, since it comes with header files and libraries required to activate MySQL support on Wolfpack.
+Wolfpack will also require MySQL libraries and headers (aka development package) if you want to use MySQL, otherwise, it will default to the SQLite shiped along with Wolfpack.
-Make sure that the QTDIR enviroment variables is properly set.
+Make sure that the QTDIR and QMAKESPEC enviroment variables are properly set.
 QTDIR should point to your qt folder, that is, where $QTDIR/include, $QTDIR/lib and $QTDIR/bin/qmake can be found.
+QMAKESPEC is the platform + compiler identification, see qmake Documentation for details.
 The examples shown here will also assume that $QTDIR/bin is in your $PATH.
-=== Installing Qt ===
+==== Generating Makefiles ====
+Go to the folder containing wolfpack folders then do a chmod +x configure to fix the script permission. The configure script will try to locate the headers and libraries required in your system and pass them to qmake to generate a makefile. Some options can be enabled/disabled from arguments passed to configure, check ''%%configure --help%%'' for details on them.
-For compiling Qt yourself please follow up the specific instructions from Trolltech. Otherwise just download Qt SDK (LPGL) and install it. Don't forget to set the paths mentioned above.
+  ./configure2.py
-==== Generating Makefiles ====
+If you don't have installed the Boost-packages or want them to link statically, you have to build the special boost-library:
-Go to the folder containing wolfpack folders. Inside the build folder you should find the configure script (configure2.py) The configure script will try to locate the headers and libraries required in your system and pass them to qmake to generate a makefile. Some options can be enabled/disabled from arguments passed to configure, check configure2.py --help for details on them. To run the script, call it with configure2.py. Eventually you might have to specify the full Python path ( usually c:\Python24 ), in case that folder isn't in your PATH environment variable
-  C:\Python24\python configure.py
+  cd ../boost
-Now change to the path ../boost and do mingw32-make. After compiling change back to ../build and compile Wolfpack server by typing mingw32-make. That's it.
+  qmake
+  make
+Debian GNU/Linux [[Client]]: (In the moment you have to add a path to your Python include files e.g. /usr/include/python2.7 manually)
+Finally
+  make
+  make install
+==== Distribution Specific Notes ====
+=== Debian ===
+  * Recommended that you use at least Debian 8.x Jessie
+  * QT4 Packages: ''libqt4-core libqt4-dev''
+  * Python Packages: ''python2.7 python2.7-dev''
+  * Boost: ''libboost-python1.55.0 libboost-python-dev''
+  * OpenAL Packages: ''lobopenal1 libopenal-dev'' (only required for the client)
+  * Recommended Packages: ''python2.7-mysqldb python2.7-sqlite python2.7-xml libsqlite0 libsqlite0-dev sqlite sqlite-doc''
+  * MySQL Packages: ''libmysqlclient-dev libmysqlclient18 mysql-client mysql-common mysql-server''
-PS: You can also run make, nmake or mingw-make depending on your compiler. We recommend mingw32-make as it comes with Qt.
+The ''$QTDIR'' environment variable must be set. You can add the line ''export QTDIR=/usr/share/qt4''
+to your ''.bashrc'' file.
-==== Compiler Specific Notes ====
+You don't need to add ''$QTDIR/bin'' to your path. The QT-programs are all in ''/usr/bin''. But make sure, you configured the alternatives if you have installed both QT3 and QT4:
-Unfortunally, different compilers have some sligtly differences in make's name, or requires additional steps.
+  update-alternatives --config lrelease
+  update-alternatives --config lupdate
+  update-alternatives --config moc
+  update-alternatives --config qmake
+  update-alternatives --config uic
-=== MinGW ===
+===== MacOS X =====
-Python doesn't come with the import library file for linking with MingW, so you will have to generate it before running the configure script.
-To do so, you will need to download pexports.exe ( pexports 0.42h ). Extract it somewhere in your PATH, as a suggestion, use MingW's bin folder ( usually c:\mingw\bin ). Locate python24.dll, usually it's in c:\winnt\system32 or c:\windows\system32. Go to c:\Python24\libs ( or the equivalent to your installation ) and run pexports c:\WINNT\system32\python24.dll > python24.def to build a list of exported functions, then dlltool --dllname python24.dll --def python24.def --output-lib libpython24.a to build the import library file we need.
+see [[compile_macos]]
-  cd \Python24\libs
-  pexports c:\WINNT\system32\python24.dll > python24.def
-  dlltool --dllname python24.dll --def python24.def --output-lib libpython24.a
-If you want to enable MySQL support, you will have to take similar steps to build an import library to mysql.