= 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