Windows#

根据您选择的许可证和功能集（包含视频编码和 3D GUI 的 GPL 版本，或不包含这些功能的 EPL 版本）以及您使用 SUMO 的目的，Windows 平台有四种不同的二进制软件包。如果您想在本地安装并且拥有计算机的管理员权限，应该下载并执行其中一个安装程序。如果您需要“便携式”版本或没有管理员权限，请使用正确的 zip 文件，使用 7Zip、Winzip 或类似工具将其解压缩到所需文件夹中。每个软件包都包含二进制文件、所需的所有 dll、示例、工具以及 HTML 格式的文档。

• 下载 64 位安装程序: sumo-win64-1.25.0.msi
• 下载 64 位 zip: sumo-win64-1.25.0.zip
• 下载包含所有附加组件的 64 位安装程序（包含 GPL 代码）: sumo-win64extra-1.25.0.msi
• 下载包含所有附加组件的 64 位 zip（包含 GPL 代码）: sumo-win64extra-1.25.0.zip

在安装文件夹中，您会找到一个名为 "bin" 的文件夹。在这里，您可以找到可执行文件（程序）。您可以双击 sumo-gui 并查看 docs/examples 中的示例。所有其他应用程序（duarouter、dfrouter 等）都必须从命令行运行。为了方便操作，还提供了一个 start-commandline.bat 文件，为您设置整个环境。如果您对命令行操作不太熟悉，请阅读从命令行运行程序。

如果您想要最新的每日构建版本，或者需要测试文件或源文件，可以从下载页面下载。

有关从源代码构建 SUMO，请参阅在 Windows 下构建 SUMO。

Linux#

如果您运行的是 debian 或 ubuntu，SUMO 是常规发行版的一部分，可以像这样安装：

sudo apt-get install sumo sumo-tools sumo-doc

如果您需要更新的 ubuntu 版本，可能会在单独的 ppa 中找到，可以像这样添加：

sudo add-apt-repository ppa:sumo/stable
sudo apt-get update

然后再次运行

sudo apt-get install sumo sumo-tools sumo-doc

针对不同发行版（如 openSUSE 和 Fedora）的预编译二进制文件可以在这些二进制 Linux 版本的存储库中找到。这些存储库也包含每日构建版本。如果您的系统未在此处列出，或者您需要修改源代码，您必须从源代码构建 SUMO。

SUMO 的预编译二进制文件也可作为 Flatpak 使用，并托管在 Flathub 上。任何支持 Flatpak 的系统都应该能够以这种方式运行 SUMO。安装 Flatpak 并按照此处的说明添加 Flathub 存储库。

安装 SUMO：

flatpak install flathub org.eclipse.sumo

您的菜单中应该会出现一个 SUMO 启动器。

卸载 SUMO：

flatpak remove org.eclipse.sumo

有关打包为 Flatpak 的 SUMO 的错误报告请发送至此处。

macOS#

通过使用提供的软件包文件，可以轻松地在 macOS 上安装 SUMO：

• sumo-1.25.0.pkg

Homebrew 不再被认为是很好的替代方案，但仍然可以使用。如果您尚未安装 homebrew，可以在 macOS 终端中执行以下命令进行安装：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

请确保您的 homebrew 安装是最新的：

brew update

如果您想使用 sumo-gui 和/或 netedit，需要安装 XQuartz 作为依赖：

brew install --cask xquartz

可能需要注销并重新登录，甚至重新启动才能激活 XQuartz 集成。 然后您可以使用以下命令安装最新的稳定版 SUMO（包含最低要求：fox、proj、xerces-c）：

brew tap dlr-ts/sumo
brew install sumo

如果您需要编译支持其他库（如 GDAL）的 SUMO，则需要提供更多的命令行选项，如本文所述。 要完成设置，请确保设置 SUMO_HOME 环境变量，并将其指向您的 SUMO 安装目录。根据您的 shell，您可以在 .bashrc 或 .zshrc 中设置此变量。要在 .bashrc 中设置此变量，可以使用以下命令。

touch ~/.bashrc; open ~/.bashrc

只需在文件末尾插入以下新行：

export SUMO_HOME=/your/path/to/sumo

其中 /your/path/to/sumo 是 brew install sumo 命令的 caveats 部分中所述的路径。重新启动终端（或运行 source ~/.bashrc）并测试新添加的变量：

echo $SUMO_HOME

安装后，您需要注销/重新登录，以便在调用基于 GUI 的应用程序（如 sumo-gui）时让 X11 自动启动。（或者，您可以按 cmd-space 并输入 XQuartz 手动启动 X11）。

此外，SUMO 为其图形应用程序提供了原生的 macOS 应用程序捆绑包，因此可以将它们添加到 macOS 程序坞中。有一个单独的 brew cask 会将这些捆绑包复制到 Applications 文件夹：

brew install --cask sumo-gui

如果此过程失败，也可以通过将这些应用程序捆绑包从 $SUMO_HOME/build/osx/sumo-gui、$SUMO_HOME/build/osx/netedit 和 $SUMO_HOME/build/osx/osm-web-wizard 复制到 /Applications 文件夹中手动完成。另一种选择是下载应用程序启动器。

这些应用程序捆绑包通过评估您的 $SUMO_HOME 变量设置来确定 SUMO 安装的位置，并相应地启动程序。可以通过更改 $SUMO_HOME 变量来使用多个 SUMO 安装。

有关从源代码构建 SUMO，请参阅在 macOS 上构建 SUMO。

macOS 故障排除#

macOS Catalina 上的分段错误#

如果您在 macOS Catalina 上遇到分段错误，请按照以下步骤操作（参见 Issue 6242）。

1. 卸载 Catalina 版本的 fox： brew uninstall --ignore-dependencies fox

2. 编辑 fox 的 brew Formula： brew edit fox

3. 注释掉或删除以下行： sha256 "c6697be294c9a0458580564d59f8db32791beb5e67a05a6246e0b969ffc068bc" => :catalina

4. 安装 Mojave 版本的 fox： brew install fox

更新到 XQuartz 2.8.0_beta3 后屏幕空白#

如果在打开 sumo-gui 后遇到空白屏幕（参见 https://github.com/eclipse-sumo/sumo/issues/8208），请尝试重置您的 DISPLAY 环境变量：

export DISPLAY=:0.0

附加工具#

SUMO 包含大量 Python 工具，这些工具是源代码和 Windows 发行版的一部分，在 Linux 上可能打包在 sumo 或单独的 sumo-tools 包中。要充分利用这些工具，您需要几个额外的 python 模块。安装它们的最简单方法是使用 pip install -r $SUMO_HOME/tools/requirements.txt。

通过 Docker#

从源代码构建和安装 SUMO 对于初学者来说并非易事。Docker 是解决此问题的流行工具。SUMO 提供了 Dockerfiles 和 预构建的 Docker 镜像 供使用。有关更多详细信息，请查看关于容器化 SUMO 的文档 或 关于容器化 SUMO 的教程。