银河麒麟及arm64环境下，离线编译osg3.4.0和osgEarth2.9库文件

编译

一、第三方库

编译前：

1. osg和osgEarth的关系是，osg是一个专门为了三维图像而生的函数库，而osgEarth则是在osg的基础上，更加集中于构建三维下的地球的一个函数库。
2. osg和osgEarth的版本选择很重要！两者的版本号是有相关性的，所以一定要注意你所下载的osg和osgEarth的版本，是否适配。所谓的适配，意思是，在osgEarth中会调用到一系列的osg的函数，但是这些函数，在最新的osg版本中，可能已经被取消了，或者更名了，都有可能。最新的osg是3.6.5版本，但是并不适用于所有的osgEarth的版本，osgEarth我能找到的最新版本是3.1，试了一下，osgEarth3.1和osg3.6.4版本，是无法成功编译的，当然，不能说是不适配，因为在我试的过程中，可能存在别的问题。但我可以肯定的是，osg3.4.0和osgEarth2.8以及osgEarth2.9版本是适配。
3. 注意在切换osg版本时，一定要将原版本卸载干净。我在这儿就吃了亏，一开始选用osg3.6.4版本，后来更换为osg3.4.0版本，当时没清理干净，导致在编译osgEarth时，不断报错，提示xxx:未定义的引用，当时很奇怪，这函数明明是源代码自带的代码中的函数，为什么一直报未定义的引用，这个报错，意思是在在头文件声明了，但是cpp中，或者说编译后的库文件中，未定义。后来我查到，库文件的链接，即LINK不对，指向了osg3.6.4版本，就是没删除干净。要删除干净，就需要搞清楚源代码编译究竟生成了什么，放在了哪里。源代码编译的时候，根据个人习惯，一是可以将依赖的库文件编译后放在一个自定义的位置，比如通过再configure后追加参数，./configure --prefix=/home/iscas/，另一种是放在默认位置，即/usr/local下，这个看个人习惯，各有各的好处，放在自定义的位置，方便卸载，放在默认位置，不用考虑环境变量的问题。源代码编译后的结果无非三种文件，一种是头文件，即函数的声明，默认放在/usr/local/include下，一种的可执行文件，默认放在/usr/local/bin下，一种是库文件，即函数的定义，默认放在/usr/local/lib或者/usr/local/lib64下。因此，知道了有什么东西，放在哪，卸载的时候，即手动去删除，务必删除干净。
4. 在编译osg代码时，需要指定使用QT5版本，因为现在大部分linux系统下，自带QT4和QT5，所以需要指定位置。在CMakeList.txt文件的IF(OSG_USE_QT AND NOT ANDROID)的前一行，添加SET(DESIRED_QT_VERSION 5)。
5. 在编译osgEarth时，在2.8版本中，如果不指定使用X11版本，会报错，因此，需要修改CMakeList.txt文件，在首行添加，add_definitions(-std=gnu++11)或者add_definitions(-std=c++11)。

6. 在osgEarth编译时，为生成可供Qt使用的库文件，修改CMakeList.txt中如下两处，由OFF改为ON。

   OPTION(OSGEARTH_QT_BUILD "Enable to use Qt (build Qt-dependent libraries, plugins and examples)" ON)
   OPTION(OSGEARTH_QT_BUILD_LEGACY_WIDGETS "Build the legacy Qt widgets" ON)

7. 将bin和lib文件夹写入环境变量。编译osg和osgEarth成功之后，在编译的目录下会出现lib和bin两个文件夹（inlcude的文件，已经默认放在了/usr/local/include下），将这两个单独放置一个妥善位置，建议同osg的DATA文件放一起，方便管理，而后将lib和bin的目录所在地址，写入/etc/profile，每次修改完这个文件profile后，记得source /etc/profile，使其生效。

   export PATH=${PATH}:/home/iscas/osg_install/OpenSceneGraph-build/bin
   export LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:/home/iscas/osg_install/OpenSceneGraph-build/lib
   export OSG_FILE_PATH=/home/iscas/osg_install/OpenSceneGraph-Data

8. 最好先清理旧版本cmake，安装新版cmake(cmake-3.23.0-rc5-linux-x86_64.tar.gz)。

   sudo apt-get remove cmake
   sudo rm -rf /usr/local/share/cmake*
   sudo rm -rf /usr/local/bin/cmake*

9. 编译三方库尤其是freetype之前最好先更新qt，否则该库会对qt安装造成影响，详见第三部分
10. 若是cmake报错或者警告提示某一库未找到，则应当将三方库（或者向前依赖项安装时指定路径，有时候不给默认参数也会造成三方库没有编译在/usr/local之中，造成想当然的错误）
11. 恒歌版本源码的问题。在编译恒歌osgearth之前，请确认gdal大版本号为2.1，小版本我使用的是2.14。源码ReaderWriterGDAL文件2000行处，papszOptions参数类型应该为const char**，将恒歌源码CPLFetchBool函数入参papszOptions强制转为(const char**)即可
12. 我个人将其编译路径设置为：/home/iscas/osg_install/usr/local，这样目的是为了没有makefile的第三方库在利用cmakelists生成时，和其他第三方库层次不一的问题，具体见下方install步骤

