Free and Open Source real time strategy game with a new take on micro-management

Difference between revisions of "Mingw compilation"

From Globulation2

Jump to: navigation, search
m
m
Line 42: Line 42:
:*Before compiling glob2, run these commands from the mingw console:
:*Before compiling glob2, run these commands from the mingw console:
::<table width="90%"><tr valign="top"><td style="border: 1px dashed #FFFFFF; padding: .3em .9em .3em; color: #FFFFFF; background-color: #114700">cd glob2_source</td></tr></table>
::<table width="90%"><tr valign="top"><td style="border: 1px dashed #FFFFFF; padding: .3em .9em .3em; color: #FFFFFF; background-color: #114700">cd glob2_source</td></tr></table>
:*Now to start compiling globulation 2. Don't worry about the warnings. If something is wrong, it will grind to a halt and it will let you know why:
:*Now to start compiling globulation 2. Don't worry about the warnings. If something is wrong, it will grind to a halt and it will let you know why. Run it one more time (there are occasional issue which are fixed by running it again). If problems persist, write a bug report.
::<table width="90%"><tr valign="top"><td style="border: 1px dashed #FFFFFF; padding: .3em .9em .3em; color: #FFFFFF; background-color: #114700">scons mingw=true</td></tr></table>
::<table width="90%"><tr valign="top"><td style="border: 1px dashed #FFFFFF; padding: .3em .9em .3em; color: #FFFFFF; background-color: #114700">scons --no-cache mingw=true</td></tr></table>
:*To make the executable smaller in size, run the following command:
:*To make the executable smaller in size, run the following command:
::<table width="90%"><tr valign="top"><td style="border: 1px dashed #FFFFFF; padding: .3em .9em .3em; color: #FFFFFF; background-color: #114700">strip ./src/glob2.exe</td></tr></table>
::<table width="90%"><tr valign="top"><td style="border: 1px dashed #FFFFFF; padding: .3em .9em .3em; color: #FFFFFF; background-color: #114700">strip ./src/glob2.exe</td></tr></table>
Line 49: Line 49:


==Testing Globulation 2 on windows==
==Testing Globulation 2 on windows==
===Running Globulation from compiled source===
:*Download [http://dl.sv.nongnu.org/releases/glob2/mingw/glob2_windows_runtime-2.tar.bz2 glob2_windows_runtime-2.tar.bz2] and put it in the home directory of msys (c:\msys\1.0\home\XXX\ where XXX is the username)
:*Download [http://dl.sv.nongnu.org/releases/glob2/mingw/glob2_windows_runtime-2.tar.bz2 glob2_windows_runtime-2.tar.bz2] and put it in the home directory of msys (c:\msys\1.0\home\XXX\ where XXX is the username)
:*Double click the MSYS icon that has been placed on your desktop during MSYS's installation.
:*Double click the MSYS icon that has been placed on your desktop during MSYS's installation.
:*Go in the directory where you put the glob2_windows_runtime-2.tar.bz2 (for example cd ~) and untar the libraries using the command below:
:*Go in the directory where you put the glob2_windows_runtime-2.tar.bz2 (for example cd ~) and untar the libraries using the command below:
<!-- ::<table width="90%"><tr valign="top"><td style="border: 1px dashed #FFFFFF; padding: .3em .9em .3em; color: #FFFFFF; background-color: #114700">mkdir glob2_runtime/</td></tr></table> -->
::<table width="90%"><tr valign="top"><td style="border: 1px dashed #FFFFFF; padding: .3em .9em .3em; color: #FFFFFF; background-color: #114700">tar jxf glob2_windows_runtime-2.tar.bz2 -C glob2_source/</td></tr></table>
:*Drag the glob2 executable into the root source folder:
::<table width="90%"><tr valign="top"><td style="border: 1px dashed #FFFFFF; padding: .3em .9em .3em; color: #FFFFFF; background-color: #114700">tar jxf glob2_windows_runtime-2.tar.bz2 -C glob2_runtime/</td></tr></table>
::<table width="90%"><tr valign="top"><td style="border: 1px dashed #FFFFFF; padding: .3em .9em .3em; color: #FFFFFF; background-color: #114700">cd glob2_source</td></tr></table>
:*Copy the folders data/, maps/, and campaigns/ and the files AUTHORS and COPYING to glob2_runtime/, overwriting any existing files
::<table width="90%"><tr valign="top"><td style="border: 1px dashed #FFFFFF; padding: .3em .9em .3em; color: #FFFFFF; background-color: #114700">cp -a ./src/glob2.exe .</td></tr></table>
:*Copy glob2.exe which is in the src directory (glob2/src/) to glob2_runtime/
:*Run glob2.exe from the glob2_runtime directory and play :)
:*Run glob2.exe from the glob2_runtime directory and play :)
===Building a Globulation 2 NSIS installer===
:*Coming soon



