Clone wiki

QMapShack / BuildWindowsVisualStudio2013

Prev (Install QMapShack) | Home | Manual | Index | (Compile Instructions for Windows with VisualStudio 2017) Next



Compiling and Building QMapShack for Windows

Foreword

The following description explains how the QMapShack windows binaries provided for download at https://bitbucket.org/maproom/qmapshack/downloads are created.

I try to keep a balance between providing a complete but still reasonably compact description. So, depending on the setup of your development machine (e.g. language settings) you might have to make some adaptations which may not be described here in full detail. So please be prepared for some improvisation, e.g. when adapting path names or resolving start menu entries.

Of course, there might be other ways to create windows binaries, e.g. with other compiler tool chains. If you succeed, you are encouraged to create a build description on a separate Wiki page.

General remarks

QMapShack for Windows (short: QMS) is build with Visual Studio 2013 as 64bit application.

  • Ensure to have the 64bit option selected in all build steps.
  • Currently, no 32bit version is officially supported. It should still be possible to build a 32bit version using analogous steps. But you might have problems with memory limitations on large maps and you will be on your own when it comes to bug fixing.

Note: You don't have to buy Visual Studio 2013. The free-of-charge Visual Studio 2013 Community-Edition works, too. Instead of Visual Studio 2013, Visual Studio 2015 should also work. Maybe we switch to 2015 sooner or later due to its improved C++-11 support (https://msdn.microsoft.com/library/hh567368.aspx#featurelist)

Required tools for building and installing

Compile instructions

C1.) Compile the GDAL library, http://www.gdal.org/

Build instructions inspired by http://trac.osgeo.org/gdal/wiki/BuildingOnWindows, http://dominoc925.blogspot.de/2013/03/build-64-bit-gdal-for-windows.html

If you need support for formats such as WCS, WMS, WMTS, MBTiles: see Compile the GDAL library with additional formats

  MSVC_VER=1800
  # NOTE: MSVC_VER=1800 corresponds to Visual Studio 2013
  GDAL_HOME = "M:\lib\gdal"
  # NOTE: GDAL_HOME specifies where the build results will be stored
  # NOTE: try to avoid path names with spaces and non-ASCII characters and in case of trouble try without quotes
  WIN64=YES
  • On the Windows Desktop: select Start | All Programs | Microsoft Visual Studio 2013 | Visual Studio Tools | VS 2013 x64 Native Tools Command Prompt.
  • in the command prompt: change directory to the extracted GDAL source code root folder
  nmake /f makefile.vc
  nmake /f makefile.vc devinstall

C2.) Compile the PROJ library http://trac.osgeo.org/proj/

  • Download the source code of the version 4.8 (or latest) from http://trac.osgeo.org/proj/ and unzip it
  • In nmake.opt, adapt the following lines, according to your build environment [my settings are given as example]
  INSTDIR=M:\lib\PROJ
  • On the Windows Desktop: select Start | All Programs | Microsoft Visual Studio 2013 | Visual Studio Tools | VS 2013 x64 Native Tools Command Prompt.
  • in the command prompt: change directory to the extracted PROJ4 source code root folder:
  nmake /f makefile.vc
  nmake /f makefile.vc install-all

C3.) Compile the routino library http://www.routino.org

  svn co http://routino.org/svn/trunk routino

Note: you might have to install TortoiseSVN or any other svn client

  • Adapt, use and follow instructions found in build_routino.bat which you can find in \msvc_64 directory of your QMS source directory
  • It may be necessary to switch off antivirus software before compilation (Avast has been reported to block compilation by one user)

C4.) Install Qt5.5 http://qt-project.org

Note: QMS should compile with Qt5.4 as well but Qt5.4 has a nasty bug in list scrolling. Qt5.6 on the other hand will not work as QWebkit is used in QMS which has been removed from Qt5.6.

Note: if you prefer offline installation you can choose the right package in OFFLINE INSTALLERS section of that page