二、库文件依赖的解决

依赖问题始终是最棘手的问题，为了解决依赖问题，可以根据osg和osgEarth中的CMakeList中的提示，可以获悉需要什么依赖，以及该库的版本号。我在解决依赖问题的时候，将所有能下到的依赖库的源代码下了下来，自行编译，其实本人觉得，直接编译源代码会简单一些，源代码的编译方法其实相对比较简单，大致上就是两个方法去编译，一个就是看见源代码目录下，有configure文件，就使用./configure来编译，生成Makefile文件，第二种方法是看见目录下，有CMakeList.txt文件，就使用cmake CMakeList.txt去生成Makefile，总之，都是为了生成Makefile文件，然后可以进一步make，sudo make install。

在处理osg和osgEarth中涉及的依赖时，只编译了部分依赖，其实还有一些依赖未解决，但不影响osg和osgEarth编译的成功，不过不解决，会导致后面部分功能无法使用。

网上有一个集成依赖库的，OSG配置第三方资源库3rdparty，这个仅适用于windows平台，不适用于linux。

osg和osgEarth所涉及的依赖的库文件，他们之间也存在一些依赖关系，所以编译的顺序应该较为严格执行。以下顺序仅供参考。

1. 编译 zlib-1.2.8 //sudo ldconfig
2. 编译 png-1.2.40
3. 编译 curl-7.47.0
4. 编译 freetype-2.4.8 //编译前检查qt是否更新的目标版本
5. 编译 gdal（proj-4.9.2->geos-3.5.0->gdal-2.1.14）
6. 编译 jpeg（nasm-2.13.03->libjpeg-turbo-1.2.1）
7. 编译 tiff-3.8.2
8. 编译 minizip //下面为可选项
9. 编译 sqlite
10. 编译 SDL2
11. 编译 libtool
12. 编译 googletest
13. 编译 protobuf //请参考下面的特殊情况
14. 编译 rocksdb(gflags->rocksdb) //请参考下面的特殊情况
15. qwt-6.2.0

在上述库文件的编译过程中，大部分只需要简单的编译。
如，有configure文件时候，使用

./configure --prefix=/home/iscas/osg_install/usr/local
make -j8
sudo make install

有CMakeList.txt时，使用

cmake CMakeList.txt
make -j8
sudo make install DESTDIR=/home/iscas/osg_install

正如上文所言，这样写为了避免文件夹路径层次不一，当然，如果你事先了解这两种安装的区别，那么可以无视这条建议。

只有下述几个情况比较特殊。

在用configure生成Makefile文件时，有时候会报错configure:error: cannot guess build type; you must specify one，这时候，只需要在configure后添加参数，指定编译所用的引擎即可。./configure --build=arm-linux。

在编译gflags库，默认只生成静态库，而在编译rocksdb时候，需要调用gflags的动态库，需要动态库才行。解决的方法。在cmake生成Makefile时，启用动态库。cmake -DBUILD_SHARED_LIBS=ON -DBUILD_STATIC_LIBS=ON -DINSTALL_HEADERS=ON -DINSTALL_SHARED_LIBS=ON -DINSTALL_STATIC_LIBS=ON。

在编译protobuf库文件时，需要首先运行./autogen.sh而后才会出现configure文件。

每编译完一个库文件，建议在命令行输入一次sudo ldconfig，更新引用，不然可能会有部分库文件不能马上生效，导致后续相关依赖的库文件编译时报错。

如若在库文件编译时，自定义目录，建议将所有目录统一，方便写入环境变量，写入环境变量，则需要使用export，写在/etc/profile最后面。

qwt编译：qmake qwt.pro(指定好了qmake和qwt文件夹内的pro文件)

三、测试是否成功

测试osg，可以在命令行运行osgviewer cow.osg是否显示一头牛，或者osgversion，看是否显示版本号。

测试osgEarth，可以在命令行运行osgearth_version，看是否显示版本号。

四、乱七八糟的问题

4.1 显卡安装

