1 Compiling LyX 1.5 for Win32
2 ===========================
4 LyX 1.5 can be compiled with Microsoft Visual C++ 2005 or MinGW.
6 Compiling with MSVC 2005
7 ========================
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/
14 2 Install the Windows Platform SDK
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.)
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.)
32 Get the latest Python 2.5 version at
33 http://www.python.org/download/releases/2.5/
35 Install in C:\Python25 and add this directory to the PATH environment
36 variable (Start > Settings > Control Panel > System > Advanced >
37 Environment Variables).
41 Download and install SCons 0.96.92 (or newer, but not 0.96.1) from http://www.scons.org/download.php
43 6 Install the dependencies
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.).
52 From MS Visual Studio command prompt (not the regular cmd.exe),
53 run development\Win32\packaging\build_msvc.bat
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:
64 Microsoft.VC80.CRT.manifest
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.)
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
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
88 1 Install MinGW, and all the gcc-related stuff, and win32api.
90 2 download qt-win-opensource-4.x.x-mingw.exe and install to c:\qt\4.2.2.
92 3 install python and scons as instructed above. Set $path for python
93 to make your life a bit easier.
95 4 Check out lyx svn to c:\lyx-devel\lyx-1.5.x
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.
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 \
110 DESTDIR=..\lyx-1.5-install \
114 Creating the Installer
115 ======================
117 To create an installer with LyX and all related components, download
118 and install the latest NSIS from http://nsis.sourceforge.net
120 Open development\Win32\packaging\installer\setttings.user.nsh and modify
121 the settings depending on your build environment.
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".
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.
132 If you also want to generate bundled installer, download
133 lyx-windows-bundle-deps.zip from http://www.lyx.org/~bpeng, unpack
134 to lyx-windows-bundle-deps under the top source directory, and run
135 $ scons -f development\scons\SConstruct installer bundle=1
136 If you prefer to use another directory, you can use option bundle_dir like
137 $ scons -f development\scons\SConstruct installer bundle=1 bundle_dir=c:\bundle