contrib/mingw-cross-compile/README.txt

   1 Introduction
   2 ============
   3
   4 With these instructions you will be able to generate libsipe.dll on a Linux
   5 machine that is compatible with the official Pidgin Windows releases.
   6
   7 The approach described here is based on this wiki page:
   8
   9    http://code.google.com/p/pidgin-privacy-please/wiki/HowToCrossCompileForWindowsAgainstLatestPidgin
  10
  11 The build has been verified to work at the time this text was written. When
  12 you read this some things in Pidgin or MinGW might changed, so make sure to
  13 check the comments on that wiki page for updates.
  14
  15
  16 Preparation
  17 ===========
  18
  19 You'll need a Linux machine with the following MinGW cross-compilation
  20 packages installed:
  21
  22 Ubuntu:
  23    sudo apt-get install mingw32 mingw32-binutils mingw32-runtime
  24
  25 Fedora:
  26    sudo yum install mingw32-gcc
  27
  28 This will most likely work also for other Linux distros, but you'll have
  29 to check what names the MinGW cross-compilation packages are for your
  30 distro.
  31
  32 If you are trying to build the source code from the git repository then
  33 you'll need additional tools installed, at least:
  34
  35    autoconf
  36    automake
  37
  38 If you want to build the NSIS installer package then you'll need to install:
  39
  40    mingw32-nsis
  41
  42
  43 Build
  44 =====
  45
  46  - [pidgin-sipe source code from git instead from a release tarball]
  47    run the following commands inside the git work area:
  48
  49       ./autogen.sh
  50       ./configure
  51       make dist-gzip
  52
  53    This will generate pidgin-sipe-<VERSION>.tar.gz
  54
  55  - create an empty directory and cd into it
  56
  57  - run contrib/mingw-cross-compile/fetch.sh from pidgin-sipe source
  58    * make sure to check for fetch & unpack errors before proceeding!
  59
  60  - cd into build-<...REPLACE PIDGIN VERSION HERE...>/pidgin-<...REPLACE PIDGIN VERSION HERE...>
  61
  62  - copy/unpack pidgin-sipe source code tree into into current directory
  63
  64  - run
  65
  66      cp pidgin-sipe-<...REPLACE PIDGIN-SIPE VERSION HERE...>/contrib/mingw-cross-compile/local.mak .
  67
  68  - run (this is one line on the command line!)
  69
  70      make -C pidgin-sipe-<...REPLACE PIDGIN-SIPE VERSION HERE...>/src/core
  71           -f Makefile.mingw
  72
  73      (to compile without SSPI support add " USE_SSPI=" to the command line)
  74
  75 If everything goes well you should now have
  76
  77   pidgin-sipe-<...REPLACE PIDGIN-SIPE VERSION HERE...>/src/core/libsipe.dll
  78
  79 which you can copy into your Pidgin Windows installation directory.
  80
  81 NOTE: PLEASE make sure that there is NO OTHER libsipe.dll in that installation
  82       or in your PATH!
  83
  84
  85 NSIS Installer Package
  86 ======================
  87
  88 After you have successfully executed the build:
  89
  90  - run (this is one line on the command line!)
  91
  92      PIDGIN_TREE_TOP=.. make
  93           -C pidgin-sipe-<...REPLACE PIDGIN-SIPE VERSION HERE...>
  94           -f Makefile.mingw cross-compile-nsis
  95
  96      (to compile without SSPI support add " USE_SSPI=" to the command line)
  97
  98 If everything goes well you should now have
  99
 100   pidgin-sipe-<...REPLACE PIDGIN-SIPE VERSION HERE...>.exe
 101
 102 which you now can execute on your Windows machine.