Building widelands

Building widelands

This page is about building widelands for various OSes. If you managed to build widelands under you OS and you can't find informations about it here, please add them for the other who will come after you and try it.

Libraries

Widelands depends currently on the following libraries, make sure they all are installed and in the search path of your compiler. The suggested compiler to build widelands is gcc 3, but it might work with other compilers too.

• libSDL >=1.2.11
• libSDL_gfx
• libSDL_image
• libSDL_net
• libSDL_mixer >= 1.2.6
• libSDL_ttf >= 2.0.0
• gettext
• libiconv (on same mirrors as gettext)
• zlib
• libpng
• Boost

For using the new, SCons-based build system (introduced after build-9half), you will also need

• Python >= 1.5.2

Building under Linux (i386)

This is actually the most simple of all cases: Get yourself all the libraries, make sure that sdl-config is in your searchpath and hit make in the unpacked widelands source dir. Everything should be ok, you can run the game directly from it's location.

With the new build system (>build-9half), make sure you have Python installed and call ./build_widelands.sh from wideland's main directory. You can run the game directly from it's location.

For further information, there is a page about using the SCons build system.

Build instructions for Ubuntu

Install all needed packages:

Building under Windows

To access SVN, i suggest Tortoise SVN.

Building under DevCpp/MinGW

Please visit Building Widelands under Windows

Building under MSVC

As far as we know, noone has tried this since build 4, so if anyone is brave enough, go for it and post your informations here.

Building under MacOS X

Widelands is now build using XCode 2 under Mac Os X, you therefor need Mac OS 10.4. You also need some third party libraries, our XCode Project expects them under /opt/local, so the easiest way to install them is using MacPorts (formerly DarwinPorts). You'll need the following command (in Terminal.app) to install everything needed:

 $ sudo port install gettext libpng zlib libjpeg libvorbis freetype

Furthermore you need to install the libSDL Frameworks for the following librariers: SDL, SDL_Image, SDL_Net, SDL_Mixer, SDL_TTF, SDL_gfx. You can get them all at www.libsdl.org. The SDL-* Libs are available through searching in the libraries section of this page.

To Install them create the Directory /Library/Frameworks/ManuallyInstalled and copy all the *.frameworks directories from the SDL DMG-Images into this new Directory. The Directory name is mandatory (our XCode Project searches there), it is choosen because the Macports libsdl*-framework are not statically linked and are therefore no use for us, but we do not want to interfere with them, since some Ports from Macports depend on them. So we create our own Directory for the manually installed SDL Libs and stay out of the way.
Note: there is no SDL_gfx precompiled library for Mac OS X, so you might need to build one (download and unpack sources, unpack XCode project under build/ directory, compile and copy created framework to the same location as other SDL libs).

Now opening the XCode Project in the macos directory of the widelands SVN Tree and compiling should make a working widelands version for your OS X Version and your Hardware (Intel, PPC). This binary should also work on every other Mac with > OS X 10.4 and the same Processor. But beware: there is no universal binary at this point.

Good luck. Help is available on the mailing list.