C5.) Compile the QuaZip library http://quazip.sourceforge.net/index.html

  • Get the latest version from the Sourceforce download page https://sourceforge.net/projects/quazip/
  • unzip the file
  • Start the CMake GUI (you did install CMake before, didn't you)
  • Enter the path to the source directory (where you unzipped the sources to)
  • Enter the path where you want to build the quazip-library (should be a new directory)
  • Select "Visual Studio 12 2013 Win64" and "Use default native compilers"
  • add these two entries before running configure:
CMAKE_PREFIX_PATH C:/Qt5/5.5/msvc2013_64    <-- this path has to match the actuall Qt-installation
ZLIB_INCLUDE_DIRS C:/Qt5/5.5/msvc2013_64/include/QtZlib
  • click 'configure'
  • verify no 'NOTFOUND' entries remain
  • click 'generate'
  • click 'open project' --> this opens the configured project in Visual studio

  • in Visual Studio select the solution configuration type 'Release' or 'RelWithDebInfo' (must match the configuration used to build QMS)

  • Right-Click on the ALL_BUILD project and select build to start the compilation
  • the last step created subdirectories 'Release' resp. 'RelWithDebInfo' in the quazip-build-directory. Within this directory the new build quazip5.dll and lib are to be found.
  • quazip-headerfiles are to be found in quazip-source-directory, subdirectory 'quazip'
  • create a new directory to collect quazip binaries and includes, e.g.
  M:\lib\QUAZIP
  • In that directory, create a sub-directory 'include' and there copy the quazip header files
  • In that directory, create a sub-directory 'lib' and there copy the quazip5.dll and lib files

C6.) Compile the jpeg library http://www.ijg.org/

Note: libjpeg is needed for qmt_map2jnx. Other parts of QMapshack may use the jpeg libraries included in Qt or GDAL. - Get the latest version of the source code as .zip file from http://www.ijg.org/

  http://www.ijg.org/files/jpegsr9c.zip
  • Unzip the source. You will get the directory jpeg-9c
  • Read file install.txt concerning the build instructions for "Microsoft Windows, Visual Studio 2017 (v15):"
  • Adapt the file makejvcx.v15 for using VS2103 instead of VS2015 by replacing v141 with v120 in the property PlatformToolset (line 80). See PlatformToolset for some background.
  • On the Windows Desktop: select Start | All Programs | Microsoft Visual Studio 2013 | Visual Studio Tools | VS 2013 x64 Native Tools Command Prompt.
  • in the command prompt: change directory to the extracted jpeg source code root folder:
  NMAKE /f makefile.vs  setup-v15
  • Open the solution file jpeg.sln
  • Open the configuration manager (click on the list box filled with "Win32"
  • create a new project platform x64 by clining from Win32
  • now build the project for x64 - Release
  • create a directory structure for the header files and the resulting library, e.g. ~ M:\lib\JPEG\include M:\lib\JPEG\lib ~
  • copy the files jconfig.h, jmorecfg.h, jpeglib.h to the include directory
  • copy the file jpeg.lib to the lib directory

C7.) Get the QMapShack source from the repository, e.g.

   hg clone https://bitbucket.org/maproom/qmapshack QMapShack

Note: you might have to install TortoiseHG or any other mercurial client

C8.) Start the CMake GUI (you did install CMake before, didn't you)

  • Enter the path to the source directory (which has been created by cloning the hg repository in the previous step)
  • Enter the path where you want to build the binaries (should be a new directory)
  • Select "Visual Studio 12 2013 Win64" and "Use default native compilers"
  • Configure
    • In the first run there will be errors.
    • Now enter the directories where you have installed Qt5, GDAL, PROJ.4, routino and quazip, JPEG to the respective variables.
    • in addition to the usual defines for QUAZIP you have to specify the path where zlib.h is being found. Zlib is being shipped with Qt5.5 but is not included within the cmake-find-files Qt does provide. (set QUAZIP_ZLIB_INCLUDE_DIR to e.g. C:/Qt/5.5/msvc2013_64/include/QtZlib)
    • Only change the UPDATE_TRANSLATIONS option in you know what you are doing. See the DeveloperTranslate Wiki page for details.
    • After that, Configure again.
    • Note: in case that you only get some warnings, you anyway can try to GENERATE
  • Generate

C9.) Open the generated build\QMapShack.sln with VS2013

  • Change solution configuration type to "Release"
  • Set the qmapshack project as start project by right-clicking and selecting "Set as StartUp Project" (may not be necessary)
  • Right-Click on the ALL_BUILD project and select build to start the compilation

