r23582 by jghali - Update BUILDING_win32_msvc.txt file

scribus-commit scribus-commit at lists.scribus.net
Fri Apr 10 02:57:39 UTC 2020


Author: jghali
Date: Fri Apr 10 02:57:39 2020
New Revision: 23582

URL: http://scribus.net/websvn/listing.php?repname=Scribus&sc=1&rev=23582
Log:
Update BUILDING_win32_msvc.txt file

Modified:
    trunk/Scribus/BUILDING_win32_msvc.txt

Modified: trunk/Scribus/BUILDING_win32_msvc.txt
URL: http://scribus.net/websvn/diff.php?repname=Scribus&rev=23582&path=/trunk/Scribus/BUILDING_win32_msvc.txt
==============================================================================
--- trunk/Scribus/BUILDING_win32_msvc.txt	(original)
+++ trunk/Scribus/BUILDING_win32_msvc.txt	Fri Apr 10 02:57:39 2020
@@ -7,12 +7,14 @@
 
 You will need:
 - Microsoft Vista, 7 or a more recent version
-- Microsoft Visual Studio 2013 or later (for 32/64bit build)
+- Microsoft Visual Studio 2015 or later (for 32/64bit build)
 - A recent Qt release built with corresponding Visual Studio version (minimum 5.11, recommended >= 5.12.0)
-- Scribus common libraries kit downloaded from http://sourceforge.net/projects/scribus/files/scribus-libs/
-- Scribus 15x libraries kit downloaded from http://sourceforge.net/projects/scribus/files/scribus-libs/
+- Scribus common libraries kit downloaded from https://sourceforge.net/projects/scribus/files/scribus-libs/
+- Scribus 15x libraries kit downloaded from https://sourceforge.net/projects/scribus/files/scribus-libs/
 
-It is possible to use Microsoft Visual Studio 2013, 2015 or 2017 Express editions.
+Provided solutions have been tested with following Microsoft Visual Studion editions:
+- Microsoft Visual Studio 2015 Express and Professional
+- Microsoft Visual Studio 2017 Express, Community and Professional
 
 GETTING DEPENDENCIES
 ====================
@@ -26,19 +28,25 @@
 Building Qt:
 ------------
 
-Download the latest Qt 5 release from http://download.qt.io/official_releases/qt/ and unpack it to C:\Developer.
+Due to the complexity involved in compiling Qt, it is suggested to download precompiled binaries. To do so, 
+get Qt Online installer at https://www.qt.io/download-qt-installer, execute installer and follow instructions.
+
+If you want to compile Qt yourself, you will find some basic instructions below.  
+
+Download the latest Qt 5 release from https://download.qt.io/official_releases/qt/ and unpack it to C:\Developer.
 
 Follow instructions in following pages to get Qt build dependencies, noticeably perl, python and ruby:
-http://doc.qt.io/qt-5/windows-requirements.html
-http://doc.qt.io/qt-5/windows-building.html
+https://doc.qt.io/qt-5/windows-requirements.html
+https://doc.qt.io/qt-5/windows-building.html
 
 Start a command line and import your Visual Studio environment:
-- for building 32bit : \path\to\visual\studio\VC\vcvarsall.bat x86
-- for building 64bit : \path\to\visual\studio\VC\vcvarsall.bat x86_amd64
+- for building 32bit on Visual Studio 2015: \path\to\visual\studio\VC\vcvarsall.bat x86
+- for building 64bit on Visual Studio 2015: \path\to\visual\studio\VC\vcvarsall.bat x86_amd64
+- for building 32bit on Visual Studio 2017: \path\to\visual\studio\VC\Auxiliary\Build\vcvarsall.bat x86
+- for building 64bit on Visual Studio 2017: \path\to\visual\studio\VC\Auxiliary\Build\vcvarsall.bat x86_amd64
 
 Now cd to C:\Developer\qt-everywhere-whatever and run configure:
-- Visual Studio 2013 : configure -platform win32-msvc2013 -prefix /path/where/you/want/qt5/to/be/installed -nomake examples -nomake tests -opengl desktop -opensource -mp
-- Visual Studio 2015 : configure -platform win32-msvc2015 -prefix /path/where/you/want/qt5/to/be/installed -nomake examples -nomake tests -opengl desktop -opensource -mp 
+configure -platform win32-msvc -prefix /path/where/you/want/qt5/to/be/installed -nomake examples -nomake tests -opengl dynamic -opensource -mp
 
 After configure has finished its work, run nmake. Depending on the number of processors available on your machine, a complete Qt build may 
 take from a few hours to several days. Once Qt has finished building, run following command to install Qt to its install directory:
@@ -55,8 +63,11 @@
 -----------------------------
 
 Archives with ready-to-build solutions for scribus dependencies have been made available on Sourceforge: 
