moin2iki: Importing Moin history for page Windows

1 files changed, 101 insertions, 0 deletions

diff --git a/Windows.moin b/Windows.moin
new file mode 100644
index 0000000..06753b1
--- /dev/null
+++ b/Windows.moin
@@ -0,0 +1,101 @@
+= 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/ || Visual studio ]]

+ * GNU bin utilities for windows from [[http://gnuwin32.sourceforge.net/ || Gnu Tools]]

+ * CMake version 2.6 or newer from [[http://www.cmake.org || CMake Website]]

+ * Git for Windows from [[http://code.google.com/p/msysgit/  || Git for windows]]

+ * OpenSSL for windows from [[http://www.openssl.org/related/binaries.html || OpenSSL for Windows]]

+ * 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 || WinDbus]]. 

+

+ * Download windbus sources [[https://windbus.svn.sourceforge.net/svnroot/windbus/trunk/ | 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.

+

+ * [[http://cgit.freedesktop.org/dbus/dbus-glib/commit/?id=bc474819fa638a0daf3c89e6d041949b73e9228e|Patch]]

+ * [[http://git.collabora.co.uk/?p=user/siraj/dbus-glib.git;a=summary | 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 ==

+ * [[http://gitorious.org/+telepathy-windows/telepathy-glib-cmake/telepathy-glib-cmake | 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 ==

+ * [[ http://git.collabora.co.uk/?p=user/siraj/gabble-win32.git;a=summary | 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 [[http://techbase.kde.org/Getting_Started/Build/KDE4/Windows/emerge | 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 [[http://git.collabora.co.uk/?p=user/imonroe/telepathy-qt4-cmake.git;a=summary | 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.