在Windows上为SUMO项目构建依赖库的完整指南

在Windows上为SUMO项目构建依赖库的完整指南

前言

SUMO（Simulation of Urban MObility）是一个开源的、多模态交通模拟软件包。在Windows平台上构建SUMO时，需要先准备一系列依赖库。本文将详细介绍这些依赖库的获取和构建方法，帮助开发者顺利完成SUMO的编译工作。

依赖库概述

SUMO在Windows平台上的主要依赖库包括：

1. Xerces-C：XML解析库
2. Fox：GUI工具包
3. PROJ和GDAL：地理坐标转换库
4. FFMPEG：视频编码库
5. OpenSceneGraph：3D渲染引擎

各依赖库详细说明

Xerces-C XML解析库

版本要求：SUMO默认使用Xerces-C 3.1.x或3.2.x版本

注意事项：

• Xerces-C 3.1.4在处理Unicode字符（特别是从公开地图数据导入中文街道名）时可能存在问题
• Apache已不再提供二进制发行版，建议使用预编译版本

解决方案：

• 直接使用预编译版本是最简单的方式
• 注意环境变量设置方式已不再适用

Fox GUI工具包

基本要求：

• 如果不需要GUI功能，可以跳过此部分
• SUMO仅支持Fox 1.6版本，不支持Fox 1.7
• 建议使用预编译版本

构建Fox的注意事项：

1. 从官网获取最新源代码
2. 使用Visual Studio打开项目解决方案文件(x64.sln)
3. 构建过程中可能出现约240个警告和1个错误，通常可以忽略
4. 如果出现找不到windows.h的错误，说明Windows SDK未正确安装

添加PNG支持

准备工作：

• 需要libpng 1.5.2/1.6.20和zlib 1.2.5/1.2.8
• 下载并解压zlib和libpng源代码

构建步骤：

1. 修改libpng项目中的zlib.props文件路径
2. 使用vstudio.sln构建libpng项目
3. 在Fox项目中配置：
   • 添加libpng目录到包含路径
   • 添加HAVE_PNG_H预处理器定义
   • 在链接器输入中添加.lib文件
4. 重新编译Fox并将生成的DLL与libpng DLL一起放入系统路径

添加JPEG支持

准备工作：

• 需要jpeg 8d或9b版本（8c版本存在问题）
• 下载libjpeg源代码

构建步骤：

1. 下载win32.mak并放入jpeg目录
2. 在Visual Studio命令提示符中执行构建命令
3. 在Fox项目中配置：
   • 添加jpeg目录到包含路径
   • 添加HAVE_JPEG_H预处理器定义
   • 在链接器输入中添加.lib文件
4. 重新编译Fox并将生成的DLL放入系统路径

PROJ和GDAL地理库

基本要求：

• 如果不需要地理坐标转换功能，可以在CMakeCache.txt中禁用
• 建议使用预编译版本

自行构建注意事项：

• 仅当需要32位构建或特定版本时才需要自行构建
• 需要参考PROJ和GDAL的官方构建说明
• 构建完成后替换预编译版本

FFMPEG视频编码库

基本要求：

• 仅当需要直接从sumo-gui保存视频时才需要
• 建议使用预编译版本

自行安装步骤：

1. 下载二进制发行版（包括Shared和Dev版本）
2. 解压Dev版本并替换预编译版本
3. 解压Shared版本并将DLL文件复制到库目录

OpenSceneGraph 3D引擎

基本要求：

• 仅3D GUI需要此库
• 需要至少OSG 3.4.0版本（早期版本不支持VS2012）

注意事项：

• 目前没有现成的二进制版本可用
• 可以通过设置OSG_FILE_PATH环境变量添加自定义模型路径
• 构建时会从预定义位置查找库和包含文件

总结

在Windows平台上构建SUMO的依赖库可能会遇到各种挑战，特别是对于初学者。本文详细介绍了各依赖库的获取和构建方法，建议开发者优先使用预编译版本，除非有特殊需求才考虑自行构建。对于GUI相关功能，特别注意Fox工具包的版本兼容性和多媒体支持配置。

通过遵循本文指南，开发者应该能够顺利完成SUMO在Windows平台上的依赖库准备工作，为后续的SUMO编译和开发打下坚实基础。