-http://sourceforge.net/projects/scribus/files/scribus-libs/
-These archives can be used to compile all dependencies necessary for Scribus.
+https://sourceforge.net/projects/scribus/files/scribus-libs/
+
+Archives for Visual Studio 2015 and Visual Studio 2017 are provided. These archives can be used to compile  all dependencies 
+necessary for Scribus. These archives allows to build libraries for 32bit and 64bit platforms using default toolsets. 
+The default configuration  allows to build binaries compatible with Windows Vista and up.
 
 Two different archives are needed :
 - scribus-commmon-libs-YYYYMMDD.7z : common libraries for 14x and trunk, no compilation is required here
@@ -66,13 +77,9 @@
 - msvcXXXX represents the Visual Studio version needed to compile provided Visual Studio solution
 - YYYYMMDD represents the date where the archive has been prepared/uploaded to Sourceforge.
 
-For building 15x dependencies, archives for Visual Studio 2013 and Visual Studio 2015 are provided. These archives allows to 
-build libraries  for 32bit and 64bit platforms using the different available toolsets, including the Windows XP compatible ones. 
-The default configuration  allows to build binaries compatible with Windows Vista and up.
-
 Once you downloaded the two appropriate archives :
 - decompress them in the *same* directory so as to get a layout similar to this one :
-    - your_script_libs_directory
+    - your_scribus_libs_directory
        |- scribus-1.5.x-libs-msvc2015
        |- scribus-common-libs
 - open the visual studio solution (*.sln) located in the scribus-1.5.x-libs-* directory
@@ -80,14 +87,16 @@
 
 If you want to build using a different toolset, you can use msbuild through the command line. To do so you can use the provided 
 build-all-platform-libs.bat script. For example :
-- to build with Visual Studio 2015 default toolset for x64 platform: build-all-platform-libs.bat x64 v140
-- to build with Visual Studio 2015 Windows XP toolset for Win32 platform: build-all-platform-libs.bat Win32 v140_xp
+- to build with Visual Studio 2015 default toolset for x64 platform:   build-all-platform-libs.bat x64   v140
+- to build with Visual Studio 2015 default toolset for Win32 platform: build-all-platform-libs.bat Win32 v140
+- to build with Visual Studio 2017 default toolset for x64 platform:   build-all-platform-libs.bat x64   v141
+- to build with Visual Studio 2017 default toolset for Win32 platform: build-all-platform-libs.bat Win32 v141
 
 BUILDING SCRIBUS
 ====================
 
-After having compiled all dependencies, open the Scribus-build-props.props file located in Scribus\win32\msvc2013 or
-Scribus\win32\msvc2015 depending on the Visual Studio version you are using in a text editor.
+After having compiled all dependencies, open the Scribus-build-props.props file located in Scribus\win32\msvc2015 or
+Scribus\win32\msvc2017 depending on the Visual Studio version you are using in a text editor.
 Update the dependency paths to match your system.
 
 Open the Visual Studio solution located in same directoy and start building. Note: if you built dependencies with a different 
@@ -95,63 +104,25 @@
 line using msbuild.
 
 After building completed, you will find executables in a Scribus-builds\scribus-$(configuration)-$(platform)-$(platformtoolset)\
-directory, located in same directory as Scribus sources. Those executables will not function yet. Scribus resources and
-dependencies must be copied to install directory first.
+directory, located in same directory as Scribus sources. Those executables will not function yet. Scribus dependencies must be 
+copied to install directory first.
 
 INSTALLING RESOURCES AND DEPENDENCIES
 =====================================
 
