INSTALL.Win32

   1 Compiling LyX 1.5 for Win32
   2 ===========================
   3
   4 LyX 1.5 can be compiled with Microsoft Visual C++ 2005 or MinGW.
   5
   6 Compiling with MSVC 2005
   7 ========================
   8
   9 1       Install MSVC 2005
  10
  11         If you don't have MSVC 2005 installed, download and install the free
  12         Express edition from http://msdn.microsoft.com/vstudio/express/visualc/
  13
  14 2       Install the Windows Platform SDK
  15
  16         see: http://msdn.microsoft.com/vstudio/express/visualc/usingpsdk/
  17         (You don't need to install the IIS, MDAC, and Tablet PC SDK that are
  18          delivered with the Platform SDK.)
  19
  20 3       configure MSVC
  21
  22         Follow exactly the steps of
  23         http://msdn.microsoft.com/vstudio/express/visualc/usingpsdk/
  24         In Step 3 follow also the things noted as alternative.
  25         (If you later get an error message that "windows.h" cannot be found,
  26          create the global Windows environment variables "INCLUDE" and "LIB".
  27          INCLUDE contains the paths to the "include" folders of the installed
  28          platform SDK and of MSVC. LIB contains the corresponding "lib" folders.)
  29
  30 4       Install Python
  31
  32         Get the latest Python 2.5 version at
  33         http://www.python.org/download/releases/2.5/
  34
  35         Install in C:\Python25 and add this directory to the PATH environment
  36         variable (Start > Settings > Control Panel > System > Advanced >
  37         Environment Variables).
  38
  39 5       Install SCons
  40
  41         Download and install SCons 0.96.92 (or newer, but not 0.96.1) from http://www.scons.org/download.php
  42
  43 6       Install the dependencies
  44
  45         Download http://www.lyx.org/~bpeng/lyx-windows-deps-msvc-qt422.zip
  46         and extract in the root directory of your LyX files (so you will get
  47         a directory called lyx-windows-deps-msvc next to the other directories
  48         like src, development etc.).
  49
  50 7       Compile
  51
  52         From MS Visual Studio command prompt (not the regular cmd.exe),
  53         run development\Win32\packaging\build_msvc.bat
  54
  55 8       First start of LyX
  56
  57         To start the just compiled lyx.exe, it is necessary to copy the following
  58         files to the folder where the just compiled "lyx.exe" is:
  59
  60         Aiksaurus.dll
  61         aspell.dll
  62         iconv.dll
  63         intl.dll
  64         Microsoft.VC80.CRT.manifest
  65         msvcp80.dll
  66         msvcr80.dll
  67         QtCore4.dll
  68         QtGui4.dll
  69
  70         All files except of the msvcp80.dll and msvcr80.dll should be present on your system.
  71         The missing files can be downloaded from:
  72         http://wiki.lyx.org/uploads/DevelTools/buildLyx/LyXWinBuildDLLs.zip
  73         (Currently there is a bug in the aspell.dll, so use the version that is delivered in this zip-file.)
  74
  75         msvcp80.dll and msvcr80.dll are the C Runtime and C++ libraries
  76         supplied with MSVC 2005. They are freely redistributable.
  77         See http://msdn2.microsoft.com/en-us/library/8kche8ah(VS.80).aspx
  78         for details.
  79
  80         All of the other .dlls above and the lyx executable are compiled
  81         from code released under the GPL which states (section 3) that
  82         GPL software may be linked against system files such as msvcp80.dll
  83         and msvcr80.dll.
  84
  85 Compiling with MinGW
  86 ====================
  87
  88 1       Install MinGW, and all the gcc-related stuff, and win32api.
  89
  90 2       download qt-win-opensource-4.x.x-mingw.exe and install to c:\qt\4.2.2.
  91
  92 3       install python and scons as instructed above. Set $path for python
  93            to make your life a bit easier.
  94
  95 4       Check out lyx svn to c:\lyx-devel\lyx-1.5.x
  96
  97 5       Download zlib binaries and developer files (zlib-1.2.3-bin.zip and
  98            zlib-1.2.3-lib.zip) from http://gnuwin32.sourceforge.net/packages/zlib.htm
  99            libiconv from http://gnuwin32.sourceforge.net/packages/libiconv.htm
 100            gettext  from http://gnuwin32.sourceforge.net/packages/gettext.htm
 101            unpack all of them to the same directory c:\lyx-devel\mingw_deps.
 102
 103 6       start a command window, run commands:
 104            $ cd c:\lyx-devel\lyx-1.5.x
 105            $ scons -f development\scons\SConstruct \
 106                extra_lib_path=..\mingw_deps\lib  \
 107                    extra_inc_path=..\mingw_deps\include \
 108                    extra_bin_path=..\mingw_deps\bin \
 109                    qt_dir=c:\qt\4.2.2 \
 110                    DESTDIR=..\lyx-1.5-install \
 111                    install
 112
 113
 114 Creating the Installer
 115 ======================
 116
 117         To create an installer with LyX and all related components, download
 118         and install the latest NSIS from http://nsis.sourceforge.net
 119
 120         Open development\Win32\packaging\installer\setttings.user.nsh and modify
 121         the settings depending on your build environment.
 122
 123         Finally, go to development\Win32\packaging\installer
 124         (in a normal Windows Explorer), right-click on lyx.nsi and click
 125         "Compile NSIS Script".
 126
 127         You can also use the installer target of scons. Namely, use a command like
 128            $ scons -f development\scons\SConscript installer
 129         This will create $BUILDDIR\lyx-version-timestamp-Installer.exe for a devel version,
 130         and $BUILDDIR\lyx-version-Install.exe for a released version of lyx.