Installfromsource

abma edited this page Sep 25, 2017 · 17 revisions

Table of Contents

Guide: Installing from Source

Introduction

These instructions should work on linux and other unixes, including OS X. They will even work on windows, if you download some tools.

Tools

OS X

OS X might not have any developer tools preinstalled, but you can get "Xcode Tools from Apple":http://developer.apple.com/opensource/tools/index.html, if you haven't already.

Also, in order to install the various dependencies of the project (see below), we recommend you to install the latest version of MacPorts (www.macports.org), which is a package repository system (somewhat similar to debian's apt-get). See also MacOS and http://springrts.com/phpbb/viewtopic.php?f=65&t=23455

Windows

Windows does not have the necessary tools preinstalled, you need to get "MinGW and MSYS":http://www.mingw.org/ (the simplest option) or "Cygwin":http://www.cygwin.com/.

Software Dependencies

Required

The following packages are *required* to compile SpringLobby.

  • wxWidgets >=2.9.0
  • a c++ compiler like g++
  • GNU Make
  • CMake
  • boost (thread, system, filesystem)
  • libcurl (linux packages *libcurl3* & *libcurl4-dev* (as of summer 2014))
  • libpng (linux packages *libpng12-0* & *libpng12-dev* (as of summer 2014))
  • alure (no more required if sound disabled with: -DOPTION_SOUND=OFF)

Optional

The following software, while not required for a functional SpringLobby build, allow additional features. Most people will want to have these installed.

  • libopenal
  • gettext
  • doxygen
  • boost (test)
  • glib (linux packages *libglib2.0-bin* & *libglib2.0-dev* (as of summer 2014))
  • minizip
  • openssl

Download Source Tarball

Download the latest tarball: http://springlobby.info/

After downloading, unpack the file and cd to the unpacked directory.

Configuring, Compiling and Installing

Configure, then compile; if you don't have (or don't want to install) gettext or the openAL libs, you can disable with:

cmake . -DOPTION_TRANSLATION_SUPPORT=OFF -DOPTION_SOUND=OFF 

otherwise use:

cmake .

to start compiling (might take a couple of minutes):

make

The following command installs the program. It needs root / admin / super user rights, so do what is necessary on your platform to have them.

make install

Building from Git

git clone --recursive https://github.com/springlobby/springlobby.git
cd springlobby
cmake .
make
make install

If you would like to disable sound, replace cmake command above with:

cmake -DOPTION_SOUND=OFF

Troubleshooting

If building the latest source doesn't work, take a look at "buildbot status page":http://buildbot.springlobby.info/waterfall and if there's a lot of red on the top of the page, the developers already know that the build is broken. If not, then you are welcome to submit a bug report send a patch. Remember to attach full log of the command that failed, and from configure also. If not sure then contact developers.

Note on Dependencies

Debian (and probably ubuntu) users can get the dependencies with:

sudo apt-get install build-essential cmake libwxgtk3.0-dev libcurl4-openssl-dev libalure-dev libboost-thread-dev libboost-filesystem-dev libboost-system-dev libpng12-dev libssl-dev

Gentoo users need:

echo 'x11-libs/wxGTK X' >> /etc/portage/package.use
emerge \>=x11-libs/wxGTK-2.8.0
 Check the currently used version:
eselect wxwidgets list

Fedora 20 users need:

yum install gcc-c++ cmake boost-devel wxGTK-devel libcurl-devel libnotify-devel alure-devel openssl-devel

Windows users need:

git clone -b "alure-1.x" git://repo.or.cz/alure.git alure-1.x
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.