1 #summary Instructions for building Hedgewars on Windows |
1 #summary Instructions for building Hedgewars on Windows |
2 #labels Phase-Implementation,Phase-Design,Phase-Support |
2 #labels Phase-Implementation,Phase-Design,Phase-Support |
3 |
3 |
4 = Building on Windows = |
4 = Building on Windows = |
5 |
5 |
6 == Things to download == |
6 == Prerequisites == |
|
7 These build instructions require at least Windows 7. |
7 First of all, figure out whether your system is a 32-bit or a 64-bit system. You can use the guide at [https://support.microsoft.com/en-us/help/15056/windows-32-64-bit-faq]. On a 64-bit system both 32-bit and 64-bit builds can be made, although 64-bit is preferred. Making a 64-bit build on a 32-bit system might be possible, but hasn't been tested. |
8 First of all, figure out whether your system is a 32-bit or a 64-bit system. You can use the guide at [https://support.microsoft.com/en-us/help/15056/windows-32-64-bit-faq]. On a 64-bit system both 32-bit and 64-bit builds can be made, although 64-bit is preferred. Making a 64-bit build on a 32-bit system might be possible, but hasn't been tested. |
8 |
9 |
9 == Required Tools == |
10 == Required Tools == |
10 Choose either 32-bit or 64-bit depending on your system and which build you want to make. |
11 Choose either 32-bit or 64-bit depending on your system and which build you want to make. |
11 |
12 |
12 # CMake: click either *Windows win32-x86 Installer* or *Windows win64-x64 Installer* |
13 * CMake: click either *Windows win32-x86 Installer* or *Windows win64-x64 Installer* |
13 * Link: https://cmake.org/download/ |
14 Link: https://cmake.org/download/ |
14 # Visual Studio: click *Download Visual Studio → Community 2019* (earlier version starting from Community 2015 Update 3 might also work) |
15 * Visual Studio: click *Download Visual Studio → Community 2019* (earlier version starting from Community 2015 Update 3 might also work) |
15 * Link: https://visualstudio.microsoft.com/ |
16 Link: https://visualstudio.microsoft.com/ |
16 # Vcpkg |
17 * Vcpkg |
17 * Link: https://github.com/Microsoft/vcpkg |
18 Link: https://github.com/Microsoft/vcpkg |
18 # !FreePascal: click *Windows 32-bit*, then download *fpc-<version>-win32.exe* (for 64-bit builds also download *fpc-<version>.i386-win32.cross.x86_64-win64.exe*) |
19 * !FreePascal: click *Windows 32-bit*, then download *fpc-<version>-win32.exe* (for 64-bit builds also download *fpc-<version>.i386-win32.cross.x86_64-win64.exe*) |
19 * Link: https://www.freepascal.org/download.html |
20 Link: https://www.freepascal.org/download.html |
20 # Mercurial: pick one (!TortoiseHg has a GUI and is more user-friendly) |
21 * Mercurial: pick one (!TortoiseHg has a GUI and is more user-friendly) |
21 * !TortoiseHg: Chose one based on your OS version |
22 # !TortoiseHg: Chose one based on your OS version |
22 * Link: https://tortoisehg.bitbucket.io/ |
23 Link: https://tortoisehg.bitbucket.io/ |
23 * Command-line mercurial |
24 # Command-line mercurial |
24 * Link: http://mercurial.selenic.com/downloads/ |
25 Link: http://mercurial.selenic.com/downloads/ |
25 |
26 |
26 == Setup == |
27 == Setup == |
27 # 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. |
28 # 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. |
28 # Install !FreePascal and if necessary the 64-bit cross-compiler plugin (the one with `cross.x86_64-win64` in the file name). |
29 # Install !FreePascal and if necessary the 64-bit cross-compiler plugin (the one with `cross.x86_64-win64` in the file name). |
29 # Install Visual Studio, ensuring the *Workloads → Desktop development with C++* and *Language packs → English* options are selected. |
30 # Install Visual Studio, ensuring the *Workloads → Desktop development with C++* and *Language packs → English* options are selected. |
35 * Right-click in any folder on your computer |
36 * Right-click in any folder on your computer |
36 * Select Tortoise HG → Clone. |
37 * Select Tortoise HG → Clone. |
37 * In the _Source_ textbox, enter: https://hg.hedgewars.org/hedgewars/ |
38 * In the _Source_ textbox, enter: https://hg.hedgewars.org/hedgewars/ |
38 * Press "clone" |
39 * Press "clone" |
39 # Using command-line Mercurial |
40 # Using command-line Mercurial |
40 * If you have Windows 7 or later, skip the next 3 steps, and instead, use Shift + Right-click in the folder where you want to download the source. |
41 * Shift + Right-click in the folder where you want to download the source and select "Open Command Prompt Window Here" or "Open PowerShell window here". |
41 * Start _Run..._ ( Press Windows key + R, or click on the Start menu, then on "Run ..." ) |
|
42 * Enter: `cmd.exe` |
|
43 * Navigate to where you want to download the source |
|
44 * Type and execute (The initial clone of the repository will take a while): `hg clone https://hg.hedgewars.org/hedgewars/ trunk` |
42 * Type and execute (The initial clone of the repository will take a while): `hg clone https://hg.hedgewars.org/hedgewars/ trunk` |
45 # Navigate to the Vcpkg directory in the command line and build the necessary libraries (this will also take a while, especially for Qt). The command is: |
43 # Navigate to the Vcpkg directory in the command line and build the necessary libraries (this will also take a while, especially for Qt). The command is: |
46 * For 32-bit builds: `.\vcpkg.exe install sdl2 sdl2-image sdl2-ttf sdl2-mixer sdl2-mixer[libvorbis] sdl2-net physfs openssl qt5-base qt5-tools ffmpeg` |
44 * For 32-bit builds: `.\vcpkg.exe install sdl2 sdl2-image sdl2-ttf sdl2-mixer sdl2-mixer[libvorbis] sdl2-net physfs openssl qt5-base qt5-tools ffmpeg` |
47 * For 64-bit builds: `.\vcpkg.exe install sdl2:x64-windows sdl2-image:x64-windows sdl2-ttf:x64-windows sdl2-mixer:x64-windows sdl2-mixer[libvorbis]:x64-windows sdl2-net:x64-windows physfs:x64-windows openssl:x64-windows qt5-base:x64-windows qt5-tools:x64-windows ffmpeg:x64-windows` |
45 * For 64-bit builds: `.\vcpkg.exe install sdl2:x64-windows sdl2-image:x64-windows sdl2-ttf:x64-windows sdl2-mixer:x64-windows sdl2-mixer[libvorbis]:x64-windows sdl2-net:x64-windows physfs:x64-windows openssl:x64-windows qt5-base:x64-windows qt5-tools:x64-windows ffmpeg:x64-windows` |
48 # Build Hedgewars |
46 # Build Hedgewars |
49 * 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). |
47 * From the Start menu run either "x86 Native Tools Command Prompt for VS 2019" or "x64 Native Tools Command Prompt for VS 2019" (if you want Hedgewars to install to the default location in `C:\Program Files`, run it as administrator). |
50 * 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` |
|
51 * Navigate to `<hedgewars_root>\tools` where `<hedgewars_root>` is the directory where you cloned the repository source to. |
48 * Navigate to `<hedgewars_root>\tools` where `<hedgewars_root>` is the directory where you cloned the repository source to. |
52 * Run `build_vcpkg.bat` script |
49 * Run `build_vcpkg.bat` script |
53 # After building, you can run Hedgewars from the installed location (default is `C:\Program Files (x86)\hedgewars\hedgewars.exe`) |
50 # After building, you can run Hedgewars from the installed location (default is `C:\Program Files\hedgewars\hedgewars.exe`) |
|
51 |
|
52 == Additional options == |
|
53 Check the top section of `build_vcpkg.bat` to change some of build options. |