author | Wuzzy |
Fri, 19 Apr 2019 16:07:50 +0100 | |
changeset 1831 | 365c30b4c669 |
parent 1691 | 244c3e2ebc4c |
child 1998 | 32149ab9ebda |
permissions | -rw-r--r-- |
494
37952cd70b0d
Add generic dependency list for non-Debian users.
almikes@aol.com
parents:
493
diff
changeset
|
1 |
#summary Instructions for building the development version of Hedgewars on GNU/Linux (slight Debian focus) |
129
751dee35e4f1
Created wiki page with build instruction for ubuntu
vittorio.giovara@gmail.com
parents:
diff
changeset
|
2 |
#labels Phase-Implementation,Phase-Deploy,Phase-Support |
751dee35e4f1
Created wiki page with build instruction for ubuntu
vittorio.giovara@gmail.com
parents:
diff
changeset
|
3 |
|
493 | 4 |
= Building on GNU/Linux = |
5 |
== Introduction == |
|
395
2ea04ea4594d
Violated wiki page BuildingOnLinux through web user interface.
sheepyluva@gmail.com
parents:
389
diff
changeset
|
6 |
|
494
37952cd70b0d
Add generic dependency list for non-Debian users.
almikes@aol.com
parents:
493
diff
changeset
|
7 |
This page contains both generic and copy-and-paste instructions for a Hedgewars development build. |
395
2ea04ea4594d
Violated wiki page BuildingOnLinux through web user interface.
sheepyluva@gmail.com
parents:
389
diff
changeset
|
8 |
|
494
37952cd70b0d
Add generic dependency list for non-Debian users.
almikes@aol.com
parents:
493
diff
changeset
|
9 |
It has a partial focus on Debian, but this guide attempts to include generic information as well. |
129
751dee35e4f1
Created wiki page with build instruction for ubuntu
vittorio.giovara@gmail.com
parents:
diff
changeset
|
10 |
|
798
30c5f1ebd552
global replace of http with https for hedgewars.org wiki links
nemo
parents:
686
diff
changeset
|
11 |
Also, see https://hedgewars.org/download.html if you are just looking to play latest stable—there’s a good chance it exists for your distribution. |
493 | 12 |
|
13 |
== Prerequisites == |
|
656 | 14 |
The first section contains dependency lists, the second section contain copy-and-paste instructions for Debian and derivatives (Ubuntu, Linux Mint, etc.). |
494
37952cd70b0d
Add generic dependency list for non-Debian users.
almikes@aol.com
parents:
493
diff
changeset
|
15 |
|
37952cd70b0d
Add generic dependency list for non-Debian users.
almikes@aol.com
parents:
493
diff
changeset
|
16 |
=== Required packages === |
547 | 17 |
For a full list see [Dependencies Dependencies]. |
494
37952cd70b0d
Add generic dependency list for non-Debian users.
almikes@aol.com
parents:
493
diff
changeset
|
18 |
|
509
283791011d7c
Edited wiki page BuildingOnLinux through web user interface.
sheepyluva@gmail.com
parents:
497
diff
changeset
|
19 |
In most Linux distributions, you should find readily available packages. |
494
37952cd70b0d
Add generic dependency list for non-Debian users.
almikes@aol.com
parents:
493
diff
changeset
|
20 |
|
656 | 21 |
Please note that for libraries, you also need their development headers. Some distributions (most notably Debian and its derivatives) provide separate packages for the headers. |
494
37952cd70b0d
Add generic dependency list for non-Debian users.
almikes@aol.com
parents:
493
diff
changeset
|
22 |
|
509
283791011d7c
Edited wiki page BuildingOnLinux through web user interface.
sheepyluva@gmail.com
parents:
497
diff
changeset
|
23 |
=== Resolving dependencies under Debian and Debian-based systems (e.g. Mint, Ubuntu) === |
494
37952cd70b0d
Add generic dependency list for non-Debian users.
almikes@aol.com
parents:
493
diff
changeset
|
24 |
These line contain `apt-get` lines you can simply paste into your shell and execute. Please remember to copy the _entire_ `apt-get` lines! |
129
751dee35e4f1
Created wiki page with build instruction for ubuntu
vittorio.giovara@gmail.com
parents:
diff
changeset
|
25 |
|
751dee35e4f1
Created wiki page with build instruction for ubuntu
vittorio.giovara@gmail.com
parents:
diff
changeset
|
26 |
{{{ |
1687
425eb8f784a9
Drop 0.9.22 reference to tidy up. - not much point in building anything that old anymore - if anyone wants ancient builds of server, eh, the wiki is versioned.
nemo
parents:
1529
diff
changeset
|
27 |
sudo apt-get install mercurial cmake g++ qtbase5-dev qtbase5-private-dev qttools5-dev-tools qttools5-dev qt5-style-plugins libsdl-ttf2.0-dev libsdl2-dev libsdl2-net-dev libsdl2-mixer-dev libsdl2-image-dev libsdl2-ttf-dev liblua5.1-dev fpc libphysfs-dev fonts-dejavu-core ttf-wqy-zenhei |
129
751dee35e4f1
Created wiki page with build instruction for ubuntu
vittorio.giovara@gmail.com
parents:
diff
changeset
|
28 |
}}} |
1523
b67aa6e196de
BuildingOnLinux: Flip order of apt-get lines in order of relevance
Wuzzy
parents:
1320
diff
changeset
|
29 |
|
1687
425eb8f784a9
Drop 0.9.22 reference to tidy up. - not much point in building anything that old anymore - if anyone wants ancient builds of server, eh, the wiki is versioned.
nemo
parents:
1529
diff
changeset
|
30 |
If you are on debian stable as of 2018-12-14, you may have to install the backport of physfs. |
425eb8f784a9
Drop 0.9.22 reference to tidy up. - not much point in building anything that old anymore - if anyone wants ancient builds of server, eh, the wiki is versioned.
nemo
parents:
1529
diff
changeset
|
31 |
|
1523
b67aa6e196de
BuildingOnLinux: Flip order of apt-get lines in order of relevance
Wuzzy
parents:
1320
diff
changeset
|
32 |
If you want PNG screenshots (instead of BMP screenshots), add: |
247 | 33 |
{{{ |
34 |
sudo apt-get install libpng12-dev |
|
35 |
}}} |
|
36 |
If you want video recording, add: |
|
37 |
{{{ |
|
265 | 38 |
sudo apt-get install libavcodec-dev libavformat-dev freeglut3-dev |
247 | 39 |
}}} |
40 |
If you want to try building the server as well (requires at least libghc base 4.3 now) try these too: |
|
910 | 41 |
|
1523
b67aa6e196de
BuildingOnLinux: Flip order of apt-get lines in order of relevance
Wuzzy
parents:
1320
diff
changeset
|
42 |
{{{ |
1529 | 43 |
sudo apt-get install ghc libghc-binary-dev libghc-bytestring-show-dev libghc-sandi-dev libghc-deepseq-dev libghc-hslogger-dev libghc-mtl-dev libghc-network-dev libghc-parsec3-dev libghc-utf8-string-dev libghc-vector-dev libghc-random-dev libghc-zlib-dev libghc-sha-dev libghc-entropy-dev libghc-regex-tdfa-dev libghc-aeson-dev libghc-yaml-dev libghc-text-dev |
1523
b67aa6e196de
BuildingOnLinux: Flip order of apt-get lines in order of relevance
Wuzzy
parents:
1320
diff
changeset
|
44 |
}}} |
1687
425eb8f784a9
Drop 0.9.22 reference to tidy up. - not much point in building anything that old anymore - if anyone wants ancient builds of server, eh, the wiki is versioned.
nemo
parents:
1529
diff
changeset
|
45 |
|
425eb8f784a9
Drop 0.9.22 reference to tidy up. - not much point in building anything that old anymore - if anyone wants ancient builds of server, eh, the wiki is versioned.
nemo
parents:
1529
diff
changeset
|
46 |
Note that Haskell is also required to build Hedgewars 0.9.25 on 32 bit linux due to a FreePascal alignment bug triggered by an undisableable SDL2 CPU feature detection. 0.9.24 and 0.9.23 have same bug, so will not function properly on 32 bit Linux. |
129
751dee35e4f1
Created wiki page with build instruction for ubuntu
vittorio.giovara@gmail.com
parents:
diff
changeset
|
47 |
|
493 | 48 |
== Fetching the source code == |
395
2ea04ea4594d
Violated wiki page BuildingOnLinux through web user interface.
sheepyluva@gmail.com
parents:
389
diff
changeset
|
49 |
|
2ea04ea4594d
Violated wiki page BuildingOnLinux through web user interface.
sheepyluva@gmail.com
parents:
389
diff
changeset
|
50 |
Below you find instructions for downloading the Hedgewars source code from the development repository. |
2ea04ea4594d
Violated wiki page BuildingOnLinux through web user interface.
sheepyluva@gmail.com
parents:
389
diff
changeset
|
51 |
|
798
30c5f1ebd552
global replace of http with https for hedgewars.org wiki links
nemo
parents:
686
diff
changeset
|
52 |
If you have already downloaded and unpacked the source code version of your choice (e.g. the source tarball from the [https://hedgewars.org/download.html download page]), just {{{cd}}} to your copy of the Hedgewars source in a terminal and go straight to the building section further below. |
395
2ea04ea4594d
Violated wiki page BuildingOnLinux through web user interface.
sheepyluva@gmail.com
parents:
389
diff
changeset
|
53 |
---- |
129
751dee35e4f1
Created wiki page with build instruction for ubuntu
vittorio.giovara@gmail.com
parents:
diff
changeset
|
54 |
|
751dee35e4f1
Created wiki page with build instruction for ubuntu
vittorio.giovara@gmail.com
parents:
diff
changeset
|
55 |
{{{ |
263
afcb38bfd761
Revert use of build dir. Nice idea, but breaks pas2c and confused people. Esp people who had done this before. For most people, a purge is adequate if they need to clean up. Heck, that's what unc0rr and I apparently do, or we would have noticed the pas2c thing earlier
kyberneticist@gmail.com
parents:
253
diff
changeset
|
56 |
mkdir -p ~/games ~/hg/hedgewars/ |
129
751dee35e4f1
Created wiki page with build instruction for ubuntu
vittorio.giovara@gmail.com
parents:
diff
changeset
|
57 |
cd ~/hg/hedgewars |
798
30c5f1ebd552
global replace of http with https for hedgewars.org wiki links
nemo
parents:
686
diff
changeset
|
58 |
hg clone -v https://hg.hedgewars.org/hedgewars/ trunk |
129
751dee35e4f1
Created wiki page with build instruction for ubuntu
vittorio.giovara@gmail.com
parents:
diff
changeset
|
59 |
}}} |
751dee35e4f1
Created wiki page with build instruction for ubuntu
vittorio.giovara@gmail.com
parents:
diff
changeset
|
60 |
|
1691 | 61 |
The initial clone of the repository will take a while, is just under 700 MiB, due to all the multimedia revisions. |
333
5b70b52c17c4
Edited wiki page BuildingOnLinux through web user interface.
sheepyluva@gmail.com
parents:
332
diff
changeset
|
62 |
After that switch to the trunk folder: |
129
751dee35e4f1
Created wiki page with build instruction for ubuntu
vittorio.giovara@gmail.com
parents:
diff
changeset
|
63 |
|
751dee35e4f1
Created wiki page with build instruction for ubuntu
vittorio.giovara@gmail.com
parents:
diff
changeset
|
64 |
{{{ |
263
afcb38bfd761
Revert use of build dir. Nice idea, but breaks pas2c and confused people. Esp people who had done this before. For most people, a purge is adequate if they need to clean up. Heck, that's what unc0rr and I apparently do, or we would have noticed the pas2c thing earlier
kyberneticist@gmail.com
parents:
253
diff
changeset
|
65 |
cd trunk |
333
5b70b52c17c4
Edited wiki page BuildingOnLinux through web user interface.
sheepyluva@gmail.com
parents:
332
diff
changeset
|
66 |
}}} |
5b70b52c17c4
Edited wiki page BuildingOnLinux through web user interface.
sheepyluva@gmail.com
parents:
332
diff
changeset
|
67 |
|
5b70b52c17c4
Edited wiki page BuildingOnLinux through web user interface.
sheepyluva@gmail.com
parents:
332
diff
changeset
|
68 |
If you want to build the latest release version (so that you can play with other people online) use this command: |
5b70b52c17c4
Edited wiki page BuildingOnLinux through web user interface.
sheepyluva@gmail.com
parents:
332
diff
changeset
|
69 |
{{{ |
1688 | 70 |
hg update 0.9.25 |
333
5b70b52c17c4
Edited wiki page BuildingOnLinux through web user interface.
sheepyluva@gmail.com
parents:
332
diff
changeset
|
71 |
}}} |
1689 | 72 |
Note. Do *not* run the command above if you want to play the latest development code (currently 0.9.26-dev). |
333
5b70b52c17c4
Edited wiki page BuildingOnLinux through web user interface.
sheepyluva@gmail.com
parents:
332
diff
changeset
|
73 |
|
395
2ea04ea4594d
Violated wiki page BuildingOnLinux through web user interface.
sheepyluva@gmail.com
parents:
389
diff
changeset
|
74 |
|
493 | 75 |
== Building process == |
395
2ea04ea4594d
Violated wiki page BuildingOnLinux through web user interface.
sheepyluva@gmail.com
parents:
389
diff
changeset
|
76 |
|
493 | 77 |
Now let’s configure and build! |
395
2ea04ea4594d
Violated wiki page BuildingOnLinux through web user interface.
sheepyluva@gmail.com
parents:
389
diff
changeset
|
78 |
|
2ea04ea4594d
Violated wiki page BuildingOnLinux through web user interface.
sheepyluva@gmail.com
parents:
389
diff
changeset
|
79 |
If you want to install Hedgewars *just for your user account* run |
333
5b70b52c17c4
Edited wiki page BuildingOnLinux through web user interface.
sheepyluva@gmail.com
parents:
332
diff
changeset
|
80 |
{{{ |
263
afcb38bfd761
Revert use of build dir. Nice idea, but breaks pas2c and confused people. Esp people who had done this before. For most people, a purge is adequate if they need to clean up. Heck, that's what unc0rr and I apparently do, or we would have noticed the pas2c thing earlier
kyberneticist@gmail.com
parents:
253
diff
changeset
|
81 |
cmake -DCMAKE_BUILD_TYPE="DEBUG" -DCMAKE_INSTALL_PREFIX="$HOME/games" -DDATA_INSTALL_DIR="$HOME/games" -DNOSERVER=1 |
129
751dee35e4f1
Created wiki page with build instruction for ubuntu
vittorio.giovara@gmail.com
parents:
diff
changeset
|
82 |
make install |
751dee35e4f1
Created wiki page with build instruction for ubuntu
vittorio.giovara@gmail.com
parents:
diff
changeset
|
83 |
}}} |
395
2ea04ea4594d
Violated wiki page BuildingOnLinux through web user interface.
sheepyluva@gmail.com
parents:
389
diff
changeset
|
84 |
If you want to install Hedgewars *system-wide* (not recommended for development builds) then run |
2ea04ea4594d
Violated wiki page BuildingOnLinux through web user interface.
sheepyluva@gmail.com
parents:
389
diff
changeset
|
85 |
|
2ea04ea4594d
Violated wiki page BuildingOnLinux through web user interface.
sheepyluva@gmail.com
parents:
389
diff
changeset
|
86 |
{{{ |
2ea04ea4594d
Violated wiki page BuildingOnLinux through web user interface.
sheepyluva@gmail.com
parents:
389
diff
changeset
|
87 |
cmake -DCMAKE_BUILD_TYPE="RELEASE" -DNOSERVER=1 |
2ea04ea4594d
Violated wiki page BuildingOnLinux through web user interface.
sheepyluva@gmail.com
parents:
389
diff
changeset
|
88 |
sudo make install |
2ea04ea4594d
Violated wiki page BuildingOnLinux through web user interface.
sheepyluva@gmail.com
parents:
389
diff
changeset
|
89 |
}}} |
2ea04ea4594d
Violated wiki page BuildingOnLinux through web user interface.
sheepyluva@gmail.com
parents:
389
diff
changeset
|
90 |
|
493 | 91 |
*Important*: If you decided against png-screenshots or video-recording support, please append `-DNOPNG=1` and/or `-DNOVIDEOREC=1` to the cmake command line respectively! |
327 | 92 |
|
493 | 93 |
If you want to build the server as well, change `-DNOSERVER=1` to `-DNOSERVER=0` |
327 | 94 |
|
129
751dee35e4f1
Created wiki page with build instruction for ubuntu
vittorio.giovara@gmail.com
parents:
diff
changeset
|
95 |
|
493 | 96 |
then wait for the build to complete, then run … |
129
751dee35e4f1
Created wiki page with build instruction for ubuntu
vittorio.giovara@gmail.com
parents:
diff
changeset
|
97 |
|
751dee35e4f1
Created wiki page with build instruction for ubuntu
vittorio.giovara@gmail.com
parents:
diff
changeset
|
98 |
{{{ |
751dee35e4f1
Created wiki page with build instruction for ubuntu
vittorio.giovara@gmail.com
parents:
diff
changeset
|
99 |
~/games/bin/hedgewars |
751dee35e4f1
Created wiki page with build instruction for ubuntu
vittorio.giovara@gmail.com
parents:
diff
changeset
|
100 |
}}} |
395
2ea04ea4594d
Violated wiki page BuildingOnLinux through web user interface.
sheepyluva@gmail.com
parents:
389
diff
changeset
|
101 |
or just {{{hedgewars}}} if you did a system-wide install. |
129
751dee35e4f1
Created wiki page with build instruction for ubuntu
vittorio.giovara@gmail.com
parents:
diff
changeset
|
102 |
|
493 | 103 |
You can also create a launcher for it on your desktop or on applications menu if you wish, using the `$HOME/games/bin/hedgewars` path |
129
751dee35e4f1
Created wiki page with build instruction for ubuntu
vittorio.giovara@gmail.com
parents:
diff
changeset
|
104 |
|
493 | 105 |
== Build latest development code repository updates == |
395
2ea04ea4594d
Violated wiki page BuildingOnLinux through web user interface.
sheepyluva@gmail.com
parents:
389
diff
changeset
|
106 |
|
2ea04ea4594d
Violated wiki page BuildingOnLinux through web user interface.
sheepyluva@gmail.com
parents:
389
diff
changeset
|
107 |
If you have built from your repository clone before and now you want to download more recent updates and rebuild Hedgewars with them, then run |
129
751dee35e4f1
Created wiki page with build instruction for ubuntu
vittorio.giovara@gmail.com
parents:
diff
changeset
|
108 |
|
751dee35e4f1
Created wiki page with build instruction for ubuntu
vittorio.giovara@gmail.com
parents:
diff
changeset
|
109 |
{{{ |
263
afcb38bfd761
Revert use of build dir. Nice idea, but breaks pas2c and confused people. Esp people who had done this before. For most people, a purge is adequate if they need to clean up. Heck, that's what unc0rr and I apparently do, or we would have noticed the pas2c thing earlier
kyberneticist@gmail.com
parents:
253
diff
changeset
|
110 |
cd ~/hg/hedgewars/trunk |
afcb38bfd761
Revert use of build dir. Nice idea, but breaks pas2c and confused people. Esp people who had done this before. For most people, a purge is adequate if they need to clean up. Heck, that's what unc0rr and I apparently do, or we would have noticed the pas2c thing earlier
kyberneticist@gmail.com
parents:
253
diff
changeset
|
111 |
hg pull -u |
afcb38bfd761
Revert use of build dir. Nice idea, but breaks pas2c and confused people. Esp people who had done this before. For most people, a purge is adequate if they need to clean up. Heck, that's what unc0rr and I apparently do, or we would have noticed the pas2c thing earlier
kyberneticist@gmail.com
parents:
253
diff
changeset
|
112 |
cmake . |
129
751dee35e4f1
Created wiki page with build instruction for ubuntu
vittorio.giovara@gmail.com
parents:
diff
changeset
|
113 |
make install |
686 | 114 |
}}} |