git.cworth.org Git - apitrace/blob - INSTALL.markdown

   1 Building from source
   2 ====================
   3
   4
   5 Requirements common for all platforms:
   6
   7 * Python (requires version 2.6)
   8
   9 * CMake (tested with version 2.8)
  10
  11 Requirements to build the GUI (optional):
  12
  13 * Qt (tested with version 4.7)
  14
  15 * QJSON (tested with version 0.7.1)
  16
  17
  18 Linux / Mac OS X
  19 ----------------
  20
  21 Build as:
  22
  23     cmake -H. -Bbuild
  24     make -C build
  25
  26 You can also build the 32bit GL wrapper on 64bit distro with a multilib gcc by
  27 doing:
  28
  29     cmake -H. -Bbuild32 -DCMAKE_C_FLAGS=-m32 -DCMAKE_CXX_FLAGS=-m32 -DCMAKE_EXE_LINKER_FLAGS=-m32
  30     make -C build32 glxtrace
  31
  32
  33 Windows
  34 -------
  35
  36 Additional requirements:
  37
  38 * Microsoft Visual Studio (tested with 2008 version) or MinGW (tested with gcc version 4.4)
  39
  40 * Microsoft DirectX SDK (tested with August 2007 release)
  41
  42 To build with Visual Studio first invoke CMake GUI as:
  43
  44     cmake-gui -H. -B%cd%\build
  45
  46 and press the _Configure_ button.
  47
  48 It will try to detect most required/optional dependencies automatically.  When
  49 not found automatically, you can manually specify the location of the
  50 dependencies from the GUI.
  51
  52 If you are building with GUI support (i.e, with QT and QJSON), it should detect
  53 the official QT sdk automatically, but you will need to build QJSON yourself
  54 and also set the `QJSON_INCLUDE_DIR` and `QJSON_LIBRARIES` variables in the
  55 generated `CMakeCache.txt` when building apitrace and repeat the above
  56 sequence.
  57
  58 After you've succesfully configured, you can start the build by opening the
  59 generated `build\apitrace.sln` solution file, or invoking `cmake` as:
  60
  61     cmake --build build --config MinSizeRel
  62
  63 The steps to build 64bit version are similar, but choosing _Visual Studio 9
  64 2008 Win64_ instead of _Visual Studio 9 2008_.
  65
  66 It's also possible to instruct `cmake` build Windows binaries on Linux with
  67 [MinGW cross compilers](http://www.cmake.org/Wiki/CmakeMingw).
  68
  69