Changes: GAE/Windows Compiling

Latest revision as of 21:35, 23 March 2011

This article or section may be outdated.

You can edit this page to improve it.

v • d • e

GAE, or the Glest Advanced Engine, is open source like its predecessor, so has its source code available to compile. This page goes over the compiling process for GAE in Windows. Compiling for Linux or Mac can be found on their respective pages.

Prerequisites[]

TortoiseSVN.
CMake.

Win check out — Checking out the source.

Checkout source[]

Navigate to where you would like to place the project in your filesystem, right click and select SVN Checkout and enter the URL:

https://glestae.svn.sourceforge.net/svnroot/glestae/trunk

You can change the name of the checkout directory if desired. Hit Ok and wait. The directory you checked out the source to will now be referred to as $SVN_DIR$ .

Download dependencies[]

A windows dependencies package can be found on GAE's Sourceforge page. Download and extract it somewhere. The directory you extracted this package to will now be referred to as $DEP_DIR$ .

Compiling[]

Start CMake, set the source directory to $SVN_DIR$ and change the build directory to $SVN_DIR$/build, then add an entry called GAE_WINDEPS of type path, and point it at $DEP_DIR$
Press configure, choose the Visual Studio 9 generator, when done switch the GUI to 'grouped' view and expand the GAE section, ensure GAE_USE_PHYSFS & GAE_USE_PRECOMPILED_HDR are checked, and change the GAE_DATA_DIR (and optionally GAE_CONFIG_DIR) to $SVN_DIR$/data/game.

