BuildingOnWindows.wiki
author alfadur
Thu, 22 Aug 2019 23:12:07 +0300
changeset 1966 4804d8c23fba
parent 1965 25554a6a7b03
child 1967 adf0a1ba96c8
permissions -rw-r--r--
add missing emphasis
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
1955
637685e52477 Update Windows building guide
alfadur
parents: 1895
diff changeset
     1
#summary Instructions for building Hedgewars on Windows
185
859277aa45f2 Add windows building wiki page.
ovibalea@gmail.com
parents:
diff changeset
     2
#labels Phase-Implementation,Phase-Design,Phase-Support
859277aa45f2 Add windows building wiki page.
ovibalea@gmail.com
parents:
diff changeset
     3
774
86e81308d67d BuildingOnWindows: Edited via web interface
unC0Rr
parents: 757
diff changeset
     4
= Building on Windows =
652
0f7445a72880 Big fat warning about these instructions being outdated
Wuzzy
parents: 594
diff changeset
     5
757
0ac49c33cf3e BuildingOnWindows: Add title, fix header levels
Wuzzy
parents: 652
diff changeset
     6
== Things to download ==
1965
25554a6a7b03 change windows build instructions to use fpc cross-compiler
alfadur
parents: 1964
diff changeset
     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.
1891
8c23bd1647de BuildingOnWindows: Link to other wikipage
Wuzzy
parents: 798
diff changeset
     8
1955
637685e52477 Update Windows building guide
alfadur
parents: 1895
diff changeset
     9
== Required Tools ==
1956
625477ff2786 BuildingOnWindows: Formatting, grammar fixes
Wuzzy
parents: 1955
diff changeset
    10
Choose either 32-bit or 64-bit depending on your system and which build you want to make.
185
859277aa45f2 Add windows building wiki page.
ovibalea@gmail.com
parents:
diff changeset
    11
1965
25554a6a7b03 change windows build instructions to use fpc cross-compiler
alfadur
parents: 1964
diff changeset
    12
 # CMake: click either *Windows win32-x86 Installer* or *Windows win64-x64 Installer*
1893
dae83669bc68 BuildingOnWindows: Update links
Wuzzy
parents: 1891
diff changeset
    13
  * Link: https://cmake.org/download/
1956
625477ff2786 BuildingOnWindows: Formatting, grammar fixes
Wuzzy
parents: 1955
diff changeset
    14
 # Visual Studio: click *Download Visual Studio → Community 2019* (earlier version starting from Community 2015 Update 3 might also work)
1955
637685e52477 Update Windows building guide
alfadur
parents: 1895
diff changeset
    15
  * Link: https://visualstudio.microsoft.com/
637685e52477 Update Windows building guide
alfadur
parents: 1895
diff changeset
    16
 # Vcpkg
637685e52477 Update Windows building guide
alfadur
parents: 1895
diff changeset
    17
  * Link: https://github.com/Microsoft/vcpkg
1966
4804d8c23fba add missing emphasis
alfadur
parents: 1965
diff changeset
    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*)
1965
25554a6a7b03 change windows build instructions to use fpc cross-compiler
alfadur
parents: 1964
diff changeset
    19
  * Link: https://www.freepascal.org/download.html
1956
625477ff2786 BuildingOnWindows: Formatting, grammar fixes
Wuzzy
parents: 1955
diff changeset
    20
 # Mercurial: pick one (!TortoiseHg has a GUI and is more user-friendly)
625477ff2786 BuildingOnWindows: Formatting, grammar fixes
Wuzzy
parents: 1955
diff changeset
    21
  * !TortoiseHg: Chose one based on your OS version
1893
dae83669bc68 BuildingOnWindows: Update links
Wuzzy
parents: 1891
diff changeset
    22
   * Link: https://tortoisehg.bitbucket.io/
1895
93f8269fca27 BuildingOnWindows: Fix indents?
Wuzzy
parents: 1894
diff changeset
    23
  * Command-line mercurial
266
76e82a7897f1 updated qt, fpc and hg links
vittorio.giovara@gmail.com
parents: 212
diff changeset
    24
   * Link: http://mercurial.selenic.com/downloads/
185
859277aa45f2 Add windows building wiki page.
ovibalea@gmail.com
parents:
diff changeset
    25
757
0ac49c33cf3e BuildingOnWindows: Add title, fix header levels
Wuzzy
parents: 652
diff changeset
    26
== Setup ==
1955
637685e52477 Update Windows building guide
alfadur
parents: 1895
diff changeset
    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.
1965
25554a6a7b03 change windows build instructions to use fpc cross-compiler
alfadur
parents: 1964
diff changeset
    28
 # Install !FreePascal and if necessary the 64-bit cross-compiler plugin (the one with `cross.x86_64-win64` in the file name).
