Windows installation guide for Telepathy Gabble

This page contains instructions to build telepathy gabble (Telepathy connection manager for Jabber/XMPP) and the required dependencies on Microsoft Windows XP and Vista. Before you start, make sure you have the following tools installed on you system. And also make sure the install locations are on your path.

Microsoft Visual C++ Express version 9 or newer from http://www.microsoft.com/Express/
GNU bin utilities for windows from http://gnuwin32.sourceforge.net/
CMake version 2.6 or newer from http://www.cmake.org
Git for Windows from http://code.google.com/p/msysgit/
OpenSSL for windows from http://www.openssl.org/related/binaries.html
libxml2, zlib, iconv (both runtime and devel packages) and libxslt binaries from http://www.winkde.org/pub/kde/ports/win32/releases/stable/latest/ and extract packages to ex. c:\unix

Building Dbus on Windows Vista

These instructions are only for those users who wish to build DBus under Windows Vista, and if you are using Windows XP you can skip over to the next section after installing pre-built binaries if windbus from http://windbus.sf.net.

Download windbus sources Windbus svn sources
First set the dev variables (compiler path ..etc) by issuing "C:\Program Files\Microsoft Visual Studio 9.0\VC\bin\vcvars32.bat"
cd windbus/cmake directory
cmake -G "NMake Makefiles" -DCMAKE_BUILD_TYPE=Release -DDBUS_INSTALL_SYSTEM_LIBS=ON -DLIBXML2_INCLUDE_DIR=c:\unix\include -DLIBXML2_LIBRARIES=c:\unix\lib\libxml2.lib -DCMAKE_INSTALL_PREFIX=c:\unix
nmake
nmake install

Special Note for Windows Vista users: Windows vista resolves localhost to ipv6 address ::1 so dbus daemon will fail to work. (if you are not able to change hosts file please use the patch and recompile dbus).

Changing host config :

takeown /f c:\windows\system32\drivers\etc\hosts
icacls c:\windows\system32\drivers\etc\hosts /grant yourusername:f
add "127.0.0.1 localhost" to hosts file
icacls c:\windows\system32\drivers\etc\hosts /grant Administrator:f
ipconfig /flushdns

or just find your favorite text editor ex. “Notepad“, right-click and select “Run as Administrator“. This should launch editor with elevated privileges. Now, open the host file from the File menu, add "127.0.0.1 localhost" to file and save.

after this normal binary releases of dbus should work on windows vista.

Tip: set DBUS_VERBOSE=1 will let you see whats going on when you run the dbus tool set.

Ok. now that we have dbus compiled issue the following commands to run it.

start dbus-deamon --session

Building DBus Glib on windows

Note: please note that without the following patch, telepathy-gabble will crash.

Patch
git repository for cmake version of dbus-glib (Please note that the above patch is already applied on this repository
cmake -G "NMake Makefiles" -DCMAKE_INSTALL_PREFIX=c:\unix
please note that all the dependencies should already exist in CMAKE_INSTALL_PREFIX
if you need .dll files pass something like -DLIB_TYPE=SHARED instead of STATIC
nmake install to install and nmake uninstall to uninstall

Building Loudmouth on Windows

git clone git://gitorious.org/loudmouth-cmake/loudmouth-cmake.git
git checkout -b cmake origin/cmake
cmake -G "NMake Makefiles" -DCMAKE_INSTALL_PREFIX=c:\unix
nmake
nmake install

Building Telepathy Glib on Windows

Git repository for windows port
cmake -G "NMake Makefiles" -DCMAKE_INSTALL_PREFIX=c:\unix -DSORT_PROG=c:\msys\1.0\bin\sort.exe -DLIB_TYPE=SHARED
nmake
nmake install

Building Telepathy Gabble Connection Manager

Telepathy Gabble Git repository
cmake -G "NMake Makefiles" -DXSLTPROC_PATH=<?> -DSORT_PROG=<?> -DCMAKE_INSTALL_PREFIX=<?> ..
please note that all the dependencies should already exist in CMAKE_INSTALL_PREFIX
nmake
nmake install

Building TelepathyQt4

TelepathyQt4 contains the Roaster example, which is currently the best way to test Gabble on Windows.

Install Qt 4.5 with QtDBus support. You can follow the instructions on how to 'emerge' Qt 4.5 from the KDE Windows project. Building from a source tarball from Qt Software apparently works as well.
Clone the TelepathyQt4 CMake Branch
Ensure that 'qmake' from Qt is in the PATH.
mkdir build; cd build
cmake -G "NMake Makefiles" -DCMAKE_INSTALL_PREFIX=<desired install location> ..
nmake install

after that the build folder will contains some example binaries to test certain functions of the library, located at ${BUILD_DIR}/examples/ ie : examples/roaster/.

Current Progress

If you follow the above instructions you should be able to build and run gabble successfully. Additionally you can also use the cmake build files provided here to build gabble under linux using cmake.

Tasks to complete

Polish up build procedure
Get the changes upstream.

Help and support

We are on #telepathy and #telepathy-windows on the Freenode IRC server, shout if you need help..

Credits

1.) realXtend

2.) Collabora Ltd.