development/Win32/packaging/installer/Readme.txt

   1 Building the installer
   2 ======================
   3
   4 To build the installer do the following:
   5
   6 - install the latest version 3.x of NSIS (https://nsis.sourceforge.io/Download)
   7 - install the NSIS Large Strings build (https://nsis.sourceforge.io/Special_Builds)
   8   (extract the extension ZIP file in your NSIS installation folder and this way overwrite some files)
   9 - download the plugin FindProcDLL, choose the release for unicode (https://nsis.sourceforge.io/FindProcDLL_plug-in),
  10   extract from it the file FindProc.dll to the folder \Plugins\x86-unicode of NSIS's installation folder
  11 - download the plugin Inetc (https://nsis.sourceforge.io/Inetc_plug-in)
  12   extract the content into the NSIS's installation folder
  13 - Go to the Qt-kit directory, which you have specified as CMAKE_PREFIX_PATH before compiling in CMake Gui, enter the bin folder,
  14   copy these files:
  15    Qt5Concurrent.dll"
  16    Qt5Network.dll"
  17    Qt5OpenGL.dll"
  18    Qt5PrintSupport.dll"
  19   to %%lyxbuild%%\LYX_INSTALLED\bin
  20 - open the file settings.nsh with a text editor and adapt the settings for your need. A good text editor
  21   for NSIS development is e.g. Visual Studio Code with the NSIS extension.
  22 - right-click on the file lyx-standard.nsi and choose "Compile NSIS script"
  23
  24
  25 Updating dependencies
  26 =====================
  27
  28 - Imagemagick:
  29   download the portable version of imagemagick for windows from https://imagemagick.org/script/download.php (32 or 64 bit),
  30   current version is 7.0.10-0
  31   extract the zip archive,
  32   run imagemagickConvert.bat in %%repo%%\development\Win32\packaging\dependencies, browse to the extracted imagemagick archive,
  33   after the script finishes check for anything suspicious.
  34   if there is anything suspicious or it didn't work (in case imagemagic devs changed something), read the following description,
  35   it describes how it was done for 7.0.10-0, repair the bat file and update the description
  36   In the fresh extracted archive will be many executable files which are the exact same size as "magick.exe". magick.exe is
  37   the only executable LyX needs, delete the other redundant executables. Also delete ffmpeg.exe and IMDisplay.exe.
  38   The resulting folder size should be around 15-16 MB
  39
  40 - Ghostscript
  41   download ghostscript for windows from https://www.ghostscript.com/download/gsdnld.html (32 or 64 bit), current version is 9.50
  42   install to your computer or open the installer executable with 7zip, extract the folders "bin" and "lib" from the installdir/archive
  43   to %%dependencies%%\ghostscript.
  44
  45 - Python
  46   download the latest Python 2 release for windows from https://www.python.org/downloads/windows/ (32 or 64 bit),
  47   current version is 2.7.17
  48   Install it or extract with a tool named lessmsi. If you install it, you will have to find python27.dll in the
  49   Windows\System32 folder. 64-bit dlls on a 64-bit windows are stored in Windows\System32 folder, 32-bit dlls on a 64-bit windows
  50   are stored in Windows\SysWOW64. Copy this python27.dll to %%dependencies%%\Python, from the python installation folder copy
  51   all files and "DLLs", "Lib" and "libs" subfolders to %%dependencies%%\Python. You can uninstall python afterwards.
  52   If you extracted with lessmsi, you will also get visual studio runtime dlls and some executables, which are used during installation,
  53   these are not needed. Copy the 2 python executables, the python dll, the 3 textfiles (license, news and readme) and the "DLLs",
  54   "Lib" and "libs" subfolders to %%dependencies%%\Python.
  55
  56 - Visual Studio runtime
  57   Download the latest Visual C++ Redistributable (if you still haven't), the version should match with your VS C++ compiler
  58   (Buildtools) though. Find these files in Windows/System32 folder:
  59    concrt140.dll
  60    msvcp140.dll
  61    vcamp140.dll
  62    vccorlib140.dll
  63    vcomp140.dll
  64    vcruntime140.dll
  65   For 64 bit you will additionally need
  66    vcruntime140_1.dll
  67   See the Python description above for explanation of different store locations of 64 and 32 bit dlls. Copy these dlls to
  68   %%dependencies%%\bin.
  69
  70 - NetPbm
  71   download the latest binaries zip file from http://gnuwin32.sourceforge.net/packages/netpbm.htm,
  72   current version is 10.27, last updated on 12 May 2005
  73   extract the files
  74    libnetpbm10.dll
  75    pnmcrop.exe
  76   to %%dependencies%%\bin.
  77
  78 - DTL
  79   Using TeX Live Manager install package dtl.win32,
  80   From C:\texlive\2019\bin\win32 copy these files
  81    dt2dv.exe
  82    dv2dt.exe
  83   to %%dependencies%%\bin. You can uninstall the package afterwards.
  84   Info: Version 0.6.1 does not work with MikTex (math preview triggers error complaining about missing kpathsea631.dll),
  85   therefore this method is not usable.
  86   Update: as of report 11325 DTL tools are included in lyxgit and get compiled alongside lyx.
  87
  88 - rsvg-convert
  89   dowload the 7zip archve from https://opensourcepack.blogspot.com/2012/06/rsvg-convert-svg-image-conversion-tool.html,
  90   current version is 2.40.20
  91   Extract rsvg-convert.exe ti %%dependencies%%\bin.
  92
  93 - unoconv
  94   download the latest source code (zip) from https://github.com/unoconv/unoconv/releases
  95   current version is 0.8.2
  96   extract unoconv (no file extension) to %%dependencies%%\bin and add the extension ".py"
  97
  98 - pdfview.exe
  99   this is a NSIS script, which calls users standard pdf viewer to display pdf files you compile with
 100   LaTeX using LyX, its source is available in %%lyxgit%%\development\Win32\pdfview
 101
 102 Note: if you update any dependencies, please add a note to ChangeLog.txt