sjero.net Git - linphone/blob - README.mingw

   1 Software to install
   2 *******************
   3
   4 Download lastest mingw-get-inst.exe from http://www.mingw.org
   5 Run mingw-get-inst.exe. Choose "download lastest catalogues".
   6 In the feature list, select:
   7 * C compiler
   8 * C++ compiler
   9 * Mingw developer toolkit
  10 Let the installer fetch and install everything.
  11
  12 In mingw shell, run
  13
  14 mingw-get install msys-zip
  15 mingw-get install msys-unzip
  16 mingw-get install msys-wget
  17 mingw-get install msys-libopenssl
  18
  19 mkdir -p /opt/perl/bin
  20 cp /bin/perl /opt/perl/bin/.
  21
  22 cd ~
  23 #Download intltool
  24 wget http://ftp.acc.umu.se/pub/GNOME/binaries/win32/intltool/0.40/intltool_0.40.4-1_win32.zip
  25
  26 Download lastest linphone-deps-win32 zip from
  27 http://download.savannah.gnu.org/releases-noredirect/linphone/misc
  28 using your browser.
  29
  30 Download lastest gtk+ win32 bundle from http://www.gtk.org
  31
  32 Install all these three package in /:
  33
  34 cd /
  35 unzip ~/intltool_0.40.4-1_win32.zip
  36 unzip <path to gtk bundle zip>
  37 unzip <path to linphone-deps>
  38
  39 #Install GTK+ Outcrop theme, the one used by linphone for distribution.
  40 cd /share/themes
  41 wget http://art.gnome.org/download/themes/gtk2/1122/GTK2-Outcrop.tar.gz
  42 tar -xvzf GTK2-Outcrop.tar.gz
  43
  44 #Remove the special stdint.h and inttypes.h included in linphone-deps: it is for MSVC only.
  45 #Mingw will use the one in /mingw/include
  46 rm /include/stdint.h /include/inttypes.h
  47
  48 #Remove libgcc specific libraries, only needed for MSVC:
  49 rm /lib/libgcc.a /lib/libmingw32.a /lib/libmingwex.a
  50
  51 #Remove libintl from gtk, we don't need it and it conflicts with the one supplied by mingw.
  52 rm /lib/libintl.dll.a
  53 rm /lib/libintl.la
  54 rm /lib/libintl.a
  55 rm /include/libintl.h
  56
  57 * Download and install Inno Setup Compiler (required only if you run 'make setup.exe'). Add it to your windows Path environment variable.
  58
  59 Get Linphone source code
  60 ************************
  61
  62 Install msys-git from (http://code.google.com/p/msysgit/). During installation you are asked to make a choice about how line endings are treated by git.
  63 Choose "Checkout line endings as they are, commit as they are". THIS CHOICE IS VERY IMPORTANT. OTHERS BREAK AUTOMAKE.
  64
  65 It is recommended that you create a directory somewhere with a path without any spaces or ~ characters, for example
  66 c:\sources\
  67 Within msys-git bash, do
  68 cd /c/sources
  69 git clone git://git.savannah.nongnu.org/linphone.git --recursive
  70
  71
  72 Building
  73 ********
  74
  75 WARNING: During the build, windows might slow down suddenly. Using ctl+alt+del to start the windows system monitor,
  76  you might see a process 'LVpSRV.exe' or something like this that eats 90% of cpu.
  77 Kill it. Don't know what it is, but once killed, windows runs normally.
  78
  79 #run autogen.sh after a git checkout or update
  80 ./autogen.sh
  81 ./configure --prefix=/opt/linphone --enable-shared --disable-static
  82 make
  83 #will install to /opt/linphone, required for compilation of plugins.
  84 make install
  85 #make a binary zip of linphone
  86 make zip
  87 #additionally you can make binary installer if you have Inno Setup 5 installed in its default path
  88 make setup.exe
  89 #now you're done, you have a fresh linphone windows installer in the current directory.
  90
  91 #build plugins
  92 cd mediastreamer2/plugins/msx264
  93 ./autogen.sh
  94 PKG_CONFIG_PATH=/opt/linphone/lib/pkgconfig ./configure --prefix=/opt/linphone --enable-shared --disable-static
  95 #make a binary zip of this plugin
  96 make zip
  97 #or make an installer
  98 make setup.exe
  99
 100 #the buddylookup plugin enables lookup of buddies in a remote database using xml-rpc over http/https.
 101 cd coreapi/plugins/buddylookup
 102 ./autogen.sh
 103 PKG_CONFIG_PATH=/opt/linphone/lib/pkgconfig ./configure --prefix=/opt/linphone --enable-shared --disable-static
 104 make
 105 #make a binary zip of this plugin
 106 make zip
 107
 108
 109 ******************************************************
 110 *      Notes about linphone-deps generation          *
 111 ******************************************************
 112
 113 Linphone-deps is a collection of linphone dependencies, that are for some of them difficult
 114 to find as windows binaries.
 115 These notes are useful if you want to upgrade part of the software that is included in the
 116 linphone-deps packages.
 117
 118 List of software included in linphone-deps:
 119 libosip2  (compiled)
 120 libeXosip2 (compiled)
 121 libavcodec, libavutil, libavformat, libavdevice, libswscale (compiled, all these from ffmpeg)
 122 libtheora (from the web)
 123 libx264 (compiled from the version distributed from linphone's web site)
 124 libogg (from the web)
 125 libspeex, libspeexdsp (compiled, statically to workaround a dll-related crash)
 126 libgnutls (from the web)
 127 libgsm (from the web)
 128 libxml2 (compiled)
 129 libsoup (compiled)
 130
 131 Remarks:
 132 For every package compiled that goes into linphone-deps, .la files (libtool files) must be removed to avoid libtool errors.
 133 When running "make install DESTDIR=<somepath>", somepath must be absolute and should not contain any ~ or space.
 134
 135 - building ffmpeg
 136   ./configure --enable-shared --disable-static --enable-memalign-hack --extra-cflags="-fno-common" --enable-gpl && make
 137   make install DESTDIR=/home/<myuser>/ffmpeg-install
 138   Copy to ~/ffmpeg-install/usr/local/* to linphone-deps/.
 139   Copy also all *.dll.a files from the build tree to lib/ directort of linphone-deps. These are the implibs necessary to link a program against the dlls.
 140
 141 - building libxml2: the binaries found on the internet are generated with MSVC++, and for obscure reason they are not suitable for building libsoup
 142   (that requires libxml2).
 143   ./configure --enable-shared --disable-static && make && make install DESTDIR=/home/<myuser>/libxml2-install
 144   copy ~/libxml2-install/usr/local/* into linphone-deps/.
 145
 146 - building x264:
 147
 148   * download yasm normal version windows executable from yasm project page:
 149   http://www.tortall.net/projects/yasm/wiki/Download
 150   copy it as /usr/local/bin/yasm.exe
 151
 152   cd into x264/ dir then run:
 153   ./configure --enable-pic
 154   make
 155   make install DESTDIR=/home/<myuser>/x264-install
 156   then copy the content of ~/x264-install/usr/local/ into linphone-deps/.
 157
 158 - libgnutls (required for libsoup https support)
 159         - download binary zip from http://josefsson.org/gnutls4win.org
 160         - add to linphone-deps
 161
 162 - building libsoup (only required for buddylookup plugin)
 163         - download source from gnome ftp (warning: at the time of the writing only version 2.26.x can compile with the
 164                 glib version supplied in the gtk-bundle, 2.27 requires a new version of glib)
 165         - uncompress libgnutls zip in /
 166         - make sure you have libxml2 installed in /
 167         - apply a bugfix patch (fix gnutls support on windows, completely broken otherwise). The patch
 168                 is in linphone-deps/src, apply it this way:
 169                 cd libsoup-2.26.*
 170                 cd libsoup
 171                 patch -p0 < libsoup-gnutls-bugfix.patch
 172         - run:
 173                 ./configure --prefix=/usr --enable-shared --disable-static
 174                 make
 175                 make install
 176                 make install DESTDIR=/home/<myuser>/libsoup-install
 177         - copy ~/libsoup-install/usr/* into linphone-deps/
 178
 179 Once you have everything in linphone-deps, remove .la files from lib:
 180         cd lib && rm -f *.la