Mapnik-Windows编译

Build and Package Mapnik for windows编译和打包

These are working notes on building Mapnik from source on windows.

• Currently these instructions target the upcoming Mapnik 2.3.x release.
• This is being tested on windows 7 64 bit.
• This is currently only tested with release builds in 32 bit. 64 bit support is planned, but not tested yet.

Visual Studio versions.

These notes attempt to map out the steps to compile Mapnik and dependencies with either VS 2008 or VS 2010. We also plan to support VS 2012.

编译Mapnik和依赖是VS2008或VS2010。

Setup

Step 1: Build Mapnik dependencies

第1步：编译Mapnik依赖

See the building_mapnik_dependencies.md document for details on building Mapnik dependencies.

查看“编译_Mapnik_依赖.md”文档有更多关于编译Mapnik依赖的细节。

Step through it copying and pasting chunks of commands, ensuring they work before continuing.

逐步复制和粘贴命令块，确保它们在继续之前工作。

Step 2: Download and build Mapnik

Currently we are targeting Mapnik 2.3.x:

git clone https://github.com/mapnik/mapnik.git -b 2.3.x mapnik

Next edit the build_mapnik.bat and ensure the variables match your system (https://github.com/mapnik/mapnik-packaging/blob/18bb66ba95540c069acaf267ea7594bfd83734d9/windows/build_mapnik.bat#L3-L12). In particular ensure that the MAPNIK_SOURCE variable points the git checkout you just made above.

Then run the build_mapnik.bat:

cd mapnik-packaging/windows
build_mapnik.bat 1> build.log

Mapnik should be compiled and placed in the folder pointed to by the PREFIX variable in build_mapnik.bat

If you hit errors you can ask for help by creating an issue at https://github.com/mapnik/mapnik-packaging/issues?state=open

Gochas

The VS 2008 vcbuild command is broken on arrival

It complains about write-access. To fix it do:

cd C:\Program Files (x86)\Microsoft Visual Studio 9.0\VC\vcpackages
regsvr32 vcprojectengine.dll

https://github.com/mapnik/mapnik-packaging/tree/master/windows

编译依赖

Building Mapnik dependencies on Windows编译Mapnik依赖

(Visual C++ express 2008, 2010 and 2012 32-bit)

Buiding dependencies on windows can be very tedious. The goal here is to provide concise instructions for building individual packages using either VC++ 2008, or 2010/2012.

在windows上构建依赖关系可能非常乏味。这里的目标是提供使用VC++2008或2010/2012构建单个包的简明说明。

Hopefully, this will allow fully automated builds in the future.

希望这将允许将来完全自动化的构建。

Prerequisites前提准备

• Visual C++ 2008, 2010 or 2012, Express or Professional versions
  • http://www.microsoft.com/visualstudio/en-us/products/2008-editions/visual-basic-express
  • http://www.microsoft.com/visualstudio/en-us/products/2010-editions/visual-basic-express
• GNU Unix tools (GnuWin32) * bsdtar * make * wget
• msysgit - install into c:/Git to avoid issues with spaces in paths
• unzip (from msysgit)
• patch (from msysgit)
• sed (from msysgit)
• curl (from msysgit)
• cygwin (install bash,make,coreutils) - needed to build pixman and icu (vs 2008)

Environment

We'll be using combination of "Visual Studio 2008 Command Prompt" (or "Visual Studio 2010 Command Prompt" or "Developer Command Prompt for VS2012") and GNU tools. Please, ensure PATH is setup correctly and GNU tools can be accessed from VC++ command prompt. The order in %PATH% variable is important (Git / Cygwin / GnuWin32 )

set PATH=%PATH%;c:\git\bin;c:\cygwin\bin;c:\GnuWin32\bin
set ROOTDIR=c:\dev2
cd %ROOTDIR%
mkdir packages 
set PKGDIR=%ROOTDIR%/packages

Packages versions:

set ICU_VERSION=4.8
set BOOST_VERSION=49
set ZLIB_VERSION=1.2.8
set LIBPNG_VERSION=1.5.17
set JPEG_VERSION=8d
set WEBP_VERSION=1.4.0
set FREETYPE_VERSION=2.4.9
set POSTGRESQL_VERSION=9.1.3
set TIFF_VERSION=4.0.0beta7
set PROJ_VERSION=4.8.0
set PROJ_GRIDS_VERSION=1.5
set GDAL_VERSION=1.9.0
set LIBXML2_VERSION=2.7.8
set PIXMAN_VERSION=0.28.2
set CAIRO_VERSION=1.12.14
set SQLITE_VERSION=3071100
set EXPAT_VERSION=2.1.0
set GEOS_VERSION=3.3.3

Download

wget https://raw.github.com/mapnik/mapnik-packaging/master/windows/cairo-win32.patch --no-check-certificate
wget https://raw.github.com/mapnik/mapnik-packaging/master/windows/libxml.patch --no-check-certificate

cd %PKGDIR%
curl http://iweb.dl.sourceforge.net/project/boost/boost/1.%BOOST_VERSION%.0/boost_1_%BOOST_VERSION%_0.tar.gz -O
curl http://www.ijg.org/files/jpegsr%JPEG_VERSION%.zip -O
curl https://webp.googlecode.com/files/libwebp-%WEBP_VERSION%-windows-x86.zip -O
curl http://ftp.igh.cnrs.fr/pub/nongnu/freetype/freetype-%FREETYPE_VERSION%.tar.gz -O
curl http://ftp.postgresql.org/pub/source/v%POSTGRESQL_VERSION%/postgresql-%POSTGRESQL_VERSION%.tar.gz -O
curl ftp://ftp.simplesystems.org/pub/libpng/png/src/libpng15/libpng-%LIBPNG_VERSION%.tar.gz -O
curl http://www.zlib.net/zlib-%ZLIB_VERSION%.tar.gz -O
curl http://download.osgeo.org/libtiff/tiff-%TIFF_VERSION%.tar.gz -O
curl http://www.cairographics.org/releases/pixman-%PIXMAN_VERSION%.tar.gz -O
curl http://www.cairographics.org/releases/cairo-%CAIRO_VERSION%.tar.xz -O
curl http://download.icu-project.org/files/icu4c/4.8.1.1/icu4c-4_8_1_1-src.tgz -O
curl ftp://xmlsoft.org/libxml2/libxml2-%LIBXML2_VERSION%.tar.gz -O
curl http://iweb.dl.sourceforge.net/project/expat/expat_win32/%EXPAT_VERSION%/expat-win32bin-%EXPAT_VERSION%.exe -O
curl http://download.osgeo.org/gdal/gdal-%GDAL_VERSION%.tar.gz -O
curl http://www.sqlite.org/sqlite-amalgamation-%SQLITE_VERSION%.zip -O
curl http://download.osgeo.org/proj/proj-%PROJ_VERSION%.tar.gz -O
curl http://download.osgeo.org/proj/proj-datumgrid-%PROJ_GRIDS_VERSION%.zip -O
curl http://download.osgeo.org/geos/geos-%GEOS_VERSION%.tar.bz2 -O

If BOOST and EXPAT don't seem to download properly by CURL, check the file you get. It probably contains
an error/redirect, telling you to visit their project download URLs like these to select a mirror:
http://sourceforge.net/projects/boost/files/boost/1.49.0/boost_1_49_0.tar.gz/download
http://downloads.sourceforge.net/project/expat/expat_win32/2.1.0/expat-win32bin-2.1.0.exe

cd %ROOTDIR%

Building individual packages

NOTE: Some packages require different commands depending on the VC++ version. To avoid run-time clashes, it is a good idea to have a separate %ROOTDIR% for every build variant.

ICU

bsdtar xvfz %PKGDIR%\icu4c-4_8_1_1-src.tgz

VC++ 2008

cd icu/source
bash ./runConfigure Cygwin/MSVC --prefix=%ROOTDIR%\icu
make install

VC++ 2010/2012

cd icu/
msbuild source\allinone\allinone.sln /t:Rebuild  /p:Configuration="Release" /p:Platform=Win32

cd %ROOTDIR%

boost

bsdtar xzf %PKGDIR%/boost_1_%BOOST_VERSION%_0.tar.gz
cd boost_1_%BOOST_VERSION%_0
#set to -vc110 if using MSVC 2012
set BOOST_PREFIX=boost-%BOOST_VERSION%-vc100
bootstrap.bat
# note for VS2012, use toolset=msvc-11.0 and VS2010 use toolset=msvc-10.0 
bjam toolset=msvc --prefix=..\\%BOOST_PREFIX% --with-thread --with-filesystem --with-date_time --with-system --with-program_options --with-regex --with-chrono --disable-filesystem2 -sHAVE_ICU=1 -sICU_PATH=%ROOTDIR%\\icu -sICU_LINK=%ROOTDIR%\\icu\\lib\\icuuc.lib release link=static install --build-type=complete

# if you need python
# note for VS2012, use toolset=msvc-11.0 and VS2010 use toolset=msvc-10.0 
bjam toolset=msvc --prefix=..\\%BOOST_PREFIX% --with-python python=2.7 release link=static --build-type=complete install

cd %ROOTDIR%

webp

unzip %PKGDIR%\libwebp-%WEBP_VERSION%-windows-x86.zip
rename libwebp-%WEBP_VERSION%-windows-x86 webp
@rem nothing more needed as we use the binaries
cd %ROOTDIR%

Jpeg

unzip %PKGDIR%\jpegsr%JPEG_VERSION%.zip
rename jpeg-%JPEG_VERSION% jpeg
cd jpeg 
copy jconfig.txt jconfig.h
nmake /f Makefile.vc nodebug=1

If you receive an error about not finding Win32.mak, you may need to do something like:
set INCLUDE=%include%;C:\Program Files\Microsoft SDKs\Windows\v7.1\Include

cd %ROOTDIR%

Freetype

bsdtar xfz "%PKGDIR%\freetype-%FREETYPE_VERSION%.tar.gz"
rename freetype-%FREETYPE_VERSION% freetype
cd freetype

VC++ 2008

vcbuild builds\win32\vc2008\freetype.vcproj "Release|Win32"

VC++ 2010/2012

msbuild builds\win32\vc2010\freetype.sln /p:Configuration=Release /p:Platform=Win32

move objs\win32\vc2010\freetype249.lib freetype.lib
cd %ROOTDIR%

zlib

VC++ 2008

bsdtar xvfz %PKGDIR%\zlib-%ZLIB_VERSION%.tar.gz
#libpng 2010/2012 project looks for a folder called zlib-1.2.5, this is here for consistency
rename zlib-%ZLIB_VERSION% zlib-1.2.5
cd %ROOTDIR%\zlib-1.2.5\contrib\masmx86
bld_ml32.bat
cd %ROOTDIR%\zlib-1.2.5\contrib\vstudio\

cd vc9
vcbuild /rebuild zlibstat.vcproj "Release|Win32"

cd %ROOTDIR%\zlib-1.2.5
move contrib\vstudio\vc9\x86\ZlibStatRelease\zlibstat.lib zlib.lib
cd  %ROOTDIR%

VC++ 2010/2012

bsdtar xvfz %PKGDIR%\zlib-%ZLIB_VERSION%.tar.gz
#libpng build scripts look for a folder called zlib-1.2.5
rename zlib-%ZLIB_VERSION% zlib-1.2.5
#zlib will be built with/by libpng below
cd  %ROOTDIR%

libpng

bsdtar xvfz %PKGDIR%\libpng-%LIBPNG_VERSION%.tar.gz
rename libpng-%LIBPNG_VERSION% libpng

VC++ 2008

cd %ROOTDIR%\libpng\projects\visualc71
vcbuild /upgrade libpng.vcproj
vcbuild libpng.vcproj "LIB Release"

cd %ROOTDIR%\libpng
move projects\visualc71\Win32_LIB_Release\libpng.lib libpng.lib
cd %ROOTDIR%

VC++ 2010/2012

cd %ROOTDIR%\libpng\projects\vstudio\
msbuild vstudio.sln /t:Rebuild  /p:Configuration="Release" /p:Platform=Win32

cd %ROOTDIR%\libpng
move projects\vstudio\Release\libpng15.lib libpng.lib
move projects\vstudio\Release\zlib.lib ..\zlib-1.2.5\zlib.lib
cd %ROOTDIR%

libpq (PostgreSQL C-interface)

bsdtar xvfz "%PKGDIR%\postgresql-%POSTGRESQL_VERSION%.tar.gz"
rename postgresql-%POSTGRESQL_VERSION% postgresql
cd postgresql\src
nmake /f win32.mak

#Note: The following errors occurred uring this process:
#.\Release\libpq.dll.manifest : general error c1010070: Failed to load and parse the manifest. The system cannot find the file specified.

NMAKE : fatal error U1077: '"C:\Program Files (x86)\Windows Kits\8.0\bin\x86\mt.EXE"' : return code '0x1f' # However libpq.lib was successfully built.

cd %ROOTDIR%

Tiff

bsdtar xvfz %PKGDIR%\tiff-%TIFF_VERSION%.tar.gz
rename tiff-%TIFF_VERSION% tiff
cd tiff
set P1=s/\^#JPEG_SUPPORT.*/JPEG_SUPPORT = 1/;
set P2=s/\^#JPEGDIR.*/JPEGDIR = %ROOTDIR:\=\\\%\\\jpeg/;
set P3=s/\^#JPEG_INCLUDE/JPEG_INCLUDE/;
set P4=s/\^#JPEG_LIB.*/JPEG_LIB = \$(JPEGDIR^)\\\libjpeg.lib/;
set P5=s/\^#ZIP_SUPPORT.*/ZIP_SUPPORT = 1/;
set P6=s/\^#ZLIBDIR.*/ZLIBDIR = %ROOTDIR:\=\\\%\\\zlib-1.2.5/;
set P7=s/\^#ZLIB_INCLUDE/ZLIB_INCLUDE/;

VC++ 2008

set P8=s/\^#ZLIB_LIB.*/ZLIB_LIB = \$(ZLIBDIR^)\\\zlib.lib/;

VC++ 2010/2012

set P8=s/\^#ZLIB_LIB.*/ZLIB_LIB = \$(ZLIBDIR^)\\\zlib.lib/;

Common

set PATTERN="%P1%%P2%%P3%%P4%%P5%%P6%%P7%%P8%"
sed %PATTERN%  nmake.opt > nmake.opt.fixed
move /Y nmake.opt.fixed nmake.opt
nmake /f Makefile.vc
cd %ROOTDIR%

Pixman

bsdtar xvfz %PKGDIR%\pixman-%PIXMAN_VERSION%.tar.gz
rename pixman-%PIXMAN_VERSION% pixman
cd pixman\pixman
make -f Makefile.win32 "CFG=release"
cd %ROOTDIR%

Cairo

@rem extract with 7zip GUI
%PKGDIR%\cairo-%CAIRO_VERSION%.tar.xz
rename cairo-%CAIRO_VERSION% cairo
cd cairo
@rem edit the build\Makefile.win32.features
@rem enable CAIRO_HAS_FT_FONT=1
@rem edit the build\Makefile.win32.common
@rem change zdll.lib to zlib.lib and zlib path to zlib-1.2.5
@rem add freetype lib path and freetype.lib to CAIRO_LIBS variable
set INCLUDE=%INCLUDE%;%ROOTDIR%\zlib-1.2.5
set INCLUDE=%INCLUDE%;%ROOTDIR%\libpng
set INCLUDE=%INCLUDE%;%ROOTDIR%\pixman\pixman
set INCLUDE=%INCLUDE%;%ROOTDIR%\cairo\boilerplate
set INCLUDE=%INCLUDE%;%ROOTDIR%\cairo
set INCLUDE=%INCLUDE%;%ROOTDIR%\cairo\src
set INCLUDE=%INCLUDE%;%ROOTDIR%\freetype\include
make -f Makefile.win32 "CFG=release"
@rem - delete bogus cairo-version.h
@rem https://github.com/mapnik/mapnik-packaging/issues/56
del src\cairo-version.h
cd %ROOTDIR%

LibXML2

bsdtar xvfz %PKGDIR%\libxml2-%LIBXML2_VERSION%.tar.gz
rename libxml2-%LIBXML2_VERSION% libxml2
cd libxml2\win32
cscript configure.js compiler=msvc prefix=%ROOTDIR%\libxml2 iconv=no icu=yes include=%ROOTDIR%\icu\include lib=%ROOTDIR%\icu\lib
patch  -p1 < %ROOTDIR%\libxml.patch
nmake /f Makefile.msvc
cd %ROOTDIR%

Proj4

Official release

bsdtar xfz %PKGDIR%\proj-%PROJ_VERSION%.tar.gz
rename proj-%PROJ_VERSION% proj
cd proj/nad
unzip -o ../../packages/proj-datumgrid-%PROJ_GRIDS_VERSION%.zip
cd ..
nmake /f Makefile.vc
cd %ROOTDIR%

Expat (for GDAL's KML,GPX, GeoRSS read support)

@rem - run the binary installer
start packages\expat-win32bin-%EXPAT_VERSION%.exe

GDAL

bsdtar xvfz %PKGDIR%\gdal-%GDAL_VERSION%.tar.gz
mkdir gdal
@rem create gdal/gdal directory to mirror if we
@rem checked out from github
rename gdal-%GDAL_VERSION% gdal/gdal
cd gdal/gdal

@rem Edit the 'nmake.opt' to point to the location the expat binary was installed to:
EXPAT_DIR="C:\Program Files (x86)\Expat 2.1.0"
@rem un-comment the other two lines as well
EXPAT_INCLUDE = -I$(EXPAT_DIR)/source/lib
EXPAT_LIB = $(EXPAT_DIR)/bin/libexpat.lib

VC++ 2008

nmake /f makefile.vc MSVC_VER=1500

VC++ 2010

nmake /f makefile.vc MSVC_VER=1600

VC++ 2012

nmake /f makefile.vc MSVC_VER=1700

cd %ROOTDIR%

sqlite

NOTE: there's no build step for sqlite, we simply unzip archive and rename dir

unzip %PKGDIR%\sqlite-amalgamation-%SQLITE_VERSION%.zip
rename sqlite-amalgamation-%SQLITE_VERSION% sqlite

If you want to build sqlite standalone you might be interested in: https://skydrive.live.com/view.aspx?resid=A737583042956228!1940&cid=a737583042956228

protobuf

*NOTE: only needed if building node-mapnik >=1.x (which needs protobuf to work with vector tiles)

Download https://protobuf.googlecode.com/files/protobuf-2.5.0.zip and unzip

rename protobuf-2.5.0 protobuf
cd protobuf\vcprojects
vcupgrade libprotobuf-lite.vcproj
vcupgrade libprotobuf.vcproj
vcupgrade protoc.vcproj
msbuild libprotobuf-lite.vcxproj /p:Configuration="Release" /p:Platform=Win32
msbuild libprotobuf.vcxproj /p:Configuration="Release" /p:Platform=Win32
# fails linking so I used binary from google code
#msbuild protoc.vcxproj /p:Configuration="Release" /p:Platform=Win32
extract_includes.bat

GEOS

NOTE: this is optional as GEOS is not used by Mapnik

bsdtar xvf %PKGDIR%\geos-%GEOS_VERSION%.tar.bz2
rename geos-%GEOS_VERSION% geos

VC++ 2010/2012

#on VS2012, take note of these issues:
#http://trac.osgeo.org/geos/ticket/616
#add  #define NOMINMAX to the beginning of geos\src\operation\buffer\BufferOp.cpp

cd geos
mkdir build
cd build
cmake -G "NMake Makefiles" ..
nmake /f Makefile geos