在Windows上玩转RoboCup救援仿真？手把手教你用WSL2+Ubuntu 20.04搞定Java环境与项目运行-编程实验室

在Windows上玩转RoboCup救援仿真？手把手教你用WSL2+Ubuntu 20.04搞定Java环境与项目运行

对于许多想要尝试RoboCup救援仿真项目的Windows用户来说，传统双系统安装方式往往让人望而却步——需要分区、制作启动盘、处理引导问题，甚至可能影响现有系统。现在，我们有了更优雅的解决方案：WSL2（Windows Subsystem for Linux 2）。这个微软官方支持的Linux子系统，让你无需重启电脑就能在Windows上运行完整的Ubuntu环境，完美支持RoboCup救援仿真项目所需的所有工具链。

1. WSL2环境配置：从零开始搭建Linux开发环境

1.1 启用WSL2功能

首先确保你的Windows版本是Windows 10 2004及以上或Windows 11。按下Win+X选择"终端(管理员)"，依次执行以下命令：

# 启用WSL功能 dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart # 启用虚拟机平台功能 dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

完成后重启电脑。接着将WSL2设为默认版本：

wsl --set-default-version 2

1.2 安装Ubuntu 20.04 LTS

打开Microsoft Store，搜索"Ubuntu 20.04 LTS"并安装。安装完成后，从开始菜单启动Ubuntu，系统会自动完成初始化设置，要求你创建用户名和密码。

提示：WSL2的Ubuntu与Windows文件系统相互独立，但可以通过/mnt/c访问Windows的C盘，方便文件交换。

1.3 优化WSL2配置

为了获得更好的性能，建议调整WSL2的内存和CPU使用限制。在Windows用户目录下创建或修改.wslconfig文件：

[wsl2] memory=8GB # 根据你的物理内存调整 processors=4 # 分配CPU核心数 swap=4GB localhostForwarding=true

保存后执行wsl --shutdown重启WSL使配置生效。

2. Java开发环境搭建：OpenJDK 17与Gradle配置

2.1 安装OpenJDK 17

在Ubuntu终端中执行以下命令更新软件源并安装JDK：

sudo apt update && sudo apt upgrade -y sudo apt install openjdk-17-jdk -y

验证安装是否成功：

java -version

你应该看到类似输出：

openjdk version "17.0.8" 2023-07-18 OpenJDK Runtime Environment (build 17.0.8+7-Ubuntu-0ubuntu120.04) OpenJDK 64-Bit Server VM (build 17.0.8+7-Ubuntu-0ubuntu120.04, mixed mode, sharing)

2.2 配置Gradle构建工具

RoboCup救援仿真项目使用Gradle进行构建。安装最新版Gradle：

sudo apt install gradle -y

验证Gradle版本：

gradle --version

注意：Ubuntu仓库中的Gradle版本可能较旧。如需最新版，可手动安装：
wget https://services.gradle.org/distributions/gradle-8.3-bin.zip sudo unzip -d /opt/gradle gradle-8.3-bin.zip echo 'export PATH=$PATH:/opt/gradle/gradle-8.3/bin' >> ~/.bashrc source ~/.bashrc

3. RoboCup救援仿真项目部署与运行

3.1 克隆项目仓库

在WSL2的Ubuntu环境中，选择合适的目录克隆官方仓库：

git clone https://github.com/roborescue/rcrs-server.git git clone https://github.com/roborescue/adf-sample-agent-java.git

3.2 编译项目代码

服务器端编译：

cd rcrs-server ./gradlew completeBuild

客户端编译：

cd ../adf-sample-agent-java ./gradlew clean build

编译过程可能需要几分钟，取决于你的网络速度和系统性能。首次运行时会下载所有依赖项。

3.3 运行救援仿真

启动服务器：

cd ../rcrs-server/scripts ./start.sh -m ../maps/test/map -c ../maps/test/config

启动客户端（在新终端窗口中）：

cd ../../adf-sample-agent-java ./launch.sh -all

成功运行后，你将看到服务器GUI界面显示仿真环境，客户端智能体开始执行救援任务。

4. 高级配置与优化技巧

4.1 图形界面显示配置

WSL2默认不支持GUI应用。要显示RoboCup的图形界面，需安装X Server：

在Windows端安装VcXsrv
启动XLaunch，选择"One large window"，Display number设为0
在Ubuntu终端中配置DISPLAY变量：

echo "export DISPLAY=$(cat /etc/resolv.conf | grep nameserver | awk '{print $2}'):0" >> ~/.bashrc source ~/.bashrc

4.2 性能优化对比

环境类型	启动速度	资源占用	文件交互	图形性能	适用场景
WSL2	快	低	无缝	一般	日常开发、快速测试
双系统	慢	独占	困难	优秀	长期开发、性能敏感任务
传统虚拟机	中等	高	中等	差	隔离测试、多系统需求

4.3 常见问题解决

问题1：Gradle构建失败，提示依赖下载超时

解决方案：

# 设置阿里云镜像 mkdir -p ~/.gradle && echo 'systemProp.http.proxyHost=mirrors.aliyun.com systemProp.https.proxyHost=mirrors.aliyun.com' > ~/.gradle/gradle.properties

问题2：X Server连接失败

检查步骤：

确保Windows防火墙允许VcXsrv通过
确认WSL2的IP与DISPLAY设置匹配

尝试在Ubuntu中安装基础图形库：

sudo apt install libxrender-dev libxtst-dev libxi-dev -y

问题3：内存不足导致仿真崩溃

调整方案：

编辑.wslconfig增加内存限制
减少仿真规模，使用更小的测试地图
关闭不必要的Windows应用释放资源

5. 项目实战：预计算模式运行指南

预计算模式是比赛推荐的方式，可以显著提高运行效率。以下是完整流程：

5.1 服务器端预计算

cd rcrs-server/scripts ./start-precompute.sh -m ../maps/berlin/map -c ../maps/berlin/config

5.2 客户端连接

在新终端中：

cd adf-sample-agent-java ./launch.sh -t 1,0,1,0,1,0 -h localhost -pre 1

5.3 终止并重新运行

在服务器终端按Ctrl+C停止，然后执行：

./kill.sh ./start-comprun.sh -m ../maps/berlin/map -c ../maps/berlin/config

5.4 最终启动

客户端终端中：

./launch.sh -all

预计算完成后，系统会自动开始仿真，此时所有智能体将按照优化后的路径执行任务，效率比常规模式提高30%-50%。

在Windows上玩转RoboCup救援仿真？手把手教你用WSL2+Ubuntu 20.04搞定Java环境与项目运行