qgis c++二次开发初始化介绍

前言

上篇文章qgis二次开发环境搭建(qgis-3.28.6+qt5.15)
的末尾介绍了如何新建一个Qt工程，链接QGIS库并调用Qgis::releaseName()，工程代码在仓库qgis_cpp_api_apps中。

但是要调用更复杂的QGIS函数需要添加一些初始化函数，下边将介绍如何初始化。

初始化函数

插件初始化

//Alters prefix path - used by 3rd party apps.
QgsApplication::setPrefixPath( strAppDir, false );
QString strPluginDir = strAppDir + QString("/plugins/");
QgsApplication::setPluginPath(strPluginDir);
QString strPkgDir = strAppDir + QString("/share/qgis");
QgsApplication::setPkgDataPath(strPkgDir);
//loads providers
QgsApplication::initQgis();
1
2
3
4
5
6
7
8

• QgsApplication::setPluginPath用于设置插件目录，如果不设置插件目录，则只能只用QGis的内置插件，下图是未设置目录的输出

src/core/providers/qgsproviderregistry.cpp:249 : (init) [31447ms] No dynamic QGIS data provider plugins found in:
/home/t/gis/qgis_cpp_api_apps/lib/qgis/plugins
src/core/providers/qgsproviderregistry.cpp:337 : (init) [0ms] Loaded 7 providers (copc;ept;gdal;memory;mesh_memory;ogr;vectortile) 
src/core/qgsmessagelog.cpp:29 : (logMessage) [10804ms] 2023-10-15T08:56:07 No Authentication Methods[1] No QGIS auth method plugins found in:
/home/t/gis/qgis_cpp_api_apps/lib/qgis/plugins
No authentication methods can be used. Check your QGIS installation
src/core/auth/qgsauthmanager.cpp:487 : (isDisabled) [0ms] Authentication system DISABLED: QCA's qca-ossl (OpenSSL) plugin is missing
1
2
3
4
5
6
7

• 从上边的输出可以看到只加载了7个providers，第三方的data provider不能正常工作
• 下面是正常加载插件的输出

src/core/providers/qgsproviderregistry.cpp:337 : (init) [16677ms] Loaded 23 providers (OAPIF;WFS;arcgisfeatureserver;arcgismapserver;copc;delimitedtext;ept;gdal;geonode;gpx;mdal;memory;mesh_memory;mssql;ogr;postgres;postgresraster;spatialite;vectortile;virtual;virtualraster;wcs;wms) 
1

• plugins目录下是一些第三方动态库，如下图
  

算法初始化

 QgsApplication::processingRegistry()->addProvider( new QgsNativeAlgorithms( QgsApplication::processingRegistry() ) );
1

• 在调用本地算法如生成缓冲区之前，需要调用上述函数，否则会失败。如下图
  
  
• 如果代码中没有用到空间分析即算法相关功能，可以不调用该函数

坐标映射

PROJ是一个通用的坐标转换软件，它将地理空间坐标从一个坐标参考系（CRS）转换到另一个坐标参考系。

    //proj的配置目录，坐标映射相关 proj.db
    QString strProjDir = strAppDir + QString("/share/proj/");
    qputenv("PROJ_LIB",strProjDir.toStdString().c_str());
1
2
3

• 这段代码用于坐标映射
• 在QGis的User Manual有描述Proj坐标映射的段落，如下图
  
• 不过proj设置的不对或者proj.db不存在报错如下

proj_get_authorities_from_database: Cannot find proj.db
ERROR 1: PROJ: proj_identify: Cannot find proj.db
src/core/proj/qgscoordinatereferencesystem.cpp:1099 : (getRecord) [19385ms] failed : /home/t/gis/qgis_cpp_api_apps/bin/share/qgis/resources/srs.db does not exist!
proj_create_from_wkt: Cannot find proj.db
proj_identify: Cannot find proj.db
proj_as_wkt: Cannot find proj.db
ERROR 1: PROJ: proj_identify: Cannot find proj.db
proj_crs_create_bound_crs_to_WGS84: Cannot find proj.db
proj_as_proj_string: Cannot find proj.db
1
2
3
4
5
6
7
8
9

• share/proj的目录内容如下
  

总结

目前在qgis_cpp_api_apps代码只用到了以上几个初始化，随着项目的深入可能会遇到新的需要初始化的情况！