一．             SWIG簡(jiǎn)介：

SWIG 是Simple Wrapper and Interface Generator的縮寫，是一個(gè)幫助使用C或者C++編寫的軟件創(chuàng)建其他編語(yǔ)言的API的工具。例如，我想要為一個(gè)C++編寫的程序創(chuàng)建.NET API，一般情況下我必須使用托管C++(Managed C++)去編寫大量的代碼才能生成它的.NET API。有了SWIG，這個(gè)機(jī)械的工作將變得非常簡(jiǎn)單。你只須要使用一個(gè)接口文件告訴SWIG要為那些類創(chuàng)建.NET API，SWIG就會(huì)自動(dòng)幫你生成它的.NET API。

當(dāng) 然，SWIG不僅僅支持創(chuàng)建.NET API。最新版本的SWIG支持常用腳本語(yǔ)言Perl、PHP、Python、Tcl、Ruby和非腳本語(yǔ)言C#, Common Lisp (CLISP, Allegro CL, CFFI, UFFI), Java, Modula-3, OCAML以及R，甚至是編譯器或者匯編的計(jì)劃應(yīng)用（Guile, MzScheme, Chicken）。

二．             環(huán)境搭建

1.       下載swigwin，在E:/lib目錄下解壓，即把swig安裝到E:/lib/swig目錄中。

2.       新建一個(gè)Win32 Console Application，注意在Application Settings中選擇DLL以及空項(xiàng)目。完成后將工程的配置改成release

3.       工具 —> 選項(xiàng) —> 項(xiàng)目和解決方案 —> VC++目錄 —> 添加E:/lib/swigwin。即把swig添加到VC的可執(zhí)行目錄。

 ----------------若封裝成Python可用的API，執(zhí)行如下步驟----------------------------

4.       下載python2.5，安裝到D:/Program Files目錄，并在環(huán)境變量PATH中加入D:/Program Files/python2.5。

5.       把D:/Program Files/python2.5/include加入VC的Include路徑，將D:/Program Files/python2.5/libs加入VC的Library路徑。

-----------------若封裝成Java可用的API，執(zhí)行如下步驟--------------------------------

6.       下載JDK，安裝到D:/Program Files目錄，并在環(huán)境變量PATH中加入D:/Program Files/Java/jdk1.6.0_10/bin（如果之前安裝過(guò)Oracle，要將D:/Program Files/Java/jdk1.6.0_10/bin放在Oracle/jre/1.3.1/bin前面，否則在編譯的時(shí)候默認(rèn)會(huì)選擇oracle的 jdk）

7.       把D:/Program Files/Java/jdk1.6.0_10/include/win32 和 D:/Program Files/Java/jdk1.6.0_10/include 加入到加入VC的Include路徑。

三．             接口文件

要在C/C++工程中創(chuàng)建***.i 的接口文件，告訴SWIG要為那些類的那些方法創(chuàng)建API。

接口文件注解：

1.  模塊名由指定的%module來(lái)給出(或者用-module命令行選項(xiàng)).這段指示性文字必須寫在文件的頭部并且在使用時(shí)將這個(gè)模塊名作為擴(kuò)展模塊對(duì)象來(lái) 使用(此外，這個(gè)模塊名經(jīng)常在目標(biāo)語(yǔ)言中被定義成一個(gè)命名空間來(lái)使用)。如果模塊名在命令行已經(jīng)被給出了，系統(tǒng)將不考慮由%module標(biāo)示的模塊名了。

對(duì)于python：module的名字指定了生成文件xxx.py的xxx名字，

對(duì)于java：module的名字指定了生成文件xxx.java的xxx名字

2.  所有在%{...%}塊內(nèi)的東西將被簡(jiǎn)單作為結(jié)果逐字拷貝到SWIG創(chuàng)建的wrapper(包裝)文件中。這部分大部分被用來(lái)包括頭文件和生成 wrapper代碼需要的其它聲明。這里很重要的強(qiáng)調(diào)一點(diǎn)因?yàn)槟阍谝粋€(gè)SWIG的輸入文件中包含了一個(gè)聲明，這個(gè)聲明并不自動(dòng)顯示在生成的wrapper 代碼中，因此你需要確信你確實(shí)把正確的頭文件在%{ ... %}部分中。這里應(yīng)該指出SWIG不解析和解釋附在%{ ... %}部分的文字。SWIG的%{...%}內(nèi)的語(yǔ)法和語(yǔ)義很類似于輸入文件中的聲明部分 。  

3.  如果打算為類中所有方法創(chuàng)建API，那么有一個(gè)非常簡(jiǎn)單的辦法，在接口文件的類聲明部分使用%include標(biāo)記。SWIG將對(duì)%include所指定的文件進(jìn)行語(yǔ)法分析，類中所有公有方法(Public Method)都將在API中暴露。

    /* SwigTest.i */

    %module SwigTest

    %{

    #include "SwigTest.h"

    %}

%include “SwigTest.h”   //不要和#用混

-------------------------- swig庫(kù)模塊訪問(wèn)部分標(biāo)準(zhǔn)C++庫(kù)包括STL的方法-------------------

