telepathy/ DeveloperNotes/ Windows

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.

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.

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= ..
  • 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.