《GDAL源码剖析与开发指南》一一1.7 SWIG编译

本节书摘来自异步社区出版社《GDAL源码剖析与开发指南》一书中的第1章，第1.7节，作者：李民录 更多章节内容可以访问云栖社区“异步社区”公众号查看。

1.7 SWIG编译

GDAL源码剖析与开发指南
1.7.1 SWIG简介
SWIG全称是Simplified Wrapper and Interface Generator，官方网站是http://www.swig.org/。SWIG是一个开发工具，能够将使用C或者C++编写的软件与其他各种高级编程语言进行嵌入联接。SWIG能应用于各种不同类型的语言，包括常用脚本编译语言例如Perl、PHP、Python、Tcl、Ruby、PHP等，也包括非脚本编译语言，如C#、Common Lisp (CLISP、Allegro CL、CFFI、UFFI)、Java、Modula-3、OCAML、R等。SWIG最典型的应用就是转换C/C++接口，产生高级语言需要的代码来调用C/C++代码。SWIG是一个免费开源软件，可以在商业或非商业中自由使用、分发、修改。

下载安装Swig的时候我们注意要下载Swigwin文件而不是下载源代码。以swigwin-2.0.4为例，我们下载swigwin-2.0.4.zip文件后解压，将解压目录也添加到环境变量Path中去，否则后面需要设置swig的所在目录。检验swig是否成功设置到环境变量Path中的最简单的办法就是在运行中输入swig后回车，如果提示windows找不到swig，那么说明没有设置成功；如果出现一个黑屏一闪而过，那么说明已经设置成功了。

下面三小节需要在安装完SWIG之后才能进行编译。需要注意的是，编译下面三种语言的GDAL之前，我们首先要编译C++版本的，就是1.6节的内容。
**
1.7.2 编译C#版本GDAL**
首先，我们打开nmake.opt文件，找到SWIG = swig.exe这一句，假如没有将swig的目录添加到环境变量中，那么将这句后面的swig.exe修改为swig.exe的全路径，如F:Work3rdPartswigwin-2.0.4swig.exe；如果设置了环境变量，那么就不需要进行修改了。

然后，我们按照1.6节中的使用cmd命令编译GDAL的方式来进行编译，打开“Visual Studio 2008命令提示”并定位到GDAL源代码目录，然后依次执行如下三行命令，其实就是编译C++版本的GDAL。

nmake /f makefile.vc
nmake /f makefile.vc install
nmake /f makefile.vc devinstall

执行以上三句之后，接下来我们使用cd命令，进入swigcsharp文件夹中并使用nmake工具编译，命令如下所示。

cd swig\csharp
nmake /f makefile.vc
nmake /f makefile.vc install

执行完以上两句命令后，系统会在csharp文件夹下生成8个dll文件，并将这8个dll文件复制到GDAL输出目录下的csharp文件夹中。

这8个dll分别如下。

gdal\_csharp.dll
gdal\_wrap.dll
gdalconst\_csharp.dll
gdalconst\_warp.dll
ogr\_csharp.dll
ogr\_wrap.dll
osr\_csharp.dll
osr\_wrap.dll

在C#工程中引用GDAL的时候，我们只需要把上面8个dll中后面以_csharp.dll结尾的四个dll加入到C#工程中即可。需要注意的是，在使用这几个dll的时候我们需要将gdal110.dll以及它依赖的其他dll都复制到同一个目录中，才能使C#程序正常运行。

1.7.3 编译Python版本GDAL
在编译Python版本之前，我们要确保自己的电脑中已经安装了Python。如果我们安装了ArcGIS软件，那么就不用再安装Python了，因为在安装ArcGIS的时候必须要安装Python。将Python的bin目录添加到环境变量Path中去，然后我们就可以开始编译Python版本的GDAL了。

打开nmake.opt文件（1.10版本大概76行左右），将PYDIR后面的路径修改为本机Python的路径。

