CARLA模拟器：如何打包自定义地图的技术指南

概述

在CARLA自动驾驶模拟器中，开发者经常需要创建和使用自定义地图。本文将详细介绍如何在CARLA 0.9.15版本中正确打包包含自定义地图的完整项目包，以及相关的技术细节和注意事项。

自定义地图打包流程

基础打包方法

1. 地图导入：首先将RoadRunner创建的自定义地图放入Import文件夹
2. 单独打包：使用make import ARGS="--package=map_name"命令导入地图
3. 生成包：执行make package ARGS="--package=map_name"生成仅包含该地图的包

完整项目打包

当需要将自定义地图包含在完整项目包中时，需要特别注意：

1. 修改打包设置：必须将自定义地图添加到CARLA的打包配置文件中
2. 配置文件位置：/Content/Carla/Config/AdditionalMaps.Package.json
3. 配置格式：采用JSON格式指定地图路径和名称

高级配置详解

配置文件结构

完整的打包配置文件包含两个主要部分：

{
  "maps": [
    {
      "path": "/Game/map_package/Maps/cusMap",
      "name": "cusMap",
      "use_carla_materials": true
    }
  ],
  "props": []
}

• maps：定义所有需要包含的地图
  • path：地图在项目中的路径
  • name：地图显示名称
  • use_carla_materials：是否使用CARLA默认材质
• props：可包含额外的道具和资产

复杂地图处理

对于包含多个子级别的大型地图（如Town06_Opt），需要在配置文件中分别列出每个子级别：

1. 主地图文件
2. 各个子级别文件
3. 相关资产引用

这种结构确保了所有依赖项都能正确打包，避免引用丢失的问题。

跨平台使用注意事项

当需要在不同计算机间迁移自定义地图时：

1. 确保所有引用的资产路径一致
2. 检查材质和纹理引用是否完整
3. 验证蓝图和特殊元素的兼容性

最佳实践建议

1. 版本控制：保持CARLA版本和自定义地图工具的版本一致
2. 测试验证：打包后应在目标环境中进行全面测试
3. 文档记录：详细记录地图配置和依赖关系
4. 模块化设计：复杂地图建议采用子级别方式组织

通过遵循这些指南，开发者可以高效地在CARLA项目中集成和使用自定义地图，为自动驾驶算法的开发和测试提供更灵活的环境。