= Building and installing Upplay
== Building on Linux
=== Prerequisites
You will need:
- The Qt libraries development packages, including QtWebkit and QtNetwork.
- qmake.
- The development packages for libupnp version 1.6 (beware that the package
is named libupnp6 on Debian and Ubuntu 14.04, but it was libupnp3 on
Ubuntu 12.04), libcurl, and libexpat.
- Only for building from git source: the autotools (autoconf, automake,
libtool).
You need to download the release tar files for
link:downloads.html[libupnpp and upplay], or clone the git repositories:
https://opensourceprojects.eu/p/libupnpp[libupnpp],
https://opensourceprojects.eu/p/upplay[upplay].
=== Building
Extract the source for libupnpp and upplay, use the following procedures to
build the two packages:
Building libupnpp:
cd libupnpp-x.y.z
./configure --prefix=/usr
make
sudo make install
Building upplay:
cd upplay-x.y.z
qmake
make
sudo make install
And you should now be able to _upplay_
The above examples are for source extracted from tar release files. For
git source, you need to adjust the names of the top directories, and use
the following command before the libupnpp 'configure':
sh autogen.sh
== Building on Mac OS X
Thanks to link:https://github.com/distler[Jacques Distler] for providing
the procedure:
NOTE: for libupnpp versions 0.16.0 and earlier and upplay versions 1.2.11
and earlier, you will need to unset libupnpp_la_LDFLAGS in the 'Makefile'
before building libupnpp, and add -lupnp to LINK in the upplay
'Makefile'. These should be fixed in later versions.
1) Install QT. Example with link:http://www.finkproject.org/[Fink] as a package
manager. To install the relevant QT components:
fink install qt5-mac-qtbase qt5-mac-qtbase-dev-tools qt5-mac-qtwebkit qt5-mac-qtscript
It should be possible to do something similar with MacPorts.
2) Install libupnp. Extract the
link:https://sourceforge.net/projects/pupnp/[source code], then:
./configure
make
sudo make install
3) Install libupnpp. Extract the
link:https://www.lesbonscomptes.com/upplay/downloads.html[source
code], then:
CFLAGS=-I/usr/local/include LDFLAGS=-L/usr/local/lib \
upnp_CFLAGS=-I/usr/local/include upnp_LIBS=-L/usr/local/lib \
./configure --libdir=/usr/local/lib --includedir=/usr/local/include
make
sudo make install
4) Install Upplay. Extract the
link:http://www.lesbonscomptes.com/upplay/downloads.html[source code], then:
/sw/lib/qt5-mac/bin/qmake PREFIX=/usr/local
make
sudo make install
5) Finally, install a link in the usual 'Applications' folder:
sudo ln -s /usr/local/bin/upplay.app /Applications/upplay.app