Downloading and Compiling under macOS

From Arx Libertatis Wiki
Jump to navigation Jump to search

ℹ️  This page describes compiling Arx Libertatis from source under Mac OS X and assumes some familiarity with the command-line. If you just want to play the game, it might be easier to grab a binary release or snapshot if available.

This page documents how to compile Arx Libertatis from https://github.com/arx/ArxLibertatis under Mac OS X.

Specific instructions are given for a cleanly installed Lion 10.7.3 system, but the procedure should be similar for other versions.

Setting Up the Build Environment

To download and compile Arx Libertatis you will need the following tools:

Libraries

I installed those using MacPorts... but you can probably obtain "native" versions too.

  • zLib: sudo port install zlib
  • freetype: sudo port install freetype
  • boost: sudo port install boost
  • qt: sudo port install qt4-mac
  • sdl: sudo port install libsdl
  • glew: sudo port install glew

Or as a single line: 

sudo port install zlib freetype boost qt4-mac libsdl glew
  • NOTE: these packages take a long time to build. Do not be discouraged if it seems like nothing is happening.

Cloning the code repository

Using GitHub for Mac

Refer to http://mac.github.com/help.html :)

From the command line

First, go to where you want the ArxLibertatis directory to be located. 

cd ~/Code

You are now ready to clone the repository, type: 

git clone git://github.com/arx/ArxLibertatis.git

This creates a directory called ArxLibertatis and downloads the current source code from github. 

cd ArxLibertatis

Alternatively you can download a stable source code release and extract that:

Compiling

Building CMake from source

The latest release of CMake (2.8.7) still has issues with Xcode 4.3, but it's been fixed in the development branch. You can build cmake from source to fix this: 

git clone http://cmake.org/cmake.git
cd cmake
./configure
make
sudo make install

You're now ready to generate makefiles or an Xcode project. cd to the root of the arx repository

Makefiles

mkdir build
cd build
cmake ..
make

NOTE: If this results in an error that says something about an invalid command "--as-needed", try again with a clean build environment (ie: remove CMakeCache.txt). If the error persists, please report it as a bug at bugs.arx-libertatis.org with detailed build logs. You might be able to get arx to compile by opening CMakeLists.txt from the ArxLibertatis repository, and deleting lines 460 and 461, which are: 

# Because we are lazy
add_ldflag("-Wl,--as-needed")

Xcode project

mkdir build_xcode
cd build_xcode
cmake .. -G Xcode
open ArxLibertatis.xcodeproj/

Then compile and run the project from Xcode. (?)

Running the executable

By default, the user directory for Arx on Mac is /Users/username/Library/Application Support/ArxLibertatis/

You will need to obtain a copy of the data files from a commercial copy of Arx Fatalis, or use the demo data files, put these in the directory mentioned above and you are ready to go! Run the file "arx" which is in the ArxLibertatis repository. The game will automatically change all used files to lower-case on the first start. If you want to run the game with read-only data you need to do this manually.

For running arx in a debugger, see Debugging

Retrieved from "https://wiki.arx-libertatis.org/index.php?title=Downloading_and_Compiling_under_macOS&oldid=1670"