1. 概论
在连续构建了zlib、libpng、libjpeg、libtiff、giflib以及freetype这几个库之后，接下来我们就要来一个大的，构建OpenSceneGraph这样大型库。OpenSceneGraph（简称 OSG）是一个高性能、跨平台的三维图形应用程序框架，广泛应用于科学可视化、模拟仿真、游戏开发等领域。理论上来说，上述几个库不是OSG的必须依赖库，但是将它们作为依赖库构建，OSG的功能就更完整。
2. 构建过程
构建OSG库的关键指令如下所示：
# 配置CMake
cmake .. -G "$Generator" -A x64 `-DCMAKE_BUILD_TYPE=RelWithDebInfo `-DCMAKE_PREFIX_PATH="$InstallDir" `-DCMAKE_INSTALL_PREFIX="$InstallDir" `-DGIFLIB_LIBRARY="$InstallDir/lib/giflib.lib" `-DBUILD_OSG_APPLICATIONS=ON `-DBUILD_OSG_EXAMPLES=OFF `-DBUILD_OSG_DEPRECATED_SERIALIZERS=OFF `-DCMAKE_RELWITHDEBINFO_POSTFIX=""# 构建阶段，指定构建类型
cmake --build . --config RelWithDebInfo -- /m:8# 安装阶段，指定构建类型和安装目标
cmake --build . --config RelWithDebInfo --target install
再次强调一遍，如果要优先找到提前编译好的依赖库，就需要设置CMAKE_PREFIX_PATH变量。我们把所有的库都安装到同一个目录中并设置成CMAKE_PREFIX_PATH变量，这样在构建新的依赖库的时候，CMake就能准确查找到相关的依赖库。不过，也会出现少数查找不到的情况，这里的GIFLIB就没有查找到，因此我们手动设置GIFLIB_LIBRARY。
其余的几个OSG提供的自定义构建选项中：
- BUILD_OSG_APPLICATIONS表示是否构建基于OSG的可执行程序，例如osgviewer、osgconv等。这样的应用工具还是非常实用的，推荐还是进行构建。
- BUILD_OSG_EXAMPLES表示是否构建示例程序，像这样的构建选项，为了加快构建速度一般不用进行构建。
- BUILD_OSG_DEPRECATED_SERIALIZERS看到这个DEPRECATED字眼就不用参与进行构建了，反正也是非必须项。
- CMAKE_RELWITHDEBINFO_POSTFIX表示是否给RelWithDebInfo方式编译的结果增加后缀，默认会增加后缀“rd”，这里将其设置为空。
3. 经验总结
构建像OSG这样的大型程序库，最好多看看CMake配置完成后的输出信息，例如这里的输出信息如下所示：
CMake Deprecation Warning at CMakeLists.txt:16 (CMAKE_MINIMUM_REQUIRED):Compatibility with CMake < 2.8.12 will be removed from a future version ofCMake.Update the VERSION argument <min> value or use a ...<max> suffix to tellCMake that the project does not need compatibility with older versions.-- Selecting Windows SDK version 10.0.22000.0 to target Windows 10.0.22631.
-- Could NOT find EGL (missing: EGL_LIBRARY EGL_INCLUDE_DIR)
-- Checking windows version...
-- 64 bit architecture detected
-- Could NOT find Jasper (missing: JASPER_LIBRARIES JASPER_INCLUDE_DIR)
-- Could NOT find LibXml2 (missing: LIBXML2_INCLUDE_DIR)
CMake Warning (dev) at C:/Program Files/CMake/share/cmake-3.26/Modules/FindPackageHandleStandardArgs.cmake:438 (message):The package name passed to `find_package_handle_standard_args` (PkgConfig)does not match the name of the calling package (GTA). This can lead toproblems in calling code that expects `find_package` result variables(e.g., `_FOUND`) to follow a certain pattern.
Call Stack (most recent call first):C:/Program Files/CMake/share/cmake-3.26/Modules/FindPkgConfig.cmake:99 (find_package_handle_standard_args)CMakeModules/FindGTA.cmake:11 (INCLUDE)CMakeLists.txt:751 (FIND_PACKAGE)
This warning is for project developers. Use -Wno-dev to suppress it.CMake Warning (dev) at C:/Program Files/CMake/share/cmake-3.26/Modules/FindPackageHandleStandardArgs.cmake:438 (message):The package name passed to `find_package_handle_standard_args` (PkgConfig)does not match the name of the calling package (GTA). This can lead toproblems in calling code that expects `find_package` result variables(e.g., `_FOUND`) to follow a certain pattern.
Call Stack (most recent call first):C:/Program Files/CMake/share/cmake-3.26/Modules/FindPkgConfig.cmake:99 (find_package_handle_standard_args)CMakeModules/FindGTA.cmake:15 (INCLUDE)CMakeLists.txt:751 (FIND_PACKAGE)
This warning is for project developers. Use -Wno-dev to suppress it.-- Checking for module 'gta'
-- No package 'gta' found
-- Trying to find DCMTK expecting DCMTKConfig.cmake
-- Trying to find DCMTK expecting DCMTKConfig.cmake - failed
-- Trying to find DCMTK relying on FindDCMTK.cmake
-- Please set DCMTK_DIR and re-run configure (missing: DCMTK_config_INCLUDE_DIR DCMTK_dcmdata_INCLUDE_DIR DCMTK_dcmimage_INCLUDE_DIR DCMTK_dcmimgle_INCLUDE_DIR DCMTK_dcmjpeg_INCLUDE_DIR DCMTK_dcmjpls_INCLUDE_DIR DCMTK_dcmnet_INCLUDE_DIR DCMTK_dcmpstat_INCLUDE_DIR DCMTK_dcmqrdb_INCLUDE_DIR DCMTK_dcmsign_INCLUDE_DIR DCMTK_dcmsr_INCLUDE_DIR DCMTK_dcmtls_INCLUDE_DIR DCMTK_ofstd_INCLUDE_DIR DCMTK_oflog_INCLUDE_DIR)
-- Could NOT find GStreamer (missing: GSTREAMER_INCLUDE_DIRS GSTREAMER_LIBRARIES GSTREAMER_VERSION GSTREAMER_BASE_INCLUDE_DIRS GSTREAMER_BASE_LIBRARIES GSTREAMER_APP_INCLUDE_DIRS GSTREAMER_APP_LIBRARIES GSTREAMER_PBUTILS_INCLUDE_DIRS GSTREAMER_PBUTILS_LIBRARIES)
-- Could NOT find SDL2 (missing: SDL2_LIBRARY SDL2_INCLUDE_DIR)
-- Could NOT find SDL (missing: SDL_LIBRARY SDL_INCLUDE_DIR)
CMake Warning (dev) at C:/Program Files/CMake/share/cmake-3.26/Modules/FindPackageHandleStandardArgs.cmake:438 (message):The package name passed to `find_package_handle_standard_args` (PkgConfig)does not match the name of the calling package (Poppler-glib). This canlead to problems in calling code that expects `find_package` resultvariables (e.g., `_FOUND`) to follow a certain pattern.
Call Stack (most recent call first):C:/Program Files/CMake/share/cmake-3.26/Modules/FindPkgConfig.cmake:99 (find_package_handle_standard_args)CMakeModules/FindPoppler-glib.cmake:2 (INCLUDE)CMakeLists.txt:761 (FIND_PACKAGE)
This warning is for project developers. Use -Wno-dev to suppress it.CMake Warning (dev) at C:/Program Files/CMake/share/cmake-3.26/Modules/FindPackageHandleStandardArgs.cmake:438 (message):The package name passed to `find_package_handle_standard_args` (PkgConfig)does not match the name of the calling package (Poppler-glib). This canlead to problems in calling code that expects `find_package` resultvariables (e.g., `_FOUND`) to follow a certain pattern.
Call Stack (most recent call first):C:/Program Files/CMake/share/cmake-3.26/Modules/FindPkgConfig.cmake:99 (find_package_handle_standard_args)CMakeModules/FindPoppler-glib.cmake:6 (INCLUDE)CMakeLists.txt:761 (FIND_PACKAGE)
This warning is for project developers. Use -Wno-dev to suppress it.-- Checking for module 'cairo'
-- No package 'cairo' found
-- Checking for module 'poppler-glib'
-- No package 'poppler-glib' found
CMake Warning (dev) at C:/Program Files/CMake/share/cmake-3.26/Modules/FindPackageHandleStandardArgs.cmake:438 (message):The package name passed to `find_package_handle_standard_args` (PkgConfig)does not match the name of the calling package (RSVG). This can lead toproblems in calling code that expects `find_package` result variables(e.g., `_FOUND`) to follow a certain pattern.
Call Stack (most recent call first):C:/Program Files/CMake/share/cmake-3.26/Modules/FindPkgConfig.cmake:99 (find_package_handle_standard_args)CMakeModules/FindRSVG.cmake:2 (INCLUDE)CMakeLists.txt:762 (FIND_PACKAGE)
This warning is for project developers. Use -Wno-dev to suppress it.CMake Warning (dev) at C:/Program Files/CMake/share/cmake-3.26/Modules/FindPackageHandleStandardArgs.cmake:438 (message):The package name passed to `find_package_handle_standard_args` (PkgConfig)does not match the name of the calling package (RSVG). This can lead toproblems in calling code that expects `find_package` result variables(e.g., `_FOUND`) to follow a certain pattern.
Call Stack (most recent call first):C:/Program Files/CMake/share/cmake-3.26/Modules/FindPkgConfig.cmake:99 (find_package_handle_standard_args)CMakeModules/FindRSVG.cmake:6 (INCLUDE)CMakeLists.txt:762 (FIND_PACKAGE)
This warning is for project developers. Use -Wno-dev to suppress it.-- Checking for module 'librsvg-2.0>=2.35'
-- No package 'librsvg-2.0' found
-- Checking for module 'cairo'
-- No package 'cairo' found
CMake Warning (dev) at C:/Program Files/CMake/share/cmake-3.26/Modules/FindPackageHandleStandardArgs.cmake:438 (message):The package name passed to `find_package_handle_standard_args` (PkgConfig)does not match the name of the calling package (GtkGl). This can lead toproblems in calling code that expects `find_package` result variables(e.g., `_FOUND`) to follow a certain pattern.
Call Stack (most recent call first):C:/Program Files/CMake/share/cmake-3.26/Modules/FindPkgConfig.cmake:99 (find_package_handle_standard_args)CMakeModules/FindGtkGl.cmake:2 (INCLUDE)CMakeLists.txt:763 (FIND_PACKAGE)
This warning is for project developers. Use -Wno-dev to suppress it.CMake Warning (dev) at C:/Program Files/CMake/share/cmake-3.26/Modules/FindPackageHandleStandardArgs.cmake:438 (message):The package name passed to `find_package_handle_standard_args` (PkgConfig)does not match the name of the calling package (GtkGl). This can lead toproblems in calling code that expects `find_package` result variables(e.g., `_FOUND`) to follow a certain pattern.
Call Stack (most recent call first):C:/Program Files/CMake/share/cmake-3.26/Modules/FindPkgConfig.cmake:99 (find_package_handle_standard_args)CMakeModules/FindGtkGl.cmake:6 (INCLUDE)CMakeLists.txt:763 (FIND_PACKAGE)
This warning is for project developers. Use -Wno-dev to suppress it.-- Checking for module 'gtk+-2.0'
-- No package 'gtk+-2.0' found
-- Checking for module 'gtkglext-win32-1.0'
-- No package 'gtkglext-win32-1.0' found
-- Could NOT find Fontconfig (missing: FONTCONFIG_LIBRARY FONTCONFIG_INCLUDE_DIR)
-- osgText will not be linked with FontConfig library
CMake Warning (dev) at C:/Program Files/CMake/share/cmake-3.26/Modules/Documentation.cmake:30 (message):Policy CMP0106 is not set: The Documentation module is removed. Run "cmake--help-policy CMP0106" for policy details. Use the cmake_policy command toset the policy and suppress this warning.Documentation.cmake is VTK-specific code and should not be used in non-VTKprojects. This logic in this module is best shipped with the project usingit rather than with CMake.
Call Stack (most recent call first):CMakeLists.txt:1162 (INCLUDE)
This warning is for project developers. Use -Wno-dev to suppress it.-- The following OPTIONAL packages have been found:* OpenGL* Freetype* FBX* GDAL* CURL* GIFLIB* JPEG* ZLIB* PNG* TIFF* Threads-- The following OPTIONAL packages have not been found:* EGL* ilmbase* Inventor* Jasper* OpenEXR* OpenCascade* LibXml2* COLLADA* GTA* LibVNCServer* DCMTK* FFmpeg* GStreamer* GLIB* DirectShow* SDL2* SDL* Poppler-glib* RSVG* RSVG* GtkGl* DirectInput* GtkGl* DirectInput* NVTT* NVTT* ZeroConf* LIBLAS* ZeroConf* LIBLAS* QuickTime* LIBLAS* QuickTime* QuickTime* Fontconfig-- Configuring done (3.5s)
-- Generating done (15.6s)
-- Build files have been written to: C:/Github/BuildCppDependency/Windows/OpenSceneGraph-OpenSceneGraph-3.6.5/build
看起来非常的繁杂，但是其实没什么内容，只要是在说有的依赖库找不到，有的依赖库找到了。最后还把找到的依赖库和没找到的依赖库都列出来了。关于这一点，我们只需要重点关心我们需要的依赖库是否识别成功了即可，以为有的大型库的依赖项非常多，不太可能一次性就把完整的依赖项准备好。
除此之外，还可以看看程序库提供的自定义构建选项，暂时用不到的暂时设为OFF不进行构建了，例如一些测试程序或者案例程序。CMake提供的功能非常强大，有的功能还会远程拉取代码，这个时候往往会因为国内网速的原因导致终端构建配置。不过，提供这种功能的模块往往是非必须的构建选项，可以找一找将其取消掉，在重新进行构建。
