Skip to content

Windows 安装（二进制包）

警告：当前对 Windows 的支持仍处于实验阶段。

Windows 11 二进制安装

Gazebo 使用的所有依赖的二进制文件均可在 conda-forge 包仓库中找到。Gazebo 的构建农场（buildfarm）和本教程均使用 Pixi 包管理器。

安装依赖

按照 pixi.sh/latest 上的说明安装 pixi。安装完成后，关闭终端会话并重新打开，以确保 pixi 已加入 PATH。
创建一个文件夹来初始化 Pixi 项目。请确保该目录路径中不包含空格。打开命令提示符并输入以下命令：
Terminal window
```
   cd C:\Users\%USERNAME%\
   mkdir gz-ws
   cd gz-ws
   pixi init
```
你应该会看到如下输出：
Terminal window
```
   ✔ Created C:\Users\USER\ws_gz\pixi.toml
```
准备 pixi.toml 文件 Pixi 环境就绪后，可以将打包好的 Gazebo 二进制包以及 QT 库所需的环境变量添加进去。

用你喜欢的编辑器（或直接用记事本）打开 pixi.toml 文件。
Terminal window
```
notepad pixi.toml
```
在 pixi.toml 文件中把 [dependencies] 替换为以下内容：
```
[target.win-64.activation.env]
QT_QPA_PLATFORM_PLUGIN_PATH="%CONDA_PREFIX%\\Library\\lib\\qt6\\plugins\\platforms"
QML2_IMPORT_PATH="%CONDA_PREFIX%\\Library\\lib\\qt6\\qml"

[dependencies]
gz-sim = "10.*"
```
保存并关闭 pixi.toml 文件，然后让 Pixi 拉取所有依赖并安装 Gazebo。
Terminal window
```
pixi install
```

现在应该可以在 pixi shell 中正常启动 Gazebo 了：

pixi shell
gz sim -v4 shapes.sdf

或者使用 pixi run，效果相同但只需一行命令：

pixi run gz sim -v4 empty.sdf

注意： 目前直接运行 gz sim 还无法正常工作（原因见此 issue），因此在问题解决之前，请务必指定一个 world 的 sdf 文件。

二进制安装说明到此结束；返回入门页面，开始使用 Gazebo！

卸载二进制安装的 Gazebo

卸载二进制安装的 Gazebo 很简单，只需删除用 Pixi 环境创建的那个文件夹即可。

在命令提示符中，导航到该文件夹所在的根目录（取决于第一步中选择的位置），然后删除它。

   cd C:\Users\%USERNAME%\
   rmdir /s /q gz-ws

故障排除

参见故障排除