-To copy resources to build directory, create a batch script and copy/paste following lines :
-
-set SCRIBUS_SRC_PATH=.\Scribus
-set SCRIBUS_BUILD_ROOT=.\Scribus-builds
-set SCRIBUS_INSTALL_PATH=.\Scribus-builds\scribus-debug-win32-v140
-
-if not exist %SCRIBUS_INSTALL_PATH%\libs                mkdir %SCRIBUS_INSTALL_PATH%\libs
-if not exist %SCRIBUS_INSTALL_PATH%\share               mkdir %SCRIBUS_INSTALL_PATH%\share
-if not exist %SCRIBUS_INSTALL_PATH%\share\doc           mkdir %SCRIBUS_INSTALL_PATH%\share\doc
-if not exist %SCRIBUS_INSTALL_PATH%\share\plugins       mkdir %SCRIBUS_INSTALL_PATH%\share\plugins
-if not exist %SCRIBUS_INSTALL_PATH%\share\qml           mkdir %SCRIBUS_INSTALL_PATH%\share\qml
-
- copy %SCRIBUS_SRC_PATH%\AUTHORS                        %SCRIBUS_INSTALL_PATH%\share\doc
- copy %SCRIBUS_SRC_PATH%\COPYING                        %SCRIBUS_INSTALL_PATH%\share\doc
- copy %SCRIBUS_SRC_PATH%\LINKS                          %SCRIBUS_INSTALL_PATH%\share\doc
- copy %SCRIBUS_SRC_PATH%\TRANSLATION                    %SCRIBUS_INSTALL_PATH%\share\doc
-xcopy %SCRIBUS_SRC_PATH%\doc                            %SCRIBUS_INSTALL_PATH%\share\doc /s /y /i /D
-xcopy %SCRIBUS_SRC_PATH%\resources\dicts                %SCRIBUS_INSTALL_PATH%\share\dicts /s /y /i /D
-xcopy %SCRIBUS_SRC_PATH%\resources\editorconfig         %SCRIBUS_INSTALL_PATH%\share\editorconfig /s /y /i /D
-xcopy %SCRIBUS_SRC_PATH%\resources\iconsets             %SCRIBUS_INSTALL_PATH%\share\icons /s /y /i /D
- copy %SCRIBUS_SRC_PATH%\resources\iconsets\1_5_0\*.xml %SCRIBUS_INSTALL_PATH%\share\icons /y
- copy %SCRIBUS_SRC_PATH%\resources\iconsets\1_5_1\*.xml %SCRIBUS_INSTALL_PATH%\share\icons /y
-xcopy %SCRIBUS_SRC_PATH%\resources\keysets              %SCRIBUS_INSTALL_PATH%\share\keysets /s /y /i /D
-xcopy %SCRIBUS_SRC_PATH%\resources\loremipsum           %SCRIBUS_INSTALL_PATH%\share\loremipsum /s /y /i /D
-xcopy %SCRIBUS_SRC_PATH%\resources\profiles             %SCRIBUS_INSTALL_PATH%\share\profiles /s /y /i /D
-xcopy %SCRIBUS_SRC_PATH%\resources\swatches             %SCRIBUS_INSTALL_PATH%\share\swatches /s /y /i /D
-xcopy %SCRIBUS_SRC_PATH%\resources\templates            %SCRIBUS_INSTALL_PATH%\share\templates /s /y /i /D
- copy %SCRIBUS_SRC_PATH%\scribus\scribus.css            %SCRIBUS_INSTALL_PATH%\libs\scribus.css /y
- copy %SCRIBUS_SRC_PATH%\scribus\plugins\tools\pathcut\*.png      %SCRIBUS_INSTALL_PATH%\share\icons\1_5_1 /y
- copy %SCRIBUS_SRC_PATH%\scribus\plugins\tools\pathfinder\*.png   %SCRIBUS_INSTALL_PATH%\share\icons\1_5_1 /y
-xcopy %SCRIBUS_SRC_PATH%\scribus\plugins\scriptplugin\scripts     %SCRIBUS_INSTALL_PATH%\share\scripts /s /y /i /D
-xcopy %SCRIBUS_SRC_PATH%\scribus\plugins\scriptplugin\samples     %SCRIBUS_INSTALL_PATH%\share\samples /s /y /i /D
-copy  %SCRIBUS_SRC_PATH%\scribus\plugins\import\ps\import.prolog  %SCRIBUS_INSTALL_PATH%\libs\import.prolog
-copy  %SCRIBUS_SRC_PATH%\scribus\plugins\barcodegenerator\barcode.ps %SCRIBUS_INSTALL_PATH%\share\plugins\barcode.ps
-xcopy %SCRIBUS_SRC_PATH%\scribus\ui\qml                           %SCRIBUS_INSTALL_PATH%\share\qml /s /y
-copy  %SCRIBUS_SRC_PATH%\scribus\unicodemap\unicodenameslist.txt  %SCRIBUS_INSTALL_PATH%\share\unicodenameslist.txt
-
-del   %SCRIBUS_BUILD_ROOT%\*CMake* /s
-del   %SCRIBUS_BUILD_ROOT%\*MakeFile* /s
-
-Adjust SCRIBUS_SRC_PATH, SCRIBUS_BUILD_ROOT and SCRIBUS_INSTALL_PATH as needed and run batch script.
+The provided Visual Studio solutions are configured in such a way that resources provided by Scribus source code will be copied
+to appropriate directories during the build process. Before being able to run Scribus, you will have however to copy dependency 
+dlls to build directories.
 
 To install common libs:
-- open the scribus-common-libs directory where you uncompressed 15x/trunk libs
+- open the scribus-common-libs directory where you uncompressed common libraries
 - open the copy-dlls-to-15x-build-dir.bat file from scribus-common-libs directory in a text editor
-- modify the SCRIBUS_BUILDS_DIR, SCRIBUS_LIB_TOOLSET and PYTHON_DIR_* variables appropriately
+- modify the SCRIBUS_BUILDS_DIR, SCRIBUS_LIB_TOOLSET variables appropriately
 - execute batch file
 
 To install version specific libs:
 - open the scribus-15x-libs-msvc* directory where you uncompressed Scribus 15x libs
-- open the copy-*-dlls-to-build-dir.bat file in a text editor
+- open the copy-dlls-to-build-dir file in a text editor
 - modify the SCRIBUS_BUILDS_DIR and SCRIBUS_LIB_TOOLSET variables appropriately
 - execute batch file
 




More information about the scribus-commit mailing list