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