AirSim 1.8.1 Windows 11 编译实战：VS 2022与CMake兼容性深度解析

1. 环境准备：工具链精准匹配

在Windows 11平台编译AirSim 1.8.1时，工具链的版本协调是成功的关键前提。根据实测数据，推荐采用以下组合：

典型安装错误排查：

• 若出现Windows SDK not found错误，需检查：

  Get-ChildItem "HKLM:\SOFTWARE\Microsoft\Windows Kits\Installed Roots" | Select-Object Name

• CMake版本验证命令：

  cmake --version

2. CMake生成器配置陷阱

2.1 生成器选择策略

在VS 2022环境下，CMake需明确指定生成器版本。常见错误Could not create named generator的解决方案：

# 正确生成器指定方式（VS 2022对应17.x版本） cmake -G "Visual Studio 17 2022" -A x64 ..

不同VS版本对应的生成器名称对照：

2.2 多版本工具链冲突

当系统存在多个VS版本时，推荐使用vcvarsall.bat明确环境：

:: 强制使用VS 2022环境 "C:\Program Files\Microsoft Visual Studio\2022\Community\VC\Auxiliary\Build\vcvarsall.bat" x64

3. 依赖组件完整清单

3.1 VS 2022必装组件

通过VS Installer必须安装的组件包括：

• 核心组件

  • MSVC v143 - VS 2022 C++ x64/x86生成工具
  • Windows 10 SDK (10.0.19041.0)
  • C++ CMake工具

• 扩展组件

  • .NET Framework 4.8 SDK
  • C++ ATL (x86/x64)
  • 测试适配器

3.2 第三方依赖管理

AirSim编译过程中会自动下载的依赖项：

graph TD A[AirSim] --> B[rpclib] A --> C[Eigen3] A --> D[MavLinkCom] B --> E[asio] C --> F[LAPACK]

4. 编译流程优化方案

4.1 并行编译配置

在64核处理器上实测的编译参数优化：

# 使用clang-cl工具链加速编译 build.cmd --clang --parallel --build-type=Release

不同硬件配置下的最优并行参数：

4.2 常见编译错误处理

错误案例1：LNK1181无法打开输入文件

LINK : fatal error LNK1181: cannot open input file 'ws2_32.lib'

解决方案：

1. 检查Windows SDK版本是否匹配
2. 验证库目录包含路径：

   dir "C:\Program Files (x86)\Windows Kits\10\Lib\*\um\x64\ws2_32.lib"

错误案例2：C++20兼容性问题

error C2039: 'format': is not a member of 'std'

需在CMakeLists.txt中添加：

add_compile_definitions(_SILENCE_CXX20_CISO646_REMOVED_WARNING)

5. Unreal引擎集成要点

5.1 插件部署规范

正确部署编译产物的目录结构：

UnrealProject/ └── Plugins/ └── AirSim/ ├── Binaries/ ├── Content/ ├── Resources/ └── AirSim.uplugin

5.2 项目文件关联

当出现.uproject文件无法识别时，需执行：

# 重新生成VS项目文件 & "C:\Program Files\Epic Games\UE_4.27\Engine\Binaries\DotNET\UnrealBuildTool.exe" -projectfiles -project="YourProject.uproject" -game -rocket -progress

6. 性能调优指南

6.1 编译缓存利用

通过CCache加速二次编译：

set CCACHE_BASEDIR=%CD% build.cmd --ccache --clean

6.2 内存优化配置

针对32GB以下内存设备的调整：

# 在Engine\Config\BaseEngine.ini中添加 [Memory] PoolSize=8192

7. 深度调试技巧

7.1 符号调试配置

在VS中启用PDB生成：

set(CMAKE_EXE_LINKER_FLAGS "${CMAKE_EXE_LINKER_FLAGS} /DEBUG:FASTLINK")

7.2 实时诊断工具

推荐使用VS性能探查器：

1. 启动"调试 → 性能探查器"
2. 选择"CPU使用率"和"GPU使用率"
3. 重点关注AirLib模块的耗时分布

在最近一次为自动驾驶团队部署开发环境时，发现VS 2022 17.4版本与CMake 3.25存在线程调度冲突，通过降级到CMake 3.24.2解决了随机编译失败问题。这提醒我们即使使用官方推荐版本，也需要关注工具链组合的细微兼容性差异。