INSTALL.cmake

   1 CMake supports and encourages out-of-source builds, which do not clutter the source directory.
   2 You can (and should) thus use an arbitrary directory for building.
   3 There is no "make distclean"; "make clean" should usually be enough since CMake actually
   4 cleans up properly (qmake often didn't). If you really want to get rid of all build files,
   5 just remove the build directory.
   6
   7 Usually, you will build Quassel as follows:
   8
   9 cd /path/to/build/dir
  10 cmake /path/to/quassel
  11 make
  12
  13 Additionally, you may add some options to the cmake call, prefixed by -D. These need to follow
  14 the source directory PATH:
  15
  16 cmake /path/to/quassel -D<option1> -D<option2>
  17
  18 NOTE: In order to reconfigure, you need to remove CMakeCache.txt (or empty
  19       the build directory), otherwise cmake will ignore modified -D options!
  20
  21 Quassel recognizes the following options:
  22
  23 -DWANT_(CORE|QTCLIENT|MONO)=(ON|OFF)
  24     Allow to choose which Quassel binaries to build.
  25
  26 -DQT=/path/to/qt
  27     Use a non-system Qt installation. This is for example useful if you have a static
  28     Qt installed in some local dir.
  29
  30 -DSTATIC=1
  31     Enable static building of Quassel. You should link the static versions of some libs
  32     (in particular libstdc++.a) into /path/to/build/dir/staticlibs in oder to create
  33     a portable binary!
  34
  35 -DSTATICWIN=1
  36     Enable static building for Windows platforms. This adds some libs that are not automatically
  37     included for some reason.
  38
  39 BUILDING ON WINDOWS:
  40 --------------------
  41 We have tested building on Windows with a statically built Qt (with its /bin directory in %PATH%)
  42 and MSVC 2005/2008. Make sure that you use a "shell" that has all needed env variables setup,
  43 such as the "Visual Studio Command Prompt". You will also need the /bin of the Microsoft SDK in
  44 your %PATH% at least for VS 2008, otherwise rc.exe is not found.
  45 Currently, only building in the shell using nmake seems to work; CMake can also create MSVC project
  46 files, but they seem to be problematic. However, YMMV.
  47
  48 After you have everything setup:
  49
  50 cd C:\path\to\quassel-build
  51 cmake -G"NMake Makefiles" C:\path\to\quassel\source -DSTATICWIN=1
  52 nmake