Press configure again, then press generate.
The generated project files can be found in the $SVN_DIR$/build directory.
Before running the game you will need to copy the binary dependencies in $DEP_DIR$/bin to $SVN_DIR$/data/game. (NOTE: You can skip this step if you set the project's working directory to $DEP_DIR$/bin in the next step).
To run the game from Visual Studio you need to set the working directory (otherwise it won't be able to find the DLLs). Right click on glestadv project and click Properties. Go to Debugging. Set the Working Directory to $SVN_DIR$/data/game. This will need to be done for each configuration (e.g. Debug and Release).
Now, right click the game project (e.g. glestadv) and set it as the start-up project, you can then launch the game in the debugger using the green play button (or by pressing F5).
You may wish to delete projects you do not plan to work with, to streamline the build process.

@@ Line 1: / Line 1: @@
+{{Outdated}}
-*Download and install [http://tortoisesvn.tigris.org/ TortoiseSVN].
-*Download and install [http://www.cmake.org/cmake/resources/software.html CMake].
-*Checkout source:
-Navigate to where you would like to place the project in your filesystem, right click and select 'SVN Checkout' and enter the url: https://glestae.svn.sourceforge.net/svnroot/glestae/trunk and change the name of the checkout directory if desired. Hit 'Ok' and go make a coffee.
-The directory you checked out the source to will now be referred to as $SVN_DIR$
+[[GAE]], or the [[Glest]] Advanced Engine, is open source like its predecessor, so has its source code available to compile. This page goes over the compiling process for GAE in Windows. Compiling for [[GAE/Linux Compiling|Linux]] or [[GAE/Mac Compiling|Mac]] can be found on their respective pages.
-[[File:Win_check_out.jpg]]
-*Download dependencies:
+==Prerequisites==
-A windows dependencies package can be found at https://sourceforge.net/projects/glestae/files/win_dev_deps/win_deps.7z/download download and extract it somewhere.
+*[http://tortoisesvn.tigris.org/ TortoiseSVN].
-The directory you extracted this package to will now be referred to as $DEP_DIR$
+*[http://www.cmake.org/cmake/resources/software.html CMake].
-*Start CMake, set the source directory to $SVN_DIR$ and change the build directory to $SVN_DIR$/build, then add an entry called GAE_WINDEPS of type path, and point it at $DEP_DIR$
-[[File:Cmake_setup_win.jpg]]
+[[File:Win_check_out.jpg|thumb|Checking out the source.]]
-*Press configure, choose the Visual Studio 9 generator, when done switch the Gui to 'grouped' view and expand the GAE section, ensure GAE_USE_PHYSFS & GAE_USE_PRECOMPILED_HDR are checked, and change the GAE_DATA_DIR (and optionally GAE_CONFIG_DIR) to $SVN_DIR$/data/game
+==Checkout source==
+Navigate to where you would like to place the project in your filesystem, right click and select ''SVN Checkout'' and enter the URL:
+ https://glestae.svn.sourceforge.net/svnroot/glestae/trunk
+You can change the name of the checkout directory if desired. Hit ''Ok'' and wait. The directory you checked out the source to will now be referred to as <tt>$SVN_DIR$</tt>.
+[[File:Cmake_setup_win.jpg|thumb|Path setups.]]
+==Download dependencies==
+A windows dependencies package can be found on GAE's [https://sourceforge.net/projects/glestae/files/win_dev_deps/win_deps.7z/download Sourceforge page]. Download and extract it somewhere. The directory you extracted this package to will now be referred to as <tt>$DEP_DIR$</tt>.
+==Compiling==
+*Start CMake, set the source directory to <tt>$SVN_DIR$</tt> and change the build directory to <tt>$SVN_DIR$/build</tt>, then add an entry called <tt>GAE_WINDEPS</tt> of type path, and point it at <tt>$DEP_DIR$</tt>
+*Press configure, choose the Visual Studio 9 generator, when done switch the GUI to 'grouped' view and expand the GAE section, ensure <tt>GAE_USE_PHYSFS</tt> & <tt>GAE_USE_PRECOMPILED_HDR</tt> are checked, and change the <tt>GAE_DATA_DIR</tt> (and optionally <tt>GAE_CONFIG_DIR</tt>) to <tt>$SVN_DIR$/data/game</tt>.
 [[File:Cmake-post_configure1.jpg]]
 *Press configure again, then press generate.
-*The generated project files can be found in the 'build' directory.
+*The generated project files can be found in the <tt>$SVN_DIR$/build</tt> directory.
+*Before running the game you will need to copy the binary dependencies in <tt>$DEP_DIR$/bin</tt> to <tt>$SVN_DIR$/data/game</tt>. (NOTE: You can skip this step if you set the project's working directory to <tt>$DEP_DIR$/bin</tt> in the next step).
-[[File:Build-folder.jpg]]
+*To run the game from Visual Studio you need to set the working directory (otherwise it won't be able to find the DLLs). Right click on glestadv project and click ''Properties''. Go to ''Debugging''. Set the ''Working Directory'' to <tt>$SVN_DIR$/data/game</tt>. This will need to be done for each configuration (e.g. Debug and Release).
-*Before running the game you will need to copy the binary dependencies in $DEP_DIR$/bin to $SVN_DIR$/data/game. (NOTE: You can skip this step if you set the project's working directory to $DEP_DIR$/bin in the next step)
+*Now, right click the ''game'' project (e.g. glestadv) and set it as the start-up project, you can then launch the game in the debugger using the green ''play'' button (or by pressing F5).
-*[[File:Binary_deps.jpg]]
+*You may wish to delete projects you do not plan to work with, to streamline the build process.
-*To run the game from Visual Studio you need to set the working directory (otherwise it won't be able to find the DLLs). Right click on glestadv project and click 'Properties'. Go to 'Debugging'. Set the 'Working Directory' to $SVN_DIR$/data/game. This will need to be done for each configuration (eg Debug and Release). [[File:Working_dir.jpg]]
-*Now, right click the 'game' project (ie glestadv) and set it as the start-up project, you can then launch the game in the debugger using the green 'play' button (or by pressing F5)
+==See Also==
-[[File:Set-startup-proj.jpg]]
+*[[GAE|GAE]]
-*You may wish to delete projects you do not plan to work with, to streamline the build process
+*[[GAE/Linux Compiling|Linux Compiling]]
-[[File:Delete-other-projects.jpg]]
+*[[GAE/Mac Compiling|Mac Compiling]]
 [[Category:GAE]]