[PATCH] INSTALL: add notes for a native win32 build

Lubomir I. Ivanov neolit123 at gmail.com
Mon Oct 14 03:52:49 UTC 2013


From: "Lubomir I. Ivanov" <neolit123 at gmail.com>

There are more details to it, but i decided to exclude them
as these seem situational:

- libraries tend to mostly fail to build from source on win32...
- libiconv may be required by an oddly pre-built libxml2 package
- pkg-config requires a CMD wrapper so that an extra CRLF line is
trimmed from stdout

If someone takes on this task, i guess he/she may pop on the
mailing list for questions.

Signed-off-by: Lubomir I. Ivanov <neolit123 at gmail.com>
---
 INSTALL | 57 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 56 insertions(+), 1 deletion(-)

diff --git a/INSTALL b/INSTALL
index 9e016d1..37387b8 100644
--- a/INSTALL
+++ b/INSTALL
@@ -119,7 +119,62 @@ $ make create-windows-installer
 Building Subsurface on Windows
 ------------------------------
 
-This is still work in progress.
+1) Install msys-git:
+http://msysgit.github.io
+
+Tools part of MSYS are required for building Subsurface, while you also
+need Git to be upstream and contribute to the project.
+Make sure that the msys/bin (or git/bin) folder is in PATH.
+
+2) Install Qt
+http://qt-project.org/downloads
+
+Subsurface is currently built against Qt 4.8.5.
+
+3) Install a MinGW toolchain
+https://docs.google.com/open?id=0B4D8x6CJEmtuczdiQklwMEs4RUU
+
+Qt 4.8.5 comes without a compiler and you will have to download it from
+a separate location. Other compiler may work, but there are no guaranties for
+that. Make sure that the mingw/bin folder is in PATH.
+
+4) Install Libdivecomputer
+Use similar steps to the previous section, without the sudo command.
+
+5) Install CMake (required for building Marble):
+http://www.cmake.org/cmake/resources/software.html
+
+Make sure that the cmake/bin folder is in PATH.
+
+5) Download and build Marble
+http://marble.kde.org/sources.php
+http://techbase.kde.org/Projects/Marble/WindowsCompiling#Compiling_Marble_using_MingW
+
+Make sure you build both the Debug and Release versions.
+
+6) Install pkg-config
+http://ftp.gnome.org/pub/gnome/binaries/win32/dependencies/pkg-config_0.26-1_win32.zip
+
+pkg-config depends on DLL files such as libglib-2.0-0.dll and has to be in
+PATH, so it's best that you copy the executable to msys/bin.
+
+7) Install other dependencies
+Subsurface also depends on the following libraries:
+
+* libxml2
+http://www.xmlsoft.org/downloads.html
+* libxslt
+http://xmlsoft.org/XSLT/
+* libusb-1.0
+http://sourceforge.net/apps/trac/libusb-win32/wiki
+* zlib
+http://www.zlib.net/
+* libzip
+http://www.nih.at/libzip/
+
+Once you have the libraries, create .pc files (pkg-config) for them and place
+the files in a folder that is indicated by the PKG_CONFIG_PATH environment
+variable - e.g. PKG_CONFIG_PATH=c:\msys\pkg-config
 
 To build subsurface, use:
 
-- 
1.7.11.msysgit.0



More information about the subsurface mailing list