关于QGis1.8二次开发的环境配置

这篇文章是基于已经正确编译并且生成二次开发所需的库文件的基础上的，如果你还没有得到开发的库文件，请参见我的上一篇博文，点击这里查看。

OK，要进行二次开发首先就是环境配置。这里使用的QGis版本为1.8。打开Visual Studio 2010，新建一个Qt application（如果你没有这个项目模板说明你没有正确安装Qt for vs add-in插件），这样做可以避免我们手动去添加Qt的库文件目录。出现如下界面：

注意将 XML library勾上，这个非常重要，不然后面会报错。因为QgsMapCanvas需要用到QDomNode文件，而QDomNode是一个XML文件，包含在Qt的XML library中。

点击Finish之后，生成解决方案。在工程项目上点击右键—属性，出现工程属性配置对话框，在这里我们需要配置QGis的开发库路径，分别包含4个设置步骤，分别是：

1、添加附加包含目录：

选中C/C++选项卡的“常规”选项，在附加包含目录当中加入编译QGis生成的include文件夹路径，如：

2、添加预处理命令：

选中C/C++选项卡下的“预处理器”命令，添加预处理定义，输入下图中的三行预处理命令：

3、添加附加库目录

在链接器选项卡下，打开“常规”，添加附加库目录，将QGis开发库中的lib文件夹添加进来，例如：

4、输入附加依赖项

选择链接器选项卡中的“输入”选项，添加附加依赖项，将下图所示三行个lib文件名称添加进来：

OK，大功告成，下面就是写测试代码了。

我将QGis官方文档中的一段代码贴过来，大家可以用此来测试自己的环境是否正确搭建。非常简单，把你的main.cpp文件中的代码替换为下面的代码：

1. #include<QtGui/QApplication>

2. #include<qgsapplication.h>

3. #include<qgsproviderregistry.h>

4. #include<qgssinglesymbolrenderer.h>

5. #include<qgsmaplayerregistry.h>

6. #include<qgsvectorlayer.h>

7. #include<qgsmapcanvas.h>

8. #include<QString>

9. #include<QApplication>

10. #include<QWidget>

11.  
12.  
13.  

14. int main( intargc, char *argv[] )

15. {

16. QgsApplication a( argc, argv ,true);

17. //

18. //注意这三行代码需要更改路径;

19. QString myPluginsDir ="D:/3rd_Party/qgis1.8vs2008/plugins";//插件路径(编译好的qgis文件夹下的plugins文件夹);

20. QString myLayerPath ="E:/Jacory/Work/Clip.shp";//图层路径，必须设置为你电脑里面shp文件的路径，不然打不开数据;

21. QStringmyLayerBaseName = "Clip";//图层名称;

22. //

23. QgsProviderRegistry::instance( myPluginsDir); //初始化插件的目录;

24.  

25. QgsVectorLayer * mypLayer = newQgsVectorLayer( myLayerPath, myLayerBaseName, "ogr" ); //初始化矢量图层;

26.  

27. QgsSingleSymbolRenderer *mypRenderer = newQgsSingleSymbolRenderer( mypLayer->geometryType() );

28. QList <QgsMapCanvasLayer> myLayerSet;

29. mypLayer->setRenderer( mypRenderer );

30.  
31.  

32. QgsMapLayerRegistry::instance()->addMapLayer( mypLayer, TRUE );

33.  

34. myLayerSet.append( QgsMapCanvasLayer(mypLayer, TRUE ) );

35.  

36. QgsMapCanvas * mypMapCanvas = newQgsMapCanvas( 0, 0 );

37. mypMapCanvas->setExtent(mypLayer->extent() );

38. mypMapCanvas->enableAntiAliasing( true);

39. mypMapCanvas->setCanvasColor( QColor(255, 255, 255 ) );

40. mypMapCanvas->freeze( false );

41. mypMapCanvas->setLayerSet( myLayerSet);

42. mypMapCanvas->setVisible( true );

43. mypMapCanvas->refresh();

44.  

45. return a.exec();

46. }