25554a6a7b03 change windows build instructions to use fpc cross-compiler
alfadur
parents: 1964
diff changeset
    29
 # Install Visual Studio, ensuring the *Workloads → Desktop development with C++* and *Language packs → English* options are selected.
1961
7398fb5bc4eb some more fixes to windows building
alfadur
parents: 1960
diff changeset
    30
 # Install Vcpkg by following the instructions under *Quick Start* section on the project page. If you don't have Git, use the *Clone or download → Download ZIP* option and extract the ZIP file. Create `VCPKG_ROOT` environment variable pointing to the directory you've cloned/extracted it to.
1956
625477ff2786 BuildingOnWindows: Formatting, grammar fixes
Wuzzy
parents: 1955
diff changeset
    31
 # Install !TortoiseHg / Mercurial
185
859277aa45f2 Add windows building wiki page.
ovibalea@gmail.com
parents:
diff changeset
    32
 # Restart the computer
1956
625477ff2786 BuildingOnWindows: Formatting, grammar fixes
Wuzzy
parents: 1955
diff changeset
    33
 # Download the Hedgewars source code:
625477ff2786 BuildingOnWindows: Formatting, grammar fixes
Wuzzy
parents: 1955
diff changeset
    34
  # Using !TortoiseHg:
185
859277aa45f2 Add windows building wiki page.
ovibalea@gmail.com
parents:
diff changeset
    35
   * Right-click in any folder on your computer
1956
625477ff2786 BuildingOnWindows: Formatting, grammar fixes
Wuzzy
parents: 1955
diff changeset
    36
   * Select Tortoise HG → Clone.
625477ff2786 BuildingOnWindows: Formatting, grammar fixes
Wuzzy
parents: 1955
diff changeset
    37
   * In the _Source_ textbox, enter: https://hg.hedgewars.org/hedgewars/
625477ff2786 BuildingOnWindows: Formatting, grammar fixes
Wuzzy
parents: 1955
diff changeset
    38
   * Press "clone"
318
b5c9ee17f621 Updating the QtSDK link *again*. This time it does actually link to the QtSDK and it really does work.
Caironater@gmail.com
parents: 316
diff changeset
    39
  # Using command-line Mercurial
1956
625477ff2786 BuildingOnWindows: Formatting, grammar fixes
Wuzzy
parents: 1955
diff changeset
    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.
625477ff2786 BuildingOnWindows: Formatting, grammar fixes
Wuzzy
parents: 1955
diff changeset
    41
   * Start _Run..._ ( Press Windows key + R, or click on the Start menu, then on "Run ..." )
1957
166ed9944600 BuildingOnWindows: Fix bullet list screw-up
Wuzzy
parents: 1956
diff changeset
    42
   * Enter: `cmd.exe`
185
859277aa45f2 Add windows building wiki page.
ovibalea@gmail.com
parents:
diff changeset
    43
   * Navigate to where you want to download the source
1957
166ed9944600 BuildingOnWindows: Fix bullet list screw-up
Wuzzy
parents: 1956
diff changeset
    44
   * Type and execute (The initial clone of the repository will take a while): `hg clone https://hg.hedgewars.org/hedgewars/ trunk`
1961
7398fb5bc4eb some more fixes to windows building
alfadur
parents: 1960
diff changeset
    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:
1964
f597999c9599 add sdl2-net to packages list
alfadur
parents: 1961
diff changeset
    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`
f597999c9599 add sdl2-net to packages list
alfadur
parents: 1961
diff changeset
    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`
1955
637685e52477 Update Windows building guide
alfadur
parents: 1895
diff changeset
    48
 # Build Hedgewars
1958
6c8b92bd9511 BuildingOnWindows: Use backslash for Windows paths
Wuzzy
parents: 1957
diff changeset
    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).
1957
166ed9944600 BuildingOnWindows: Fix bullet list screw-up
Wuzzy
parents: 1956
diff changeset
    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`
1958
6c8b92bd9511 BuildingOnWindows: Use backslash for Windows paths
Wuzzy
parents: 1957
diff changeset
    51
  * Navigate to `<hedgewars_root>\tools` where `<hedgewars_root>` is the directory where you cloned the repository source to.
1956
625477ff2786 BuildingOnWindows: Formatting, grammar fixes
Wuzzy
parents: 1955
diff changeset
    52
  * Run `build_vcpkg.bat` script
1965
25554a6a7b03 change windows build instructions to use fpc cross-compiler
alfadur
parents: 1964
diff changeset
    53
 # After building, you can run Hedgewars from the installed location (default is `C:\Program Files (x86)\hedgewars\hedgewars.exe`)