[[Category:Developer Resources]]
[[Category:Developer Resources]]

Revision as of 22:27, 24 July 2007

This page explains how to compile Globulation 2 on windows using mingw.

Versions 0.8.23 and previous: As of 0.9.0 and future versions, Globulation 2 no longer uses autotools, and make for compiling the source. We have switched to Scons (which is the guide you see below). If you are wanting to compile an older version, then you will need to recompile all the required libraries when you install MinGW (0.2.23 is no longer support on MinGW).


Setting up Python, Scons, and Mercurial

  • Download and install python-2.5.1.msi into the directory "C:\Python25" (default install is Python25, don't change this)
  • Download and install scons-0.97.win32.exe into the same directory as the python install (C:\Python25\)
  • Download and install Mercurial-0.9.4-f48290864625.exe locally (to any directory, preferably default C:\Mercurial though) so the command hg will work. When you get to the end of the install, make sure you check "add mercurial to your computers search path" or something similar. And now you are ready to go.


Setting up MinGW and MSYS

  • Download and install MinGW-5.1.3.exe into the directory c:\mingw (lower case) and select the MinGW base tools and g++ compiler packages only during the installation selection process
  • And, download and install MSYS-1.0.10.exe into the directory c:\msys\1.0\ (lower case). At the end of the installation, it will ask you if you want to continue with the post-install. Select yes, and yes again when it ask if you have mingw installed. When it ask you to indicate the directory where it is installed, type in c:/mingw (yes, with a forward slash as the program prefers it that way).


Compiling Prerequisites

  • Download glob2_required_libs_mingw-2.tar.bz2 and put it in the home directory of msys (c:\msys\1.0\home\XXX\ where XXX is the username)
  • Double click the MSYS icon that has been placed on your desktop during MSYS's installation.
  • Go in the directory where you put the glob2_required_libs_mingw-2.tar.bz2 (for example cd ~) and untar the libraries using the command below. This process could take a while:
tar jxf glob2_required_libs_mingw-2.tar.bz2 -C /


Compiling Globulation 2

Step 1: Preparing for a compile

Compiling from Released source code

  • Download and extract the release to c:\msys\1.0\home\XXX\ (where XXX is the username), then run (changing the version numbers):
mv glob2-x.x.xx glob2_source

Compiling from Mercurial source files

  • Download Globulation 2 from mercurial:
hg clone http://hg.globulation2.org/glob2/
  • Extract the master (the stable branch) from the mercurial download (this can also be used to extract other branches, such as core_rewrite_2007):
hg clone -r master glob2 glob2_source
  • To get the data, maps, and campaigns needed to play the game, run the following commands:
cd glob2_source
hg update tip
./syncdata
./syncmaps

Step 2: Continue compiling

  • Before compiling glob2, run these commands from the mingw console:
cd glob2_source
  • Now to start compiling globulation 2. Don't worry about the warnings. If something is wrong, it will grind to a halt and it will let you know why. Run it one more time (there are occasional issue which are fixed by running it again). If problems persist, write a bug report.
scons --no-cache mingw=true
  • To make the executable smaller in size, run the following command:
strip ./src/glob2.exe


Testing Globulation 2 on windows

Running Globulation from compiled source

  • Download glob2_windows_runtime-2.tar.bz2 and put it in the home directory of msys (c:\msys\1.0\home\XXX\ where XXX is the username)
  • Double click the MSYS icon that has been placed on your desktop during MSYS's installation.
  • Go in the directory where you put the glob2_windows_runtime-2.tar.bz2 (for example cd ~) and untar the libraries using the command below:
tar jxf glob2_windows_runtime-2.tar.bz2 -C glob2_source/
  • Drag the glob2 executable into the root source folder:
cd glob2_source
cp -a ./src/glob2.exe .
  • Run glob2.exe from the glob2_runtime directory and play :)

Building a Globulation 2 NSIS installer

  • Coming soon
Misc