Linux 系统上的构建

本指南详细介绍了如何在 Linux 上从源代码构建 Carla。有两个部分。第一部分详细介绍系统要求和所需软件的安装，第二部分详细介绍如何实际构建和运行 Carla。

构建过程很长（4小时或更长时间）并且涉及多种软件。强烈建议在开始之前完整阅读该指南。

• 第一部分：先决条件
  • 系统要求
  • 软件要求
    • 虚幻引擎
• 第二部分：构建 Carla
  • 克隆 Carla 仓库
  • 获取资产
  • 设置虚幻引擎环境变量
  • 构建 Carla
  • 其他 make 命令

---

第一部分：先决条件

系统要求

• Ubuntu 18.04. Carla 提供对 Ubuntu 16.04 之前版本的支持。然而，虚幻引擎需要适当的编译器才能正常工作。下面单独列出了 Ubuntu 18.04 及之前版本的依赖项。确保安装与您的系统相对应的软件。
• 130 GB 磁盘空间。 Carla 将占用大约 31 GB，虚幻引擎将占用大约 91 GB，因此需要大约 130 GB 的可用空间来容纳这两个空间以及额外的小型软件安装。
• 足够的 GPU。 Carla 的目标是进行真实的仿真，因此服务器至少需要 6 GB GPU，但建议使用 8 GB。强烈建议使用专用 GPU 进行机器学习。
• 两个 TCP 端口和良好的互联网连接。 默认为 2000 年和 2001 年。确保这些端口未被防火墙或任何其他应用程序阻止。

软件要求

Carla 需要运行多种不同类型的软件。有些是在 Carla 构建过程本身期间构建的，例如Boost.Python。其他是应该在开始构建之前安装的二进制文件（cmake、clang、不同版本的Python等）。要安装这些要求，请运行以下命令：

sudo apt-get update &&
sudo apt-get install wget software-properties-common &&
sudo add-apt-repository ppa:ubuntu-toolchain-r/test &&
wget -O - https://apt.llvm.org/llvm-snapshot.gpg.key|sudo apt-key add - &&
sudo apt-add-repository "deb http://apt.llvm.org/xenial/ llvm-toolchain-xenial-8 main" &&
sudo apt-get update

Ubuntu 18.04.

sudo apt-get install build-essential clang-8 lld-8 g++-7 cmake ninja-build libvulkan1 python python-pip python-dev python3-dev python3-pip libpng-dev libtiff5-dev libjpeg-dev tzdata sed curl unzip autoconf libtool rsync libxml2-dev git

以前的 Ubuntu 版本。

sudo apt-get install build-essential clang-8 lld-8 g++-7 cmake ninja-build libvulkan1 python python-pip python-dev python3-dev python3-pip libpng16-dev libtiff5-dev libjpeg-dev tzdata sed curl unzip autoconf libtool rsync libxml2-dev git

所有 Ubuntu 系统。

为了避免虚幻引擎和 Carla 依赖项之间的兼容性问题，请使用相同的编译器版本和 C++ 运行时库来编译所有内容。Carla 团队使用 clang-8 和 LLVM 的 libc++。更改默认的 clang 版本以编译虚幻引擎和 Carla 依赖项。

sudo update-alternatives --install /usr/bin/clang++ clang++ /usr/lib/llvm-8/bin/clang++ 180 &&
sudo update-alternatives --install /usr/bin/clang clang /usr/lib/llvm-8/bin/clang 180

从 Carla 0.9.12 开始，用户可以选择使用pip或pip3安装 Carla Python API。需要 20.3 或更高版本。要检查您是否有合适的版本，请运行以下命令：

# 对于 Python 3
pip3 -V

# 对于 Python 2
pip -V

如果您需要升级：

# 对于 Python 3
pip3 install --upgrade pip

# 对于 Python 2
pip install --upgrade pip

您必须安装以下 Python 依赖项：

pip install --user setuptools &&
pip3 install --user -Iv setuptools==47.3.1 &&
pip install --user distro &&
pip3 install --user distro &&
pip install --user wheel &&
pip3 install --user wheel auditwheel

---

虚幻引擎

从版本 0.9.12 开始，Carla 使用虚幻引擎 4.26 的修改版。该分支包含 Carla 特有的补丁。

1. 将 Carla 的虚幻引擎 4.26 分支的内容克隆到本地计算机：

git clone https://github.com/OpenHUTB/UnrealEngine.git ~/UnrealEngine_4.26

2. 导航到克隆存储库的目录：

cd ~/UnrealEngine_4.26

3. 进行构建。这可能需要一两个小时，具体取决于您的系统。

./Setup.sh && ./GenerateProjectFiles.sh && make

如果出现

bash: ./Setup.sh: Permission denied
./Setup.sh: line 40: Engine/Build/BatchFiles/Linux/GitDependencies.sh: Permission denied
Engine/Build/BatchFiles/Linux/GitDependencies.sh: line 25: mono: command not found

Setting up Mono
Corlib not in sync with this runtime: expected corlib version 149, found 1051600014.

chmod +x Setup.sh
chmod +x Engine/Build/BatchFiles/Linux/GitDependencies.sh
sudo apt-get install mono-complete
git clone https://github.com/OpenHUTB/UnrealEngine.git ~/UnrealEngine_4.26

