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á.

# Começando com os exemplos AWS SDK para C\$1\$1 de código
<a name="getting-started-code-examples"></a>

## Estrutura dos exemplos de código
<a name="structure"></a>

A [pasta de exemplo de C\$1\$1](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/cpp/example_code) no Github contém pastas de projetos para cada AWS serviço. Normalmente, os arquivos-fonte .cpp individuais nas pastas demonstram um recurso ou uma ação específica do serviço em questão. Por exemplo, no caso do Amazon DynamoDB, *acessar* um item e *fazer upload* dele para o banco de dados são dois tipos diferentes de ação, portanto, há um arquivo separado para cada um na pasta do DynamoDB: `get_item.cpp` e `put_item.cpp`. Cada arquivo .cpp contém uma função `main()` como ponto de entrada para um executável autônomo. Os executáveis do projeto são gerados em uma pasta designada pelo seu sistema de compilação, e há um arquivo executável correspondente a cada exemplo de arquivo fonte. O nome de arquivo do executável segue as convenções da plataforma, como `{name}.exe` ou apenas `{name}` e se aplica qualquer prefixo personalizado `CMakeLists.txt`, como `run_`. 

**Como executar um exemplo de funcionalidade**

1. Baixe o exemplo de código desejado no [Repositório de exemplos de AWS código](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/cpp/example_code) em GitHub. 

1. Abra um arquivo .cpp para explorar a respectiva função `main()` e quaisquer métodos chamados. 

1. Compile o projeto, conforme demonstrado com o exemplo inicial em [Getting started using the AWS SDK para C\$1\$1](getting-started.md). Observe que a compilação do projeto gera o executável para cada arquivo-fonte do projeto.

1. Inicie o executável da funcionalidade selecionada.
   + Em um prompt de comando, execute esse programa usando o executável com base no nome do arquivo `*.cpp`.
   + Se você estiver trabalhando em um IDE, escolha o arquivo `.cpp` da funcionalidade que deseja demonstrar e selecione-o como a opção de inicialização (ou objeto de inicialização).

### Testes de unidade
<a name="unittest"></a>

