Começando com os exemplos AWS SDK para C++ de código - AWS SDK para C++
Estrutura dos exemplos de códigoExemplos de código de compilação e depuração no Visual Studio

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++ de código

Estrutura dos exemplos de código

A pasta de exemplo de C++ 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 em GitHub.

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

  3. Compile o projeto, conforme demonstrado com o exemplo inicial em Getting started using the AWS SDK para C++. Observe que a compilação do projeto gera o executável para cada arquivo-fonte do projeto.

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

Os testes para exemplos são escritos usando a GoogleTest estrutura. Para saber mais, consulte o GoogleTestPrimer 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 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

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++ para começar a usar o Visual Studio.

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

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

  4. 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=Debugna linha de CMake comando das instruções de instalação do SDK).

  5. Abra o arquivo CMakeLists.txt.

  6. 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 CMakedeve 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++.

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

  7. 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 (~linha 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.

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

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

  10. 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_” porque o arquivo CMakeLists.txt determina isso.

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

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

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

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