终止支持通知：2026 年 5 月 20 日， AWS 将终止对的支持。 AWS SimSpace Weaver 2026 年 5 月 20 日之后，您将无法再访问 SimSpace Weaver 控制台或 SimSpace Weaver 资源。有关更多信息，请参阅[AWS SimSpace Weaver 终止支持](https://docs.aws.amazon.com/simspaceweaver/latest/userguide/simspaceweaver-end-of-support.html)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 的快速入门教程 SimSpace Weaver
<a name="getting-started_quickstart"></a>

本教程将指导您在几分钟内在 SimSpace Weaver 上完成构建和运行模拟的过程。我们建议您从本教程开始，然后再阅读[详细的教程](getting-started_detailed.md)。

**要求**  
开始之前，请确保您已完成 [正在设置 SimSpace Weaver](setting-up.md) 中的步骤。

**注意**  
 此处提供的脚本是为了方便起见，不是必需的。有关如何手动完成这些步骤，请参阅[详细教程](getting-started_detailed.md)。

## 步骤 1：启用日志记录（可选）
<a name="getting-started_quickstart_enable-logging"></a>

**启用日志记录**

1. 导航至：

   ```
   {{sdk-folder}}/Samples/PathfindingSample/tools
   ```

1. 在文本编辑器中打开架构文件：

   ```
   pathfinding-single-worker-schema.yaml
   ```

1. 找到文件开头的 `simulation_properties:` 部分：

   ```
   simulation_properties:
     default_entity_index_key_type: "Vector3<f32>"
   ```

1. 在 `simulation_properties:` 一行之后插入以下 2 行：

   ```
     log_destination_service: "logs"
     log_destination_resource_name: "MySimulationLogs"
   ```

1. 确认 `simulation_properties:` 部分与以下内容相同：

   ```
   simulation_properties:
     log_destination_service: "logs"
     log_destination_resource_name: "MySimulationLogs"
     default_entity_index_key_type: "Vector3<f32>"
   ```

1. 保存文件并退出文本编辑器。

## 步骤 2：使用控制台客户端快速入门（选项 1）
<a name="getting-started_quickstart_console-client"></a>

 导航至：

```
sdk-folder/Samples/PathfindingSample/tools/cloud
```

运行以下命令之一：
+ 码头工人：`python quick-start.py --consoleclient`
+ WSL：`python quick-start.py —-consoleclient --al2`

 默认情况下，这将启动一个在单个工作器上使用单个分区的模拟。其他配置可以通过传递`--schema {file name}.yaml`来自`/Samples/PathfindingSample/tools/`文件夹的来启动。

**注意**  
[详细教程：了解构建示例应用程序的详细信息](getting-started_detailed.md)有关此脚本功能的深入说明，请参阅。

## 第 2 步：使用虚幻引擎客户端快速入门（选项 2）
<a name="getting-started_quickstart_unreal-client"></a>

请参阅 [启动虚幻引擎视图客户端](working-with_unreal-client.md)。

## 停止并删除您的模拟
<a name="getting-started_quickstart_stop"></a>

导航至：

```
sdk-folder/Samples/PathfindingSample/tools/cloud
```

查找您的模拟名称：

```
aws simspaceweaver list-simulations
```

停止并删除模拟

```
python stop-and-delete.py --simulation {{simulation-name}}
```

## 故障排除
<a name="getting-started_quickstart_troubleshooting"></a>
+  **FileNotFoundError: cmake** 

  ```
  subprocess.run('cmake')
  ...
   FileNotFoundError: The system cannot find the file specified
  ```
  +  **解决方案：**脚本找不到命令`cmake`。请确保您安装了推荐的最低 CMake 版本，并且可以使用 PATH 中的`cmake`命令调用该版本。使用命令`cmake -version`进行验证。
+  **ImportError: 导入 libweaver\_app\_sdk\_python\_v1 时加载失败：找不到指定的模块。**
  +  **解决方法：**当未使用 Python 3.9 启动 Weaver Python SDK 时，就会发生此错误。请确保与 “python” 命令关联的 python 版本为 Python 3.9。你可以通过运行`python --version`命令进行检查。
+  **启动 Docker Build 后，快速启动脚本似乎停滞不前。**
  +  **解决方案：**有时 Docker 需要几分钟来预热。如果此问题持续时间超过 5 分钟，请重启 Docker 或您的系统。
+  **target\_compile\_features CXX 编译器 “GNU” 没有已知的功能：**
  +  **解决方案：**清除 Docker 缓存，删除 weaverappbuilder Docker 镜像，删除项目构建工件，然后重新运行。`setup.py`这应该会重置你的 Docker 环境并解决错误。