Os testes para exemplos são escritos usando a GoogleTest estrutura. Para saber mais, consulte o [GoogleTestPrimer](https://google.github.io/googletest/primer.html) no GoogleTest site.

Os testes de unidade para cada exemplo estão em uma subpasta `tests` que contém o próprio arquivo `CMakeLists.txt`. Para cada arquivo-fonte de exemplo, há um arquivo de teste correspondente chamado `gtest_<source file>`. O executável de teste para a subpasta é denominado `<AWS service (Serviço da AWS)>_gtests`.

### CMakeArquivo Lists.txt
<a name="CMakeLists"></a>

A pasta de cada serviço contém um arquivo denominado `CMakeLists.txt`. Muitos desses arquivos contêm um constructo semelhante ao mostrado abaixo:

```
foreach(EXAMPLE IN LISTS EXAMPLES)
         add_executable(${EXAMPLE} ${EXAMPLE}.cpp)
         target_link_libraries(${EXAMPLE} aws-cpp-sdk-email aws-cpp-sdk-core)
endforeach()
```

 Para cada arquivo .cpp na pasta, o arquivo `CMakeLists.txt` cria um executável (cmake: `add_executable`) com um nome baseado no arquivo-fonte sem a extensão. 

## Exemplos de código de compilação e depuração no Visual Studio
<a name="buildingOnVisualStudio"></a>

**Compilar e executar o exemplo de código do Amazon S3**

1. Acesse o exemplo código-fonte do Amazon S3. Este procedimento usa o exemplo de código [Exemplos de código do Amazon S3 usando o AWS SDK para C\$1\$1](examples-s3.md) para começar a usar o Visual Studio. 

1. No Windows Explorer, navegue até a pasta `s3` (por exemplo, `\aws-doc-sdk-examples\cpp\example_code\s3`). 

1. Clique com o botão direito na pasta de exemplo `s3` e escolha **Abrir com o Visual Studio**.  O Visual Studio para CMake projetos não tem um arquivo de 'projeto', mas sim a pasta inteira. 

1. No menu suspenso **Seletor de configuração** no menu superior do Visual Studio, verifique se a configuração selecionada corresponde ao tipo de compilação que você selecionou ao criar o SDK com base na fonte.  Por exemplo, uma configuração de **depuração** deve ser selecionada se você compilou a partir do código-fonte usando debug (`-DCMAKE_BUILD_TYPE=Debug`na linha de CMake comando das instruções de instalação do SDK). 

1. Abra o arquivo `CMakeLists.txt`. 

1. Clique em **Salvar**. Sempre que você clica em **Salvar** no `CMakeLists.txt` arquivo, o Visual Studio atualiza os arquivos CMake gerados.  Se você tiver a guia **Saída** exibida, poderá ver as mensagens de log resultantes dessa geração. 
   + Há uma caixa suspensa na guia **Saída** que diz: "**Mostrar saída de:**" e **CMake**deve ser a opção selecionada por padrão. 
   + A saída da última mensagem deve dizer “**CMake geração concluída”.** “  
   + Se a última mensagem não for essa, o CMake arquivo tem problemas. Não prossiga com outras etapas até resolver isso.  Consulte [Solução de problemas de compilação do AWS SDK for C\$1\$1](troubleshooting-cmake.md). 
   + Observe que o CMake cache é usado pelo CMake for speed. Se você estiver resolvendo CMake problemas, você deve garantir uma “lista limpa” para que as mensagens de erro que você recebe reflitam, na verdade, as alterações mais recentes.  No Solution Explorer, clique com o botão direito do mouse `CMakeLists.txt` e escolha **CMakeCache** e escolha **Excluir cache**. Faça isso com frequência ao resolver CMake problemas progressivamente. 

1. Para compilar e executar exemplos de dentro do Visual Studio, este coloca os executáveis em uma estrutura de pastas diferente da linha de comandos. Para executar o código, os executáveis do SDK devem ser copiados no lugar certo.  Encontre a linha “`TODO`” do arquivo de CMake listas (\$1linha 40) e escolha aquela comentada para uso no Visual Studio. O Visual Studio não usa uma subpasta dedicada ao tipo de compilação, portanto, isso não está incluído.  Alterne a linha comentada no arquivo `CMakeLists.txt` para uso do Visual Studio. 

1. Exclua o CMake cache (conforme descrito acima), clique no `CMakeLists.txt` arquivo select/activate na guia e escolha **Salvar** no `CMakeLists.txt` arquivo novamente para iniciar a geração dos arquivos de CMake compilação. 

1. Abra o arquivo-fonte do “programa” que você deseja executar.
   + Por exemplo, abra `list_buckets.cpp`.
   + A pasta de exemplo do Amazon S3 é codificada para que cada “recurso” exibido do Amazon S3 seja demonstrado em um executável dedicado apenas para esse recurso.  Por exemplo, o `list_buckets.cpp` se tornará um executável que demonstra apenas a listagem de buckets. 

1. No menu superior, escolha **Compilar** e, depois, **Compilar tudo**. 
   + A opção **Mostrar saída de** da guia **Saída** deve exibir a seleção de **Compilar** e mostrar todas as mensagens de compilação e vinculação. 
   + A última saída deve ser: "**Compilação de tudo feita com êxito**”. 
   + Agora, os executáveis de cada um dos arquivos-fonte individuais são gerados.  Você pode confirmar isso examinando o diretório de saída da compilação (por exemplo, `\aws-doc-sdk-examples\cpp\example_code\s3\out\build\x64-Debug`).
   + Observe que os executáveis têm o prefixo “run\$1” porque o arquivo `CMakeLists.txt` determina isso. 

1. No menu superior, há uma **seta verde** e um **seletor suspenso** para **Depurar destino**.  Selecione `run_list_buckets.exe`. 

1. Clique no **botão de execução da seta verde** para **selecionar o item de inicialização**. 

1. Uma janela do Console de depuração do Visual Studio será aberta e exibirá a saída do código. 

1. Pressione uma tecla para fechar a janela ou feche-a manualmente para encerrar o programa.  Você também pode definir pontos de interrupção no código e, ao clicar em executar novamente, os pontos de interrupção serão acionados.