Update documentation for MSVC build support
This commit is contained in:
parent
db3879aeaa
commit
8c911257ac
@ -2,6 +2,7 @@
|
|||||||
Features:
|
Features:
|
||||||
- Support for postgresql backend added
|
- Support for postgresql backend added
|
||||||
Compatible with both ShadowNinja's and johnnyjoy's implementation
|
Compatible with both ShadowNinja's and johnnyjoy's implementation
|
||||||
|
- Support for MSVC/Windows compilation (Thanks to adrido!)
|
||||||
Enhancements:
|
Enhancements:
|
||||||
- Updated the included colors file with colors for the new tiles that
|
- Updated the included colors file with colors for the new tiles that
|
||||||
were recently added to the default minetest game.
|
were recently added to the default minetest game.
|
||||||
|
@ -39,6 +39,10 @@ Map Generation Features
|
|||||||
Build Features
|
Build Features
|
||||||
--------------
|
--------------
|
||||||
* Supports both the gcc and clang compiler suites
|
* Supports both the gcc and clang compiler suites
|
||||||
|
* Supports MSVC building on Windows (with SQLite3 and LevelDB)
|
||||||
|
|
||||||
|
* With automatic downloading of all but one of the required libraries.
|
||||||
|
|
||||||
* Build rpm, deb and/or tar.gz installation
|
* Build rpm, deb and/or tar.gz installation
|
||||||
packages. Or simply type 'make install'.
|
packages. Or simply type 'make install'.
|
||||||
|
|
||||||
@ -51,6 +55,9 @@ Windows
|
|||||||
Check the download page to obtain a compiled version:
|
Check the download page to obtain a compiled version:
|
||||||
`<https://github.com/Rogier-5/minetest-mapper-cpp/wiki/Downloads>`_
|
`<https://github.com/Rogier-5/minetest-mapper-cpp/wiki/Downloads>`_
|
||||||
|
|
||||||
|
Or check the building instructions for compiling using MSVC:
|
||||||
|
`<doc/build-instructions.rst>`_.
|
||||||
|
|
||||||
Install Dependencies
|
Install Dependencies
|
||||||
--------------------
|
--------------------
|
||||||
|
|
||||||
|
@ -8,9 +8,9 @@ Not all platforms receive the same amount of testing:
|
|||||||
|
|
||||||
* Gcc and clang builds on Linux are frequently tested.
|
* Gcc and clang builds on Linux are frequently tested.
|
||||||
* The BSD family should also give little trouble. It is not tested that I know of.
|
* The BSD family should also give little trouble. It is not tested that I know of.
|
||||||
* Windows building using MinGW is also regularly tested and should work.
|
* MSVC on Windows is tested.
|
||||||
* MSVC on Windows has not been tested recently.
|
* Windows building using MinGW is tested intermittently and should work.
|
||||||
* Building on OSX has not been tested recently.
|
* Building on OSX has not been tested recently and may not work.
|
||||||
|
|
||||||
Please let me know how you fared on your platform (when you encounter problems,
|
Please let me know how you fared on your platform (when you encounter problems,
|
||||||
but also when you're successful - so I can update this text with the latest
|
but also when you're successful - so I can update this text with the latest
|
||||||
@ -34,12 +34,18 @@ Libraries
|
|||||||
At least one of ``sqlite3``, ``postgresql``, ``leveldb`` and ``hiredis`` is required.
|
At least one of ``sqlite3``, ``postgresql``, ``leveldb`` and ``hiredis`` is required.
|
||||||
Check the minetest worlds that will be mapped to know which ones should be included.
|
Check the minetest worlds that will be mapped to know which ones should be included.
|
||||||
|
|
||||||
|
Not all database backend libraries may be obtainable for all platforms (in particular
|
||||||
|
for Windows).
|
||||||
|
|
||||||
|
The current build scripts for MSVC on windows support the SQLite3 and LevelDB backends out
|
||||||
|
of the box. Compiling with Redis or PostgreSQL support will require some extra work.
|
||||||
|
|
||||||
Build Environment
|
Build Environment
|
||||||
-----------------
|
-----------------
|
||||||
|
|
||||||
* C++ compiler suite (clang or gcc (including mingw); msvc has not recently been tested)
|
* C++ compiler suite (clang or gcc (including mingw); msvc on Windows)
|
||||||
* cmake
|
* cmake (not for msvc)
|
||||||
* make
|
* make (not for msvc)
|
||||||
|
|
||||||
Documentation
|
Documentation
|
||||||
-------------
|
-------------
|
||||||
@ -135,13 +141,33 @@ Linux Mint
|
|||||||
----------
|
----------
|
||||||
See `Debian and Derivatives`_
|
See `Debian and Derivatives`_
|
||||||
|
|
||||||
Windows
|
Windows (MinGW)
|
||||||
-------
|
---------------
|
||||||
|
|
||||||
You're probably in for a lot of work, downloading software, and
|
You're probably in for a lot of work, downloading software, and
|
||||||
probably compiling at least some of the direct and indirect dependencies.
|
probably compiling at least some of the direct and indirect dependencies.
|
||||||
At the moment, regrettably, detailed instructions are not available.
|
At the moment, regrettably, detailed instructions are not available.
|
||||||
|
|
||||||
|
Windows (MSVC)
|
||||||
|
--------------
|
||||||
|
|
||||||
|
The following must be installed to successfully compile minetestmapper using MSVC:
|
||||||
|
|
||||||
|
* Visual Studio 2015 or 2013 (lower may not work). VS Community can be obtained here:
|
||||||
|
https://www.visualstudio.com/
|
||||||
|
* A precompiled version of the gd library. A suitable version can be downloaded from
|
||||||
|
https://github.com/Rogier-5/minetest-mapper-cpp/wiki/Downloads#the-gd-library-for-compiling-minetestmapper-with-msvc
|
||||||
|
|
||||||
|
Alternatively, the gd sources can be downloaded from https://github.com/libgd/libgd.
|
||||||
|
They must be compiled using the same version of zlib that will be used when compiling
|
||||||
|
minetestmapper.
|
||||||
|
|
||||||
|
Version 2.2.1 of gd is verified to work, but any version 2.2.x should also work.
|
||||||
|
And presumably any version 2.x later than 2.2 should work as well.
|
||||||
|
|
||||||
|
All other required dependencies will be downloaded automatically by MSVC.
|
||||||
|
|
||||||
|
|
||||||
Other
|
Other
|
||||||
-----
|
-----
|
||||||
|
|
||||||
@ -177,10 +203,49 @@ Create native installation package(s):
|
|||||||
|
|
||||||
See `CMake Variables`_ for more CMake options.
|
See `CMake Variables`_ for more CMake options.
|
||||||
|
|
||||||
Windows
|
Windows (MinGW)
|
||||||
-------
|
---------------
|
||||||
|
|
||||||
Unfortunately, at the moment no instructions for Windows building are available.
|
Unfortunately, at the moment no instructions are available for Windows building using MinGW.
|
||||||
|
|
||||||
|
Windows (MSVC)
|
||||||
|
--------------
|
||||||
|
|
||||||
|
Setting up the IDE
|
||||||
|
..................
|
||||||
|
|
||||||
|
1. Open ``minetestmapper.sln`` or ``MSVC\mintestmapper.vcxproj`` with Visual Studio.
|
||||||
|
2. Configure the gd libary:
|
||||||
|
1. Open projectsettings `ALT+F7`.
|
||||||
|
2. Select `All Configurations` and `All Platforms`.
|
||||||
|
3. Click `C/C++` -> `additional include directories` and enter the path to the include directory of libGD.
|
||||||
|
4. Click `Apply`
|
||||||
|
5. Select a configuration (``Debug|Release``) and a platform (``x86|x64``)
|
||||||
|
6. Click `Linker` --> `additional libary directories` Enter the path to libgd that fits to your configuration and platform.
|
||||||
|
|
||||||
|
Do this step for all configurations and platforms you want to use.
|
||||||
|
|
||||||
|
WARNING: You will get a linker error if you select a version of libgd that does not fit to your configuration and platform.
|
||||||
|
|
||||||
|
Building Minetestmapper
|
||||||
|
.......................
|
||||||
|
|
||||||
|
With everything set up, Minetestmapper can be built.
|
||||||
|
|
||||||
|
Building for 64-bit may fail due to a `bug in snappy`__. If this happens,
|
||||||
|
the following steps will solve this:
|
||||||
|
|
||||||
|
1. Open ``packages\Snappy.1.1.1.7\lib\native\src\snappy.cc``
|
||||||
|
2. Change line 955 from ``#ifndef WIN32`` to ``#ifndef _WIN32``
|
||||||
|
|
||||||
|
__ https://bitbucket.org/robertvazan/snappy-visual-cpp/issues/1/snappycc-will-not-compile-on-windows-x64
|
||||||
|
|
||||||
|
Debugging Minetestmapper
|
||||||
|
........................
|
||||||
|
|
||||||
|
1. In projectsettings (`ALT+F7`) click `Debugging`.
|
||||||
|
2. Specify the Arguments in `Command arguments`.
|
||||||
|
3. Every time you launch the debugger, minetstmapper will be executed with those arguments.
|
||||||
|
|
||||||
OSX
|
OSX
|
||||||
---
|
---
|
||||||
|
@ -23,6 +23,10 @@ Major Features
|
|||||||
Build Features
|
Build Features
|
||||||
==============
|
==============
|
||||||
* Supports both the gcc and clang compiler suites
|
* Supports both the gcc and clang compiler suites
|
||||||
|
* Supports MSVC building on Windows (with SQLite3 and LevelDB)
|
||||||
|
|
||||||
|
* With automatic downloading of all but one of the required libraries.
|
||||||
|
|
||||||
* Build rpm, deb and/or tar.gz installation
|
* Build rpm, deb and/or tar.gz installation
|
||||||
packages. Or simply type 'make install'.
|
packages. Or simply type 'make install'.
|
||||||
|
|
||||||
@ -71,6 +75,7 @@ Differences From Stock Minetestmapper
|
|||||||
* Block numbers are shown on the scale as well
|
* Block numbers are shown on the scale as well
|
||||||
* Optionally, avoid reading the block list from the database
|
* Optionally, avoid reading the block list from the database
|
||||||
(dramatically speeds up generating maps of small parts of large worlds)
|
(dramatically speeds up generating maps of small parts of large worlds)
|
||||||
|
* Compiles using MSVC on windows.
|
||||||
|
|
||||||
In addition a number bugs have been fixed. As bugs are also getting
|
In addition a number bugs have been fixed. As bugs are also getting
|
||||||
fixed in the stock version of minetestmapper, no accurate list
|
fixed in the stock version of minetestmapper, no accurate list
|
||||||
|
Loading…
x
Reference in New Issue
Block a user