Changes in Building_Widelands_on_macOS

Old Title

BuildingWidelandsMac


Editor Comment

started to write a little more step by step instructions


Revision Differences of Revision 11

#Installing the Developer Tools/Xcode ¶
First you need to install a compiler. You should do this by installing Xcode. ¶
You can download it from the Apple Developer Connection web site (free registration required) or from the App Store, although it is around 3GB in size. ¶
This includes, amongst many other things, _gcc_, which is the compiler that are used by most opensource projects, including Widelands. ¶
Compiling widelands requires use of the command line, so before you start, you should make yourself familiar with the Terminal.app if you aren't already. ¶

#Installing required libraries ¶
In order to build Widelands from source you need to have installed some libraries which it depends upon. Depending upon your local installation you maybe also want to install a(nother) version control system like bzr to obtain the lastest trunk source of Widelands. ¶

##Using [MacPorts](http://www.macports.org/) ¶
[The MacPorts Project](http://www.macports.org/) is an open-source community initiative to design an easy-to-use system for compiling, installing, and upgrading open-source software on the Mac OS X operating system. As you will install libraries in your system dirs, you'll need to do so as Administrator via the command sudo - which will require you to enter the administrator password. Further information regarding sudo can be found on [wikipedia](http://de.wikipedia.org/wiki/Sudo). ¶

###Installing libraries with [MacPorts](http://www.macports.org/) ¶
Before installing any libraries, make sure you have access to the latest ports by updating the local repository by typing the following command to your Terminal-bash window: ¶

*sudo port selfupdate* ¶

Install the libraries: ¶
Note: The installation is very time consuming! ¶

*sudo port install \\* ¶
*libsdl \\* ¶
*libsdl_image \\* ¶
*libsdl_mixer \\* ¶
*libsdl_net \\* ¶
*libsdl_ttf \\* ¶
*libsdl_gfx \\* ¶
*boost \\* ¶
*glew \\* ¶
*lua \\* ¶


###To get the newest source we need [bzr](http://bazaar.canonical.com/en/) ¶
*sudo port install bzr* ¶

###In order to install widelands we need [cmake](http://www.cmake.org/) ¶
*sudo port install cmake* ¶

##Getting the newest source ¶
BzrPrimer ¶

##Building Widelands ¶
WidelandsGoingCmake ¶

##Hacking libSDL_image ¶
Under OSX libsdl_image and widelands have some issues. If your water looks like this, your libsdl_image uses the wrong rendering method for images. ¶
![ImageIO](http://wolkentempel.de/bilder/imageiosystem.png) ¶

To fix this issue, you need to reinstall libsdl_image with the following option: ¶
*--disable-imageio* Building Widelands on Mac OS ¶

These instructions are for Building Widelands on Mac with static libraries (needed for Releases), but glancing over it you should be able to figure out how to do it in a normal fashion too. ¶

First, install [Homebrew](http://brew.sh/). You will also need to install XCode for this. ¶

If you want to build static version of the libraries Widelands needs, you can use my fork of hombrews repositories: <https://github.com/SirVer/homebrew>. Branch is called widelands_static. ¶

Install python and bzr ¶

$ brew install python && brew install bzr ¶

Then install all the dependencies of Widelands: ¶

$ brew install sdl libjpeg libpng libogg libvorbis libsdl_mixer sdl_net ¶
$ brew link --force libpng ¶
$ brew install sdl_image ¶