Installation Instructions

From Hero of Allacrost

(Difference between revisions)
Jump to: navigation, search
(Visual Studio (VS) 2005)
(Windows)
 
(11 intermediate revisions not shown)
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

This page explains how to install the game Hero of Allacrost. The installation process is dependent on which operating system your computer is using.


Contents

BSD

FreeBSD

Install Hero of Allacrost from ports collection:

cd /usr/ports/games/allacrost
make install clean

NetBSD

OpenBSD

GNU/Linux

Debian

To use the Debian package, please perform the following steps.

  1. Add one of the following entries in your /etc/apt/sources.list, depending on which version of Debian you are running:
    • Debian Etch (stable):
      deb http://debian.ettin.org/allacrost etch-backports main
    • Debian Lenny/Sid (testing/unstable):
      deb http://debian.ettin.org/allacrost unstable main
  2. The repository is signed, and packages can be checked using this gpg key. To enable the verification, you can simply run this command:
    wget http://debian.ettin.org/key.gpg -O - | sudo apt-key add -
  3. Finally, execute the following command. After the installation is complete, you can start the game by typing allacrost at the command line.
    apt-get update && apt-get install allacrost-demo


OS X

Download the OS X version of our latest build from our Sourceforge page. Unzip the file and mount the dmg. Drag the .app bundle to your Applications directory. Unmount the dmg, and double-click on Allacrost to play.

Windows

Download and execute the Windows installer of our latest build from our Sourceforge page.

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 Sourceforge page, or check it out from our Subversion Repository.

GNU/Linux and OS X

Inside a terminal, execute the following commands from inside the allacrost/ directory:

autoreconf -i
./configure && make
sudo make install

Note that "make install" is optional, and you must run it as root, or use sudo. You can run allacrost from within the source allacrost/ directory by running "./allacrost".

Windows

Code::Blocks and MinGW

This is written for SVN, and will not work for Demo 0.2.2 or earlier.

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.

You will need the most recent Allacrost dependency archive. The last known svn version to compile with this archive is svn 1743, which is current as of February 2010.

Check out the current SVN trunk (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.

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)

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 latest stable, Demo 0.2.2, or 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
Personal tools