Creating a Windows binary installer

I1.) Download the VC redistributable installer

from http://www.microsoft.com/en-us/download/details.aspx?id=40784 Note: in case the redistributable files are already installed in your system, this step is not necessary.

I2.) [Optional] Download libmysql.dll from mariadb

Download mariadb-10.1.11-winx64.zip (large file - ca 260MB) from https://downloads.mariadb.org/mariadb/10.1.11/ and extract libmysql.dll. Or copy libmysql.dll from an existing QMS installation This library is only needed at runtime for mysql/mariadb support

Note: If you don't download/copy it, you have to comment out the respective lines in the copyfiles.bat and QMapShack_Installer.nsi scripts which are described in the next steps.

I3.) Copy all required files to intermediate directory

  • Edit the file copyfiles.bat which you can find in \msvc_64 directory of your QMS source directory and adapt the directories
    • where you have installed Qt5
    • where your self compiled binaries of routino, GDAL and PROJ4 are
    • where the runtime libraries from mingw/msys are
    • where the libmysql.dll is
    • Path to the build directory which you have specified in the CMake GUI
  • Execute the copyfiles.bat
  • The copyfiles.bat script will create a new directory "Files" which has exactly the same content as the final installation directory created by the NSIS installer will have.
  • QMapShack does not have any dependencies out of its own installation directory. So instead of creating an NSIS installer in the next step you could just copy this directory to an other machine for a quick deployment
  • [optional] Test whether the deployment is complete: double-click on Files/qmapshack.exe ==> QMapShack should start up and be fully operational without any restrictions

I4.) Create the installer with NSIS(3.0b1)

  • Run the QMapShack_Installer.nsi script e.g via right click on script file and choosing "Compile NSIS Script" from contextual menu.

Note: there also are the options to run the script on command prompt with commandline version(makensis.exe). Or you can start windows version (makensisw.exe) to run the script.

TroubleShooting

If QMapShack does not behave as you expect, please have a look at the TroubleShooting Wiki Page. If this does not help you to understand the problem, you can try to dig deeper by debugging as described in the next section.

Debugging with VS2013

For bug fixing you might want to run QMapShack with the VS2013 debugger. This requires some additional configuration

D1.) Set the solution configuration type to "RelWithDebInfo"

Note: you would expect the solution configuration "Debug" to be used. But with "Debug" you will get a crash in pj_init_plus() shortly after start as described in http://stackoverflow.com/questions/19197791/projapi-gis-library-heap-overflow The reason for this problem is currently unknown. Any help is welcome.

D2.) Right-click on the "qmapshack" project and open the "Properties" dialog

  PATH=%PATH%;M:\lib\gdal\bin;M:\lib\PROJ\bin;M:\src\routino_pkg\lib;C:\Qt5\5.5\msvc2013_64\bin

D3.) Compile

  • Right-Click on the ALL_BUILD project and select build to start the compilation

D4.) Run/Debug preparations

Now you can in principle run QMapShack with the VS2013 debugger: step through, inspect variables, see the debug output

But as QMapShack expects some configuration files for gdal and routino in the directory where it's executable is placed. If those files are not there, you will get some strange error messages such as "the specified XML file is not found" at startup and the functionality for map/coordinate transformations will be limited.

The easiest way to provide these files is to copy the whole content of the Files directory created by copyfiles.bat as described in step I2) except the qmapshack.exe to the directory where you RelWithDebInfo executable has been created (build\bin\RelWithDebInfo).

Note: If you really copy all those files, then you can skip the step to set the PATH as described in step D2). Alternatively you can set the path as described and only copy all those configuration files and resources (i.e. all files which are not .dll's + all directories)

D5.) Run/Debug

Congratulations: all preparations finished. Now you can really start debugging! Right click on "qmapshack" project and select Debug -> Start new instance


Prev (Install QMapShack) | Home | Manual | Index | Top | (Compile Instructions for Windows with VisualStudio 2017) Next

Updated