Installation Instructions

From Hero of Allacrost

Jump to: navigation, search
(Visual Studio (VS) 2005)
(Windows)
 
Line 34: Line 34:
== Windows ==
== Windows ==
-
Download the Windows version of our latest build from our [http://sourceforge.net/project/showfiles.php?group_id=115378 Sourceforge] page. It should unzip into a folder called {{Filename|Allacrost}}. Go into the folder and double-click {{Filename|Allacrost.exe}} to play.
+
Download and execute the Windows installer of our latest build from our [http://sourceforge.net/project/showfiles.php?group_id=115378 Sourceforge] page.
== Building and Installing from Source ==
== Building and Installing from Source ==
-
Installing from source means you will have to compile the game yourself. But first, you'll need the Allacrost code. Either get the tarball from our [http://www.sf.net/projects/allacrost Sourceforge] page, or check it out from our [[Subversion Repository]].  
+
Installing from source means you will have to compile the game yourself. But first, you'll need the Allacrost code. Either get the tarball from our [http://www.sf.net/projects/allacrost Sourceforge] page, or check it out from our [[Subversion Repository]].
-
=== GNU/Linux ===
+
=== GNU/Linux and OS X ===
-
If you are compiling from source for the first time, you will first have to execute the following command from inside the {{ Filename | allacrost/ }} directory:
+
Inside a terminal, execute the following commands from inside the {{ Filename | allacrost/ }} directory:
  autoreconf -i
  autoreconf -i
-
After that run:
 
  ./configure && make
  ./configure && make
-
followed by an optional
+
  sudo make install
-
  make install
+
-
=== OS X ===
+
Note that "make install" is optional, and you must run it as root, or use sudo. You can run allacrost from within the source {{ Filename | allacrost/ }} directory by running "./allacrost".
-
 
+
-
From the Terminal you may follow the same commands as listed for Linux.
+
=== Windows ===
=== Windows ===
-
== Visual Studio (VS) 2005 ==
+
==== Code::Blocks and MinGW ====
-
Load the Allacrost VS Project file, Allacrost.vcproj. It is in the root directory of the source archive.
+
This is written for SVN, and will not work for Demo 0.2.2 or earlier.
-
Download include and lib from http://www.allacrost.org/staff/libs/win/
+
You will need the Code::Blocks IDE set up with a working MinGW installation.  The version of MinGW that comes bundled with the IDE may or may not work, but 3.4.5 or later should work fine.
-
Download libintl from http://gnuwin32.sourceforge.net/packages/libintl.htm (choose for developer), and add them to include and lib.
+
You will need the most recent Allacrost [http://www.allacrost.org/staff/user/winter_knight/allacrost-win32-depends-mingw-20090607.zip dependency archive]. The last known svn version to compile with this archive is svn 1743, which is current as of February 2010.
-
Unzip include, lib, and libintl into a directory of your choice. Set include and lib dirs in VS 2005 appropriately.
+
Check out the current SVN trunk ([http://allacrost.sourceforge.net/wiki/index.php/Subversion_Repository instructions]).  Unzip the dependency file into the "demo" directory, so that it now contains an "allacrost-win32-depends" directory in addition to dat, doc, img, mus, src, et cetera.
-
If you have this error message "cant't link to jpegd.lib", try copy jpeg.lib and rename it as jpegd.lib. Or, you can compile a release version instead of a debug version.
+
Open "allacrost.workspace" in Code::Blocks, make sure the target is set to "Debug Win32" or "Release Win32," and build the Allacrost project.  Find something to occupy your time, as the initial build will take a while. Once this is finished, assuming there are no errors you should be able to run the program. Note that the Map Editor project is not yet ready and will fail to build, even though the editor builds properly on Linux.
 +
 
 +
==== Visual Studio (VS) 2005/2008 ====
 +
 
 +
'''The Visual Studio projects are currently not working.  Please post in our forums if you would like to help us get the project building under Visual Studio 2005 or 2008.'''
 +
 
 +
Load the Allacrost VS Project file, Allacrost.vcproj. It is in the root directory of the source archive.
 +
 
 +
Download develop package from http://www.allacrost.org/staff/libs/win/allarost-dep-win32-vc8sp1.zip, and add them to proper include and lib directories in vs2005.
At last, you have to copy all dll files to your project directory. (you can find those in allacrost windows demo directory, download from sourceforge)
At last, you have to copy all dll files to your project directory. (you can find those in allacrost windows demo directory, download from sourceforge)
-
This does not include the map editor, you have to install QT for compiling that.
+
This does not include the map editor, you have to install QT (kind of windows programming framework) for compiling that. Currently we're using QT 4.3.
 +
 
 +
For step by step instructions look here: http://www.allacrost.org/forum/viewtopic.php?f=7&t=1998
 +
 
 +
==== MinGW (from Linux) ====
 +
 
 +
These are instructions for cross-compiling Allacrost for Windows from Linux. You will need mingw installed on a Linux machine. In Debian or Ubuntu, this is as simple as "aptitude install mingw32".
 +
 
 +
You will need an Allacrost dependency archive. For [http://www.allacrost.org/staff/user/winter_knight/allacrost-win32-depends-mingw-20081104.zip latest stable, Demo 0.2.2], or [http://www.allacrost.org/staff/user/winter_knight/allacrost-win32-depends-mingw-20090607.zip latest svn]. The last known svn version to compile with this archive is svn 1743.
 +
 
 +
Unzip your dependency file into your home directory. Now change to the root directory of your Allacrost source archive (ie ~/svn/allacrost/demo/). Execute the following:
 +
autoreconf -i
 +
./configure
 +
~/allacrost-win32-depends/Makefiles/make.sh

Latest revision as of 03:30, 22 February 2010

Personal tools