4. 打开编辑器检查虚幻引擎是否已正确安装。

cd ~/UnrealEngine_4.26/Engine/Binaries/Linux && ./UE4Editor

电脑配置达不到Vulkan的标准会出现（OpenGL的API也废弃了）：

Cannot find a compatible Yulkan driver (ICD)

---

第二部分：构建 Carla

克隆 Carla 仓库

上面的按钮将带您进入该项目的官方存储库。从那里下载并在本地提取它或使用以下命令克隆它：

git clone https://github.com/carla-simulator/carla.git

获取资产

您需要下载 最新的 资源才能使用当前版本的 Carla。我们提供了一个脚本来自动执行此过程。要使用该脚本，请在 Carla 根文件夹中运行以下命令：

./Update.sh

资源将被下载并提取到适当的位置。

要下载 特定版本 的 Carla 资源：

1. 从 Carla 根目录，导航到 \Util\ContentVersions.txt。本文档包含所有 Carla 版本的资源链接。
2. 提取 Unreal\CarlaUE4\Content\Carla 中的资产。如果该路径不存在，请创建它。
3. 使用类似以下内容的命令提取文件：

tar -xvzf <assets_file_name>.tar.gz.tar -C C:\path\to\carla\Unreal\CarlaUE4\Content\Carla

设置虚幻引擎环境变量

为了让 Carla 找到虚幻引擎的正确安装，我们需要设置 Carla 环境变量。

仅为此会话设置变量：

export UE4_ROOT=~/UnrealEngine_4.26

要设置变量以使其在会话中保持不变：

1. 打开 ~/.bashrc 或 ./profile。

gedit ~/.bashrc
# 或 
gedit ~/.profile

2. 将以下行添加到文件底部：

export UE4_ROOT=~/UnrealEngine_4.26 

3. 保存文件并重置终端。

构建 Carla

本节概述了构建 Carla 的命令。所有命令都应在根 Carla 文件夹中运行。

Carla 的构建过程分为两个部分，编译客户端和编译服务器。

1. 编译 Python API 客户端：：

Python API 客户端授予对仿真的控制权。第一次构建 Carla 时需要编译 Python API 客户端，并且在执行任何更新后需要再次编译。客户端编译完成后，您将能够运行脚本与仿真进行交互。

以下命令编译 Python API 客户端：

make PythonAPI

或者，要为特定版本的 Python 编译 PythonAPI，请在根 Carla 目录中运行以下命令。

# Delete versions as required
make PythonAPI ARGS="--python-version=2.7, 3.6, 3.7, 3.8"

Carla 客户端库将以两种截然不同、互斥的形式构建。这使用户可以自由选择他们喜欢的形式来运行 Carla 客户端代码。两种形式包括.egg文件和.whl文件。选择以下选项之一来使用客户端库：

A. .egg 文件

.egg 文件不需要安装。导入 Carla 时，Carla 的所有示例脚本都会自动 查找此文件 。

如果您之前安装了 Carla .whl，.whl 将优先于 .egg 文件。

B. .whl 文件

.whl 文件应使用 pip 或 pip3 安装：

# Python 3
pip3 install <path/to/wheel>.whl

# Python 2
pip install <path/to/wheel>.whl

.whl 文件无法分发，因为它是专门为您的操作系统构建的。

2. 编译服务器：

以下命令编译并启动虚幻引擎。每次您想要启动服务器或使用虚幻引擎编辑器时运行此命令：

    make launch

该项目可能会要求构建其他实例，例如UE4Editor-Carla.dll第一次。同意才能打开项目。在首次启动期间，编辑器可能会显示有关着色器和网格距离场的警告。这些需要一些时间来加载，在此之前地图将无法正确显示。

3. 开始仿真：

按“运行”开始服务器仿真。可以使用WASD键移动相机，并通过在移动鼠标的同时单击场景来旋转相机。

使用PythonAPI\examples里面的示例脚本测试仿真器。在仿真器运行的情况下，为每个脚本打开一个新终端并运行以下命令以在城镇中产生一些生命并创建天气循环：

# 终端 A 
cd PythonAPI/examples
python3 -m pip install -r requirements.txt
python3 generate_traffic.py  

# 终端 B
cd PythonAPI/examples
python3 dynamic_weather.py 

其他 make 命令

您可能会发现还有更多有用的 make 命令。在下表中找到它们：

命令	描述
make help	打印所有可用的命令。
make launch	在编辑器窗口中启动 Carla 服务器。
make PythonAPI	构建 Carla 客户端。
make LibCarla	准备将 Carla 库导入到任何地方。
make package	构建 Carla 并创建用于分发的打包版本。
make clean	删除构建系统生成的所有二进制文件和临时文件。
make rebuild	make clean 和 make launch 两者都在一个命令中。

---

其他

v2ray 的版本不能太高，比如可以使用 v4.45.2 ，图形界面使用Qv2ray 2.7.0 。

有关本指南的任何问题， 请阅读 常见问题解答 页面或Carla 论坛 中的帖子。

接下来，学习如何更新 Carla 构建或在仿真中迈出第一步，并学习一些核心概念。