Cómo empezar con los ejemplos AWS SDK para C++ de código - AWS SDK para C++
Estructura de los ejemplos de códigoCompilación y depuración de códigos de ejemplo en Visual Studio

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Cómo empezar con los ejemplos AWS SDK para C++ de código

Estructura de los ejemplos de código

La carpeta de ejemplo de C++ en Github contiene carpetas de proyectos para cada AWS servicio. Por lo general, los archivos de código fuente .cpp individuales en las carpetas muestran una funcionalidad o acción específica para ese servicio. Por ejemplo, en Amazon DynamoDB, obtener un elemento de la base de datos y cargar un elemento en la base de datos son dos tipos de acción diferentes, por lo que hay un archivo independiente para cada uno de ellos en la carpeta de DynamoDB: get_item.cpp y put_item.cpp. Cada archivo .cpp contiene una función main() como punto de entrada a un ejecutable independiente. Los ejecutables del proyecto se generan en una carpeta designada por el sistema de compilación y hay un archivo ejecutable correspondiente a cada archivo de código fuente de ejemplo. El nombre del ejecutable seguirá las convenciones de la plataforma ({name}.exe o simplemente {name}) y cualquier prefijo personalizado que aplique CMakeLists.txt, como run_.

Para ejecutar una funcionalidad de ejemplo

  1. Descargue el ejemplo de código deseado del repositorio de ejemplos de AWS código en GitHub.

  2. Abra un archivo .cpp para explorar su función main() y cualquier método al que se llame.

  3. Compile el proyecto, siguiendo el ejemplo de inicio de Introducción a AWS SDK para C++. Tenga en cuenta que al compilarse el proyecto se genera un ejecutable por cada archivo de código fuente del proyecto.

  4. Ejecute el archivo ejecutable para la funcionalidad seleccionada.

    • En una línea de comandos, ejecute ese programa con el archivo ejecutable que tiene el mismo nombre que el archivo *.cpp.

    • Si trabaja en un IDE, elija el archivo .cpp de la funcionalidad que desee consultar y selecciónelo como opción de inicio (u objeto de inicio).

Pruebas unitarias

Las pruebas, como ejemplos, se escriben utilizando el GoogleTest marco. Para obtener más información, consulte GoogleTestPrimer en el GoogleTest sitio web.

Las pruebas unitarias de cada ejemplo se encuentran en una subcarpeta llamada tests que contiene su propio archivo CMakeLists.txt. Por cada archivo de código fuente de ejemplo hay un archivo de prueba correspondiente denominado gtest_<source file>. El ejecutable de prueba de la subcarpeta se llama <Servicio de AWS>_gtests.

CMakeArchivo Lists.txt

La carpeta de cada servicio contiene un archivo denominado CMakeLists.txt. Muchos de estos archivos tienen una construcción similar a esta:

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

Por cada archivo .cpp de la carpeta, el archivo CMakeLists.txt compila un ejecutable (cmake: add_executable) con el nombre del archivo de código fuente, pero sin la extensión.

Compilación y depuración de códigos de ejemplo en Visual Studio