SWIG對(duì)于一些語(yǔ)言模塊的支持使較全面的但是對(duì)很少用到的庫(kù)則支持的很少。
下面就是表示了C++類和支持的C++庫(kù) 以及SWIG接口文件的對(duì)應(yīng)表
C++ class                C++ Library file              SWIG Interface library file
std::deque                     deque                                  std_deque.i
std::list                           list                                       std_list.i
std::map                        map                                     std_map.i
std::pair                        utility                                    std_pair.i
std::set                          set                                       std_set.i
std::string                      string                                   std_string.i
std::vector                     vector                                 std_vector.i

因此，當(dāng)C / C++代碼中用到這些庫(kù)時(shí)，可將swig對(duì)應(yīng)的接口文件添加到自己的接口文

件中。如：%include "std_string.i"，

庫(kù)文件完全識(shí)別C++的命名空間。如果你輸出std::string 或 將它重命名為另一種類型。請(qǐng)確認(rèn)你將此重命名聲明包含到了你的接口文件中。例如:
%module example
%include "std_string.i"

using namespace std;
typedef std::string String;
...
void foo(string s, const String &t);     // std_string typemaps still applied

當(dāng) 封裝java調(diào)用的api且傳遞的參數(shù)中含有中文時(shí)，由于c++中的String是使用單字節(jié)編碼，而java中String是使用Unicode編碼， 所以為了傳遞時(shí)不出現(xiàn)亂碼，可以包含%include "std_wstring.i"，因?yàn)閣string使用的是wchar_t類型，這是寬字符，用于滿足非ASCII字符的要求，例如Unicode編 碼。

當(dāng)封裝python調(diào)用的api且傳遞的參數(shù)中含有中文時(shí)，就不用考慮這個(gè)編碼問(wèn)題，可以直接使用c++中的String。

四．             編譯模塊

1．寫接口執(zhí)行命令

有 了接口文件以后要對(duì)接口文件進(jìn)行編譯，右鍵點(diǎn)擊接口文件，修改它的屬性，使用自定義編譯工具（Custom Build Tool），命令行（Command Line）內(nèi)容為swig.exe -c++ -python SwigTest.i ，輸出（Outputs）為$(InputName)_wrapper.cpp；

echo JAVA_INCLUDE: %JAVA_INCLUDE% 

echo JAVA_BIN: %JAVA_BIN%

echo on

swig.exe -c++ -python SwigTest.i

命令行參數(shù)說(shuō)明：

① 為了編譯java 或python模塊，必須包含它們的include和bin目錄，可以在PATH中設(shè)置JAVA_INCLUDE、JAVA_BIN、 PYTHON_INCLUDE、PYTHON_BIN等，其中include可以在工程屬性中設(shè)置，如果工程屬性中已經(jīng)設(shè)置好，此處不用再包含頭兩句。

②“ swig.exe ”表示調(diào)用你安裝的swig的可執(zhí)行文件，之前已經(jīng)將其目錄加入到VC的可執(zhí)行目錄中，所以此處就可以不用再寫路徑，否則要找到swig路徑才行。

③ “-c++” 表示要封裝C++代碼（不寫默認(rèn)是封裝C代碼），

④“-python”表示要封裝成Python接口（Swig還可以封裝成Java、Ruby等接口），

⑤ “$(InputName)_wrapper.cpp”表示指定要生成的C++代碼文件的名字。

swig的命令還有其他的一些，目前用到的如 –package命令，用法可以為：

swig -java -package com.swig -outdir com/swig example.i

在生成java的api時(shí)，這個(gè)命令使生成的java文件包含在某個(gè)包中。

2．編譯（右鍵點(diǎn)擊接口文件—>編譯）

對(duì)于生成python可用的API：執(zhí)行上述命令會(huì)生成兩個(gè)新的文件，一個(gè)是SwigTest.py，一個(gè)是SwigTest_wrapper.cpp。

對(duì)于生成java可用的API：執(zhí)行上述命令會(huì)生成Java類文件：SwigTestJNI.java，SwigTest.java

和c文件SwigTest_wrapper.cpp。

3．將xxx_wrapper.cpp加入到工程

4．修改工程屬性：

 -----------------------封裝java可用的api---------------------

LinkeràGeneralàOutput File改成SwigTest.dll

Build EventsàPost-Build EventàCommand Line改成：

echo on

"%JAVA_BIN%/javac" *.java

這個(gè)命令作用是編譯完后調(diào)用javac將當(dāng)前編譯路徑下的所有.java文件編譯成.class二進(jìn)制文件。

-----------------------封裝python可用的api---------------------

LinkeràGeneralàOutput File改成_SwigTest.pyd（注意一定要有下劃線）

還有一些配置在VC2005里是默認(rèn)的，但在VC2003里不是的，請(qǐng)引起注意，包括

① C/C++àCode GenerationàRuntime Library要選擇Multi-threaded DLL (/MD)

② C/C++àLanguageàTreat wchar_t as Built-in Type要選擇yes（如果轉(zhuǎn)換不涉及wchar等，則無(wú)需處理這一項(xiàng)）

③ C/C++àLanguageàEnable Run-Time Type Info要選擇yes

5．生成工程

五．利用生成的api就可以在對(duì)應(yīng)的腳本語(yǔ)言（java、python等）中使用啦。

windows環(huán)境2.0.7版：http://prdownloads./swig/swigwin-2.0.7.zip

（###）