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    flex
  38
  39 If you want to build the NSIS installer package then you'll need to install:
  40
  41    mingw32-nsis
  42
  43
  44 Build
  45 =====
  46
  47  - [pidgin-sipe source code from git instead from a release tarball]
  48    run the following commands inside the git work area:
  49
  50       ./autogen.sh
  51       ./configure
  52       make dist-gzip
  53
  54    This will generate pidgin-sipe-<VERSION>.tar.gz
  55
  56  - create an empty directory and cd into it
  57
  58  - run contrib/mingw-cross-compile/fetch.sh from pidgin-sipe source
  59    * make sure to check for fetch & unpack errors before proceeding!
  60
  61  - cd into build-<...REPLACE PIDGIN VERSION HERE...>/pidgin-<...REPLACE PIDGIN VERSION HERE...>
  62
  63  - copy/unpack pidgin-sipe source code tree into into current directory
  64
  65  - run
  66
  67      cp pidgin-sipe-<...REPLACE PIDGIN-SIPE VERSION HERE...>/contrib/mingw-cross-compile/local.mak .
  68
  69  - run (this is one line on the command line!)
  70
  71      make -C pidgin-sipe-<...REPLACE PIDGIN-SIPE VERSION HERE...>/src/core
  72           -f Makefile.mingw
  73
  74      (to compile without SSPI support add " USE_SSPI=" to the command line)
  75
  76 If everything goes well you should now have
  77
  78   pidgin-sipe-<...REPLACE PIDGIN-SIPE VERSION HERE...>/src/core/libsipe.dll
  79
  80 which you can copy into your Pidgin Windows installation directory.
  81
  82 NOTE: PLEASE make sure that there is NO OTHER libsipe.dll in that installation
  83       or in your PATH!
  84
  85
  86 NSIS Installer Package
  87 ======================
  88
  89 After you have successfully executed the build:
  90
  91  - run (this is one line on the command line!)
  92
  93      PIDGIN_TREE_TOP=.. make
  94           -C pidgin-sipe-<...REPLACE PIDGIN-SIPE VERSION HERE...>
  95           -f Makefile.mingw cross-compile-nsis
  96
  97      (to compile without SSPI support add " USE_SSPI=" to the command line)
  98
  99 If everything goes well you should now have
 100
 101   pidgin-sipe-<...REPLACE PIDGIN-SIPE VERSION HERE...>.exe
 102
 103 which you now can execute on your Windows machine.