PYDIR   ="C:\Python26"

修改完之后，保存nmake.opt文件。接下来使用cd命令将命令行定位到swigpython目录后，依次输入如下命令。

python setup.py build
python setup.py install

执行完上述命令后，我们会在python的site-packages目录看到多了GDAL和OGR的文件以及一个osgeo的文件夹。我们将编译出来的gdal110.dll以及它依赖的所有DLL都复制到site-packages文件夹中的osgeo文件夹中，最后就可以在Python中用imort gdal来使用GDAL了。测试Python版本的gdal是否安装成功，可以使用如下Python代码。

from osgeo import gdal
from osgeo.gdalconst import *
dataset = gdal.Open("F:\Work\Data\envi.img",GA\_ReadOnly)
dataset.GetDriver().ShortName
#'ENVI' #图像格式
dataset.GetProjectionRef()
#'PROJCS["unnamed",GEOGCS["NAD83",DATUM["North\_American\_Datum\_1983",SPHEROID["GRS 1980",6378137,298.257222101,AUTHORITY["EPSG","7019"]],TOWGS84[0,0,0,0,0,0,0], AUTHORITY["EPSG","6269"]],PRIMEM["Greenwich",0,AUTHORITY["EPSG","8901"]],UNIT["degree",0.0174532925199433,AUTHORITY["EPSG","9108"]],AUTHORITY["EPSG","4269"]],PROJECTION["Transverse\_Mercator"],PARAMETER["latitude\_of\_origin",30],PARAMETER["central\_meridian",-84.16666666666667],PARAMETER["scale\_factor",0.9999],PARAMETER["false\_easting",2296587.926509186],PARAMETER["false\_northing",0],UNIT["Foot (International)",0.3048]]' #图像投影信息

1.7.4 编译Java版本GDAL
在编译Java版本的GDAL时，除SWIG之外，我们还需要JRE和Ant这两个工具，没有的话需要先下载安装，其中ANT只需直接解压，不用安装。接下来我们用记事本打开nmake.opt，找到第86行左右位置（1.10版本），将文件中的JAVA_HOME和ANT_HOME修改为本机的路径，只要修改到主文件夹即可（就是bin文件夹所在的文件夹）；如果文件夹路径有空格的话，把路径用双引号引起来，修改后的内容与以下代码类似。

# SWIG Java settings
!IFNDEF JAVA\_HOME
JAVA\_HOME = "C:\Program Files\Java\jdk1.6.0\_26"
!ENDIF
!IFNDEF ANT\_HOME
ANT\_HOME = F:\Work\GDAL\gdal\_need\apache-ant-1.8.4
!ENDIF
JAVADOC = $(JAVA\_HOME)\bin\javadoc
JAVAC = $(JAVA\_HOME)\bin\javac
JAVA = $(JAVA\_HOME)\bin\java
JAR = $(JAVA\_HOME)\bin\jar
JAVA\_INCLUDE = -I$(JAVA\_HOME)\include -I$(JAVA\_HOME)\include\win32

修改保存之后，我们就可以编译Java版本的GDAL了，首先还是要先编译C++版本的GDAL，然后使用cd命令切换到swig文件夹中，开始编译Java版本GDAL。

nmake /f makefile.vc
nmake /f makefile.vc install
nmake /f makefile.vc devinstall
cd swig
nmake /f makefile.vc java

正常情况下，执行完上面的命令后Java版本的GDAL应该就编译完成了。编译出来的文件存放在swigjava目录中，主要有以下五个文件。

gdalconstjni.dll
gdaljni.dll
ogrjni.dll
osrjni.dll
gdal.jar

如果目录中有上面的五个文件，那就说明编译成功，如果没有，则要根据命令行编译的输出信息排除错误重新生成。我们将上面五个文件以及编译GDAL时生成的gdal110.dll复制到一个新建的文件夹，用于Java程序调用。