在 macOS 上构建 AirSim#
目前仅在 macOS Catalina (10.15) 上进行了测试。理论上,AirSim 应该可以在更高版本的 macOS 和 Apple Silicon 硬件上运行,但此路径未得到官方支持。
我们有两种选择——你可以在 docker 容器内构建,也可以在你的主机上构建。
Docker#
请参阅此处的说明
主机#
预构建设置#
下载虚幻引擎#
- 下载 Epic Games Launcher。虽然虚幻引擎是开源且可免费下载的,但仍需要注册。
- 运行 Epic Games Launcher,打开左侧窗格中的
Library
选项卡。点击Add Versions
,它应该会显示下载 Unreal 4.27 的选项,如下所示。如果你安装了多个版本的虚幻引擎,请通过点击版本旁边 Launch 按钮的向下箭头,确保 4.27 被设置为current
。
注意:AirSim 也适用于 UE >= 4.24,但是我们推荐 4.27。注意:如果你有 UE 4.16 或更旧的项目,请参阅升级指南来升级你的项目。
构建 AirSim#
- 克隆 AirSim 并构建它
# go to the folder where you clone GitHub projects
git clone https://github.com/Microsoft/AirSim.git
cd AirSim
默认情况下,AirSim 使用 clang 8 进行构建,以与 UE 4.25 兼容。安装脚本将安装正确版本的 cmake、llvm 和 eigen。
在 Apple Silicon 上构建需要 CMake 3.19.2。
./setup.sh
./build.sh
# use ./build.sh --debug to build in debug mode
构建虚幻环境#
最后,你需要一个虚幻项目来承载你的车辆环境。AirSim 自带一个“Blocks Environment”环境,你可以使用它,或者你可以创建自己的环境。如果你想设置自己的环境,请参阅设置虚幻环境。
如何使用 AirSim#
- 浏览到
AirSim/Unreal/Environments/Blocks
。 - 从终端运行
./GenerateProjectFiles.sh
,其中UE_PATH
是虚幻引擎安装文件夹的路径。(默认情况下,这是/Users/Shared/Epic\ Games/UE_4.27/
)该脚本会创建一个名为 Blocks.xcworkspace 的 XCode 工作区。 - 打开 XCode 工作区,然后点击左上角的“构建并运行”按钮。
- 虚幻编辑器加载后,点击“播放”按钮。
有关 AirSim 用法的各种选项,请参阅使用 API和settings.json。
提示
转到“编辑”->“编辑器首选项”,在“搜索”框中输入“CPU”,并确保“在后台时减少 CPU 使用率”未选中。
[可选] 设置遥控器(仅限多旋翼)#
如果你想手动飞行,需要一个遥控器。有关更多详细信息,请参阅遥控器设置。