#summary Instructions for building Hedgewars on Windows

#labels Phase-Implementation,Phase-Design,Phase-Support

= Building on Windows =

== Things to download ==

First of all, figure out whether your system is a 32-bit or a 64-bit system. You can use the guide at [http://windows.microsoft.com/en-US/windows7/find-out-32-or-64-bit]. You will only be able to make a 64-bit build on a 64-bit system. 32-bit builds can be made on both 32-bit and 64-bit systems.

== Required Tools ==

  * Link: https://cmake.org/download/

  * Link: https://visualstudio.microsoft.com/

 # Vcpkg

  * Link: https://github.com/Microsoft/vcpkg

   * Link: https://www.freepascal.org/download.html

   * Link: https://www.lazarus-ide.org/index.php?page=downloads

   * Link: https://tortoisehg.bitbucket.io/

  * Command-line mercurial

   * Link: http://mercurial.selenic.com/downloads/

== Setup ==

 # Install CMake, but please *ensure* you select "Add CMake to the system PATH for all users", so you can run CMake directly from the command line.

 # Restart the computer

   * Right-click in any folder on your computer

  # Using command-line Mercurial

   * 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):

{{{

hg clone https://hg.hedgewars.org/hedgewars/ trunk

}}}

 # Run Vckpg in the command line to build the necessary libraries (this will also take a while, especially for Qt). The command is:

{{{

./vcpkg.exe install sdl2 sdl2-image sdl2-ttf sdl2-mixer sdl2-mixer[libvorbis] physfs openssl qt5-base qt5-tools ffmpeg

}}}

{{{

./vcpkg.exe install sdl2:x64-windows sdl2-image:x64-windows sdl2-ttf:x64-windows sdl2-mixer:x64-windows sdl2-mixer[libvorbis]:x64-windows physfs:x64-windows openssl:x64-windows qt5-base:x64-windows qt5-tool:x64-windows ffmpeg:x64-windows

}}}

 # Build Hedgewars

  * Run the Developer Command Prompt for VS 2019 (or other installed version) from the Start menu (if you want Hedgewars to install to the default location in *C:/Program Files (x86)*, run it as administrator).

  * For 64-bit builds, in the dev command prompt run the following command (not necessary for 32-bit builds)

{{{

VC\Auxiliary\Build\vcvarsall.bat amd64

}}}

== Caveats ==