什么是SWIG?
SWIG,即简化封装和接口生成器(Simplified Wrapper and Interface Generator),按照其创建者的说法,是“一种把用C、C++以及Objective-C所写的程序连接到各种高级编程语言的软件开发工具”。UNIX、Windows以及Macintosh系统都支持SWIG。
对Java程序员来说,SWIG是把C/C++代码嵌入到Java脚本的理想工具。SWIG理解C/C++申明,因此它可以解析C/C++头文件并产生Java模型并对其进行编码,编译之后,你就可以在Java中使用。
SWIG实际上一个“接口文件”作为输入,但它是用带有若干(可选)指示的标准C/C++头定义所组成的。实际上,如果代码相当干净,你就可以使用头文件本身。所产生的代码是完整的(也就是说,没有残留什么东西让你必须填写),而且代码由Java模型和C实现文件组成的,它只需要编译即可。
SWIG支持的语言
SWIG支持的语言非常的广泛,几乎支持目前所有流行的语言,目前支持C/C++转换的语言有Java/C#/PHP/Python/Perl/Perl5/Ruby/Ocaml/Tcl/Chicken。对各种语言的具体使用方法可以参考使用手册。
下面以Java为例描述使用SWIG将C++程序集成的过程。(具体的过程SWIG手册中都有详细的描述)。
下载安装SWIG
从官方网站或者开源项目中下载最新的SWIG程序,解压到本地目录。
安装JDK和添加JNI包
从sun的官方网站下载最新的Java JDK和JNI开发包。
使用VS6.0进行SWIG配置
l 打开一个新的工程并且通过向导建立一个DLL工程。
l 向工程中增加一个SWIG的接口文件(一般以.i结尾,例如example.i),以及SWIG将生成的封装文件(ie.example_wrap.c)。注意如果是使用C++为封装的文件example_wrap.cxx选择不同的后缀,不用担心封装文件没有存在-vs会自动更新。
l 选择SWIG接口文件(example.i),按右健,在弹出的菜单中选择”settings”选项。
l 在Description中输入”SWIG”。
l 在Commands文本框中输入:
echo In order to function correctly, please ensure the following environment variables are correctly set:
echo JAVA_INCLUDE: %JAVA_INCLUDE%
echo JAVA_BIN: %JAVA_BIN%
echo SWIG: %SWIG%
echo on
%SWIG%\swig.exe -c++ -java $(InputPath)”。
其中%SWIG%是在环境变量中定义的swig.exe的文件目录。
l 在Outputs文本框中输入:
$(InputName)_wrap.cxx,表示根据SWIG接口文件(example.i)生成相应的C++封装文件,这里生成的封装文件名为:example_wrap.cxx。
l 接着选中整个工程然后选中C/C++属性页,选择”Category”的Preprocessor项。在”Addition include directories”中输入包含Java和Jni头文件的目录,JAVA_INCLUDE,JAVA_INCLUDE\win32。
l 而后选择Link属性页,选择”Category”的”General”项。在out put file name中设置输出DLL文件的名称。
l 最后在选择Post-build step属性页,在Post-build command(s)中添加通过javac编译java文件的命令: %JAVA_BIN%\javac *.java。
l 至此整个设置过程已经完成,需要说明的是,生成的JNI函数接口定义是由SWIG接口文件(example.i)和方法名称一起定义的,在接口文件中由模块名称:%module example,和C++的方法名称共同组成。比如在C++中有方法Start(),那么此时在Jni中是这样描述的Java_exampleJNI_Start(),如果接口文件定义该成%module example_test那么在JNI中的函数接口定义也变为Java_example_testJNI_Start()。同时JNI函数接口的定义也要求调用的Java程序的包结构与之对应。
l 编译运行。
SWIG资源
官方网站: http://www.swig.org