지원 종료 공지: 2026 AWS 년 5월 20일에에 대한 지원이 종료됩니다 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:` 줄 뒤에 다음 두 줄을 삽입합니다.

   ```
     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
```

다음 명령 중 하나를 실행합니다.
+ Docker: `python quick-start.py --consoleclient`
+ WSL: `python quick-start.py —-consoleclient --al2`

 기본적으로 단일 작업자에서 단일 파티션으로 시뮬레이션을 시작합니다. `/Samples/PathfindingSample/tools/` 폴더`--schema {file name}.yaml`에서를 전달하여 다른 구성을 시작할 수 있습니다.

**참고**  
이 스크립트의 기능에 [상세 자습서: 샘플 애플리케이션을 빌드하면서 세부 정보를 학습합니다.](getting-started_detailed.md) 대한 자세한 설명은 섹션을 참조하세요.

## 2단계: Unreal Engine 클라이언트로 빠른 시작(옵션 2)
<a name="getting-started_quickstart_unreal-client"></a>

[Unreal Engine 뷰 클라이언트 시작](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\$1app\$1sdk\$1python\$1v1을 가져오는 동안 DLL 로드가 실패했습니다. 지정된 모듈을 찾을 수 없습니다. ** 
  +  **해결 방법:**이 오류는 Python 3.9를 사용하여 Weaver Python SDK를 시작하지 않을 때 발생합니다. “python” 명령과 연결된 python 버전이 Python 3.9인지 확인하세요. `python --version` 명령을 실행하여 확인할 수 있습니다.
+  **Docker 빌드를 시작한 후 빠른 시작 스크립트가에 멈춰 있습니다.**
  +  **해결 방법:** Docker가 워밍업하는 데 몇 분 정도 걸리는 경우가 있습니다. 이 문제가 약 5분 이상 지속되면 Docker 또는 시스템을 다시 시작하십시오.
+  **target\$1compile\$1features CXX 컴파일러 "GNU"에 대해 알려진 기능이 없습니다.**
  +  **해결 방법:** 도커 캐시를 지우고, Weaverappbuilder 도커 이미지를 삭제하고, 프로젝트 빌드 아티팩트를 삭제하고,를 다시 실행합니다`setup.py`. 이렇게 하면 Docker 환경이 재설정되고 오류가 해결됩니다.