这里要注意的是上面标注出来的三行路径代码需要更改。

OK，非常简单，将QGis安装目录中的bin文件夹下各种dll文件拷贝过来就能够调试运行了，注意，不是QGis开发包路径，是QGis Desktop安装的路径下面的bin文件夹。当然，你不想安装QGis也可以将OSGeo4W的bin文件夹下的dll和QGis开发库目录的bin文件夹下的dll文件，以及所有用到的第三方库的dll文件都拷贝到VS工程目录的文件夹下也可以。dll文件如下图：

我没有去研究到底哪些需要，哪些不需要，我采取了最简单的办法，把这些dll全部复制过去。。。

最后，调试运行，出现下图所示界面，恭喜你，你成功了！Enjoy！

补充一点：如果你运行时出现“无法找到QDomDocument（或者QDomNode）”的错误，说明你的Qt没有包含XML library，我上面已经讲过了。这里你还是可以在VS菜单栏里面选择Qt菜单—Project Settings进行设置，如下图：

最后，有用QGis进行二次开发的朋友，我非常希望与大家交流，互相学习，请大家指教！谢谢！

2015年12月26日  更新：

上面的测试代码从2.0开始已经不能用了，鉴于很多同学反应，将新版本的测试代码贴上来，如下：

1. #include<QtGui/QApplication>

2. #include<qgsapplication.h>

3. #include<qgsproviderregistry.h>

4. #include<qgssinglesymbolrendererv2.h>

5. #include<qgsmaplayerregistry.h>

6. #include<qgsvectorlayer.h>

7. #include<qgsmapcanvas.h>

8. #include<QString>

9. #include<QApplication>

10. #include<QWidget>

11. #include <QStringList>

12.  
13.  

14. #include<QMessageBox>

15. #include<QObject>

16. #include <QList>

17. #include <QFileInfoList>

18. #include <QDir>

19. #include <QLibrary>

20. #include <QDebug>

21.  
22.  

23. int main( int argc, char *argv[] )

24. {

25. QgsApplication myApp( argc, argv, true );

26. QgsApplication::setPrefixPath( "C:/Program Files/qgis2.9.0", true );

27. QString pluginPath = QgsApplication::pluginPath();

28. QgsApplication::initQgis();

29.  

30. QgsProviderRegistry* provider = QgsProviderRegistry::instance();

31.  

32. QString myLayerPath = "D:/Data/qgis_sample_data/shapefiles/airports.shp";

33. QString myLayerBaseName = "airports"; //图层名称;

34.  

35. QList<QgsMapLayer*> myList;

36. QgsVectorLayer* mypLayer = new QgsVectorLayer( myLayerPath, myLayerBaseName, "ogr", false );

37. if ( !mypLayer )

38. {

39. return 0;

40. }

41. if ( mypLayer->isValid() )

42. {

43. QMessageBox::information( 0, "", "layer is valid" );

44. mypLayer->setProviderEncoding( "System" );

45. myList << mypLayer;

46. }

47. QgsMapLayerRegistry::instance()->addMapLayer( mypLayer );

48. QList<QgsMapCanvasLayer> myLayerSet;

49. myLayerSet.append( QgsMapCanvasLayer( mypLayer ) );

50.  

51. QgsMapCanvas* mypMapCanvas = new QgsMapCanvas( 0, 0 );

52. mypMapCanvas->setExtent( mypLayer->extent() );

53. mypMapCanvas->enableAntiAliasing( true );

54. mypMapCanvas->setCanvasColor( QColor( 255, 255, 255 ) );

55. mypMapCanvas->freeze( false );

56. mypMapCanvas->setLayerSet( myLayerSet );

57. mypMapCanvas->setVisible( true );

58. mypMapCanvas->refresh();

59.  

60. return myApp.exec();

61.  
62.  

63. }