BuildingOnWindows.wiki
author ovibalea@gmail.com
Fri, 13 Jan 2012 18:26:25 +0000
changeset 187 fc67aa71e6ed
parent 186 bb25c6b754dc
child 188 5608902c4aee
permissions -rw-r--r--
Make the tutorial a bit more user friendly :P

#summary Instructions for building Hedgewars on Windows
#labels Phase-Implementation,Phase-Design,Phase-Support

= Things to download =
First of all, please use this guide over here ( http://windows.microsoft.com/en-US/windows7/find-out-32-or-64-bit) to see whether your OS is 32 or 64 bit. You will need it while doing the setup.

 # CMake - download the *Windows (Win32 Installer)* 
  * Link: http://cmake.org/cmake/resources/software.html
 # FreePascal - download the *Download as installer* - 
  * Link: http://www.freepascal.org/down/i386/win32-ftp.freepascal.org.var
 # Qt SDK 
  * Link: http://qt.nokia.com/downloads/sdk-windows-cpp-offline
 # Mercurial - pick one (TortoiseHg has a GUI and is more user-friendly)
  # TortoiseHg - Chose one based on your OS version
   * Link: http://tortoisehg.bitbucket.org/download/index.html
  # Command-line mercurial -
   * Link (OS 32 bits): http://mercurial.selenic.com/release/windows/Mercurial-2.0.2.exe
   * Link (OS 64 bits): http://mercurial.selenic.com/release/windows/Mercurial-2.0.2-x64.exe
 # _Windows building archive_ - it contains everything you need to compile Hedgewars on Windows.
   * Link: <todo>

= Setup =
 # Install CMake, but please *ensure* you select "Add CMake to the system PATH for all users", so you can run CMake directly from command line.
 # Install FreePascal.
 # Install Qt SDK, with the "Custom" option:
  * Check "Qt SDK/Miscellaneous/MinGW <any version>"
  * Check "Qt SDK/Development Tools/Desktop Qt/Qt <your version>/Desktop Qt <your version> - Mingw (it's the first checkbox)
  * Uncheck "Qt SDK/Development Tools/Symbian Toolchains"
  * Uncheck "Qt SDK/Development Tools/Harmattan"
 # Install TortoiseHg / mercurial
 # Restart the computer
 # Download the Hedgewars source:
  # Using TortoiseHg
   * Right-click in any folder on your computer
   * Select Tortoise HG -> Clone.
   * In the _Source_ textbox enter: https://hedgewars.googlecode.com/hg/
   * Press clone
  # Using Command-line mercurial
   * If you have Windows 7 skip the next 3 steps, and instead, SHIFT + Right click in the folder where you want to download the source.
   * Start _Run..._ ( WINDOWS Key + R , or Start -> Run... )
   * Enter:
{{{
cmd.exe
}}} 
   * Navigate to where you want to download the source
   * Type and execute ( The initial clone of the repository will take a while, is about 550MiB or so... ):
{{{
hg clone https://hedgewars.googlecode.com/hg/ trunk
}}}
 # Extract the _Windows Building Archive_ to the hedgewars source folder, in the *bin* directory
 # Go to the "bin/build_windows.bat" file, and modify the following:
  * SET PASCAL=<put the path to the directory that contains fpc's executable (fpc.exe)> (for example: c:\FPC\2.4.4\bin\i386-win32\)
  * SET SET QTDIR=<path to the QtSDK\Desktop\Qt\<your version>> (for example: c:\QtSDK\Desktop\Qt\4.7.3\)
 # You can now build hedgewars, by running the *bin/build_windows.bat* command.

= Building process =
Run the *bin/build_windows.bat* file each time you want to build the source.