Difference between revisions of "Talk:Building LÖVE"

(Page change suggestion)
 
(Page was pushed.)
 
Line 1: Line 1:
== Suggestion for a structure change of the page ==
 
I'd like to pull the source code stuff to the top. Any corrections or critique? --[[User:Boolsheet|Boolsheet]] 17:49, 9 March 2012 (GMT)
 
  
{|style="background: red; color: white" width='100%'
 
|- align="center"
 
|Page start.
 
|}
 
 
'''Note: This page is still incomplete.'''
 
 
If you want to build the LÖVE source code yourself, this page has all the information you need.
 
 
In only three steps you'll have your very own LÖVE binary:
 
#[[#1._Getting_the_source|Getting the source]]
 
#[[#2._Dependencies|Dependencies]]
 
#[[#3._Building|Building]]
 
 
 
= 1. Getting the source =
 
The official repository of LÖVE is hosted on [https://bitbucket.org/rude/love bitbucket].
 
 
You can download the source code either by using the 'get source' link on the bitbucket website or by installing mercurial and cloning the repository. Many linux distribution have a mercurial package in their repositories. Windows and OS X users can get the official binary from [http://mercurial.selenic.com/ selenic].
 
 
To create a clone with mercurial open a terminal or command prompt, go to the directory that you want to download the source code folder to and use the following commands:
 
<source lang="bash">
 
hg clone https://bitbucket.org/rude/love
 
</source>
 
This will create a love folder and download the latest source code into it.
 
 
If you want to use the source code of a specific version, go into the love directory and issue one of the following commands:
 
<source lang="bash">
 
hg update 0.7.2 # any (released) version from 0.6.0 onwards.
 
hg update minor # the minor branch, where development is done for the next 0.x.0 version when there's still a 0.y.z version to be released.
 
hg update default # back to the standard, the next release.
 
hg update tip # to the last commit, regardless of branch.
 
</source>
 
 
 
= 2. Dependencies =
 
LÖVE uses several open source libraries such as Lua, DevIL for images, and libvorbis for audio. Those libraries and their development files are required to successfully build LÖVE. It's possible to build every dependency yourself, but this is out of the scope of this page. The following explains how you can get prebuilt binaries instead.
 
 
== Windows ==
 
The headers and prebuilt MSVC 2008 and 2010 binaries of the dependencies can be found [http://www.love2d.org/sdk/ here].
 
 
== Linux ==
 
Download the development packages of the dependencies from the repository of your distribution.
 
 
==== Ubuntu ====
 
<source lang="bash">
 
sudo apt-get install mercurial build-essential automake libmpg123-dev libmodplug-dev libphysfs-dev libfreetype6-dev libdevil-dev liblua5.1-0-dev libopenal-dev libsdl1.2-dev libvorbis-dev
 
</source>
 
 
Older versions of Ubuntu need the latest [http://packages.ubuntu.com/natty/libmodplug1 libmodplug1] and [http://packages.ubuntu.com/natty/libmodplug-dev libmodplug-dev] packages.
 
 
==== Arch Linux ====
 
<source lang="bash">
 
pacman -S mercurial
 
pacman -S devil flac freetype2 glibc libmodplug libvorbis lua mesa mpg123 openal physfs sdl # 0.6.x
 
pacman -S devil freetype2 libmodplug libvorbis lua mpg123 openal physfs sdl # 0.7.x
 
</source>
 
 
==== Fedora ====
 
<source lang="bash">
 
yum install mercurial freetype-devel glibc-devel libmpg123-devel libmodplug-devel physfs-devel mesa-libGL-devel openal-soft-devel DevIL-devel libvorbis-devel SDL-devel libmng-devel libtiff-devel lua-devel gcc-c++
 
</source>
 
 
Please note that libmpg123-devel is in the rpmfusion-free repository.
 
 
==== Debian Squeeze ====
 
Install the following packages (using aptitude or apt):
 
 
<source lang="bash">
 
aptitude install mercurial automake libtool libphysfs-dev libsdl-dev libopenal-dev liblua5.1-0-dev libdevil-dev libmodplug-dev  libmpg123-dev  libvorbis-dev
 
</source>
 
 
Afterwards, just build it like it is mentioned below. It's e-a-s-y! :)
 
 
==== Other distributions ====
 
Any other distribution will most likely have the dependencies in their repositories too, possibly with slightly different package names.
 
 
 
= 3. Building =
 
== Windows ==
 
The source code includes Visual Studio 2008 and 2010 project files. Extract the appropriate [http://www.love2d.org/sdk/ LÖVE SDK] into the love directory and they should successfully yield a LÖVE binary.
 
 
== Linux ==
 
Use the automagic script to generate the configure file and then run configure and make as usual.
 
 
<source lang="bash">
 
./platform/unix/automagic
 
./configure
 
make
 
</source>
 
 
Your LÖVE binary will end up in the src directory.
 
 
{|style="background: red; color: white" width='100%'
 
|- align="center"
 
|Page end.
 
|}
 

Latest revision as of 23:57, 14 March 2012