Compilación y ejecución del código de ejemplo de Amazon S3

  1. Obtenga el código fuente de ejemplo de Amazon S3. En este procedimiento se utiliza el código de ejemplo de Ejemplos de código de Amazon S3 que utilizan AWS SDK para C++ para empezar a trabajar con Visual Studio.

  2. En el Explorador de Windows, vaya a la carpeta de s3 (por ejemplo, \aws-doc-sdk-examples\cpp\example_code\s3).

  3. Haga clic con el botón derecho en la carpeta de ejemplo de s3 y seleccione Abrir con Visual Studio.  Visual Studio para CMake proyectos no tiene un archivo de «proyecto», sino que es la carpeta completa.

  4. En el menú desplegable Configuration Selector del menú superior de Visual Studio, compruebe que la configuración seleccionada coincida con el tipo de compilación que seleccionó al compilar el SDK con el código fuente.  Por ejemplo, se debe seleccionar una configuración de depuración si se ha creado desde el código fuente mediante debug (-DCMAKE_BUILD_TYPE=Debugen la línea de CMake comandos de las instrucciones de instalación del SDK).

  5. Abra el archivo CMakeLists.txt.

  6. Haga clic en Guardar. Cada vez que hace clic en Guardar en el CMakeLists.txt archivo, Visual Studio actualiza los CMake archivos generados.  Si abre la pestaña Output, podrá ver los mensajes de registro resultantes de esta generación.

    • Hay un cuadro desplegable en la pestaña de salida que dice: «Mostrar la salida de:» y CMakedebería ser la opción seleccionada de forma predeterminada.

    • La salida del último mensaje debería decir «CMake generación finalizada». »  

    • Si el último mensaje no es este, significa que el CMake archivo tiene problemas. No siga adelante hasta resolverlos.  Consulte Solución de problemas de compilación del AWS SDK para C++.

    • Tenga en cuenta que la CMake memoria caché la utiliza CMake para aumentar la velocidad. Si estás resolviendo CMake problemas, asegúrate de hacer borrón y cuenta nueva para que los mensajes de error que recibas reflejen realmente tus cambios más recientes.  En el Explorador de soluciones, haga clic con el botón derecho del ratón CMakeLists.txt y seleccione CMakeCaché y, a continuación, seleccione Eliminar caché. Haga esto con frecuencia cuando vaya resolviendo CMake problemas de forma progresiva.

  7. Cuando se compilan y ejecutan ejemplos desde Visual Studio, Visual Studio coloca los ejecutables en una estructura de carpetas diferente a la de la línea de comandos. Para ejecutar el código, los ejecutables del SDK deben copiarse en el lugar correcto.  Busque la línea «TODO» del archivo de CMake listas (~línea 40) y elija la línea comentada para usarla en Visual Studio. Visual Studio no usa una subcarpeta dedicada para el tipo de compilación, por lo que no está incluida.  Descomente la línea comentada del archivo CMakeLists.txt para usarla en Visual Studio.

  8. Elimine la CMake memoria caché (como se describió anteriormente), haga clic en la pestaña select/activate del CMakeLists.txt archivo y vuelva a seleccionar Guardar en el CMakeLists.txt archivo para iniciar la generación de los archivos de CMake compilación.

  9. Abra el archivo de código fuente del programa que desee ejecutar.

    • Por ejemplo, abra list_buckets.cpp.

    • La carpeta de ejemplo de Amazon S3 está codificada de manera que cada característica de Amazon S3 se muestra en un ejecutable dedicado exclusivamente a esa característica.  Por ejemplo, list_buckets.cpp se convertirá en un ejecutable que solo muestra el listado de buckets.

  10. En el menú de la parte superior, seleccione Build y, a continuación, elija Build All.

    • La opción Show output from de la pestaña Output debería mostrar Build como la opción seleccionada y todos los mensajes de compilación y vinculación.

    • La última salida debería ser “Build All succeeded”.

    • Ahora se generan los ejecutables para cada uno de los archivos de código fuente.  Puede confirmarlo consultando el directorio de salida de la compilación (por ejemplo, \aws-doc-sdk-examples\cpp\example_code\s3\out\build\x64-Debug).

    • Tenga en cuenta que los ejecutables llevan el prefijo “run_” porque así lo establece el archivo CMakeLists.txt.

  11. En el menú superior, hay una flecha verde y un selector desplegable para Debug Target.  Elija run_list_buckets.exe.

  12. Haga clic en el botón de ejecución de la flecha verde y, a continuación, en Select Startup Item.

  13. Se abrirá una ventana de Visual Studio Debug Console donde se mostrará la salida del código.

  14. Pulse una tecla para cerrar la ventana o ciérrela manualmente para finalizar el programa.  También puede establecer puntos de interrupción en el código para que se detenga en esos puntos cuando vuelva a ejecutarlo.