Aviso de fim do suporte: em 20 de maio de 2026, AWS encerrará o suporte para AWS SimSpace Weaver. Depois de 20 de maio de 2026, você não poderá mais acessar o SimSpace Weaver console ou os SimSpace Weaver recursos. Para obter mais informações, consulte [AWS SimSpace Weaver Fim do suporte](https://docs.aws.amazon.com/simspaceweaver/latest/userguide/simspaceweaver-end-of-support.html). 

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Tutorial de início rápido para SimSpace Weaver
<a name="getting-started_quickstart"></a>

Este tutorial orienta você pelo processo de criação e execução de uma simulação no SimSpace Weaver em apenas alguns minutos. Recomendamos que você comece com este tutorial e depois passe pelo [tutorial detalhado](getting-started_detailed.md).

**Requisitos**  
Antes de começar, você deve concluir as etapas em [Configurando para SimSpace Weaver](setting-up.md). 

**nota**  
 Os scripts usados aqui são fornecidos para sua conveniência e NÃO são obrigatórios. Veja o [tutorial detalhado](getting-started_detailed.md) para saber como essas etapas podem ser executadas manualmente. 

## Etapa 1: ativar o registro (opcional)
<a name="getting-started_quickstart_enable-logging"></a>

**Como ativar o registro**

1. Navegue até:

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

1. Abra o arquivo do esquema em um editor de texto:

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

1. Encontre a seção `simulation_properties:` no início do arquivo:

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

1. Insira as duas linhas a seguir após a linha `simulation_properties:`:

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

1. Confirme se a seção `simulation_properties:` é a mesma que a seguinte:

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

1. Salve o arquivo e saia do seu editor de texto.

## Etapa 2: Início rápido com o cliente do console (opção 1)
<a name="getting-started_quickstart_console-client"></a>

 Navegue até: 

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

Execute um dos seguintes comandos:
+ Docker: `python quick-start.py --consoleclient`
+ WSL: `python quick-start.py —-consoleclient --al2`

 Por padrão, isso iniciará uma simulação com uma única partição em um único trabalhador. Outras configurações podem ser iniciadas passando a `--schema {file name}.yaml` partir da `/Samples/PathfindingSample/tools/` pasta. 

**nota**  
Consulte [Tutorial detalhado: conheça os detalhes ao criar o aplicativo de exemplo](getting-started_detailed.md) para obter uma explicação detalhada sobre o que esse script faz.

## Etapa 2: Início rápido com o cliente Unreal Engine (opção 2)
<a name="getting-started_quickstart_unreal-client"></a>

Consulte [Lançamento do cliente de visualização Unreal Engine](working-with_unreal-client.md).

## Pare e exclua sua simulação
<a name="getting-started_quickstart_stop"></a>

Navegue até:

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

Encontre os nomes das suas simulações:

```
aws simspaceweaver list-simulations
```

Pare e exclua a simulação

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

## Solução de problemas
<a name="getting-started_quickstart_troubleshooting"></a>
+  **FileNotFoundError: cmake** 

  ```
  subprocess.run('cmake')
  ...
   FileNotFoundError: The system cannot find the file specified
  ```
  +  **Resolução:** O script não consegue encontrar o comando`cmake`. Verifique se você tem a CMake versão mínima recomendada instalada e se ela pode ser chamada com o `cmake` comando no PATH. Use o comando `cmake -version` para verificar. 
+  **ImportError: Falha no carregamento da DLL ao importar libweaver\_app\_sdk\_python\_v1: O módulo especificado não foi encontrado.** 
  +  **Resolução:** Esse erro ocorre quando o Python 3.9 não está sendo usado para iniciar o SDK Weaver Python. Certifique-se de que a versão python associada ao comando “python” seja Python 3.9. Você pode verificar executando o `python --version` comando. 
+  **O script de início rápido parece travado após a inicialização do Docker Build.** 
  +  **Resolução:** Às vezes, o Docker precisa de alguns minutos para se aquecer. Se esse problema persistir por mais de 5 minutos, reinicie o Docker ou seu sistema. 
+  **target\_compile\_features nenhum recurso conhecido para o compilador CXX “GNU”:** 
  +  **Resolução:** limpe o cache do Docker, exclua a imagem do Docker weaverappbuilder, exclua os artefatos de construção do projeto e execute novamente. `setup.py` Isso deve redefinir seu ambiente Docker e resolver o erro.