利用CMake工具从源码编译出osgEarth库

目录

1.前言

2.源码下载及相关文档链接

3.环境说明

4.第三方库编译

5.编译及编译错误处理

5.1 编译

 5.2.编译错误处理

6.运行

---

1.前言

       osgEarth是基于三维引擎osg开发的三维数字地球引擎库，在OpenSceneGraph（为了便于后文表述，简称为osg）基础上实现了瓦片调度插件，可选四叉树调度插件，更多的地理数据加载插件（包括GDAL，ogr，WMS，TMS，VPB，filesystem等），再结合一套地理投影转换插件，这样就能够实现高效处理加载调度地理数据在三维地球上的显示，实现三维虚拟地球。

         本文讲解如何利用cmake等工具从osgEarth源码编译出osgEarth库。

2.源码下载及相关文档链接

•  osgEarth源码可以从osgEarth源码下载。

• 从Download | Download | CMake下载 CMake图形化工具，截至2023年4月5日，最新版本为3.26.3。直接双击安装即可。

•  官网学习文档为：Welcome to osgEarth! — osgEarth 3.3 documentation

3.环境说明

      本人环境说明如下：

• Windows 11 家庭中文版 22H2 22621.1413
• Microsoft Visual Studio Community 2022 (64 位) - Current
  版本 17.5.1
• CMake 3.23.0-rc2
• OpenSceneGraph-3.6.2
• osgearth-3.2

特别说明：osgearth和osg版本代差不能太大，否则编译osgearth时会报很多osg的头文件找不到的错误。现实中，我用osgearth3.2版本，而osg用3.4.1版本，则报很多类似如下的错误：

无法打开包括文件: “osg/BindImageTexture”: No such file or directory
error C2039: "VertexArrayState": 不是 "osg" 的成员

这是因为osgearth3.2版本用到很多osg新加入的功能，而这些功能在版本较低的osg中没有导致。

入坑说明：在编译osg、后面的第三方库、osgEarth、osgEarth例子、osgEarth插件、自己的osgEarth工程时，必须在所有项目上选择“属性->配置属性->C++->代码生成”属性页中的“运行库”下拉框中选择“多线程调试 DLL (/MDd)”，否则在调用osgEarth(d).dll库时会崩溃，即所有模块的多线程调试模式保持一致。

4.第三方库编译

• 从GitHub - protocolbuffers/protobuf: Protocol Buffers - Google's data interchange format下载prototbuffers库，并用CMake生成VS工程进行编译。注意版本不要选得太老，也不要选的太新，我选的是prototbuffers 3.13.0。
• 从OpenGL SDK: GLEW - The OpenGL Extension Wrangler Library下载glew库。
• 从GitHub - libgeos/geos: Geometry Engine, Open Source下载geos库。并用CMake生成VS工程进行编译。
• 从Download — GDAL documentation下载gdal库。并用CMake生成VS工程进行编译。
• 从https://github.com/curl/curl下载curl库，并用CMake生成VS工程进行编译。
• 从zlib Home Site下载zlib库，并编译出lib和dll。

关于如何用CMake生成VS工程，参见 后文描述，和后文利用CMake编译osgEarth类似。

5.编译及编译错误处理

5.1 编译

1）：因为osgearth是在osg库基础上开发的，需要配置osg库才行，所以需先从osg源码编译出osg库，具体编译方法参见《windows平台下用CMake编译osg》博文。

2）：打开CMake界面，在CMake图形界面中的“Where is the source code:”的编辑框中输入osgearth-3.2源码目录，注意：该目录必须是CMakeList.stxt所在目录，且目录路径不能有中文，否则CMake会报错。 

3）：在“Where to build the binaries”中输入osgearth-3.2编译、链接后生成文件的存放目录。为避免编译产生的文件和源码混放在一起，一般在源码目录的同级目录新建一个类似build目录来存放编译输出结果文件。CMake界面如下：

​

 图1

 4）：点击cmake图形界面中的“configure”按钮或“Tools->Configure”菜单，如果是初次执行，则弹出如下界面：

​

  根据本机装的VS选择VS版本，我本机装的是VS2022。注意：后面一项得选x64,相信现在用win32的已经很少了。单击Finish按钮，关闭该对话框回到cmake主界面，单击左下角的“Genrerate”，出现如下错误：

​

 这是因为osg相关库及某些第三方库没有配置，如下：

​

解决方法如下： 

• 找到步骤1)编译出来的osg库和头文件，并将上图蓝色框中所有和osg有关的NOTFOUND的信息都配置好。
• 将上图中cur、gdal、GEOS、GLEW、zlib、protobug库有关的NOTFOUND的信息都配置好。
• 从SQLite Download Page下载sqlite3库和头文件，并配置好。

说明：

• 暂时只需cur、gdal、GEOS（这个不配置貌似也可以）、GLEW、zlib、protobuf、sqlite3这几个必须库。
• 其它第三方库不用配置、不用管，要下载全部第三方库挺不容易的，一旦在cmake中配置了其它非必须库，则又会带出很多其它库，且因为其它非必须库在网上很难找全，从而又会导致如下错误：

 Error in configuration process, project files may be invalid

• 不要勾选CMake中的OSGEARTH_BUILD_LEGACY_SPLAT_NODEKIT、OSGEARTH_BUILD_PROCEDURAL_NODEKIT、OSGEARTH_BUILD_ROCKSDB_CACHE、OSGEARTH_BUILD_SILVERLINING_NODEKIT，否则需要下载LEGACY、PROCED、ROCKSDB、SILVERLINING库，这几个库很难在网上找到，暂时不知道这几个库起什么作用。
• 我的cmake配置如下：

所有配置好后，单击“configure”,之后单击“Generate”，然后单击“Open Project”启动VS开始编译整个解决方案（注意：是整个解决方案，包括Plugins，因为开发时需要Plugins中的模块）。

 5.2.编译错误处理

1）无法打开包括文件: “sqlite3.h”: No such file or directory

     这是在CMake中没有配置sqlite3引起的，请按前文描述配置好该库。

2）无法打开包括文件: “vector_tile.pb.h”: No such file or directory

     这是在CMake中没有配置protobuf引起的，请按前文描述配置好该库。

3)   error LNK2038: 检测到“RuntimeLibrary”的不匹配项: 值     “MDd_DynamicDebug”不匹配值“MTd_StaticDebug”

解决方法：找到报错的工程，然后在该工程单击右键，选择“属性->配置属性->C++->代码生成”属性页中的“运行库”下拉框中选择“多线程 (/MDd)”，如果还不行改为其它的试试，如：MT、Md等 。最好是让所有的工程这个配置都保持一致。

6.运行

再说一遍：请确保所有模块的多线程调试模式保持一致（参见前文描述）。将如下路径中的

E:\osgEarth\build3.2\lib\Debug

编译出来的所有dll及caresd.dll、gdal201.dll、glew32.dll、libcurld.dll、libeay32.dll、zlibd.dll、ssleay32.dll、sqlite3.dll第三方库、所有osg编译出的dll拷贝到：

E:\osgEarth\build3.2\bin\Debug

路径请根据你自己在CMake图形界面中配置的实际路径更改。将解决方案下的Example osgearth_annotation工程设置为启动项，并设置输出目录为上述目录（默认输出目录就是该目录），鼠标右键单击该工程，选择“属性->配置属性->调试->命令参数”编辑框输入：

E:\osgEarth\osgearth-3.2\tests\simple.earth

earth文件路径请根据实际路径更改。用VS启动该工程，结果如下：