"Hello S3" App

To create the folder and source files

1. Create a directory to hold your source files.

   Note

   This example can also be completed in Visual Studio: choose Create New Project and then choose CMake Project.

2. Within that folder, add a main.cpp file that includes the following code, which reports the Amazon S3 buckets you own.

   #include <aws/core/Aws.h>
   #include <aws/core/utils/logging/LogLevel.h>
   #include <aws/s3/S3Client.h>
   #include <iostream>
   
   using namespace Aws;
   
   int main()
   {
       //The Aws::SDKOptions struct contains SDK configuration options.
       //An instance of Aws::SDKOptions is passed to the Aws::InitAPI and 
       //Aws::ShutdownAPI methods.  The same instance should be sent to both methods.
       SDKOptions options;
       options.loggingOptions.logLevel = Utils::Logging::LogLevel::Debug;
       
       //The AWS SDK for C++ must be initialized by calling Aws::InitAPI.
       InitAPI(options); 
       {
           S3::S3Client client;
   
           auto outcome = client.ListBuckets();
           if (outcome.IsSuccess()) {
               std::cout << "Found " << outcome.GetResult().GetBuckets().size() << " buckets\n";
               for (auto&& b : outcome.GetResult().GetBuckets()) {
                   std::cout << b.GetName() << std::endl;
               }
           }
           else {
               std::cout << "Failed with error: " << outcome.GetError() << std::endl;
           }
       }
   
       //Before the application terminates, the SDK must be shut down. 
       ShutdownAPI(options);
       return 0;
   }            

3. Add a CMakeLists.txt file that specifies your project’s name, executables, source files, and linked libraries.

   cmake_minimum_required(VERSION 3.3)
   set(CMAKE_CXX_STANDARD 11)
   project(app LANGUAGES CXX)
   
   #Set the location of where Windows can find the installed libraries of the SDK.
   if(MSVC)
       string(REPLACE ";" "/aws-cpp-sdk-all;" SYSTEM_MODULE_PATH "${CMAKE_SYSTEM_PREFIX_PATH}/aws-cpp-sdk-all")
       list(APPEND CMAKE_PREFIX_PATH ${SYSTEM_MODULE_PATH})
   endif()
   
   message(STATUS "CMAKE_PREFIX_PATH: ${CMAKE_PREFIX_PATH}")
   set(BUILD_SHARED_LIBS ON CACHE STRING "Link to shared libraries by default.")
   
   #Load required services/packages: This basic example uses S3.
   find_package(AWSSDK REQUIRED COMPONENTS s3)
   add_executable(${PROJECT_NAME} "main.cpp") #Add app's main starting file.
   
   #Windows: This 'if' clause copies the SDK libraries from the installation location to the place where 
   #  this project's executable is located.  Without this you'll need to copy the install 
   #  /bin folder to the exe location (app.exe in this case) to prevent runtime errors.
   if(MSVC AND BUILD_SHARED_LIBS)
       target_compile_definitions(${PROJECT_NAME} PUBLIC "USE_IMPORT_EXPORT")
       add_definitions(-DUSE_IMPORT_EXPORT)
       # Copy relevant AWS SDK for C++ libraries into the current binary directory for running and debugging.
       list(APPEND SERVICE_LIST s3)
      
       #For IDE's like Xcode and Visual Studio this line will be ignored because Release/Debug 
       #  is switched internally, but this is necessary for non-IDE builds.
       set(CMAKE_BUILD_TYPE Debug) #Set to your build type
   
       SET(EXECUTABLE_OUTPUT_PATH ${CMAKE_CURRENT_BINARY_DIR}/${CMAKE_BUILD_TYPE}) # Necessary for IDE's to use consistent file structure
       AWSSDK_CPY_DYN_LIBS(SERVICE_LIST "" ${CMAKE_CURRENT_BINARY_DIR}/${CMAKE_BUILD_TYPE})
       
       message(STATUS ">>CMAKE_CURRENT_BINARY_DIR: ${CMAKE_CURRENT_BINARY_DIR}")
       message(STATUS ">>CMAKE_BUILD_TYPE: ${CMAKE_BUILD_TYPE}")
       message(STATUS ">>EXECUTABLE_OUTPUT_PATH : ${EXECUTABLE_OUTPUT_PATH}")
   endif()
   
   set_compiler_flags(${PROJECT_NAME})
   set_compiler_warnings(${PROJECT_NAME})
   target_link_libraries(${PROJECT_NAME} ${AWSSDK_LINK_LIBRARIES})

To build the application

1. Create a directory where cmake will build your application.

   mkdir my_project_build

2. Change to the build directory and run cmake using the path to your project’s source directory.

   cd my_project_build
   cmake ../

3. After cmake generates your build directory, you can use make (or nmake on Windows), or MSBUILD ("C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\MSBuild\Current\Bin\MSBuild.exe" ALL_BUILD.vcxproj) to build your application.

To run the program

1. Change to the Debug directory where the result of the build was generated. In this example, app.exe is in folder my_project_build\Debug.

   cd Debug

2. Run the program using the name of the executable.

   app