This page describes how to compile and install libkmess-msn, the KMess Live Messenger library.
The current development version of libkmess-msn is only in trunk. Currently, KMess itself checks if the library is installed systemwide; if it is, that version will be used, otherwise the bundled version will be built along with KMess. Before release, this will change to a system where the bundled version is always built regardless, and installed over the system version.
The library itself can be compiled apart from the rest of KMess. In the lib/ directory in trunk, you can see a CMakeLists.txt file, which contains instructions for cmake to build the library.
Important: if you want to build all of KMess, don't use these instructions. Using the normal installation procedures, you will get libkmess-msn too. These instructions are only for libkmess-msn itself.
Downloading
Make sure you have Subversion installed. Then, checkout the library directory:
svn co https://kmess.svn.sourceforge.net/svnroot/kmess/trunk/kmess/lib libkmess-msn
Compiling
CMake recommends you to make a seperate build directory for building. We'll take that approach.
mkdir -p build cd build
The library is written in C++/Qt, so you'll need a working compiler and an installation of Qt. Next to that, it requires libxml and libxslt. For logging in to MSN, it currently requires QCA and the OpenSSL plugin. The latter is only needed during runtime, but its existence is checked during compilation, so you'll need to install it too.
To find QCA, CMake needs a FindQCA2.cmake. This file is usually packaged along with KDE. If you have KDE installed, you can probably find this file under /usr/share/kde4/apps/cmake/modules or something similar. If you don't have the file, you can probably download it somewhere. Sometime in the future, we will either patch out QCA or deliver FindQCA2.cmake along with KMess so this step is no longer necessary. If your FindQCA2.cmake path is different from the one above, substitute your path in the -DCMAKE_MODULE_PATH argument below.
Now run cmake and build the project:
cmake -DKMESS_DEBUG_OUTPUT=1 -DCMAKE_BUILD_TYPE=debugfull -DCMAKE_INSTALL_PREFIX=/usr/local -DCMAKE_MODULE_PATH:PATH=/usr/share/kde4/apps/cmake/modules .. make
When compilation succeeds, you'll see a "Built target kmess-msn" line. If you get any errors, or compilation does not succeed for any other reason, please contact us at the board!
Installing
If compilation did succeed, you can now install the library:
sudo make install
You can now compile any application that uses the library, or start developing an application with LibKMess-MSN.
