【C#】C#中使用GDAL3（三）：Windows下編譯插件驅動
轉載請註明原文地址：//www.cnblogs.com/litou/p/15720236.html
本文為《C#中使用GDAL3》的第三篇，總目錄地址：//www.cnblogs.com/litou/p/15004877.html
| 本文目錄 |
| 一、介紹 |
| 二、編譯FileGDB插件驅動 |
| 三、編譯Oracle插件驅動 |
| 四、編譯PostgreSQL插件驅動 |
一、介紹
GDAL的驅動分為內置驅動和插件驅動兩類。內置驅動即GDAL編譯完成後已經內置支援的類型數據（如ESRI Shapefile / DBF），插件驅動即需要引用第三方類庫編譯才能支援類型數據（如Oracle Spatial）。
通過官方網址//gdal.org/drivers/vector/index.html，可以查詢GDAL所支援的矢量數據驅動名稱、是否可以創建、依賴的類庫等資訊。
通過ogrinfo命令可以列出當前已註冊的矢量數據驅動情況（除該命令外還有gdalinfo、gdalsrsinfo、gdallocationinfo等查詢資訊命令）。打開命令提示符，執行cd C:\gdal\gdal-3.4.0\output\bin，再執行ogrinfo –formats。
列出的標識說明如下：
1）raster：支援柵格數據
2）vector：支援矢量數據
3）ro：只讀
4）rw：支援讀、寫
5）rw+：支援讀、寫和更新
6）v：支援虛擬讀寫
7）s：支援數據子集
對於插件驅動的編譯方法，只需要準備好第三方類庫，並在GDAL的編譯選項中配置好對應插件驅動的參數路徑即可。
二、編譯FileGDB插件驅動
1、驅動情況
通過官方網頁可以看到，支援ESRI File Geodatabase數據的插件有兩個，一個是內置驅動OpenFileGDB（只讀），一個是插件驅動FileGDB（支援讀寫）。兩個驅動的對比詳見//gdal.org/drivers/vector/openfilegdb.html#comparison-with-the-filegdb-driver。
下面開始編譯插件驅動FileGDB，官方網址：//gdal.org/drivers/vector/filegdb.html
2、準備插件驅動類庫文件
為方便編譯，在C:\gdal中創建文件夾plugins，用於存放編譯所需要的第三方類庫文件。
插件驅動所需要的類庫文件下載網址：//appsforms.esri.com/products/download/#File_Geodatabase_API_1.3。
下載filegdb_api_vs2013_1_4.zip並解壓，插件驅動所需要的類庫文件路徑如下：
1）編譯需要頭文件：include
2）編譯需要庫文件：lib\FileGDBAPI.lib（32位），lib64\FileGDBAPI.lib（64位）
3）運行需要動態鏈接庫：bin\FileGDBAPI.dll（32位），bin64\FileGDBAPI.dll（64位）
這裡以編譯32位驅動為例，在C:\gdal\plugins中創建文件夾filegdb14x86，將相關類庫文件複製並組織如下：
C:\gdal\plugins\filegdb14x86 +-- include +-- lib -- FileGDBAPI.lib +-- bin -- FileGDBAPI.dll
注意：編譯32位的插件驅動需要32位的類庫文件，編譯64位的插件驅動同理。
2、修改nmake.opt
用文本編輯工具，打開C:\gdal\gdal-3.4.0下的nmake.opt文件，並修改以下鍵的值：
1）718行處FGDB_ENABLED，去掉前面的#號。
2）719行處FGDB_PLUGIN，去掉前面的#號。
3）720行處FGDB_SDK，去掉前面的#號，值改為”C:/gdal/plugins/oracle11gx86″
4）721行處FGDB_INC，去掉前面的#號。
5）722行處FGDB_LIB，去掉前面的#號。
3、編譯生成結果
1）打開”VS2015 本機工具命令提示符”
a）32位：開始菜單->”Visual Studio 2015″->”Visual Studio Tools”->”Windows Desktop Command Prompts”->”VS2015 x86 本機工具命令提示符”。
b）64位：開始菜單->”Visual Studio 2015″->”Visual Studio Tools”->”Windows Desktop Command Prompts”->”VS2015 x64 本機工具命令提示符”。
2）執行cd C:\gdal\gdal-3.4.0\ogr\ogrsf_frmts\filegdb，定位到插件驅動的源碼目錄。
3）執行下面編譯命令，結果存放在C:\gdal\gdal-3.4.0\output\bin\gdalplugins，生成文件ogr_FileGDB.dll。
a）32位：先執行nmake /f makefile.vc plugin，再執行nmake /f makefile.vc plugin-install。
b）64位：先執行nmake /f makefile.vc plugin WIN64=1，再執行nmake /f makefile.vc plugin-install WIN64=1。
c）默認情況下是Release編譯模式，如需要Debug編譯模式，需加上DEBUG=1參數執行編譯。
4、調用測試
打開命令提示符，執行cd C:\gdal\gdal-3.4.0\output\bin，定位到GDAL的程式目錄，再執行ogrinfo –formats列出已註冊的驅動情況，結果提示「找不到指定的模組」，說明插件驅動載入有問題。
出現這種情況是插件驅動沒有找到依賴的動態鏈接庫導致的，一般有兩種解決方法：
1）將動態鏈接庫複製到與執行程式（如orginfo）同級的目錄。
2）將動態鏈接庫所在目錄添加到系統的路徑環境變數中。
這裡採用的是第二種方式，在命令提示符中執行set path=C:\gdal\plugins\filegdb14x86\bin;%path%，然後重新執行ogrinfo –formats，結果顯示新的插件驅動已註冊：”FileGDB -vector- (rw+): ESRI FileGDB”。
三、編譯Oracle插件驅動
1、官方網址
//gdal.org/drivers/vector/oci.html
2、準備類庫文件
插件驅動所需要的類庫文件包含在已安裝的Oracle客戶端（非InstantClient類型）或服務端中，文件路徑如下：
1）編譯需要頭文件：%ORACLE_HOME%\oci\include
2）編譯需要庫文件：%ORACLE_HOME%\oci\lib
3）運行需要動態鏈接庫：%ORACLE_HOME%\bin\oci.dll、%ORACLE_HOME%\instantclient\oraociei11.dll
這裡以32位Oracle 11g客戶端為例，在C:\gdal\plugins中創建文件夾oracle11gx86，將相關類庫文件複製並組織如下：
C:\gdal\plugins\oracle11gx86
+-- oci
|---- include
|---- lib
+-- bin -- oci.dll
|---- oraociei11.dll
3、修改nmake.opt
用文本編輯工具，打開C:\gdal\gdal-3.4.0下的nmake.opt文件，並修改以下鍵的值：
1）704行處ORACLE_HOME，去掉前面的#號，值改為”C:/gdal/plugins/oracle11gx86″。
2）706行處OCI_PLUGIN，去掉前面的#號。
4、編譯生成結果
1）打開”VS2015 本機工具命令提示符”
a）32位：開始菜單->”Visual Studio 2015″->”Visual Studio Tools”->”Windows Desktop Command Prompts”->”VS2015 x86 本機工具命令提示符”。
b）64位：開始菜單->”Visual Studio 2015″->”Visual Studio Tools”->”Windows Desktop Command Prompts”->”VS2015 x64 本機工具命令提示符”。
2）執行cd C:\gdal\gdal-3.4.0\ogr\ogrsf_frmts\oci，定位到插件驅動的源碼目錄。
3）執行下面編譯命令，結果存放在C:\gdal\gdal-3.4.0\output\bin\gdalplugins。生成文件ogr_OCI.dll。
a）32位：先執行nmake /f makefile.vc plugin，再執行nmake /f makefile.vc plugin-install。
b）64位：先執行nmake /f makefile.vc plugin WIN64=1，再執行nmake /f makefile.vc plugin-install WIN64=1。
c）默認情況下是Release編譯模式，如需要Debug編譯模式，需加上DEBUG=1參數執行編譯。
5、調用測試
打開命令提示符，執行cd C:\gdal\gdal-3.4.0\output\bin，定位到GDAL的程式目錄，先執行set path=C:\gdal\plugins\oracle11gx86\bin;%path%設置系統路徑環境變數，再執行ogrinfo –formats，結果顯示新的插件驅動已註冊：”OCI -vector- (rw+): Oracle Spatial”。
6、調用注意事項
打開數據源：Ogr.Open的路徑參數格式為OCI:userid/password@database_instance:table,table，如OCI:system/[email protected]/orcl:tb_layer1,tb_layer2。如果不指定表名列表，獲取到的圖層只限於ALL_SDO_GEOM_METADATA中記錄的表名（相當於不能遍歷所有圖層，詳見//gdal.org/drivers/vector/oci.html#oracle-spatial）。
四、編譯PostgreSQL插件驅動
1、官方網址
//gdal.org/drivers/vector/pg.html
2、準備類庫文件
插件驅動所需要的類庫文件包含在已安裝的PostgreSQL程式中，文件路徑如下：
1）編譯需要頭文件：%PGHOME%\include
2）編譯需要庫文件：%PGHOME%\lib\libpq.lib
3）運行需要動態鏈接庫：%PGHOME%\bin\libcrypto-1_1.dll、libiconv-2.dll、libintl-8.dll、libpq.dll、libssl-1_1.dll
這裡以32位PostgreSQL 9.6為例，在C:\gdal\plugins中創建文件夾postgresql96x86，將相關類庫文件複製並組織如下：
C:\gdal\plugins\postgresql96x86
+-- include
+-- lib -- libpq.lib
+-- bin -- libcrypto-1_1.dll
|---- libiconv-2.dll
|---- libintl-8.dll
|---- libpq.dll
|---- libssl-1_1.dll
3、修改nmake.opt
用文本編輯工具，打開C:\gdal\gdal-3.4.0下的nmake.opt文件，並修改以下鍵的值：
1）631行處PG_INC_DIR，去掉前面的#號，值改為”C:\gdal\plugins\postgresql96x86\include”。
2）632行處PG_LIB，去掉前面的#號，值改為”C:\gdal\plugins\postgresql96x86\lib\libpq.lib wsock32.lib”。
4、編譯生成結果
1）打開”VS2015 本機工具命令提示符”
a）32位：開始菜單->”Visual Studio 2015″->”Visual Studio Tools”->”Windows Desktop Command Prompts”->”VS2015 x86 本機工具命令提示符”。
b）64位：開始菜單->”Visual Studio 2015″->”Visual Studio Tools”->”Windows Desktop Command Prompts”->”VS2015 x64 本機工具命令提示符”。
2）執行cd C:\gdal\gdal-3.4.0\ogr\ogrsf_frmts\pg，定位到插件驅動的源碼目錄。
3）執行下面編譯命令，結果存放在C:\gdal\gdal-3.4.0\output\bin\gdalplugins。生成文件ogr_PG.dll。
a）32位：先執行nmake /f makefile.vc plugin，再執行nmake /f makefile.vc plugin-install。
b）64位：先執行nmake /f makefile.vc plugin WIN64=1，再執行nmake /f makefile.vc plugin-install WIN64=1。
c）默認情況下是Release編譯模式，如需要Debug編譯模式，需加上DEBUG=1參數執行編譯。
5、調用測試
打開命令提示符，執行cd C:\gdal\gdal-3.4.0\output\bin，定位到GDAL的程式目錄，先執行set path=C:\gdal\plugins\postgresql96x86\bin;%path%設置系統路徑環境變數，再執行ogrinfo –formats，結果顯示新的插件驅動已註冊：”PostgreSQL -vector- (rw+): PostgreSQL/PostGIS”。
6、調用注意事項
打開數據源：Ogr.Open的路徑參數格式為postgresql://user:password@ip:port/dbname，如postgresql://postgres:[email protected]:5432/postgres。