1. 打开/boot/grub/grub.cfg在Linux /vmlinuz-4.5.0....quiet splash 所在行最后加上$vt_handoff nouveau.modeset=0，并且将驱动文件防止在容易找的位置，如home文件夹内
2. 重启系统，分辨率变模糊
3. 使用Ctrl+Alt+F2进入命令行模式，先sudo su进入root用户，然后执行init 3进入完全多用户
4. ./***.run命令安装显卡
5. 需要注意的是，在一个Would you like to run the nvidia-xconfig utility to automatically update your x configuration file so that the NVIDIA X dirver will be used when you restart X ? 选项中要选择yes...

4.2 安装cmake时间遇到了系统没有openssl环境

以./bootstrap -- -DCMAKE_USE_OPENSSL=OFF方式执行安装脚本，然后执行sudo make && make install

configure CMake with -DCMAKE_USE_OPENSSL=OFF to build without OpenSSL.

4.3 进程杀死

c++: internal compiler error: 已杀死 (program cc1plus)Please submit a full bug report,with preprocessed source if appropriate. 解决方案：提升虚拟机内存空间。

4.4 报错未发现QtOpenGL

使用高级别版本qt（5.12），避免使用系统自带qt（5.6）。

1. 下载`qt-opensource-linux-x64-5.12.12.run`文件
2. chmod +x qt-opensource-linux-x64-5.12.12.run
3. sudo ./qt-opensource-linux-x64-5.12.12.run

4.5 安装qt时

这个问题可以通过先安装qt或者安装qt时将自己编译的freeetype临时隐藏得到解决，否则请参考下面方法

遇到symbol lookup error: /home/frank/Qt5.12.2/5.12.2/gcc_64/lib/libQt5XcbQpa.so.5: undefined symbol: FT_Property_Set类似的问题

我遇到的这种情况是因为有两个版本的freeetype导致的。

输入find /usr -name libfreetype*出现如下结果：

/usr/lib/x86_64-linux-gnu/libfreetype.a
/usr/lib/x86_64-linux-gnu/libfreetype.so.6
/usr/lib/x86_64-linux-gnu/libfreetype.la
/usr/lib/x86_64-linux-gnu/libfreetype.so
/usr/lib/x86_64-linux-gnu/libfreetype.so.6.12.1
/usr/local/lib/libfreetype.a
/usr/local/lib/libfreetype.so.6
/usr/local/lib/libfreetype.so.6.9.0
/usr/local/lib/libfreetype.la
/usr/local/lib/libfreetype.so

解决方案为：
sudo rm /usr/local/lib/libfreetype.so.6
或者

cd /usr/local/lib
sudo rm libfreetype.so.6 libfreetype.so libfreetype.so.6.9.0

切记：

1. 如果其中一个libfreetype是之前自己编译的，暂时将其隐藏即可，达到环境变量找不到这个动态库的目的
2. 不要把两个地方的libfreetype.so.6都删除了，我都删了之后，出现无法使用快捷键(如：ctrl+alt+t无法弹出终端)，以及重启无法进入系统的情况，最后通过重新创建/usr/lib/x86_64-linux-gnu/里面的/usr/lib/x86_64-linux-gnu/libfreetype.so.6，才重新进入系统。（libfreetype.so.6是一个软链接文件）

4.6 qtchooser加入新的qmake版本

编辑环境变量：
sudo xdg-open ~/.bashrc
按下i输入，在其最后添加以下信息

export QTDIR=/home/iscas123/Qt5.12.12/5.12.12
export PATH=$QTDIR/gcc_64/bin:$PATH
export LD_LIBRARY_PATH=$QTDIR/gcc_64/lib

按Esc后输入:wq保存退出。

银河麒麟上的Qt版本管理工具是qtchooser：
输入qtchooser -l显示qmake的几种版本的列表：

kylin@kylin:/usr/lib/aarch64-linux-gnu/qtchooser$ qtchooser -l
4
5
default
qt-5.12-aarch64-linux-gnu
qt4-aarch64-linux-gnu
qt4
qt5-aarch64-linux-gnu
qt5

添加一个名字为5.12的:
qtchooser -install qt5.12 /home/iscas123/Qt5.12.12/5.12.12/gcc_64/bin/qmake

然后再看一下
qtchooser -l

4
5
default
qt4-x86_64-linux-gnu
qt4
qt5-x86_64-linux-gnu
qt5.12
qt5

好了加完了，再设一下环境变量
export QT_SELECT=qt5.12
好了现在的qmake就是5.12的了

4.7 missing: ZLIB_LIBRARY

make报错：cmake Could NOT find ZLIB (missing: ZLIB_LIBRARY)
解决方案：cmake .. -DZLIB_INCLUDE_DIR=/usr/include -DZLIB_LIBRARY=/usr/lib

移植

此处移植是指编译完成后移植到另一台电脑配置开发环境。开发环境需完成Qt5.12、cmake的安装，若不满足条件，请参考第一部分(4.2、4.4~4.6)。

1. 将编译好的库文件、头文件、可执行文件打包好后(osg_oe)文件夹放在指定路径，如/home/iscas/env，将其解压

2. 动态库、静态库路径写入环境变量：

   1. sudo xdg-open /etc/ld.so.conf
   2. 在文件末尾写入：/home/iscas/env/osg_oe/lib、/home/iscas/env/osg_oe/lib64(需换行)
   3. 执行：sudo ldconfig

3. 环境变量中添加osg：sudo xdg-open ~/.bashrc
   文件末尾写入：

   export PATH=${PATH}:/home/iscas/env/osg_oe/bin
   export LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:/home/iscas/env/osg_oe/lib
   export LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:/home/iscas/env/osg_oe/lib64
   export OSG_FILE_PATH=/home/iscas/env/osg_oe/data

4. last but not least：在上述步骤3时，和qt版本设置的PATH设置冲突，此时应将两者的path合并且用:间隔
   完成部署