本节书摘来自异步社区出版社《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程序调用。