从程序包管理器获取适用于 C++ 的 AWS SDK - 适用于 C++ 的 AWS SDK

从程序包管理器获取适用于 C++ 的 AWS SDK

重要

如果您使用的是 homebrew 或 vcpkg 等程序包管理器:

将适用于 C++ 的 SDK 更新到新版本后,必须重新编译依赖于该 SDK 的任何库或可执行文件。

要设置适用于 C++ 的 AWS SDK,您可以直接从源代码构建 SDK,也可以使用程序包管理器下载库。

SDK 源代码按服务划分为单独的程序包。安装整个 SDK 最多可能需要一个小时。仅安装程序使用的特定服务子集可以缩短安装时间,还可以减小所需磁盘空间。若要选择安装哪些服务,您需要知道程序所使用的每个服务的程序包名称。您可以在 GitHub 上的 aws/aws-sdk-cpp 中查看程序包目录列表。程序包名称是服务目录名称的后缀。

aws-sdk-cpp\aws-cpp-sdk-<packageName> # Repo directory name and packageName aws-sdk-cpp\aws-cpp-sdk-s3 # Example: Package name is s3

先决条件

要构建一些较大的 AWS 客户端,您至少需要 4 GB 的 RAM。由于内存不足,该 SDK 可能无法在 Amazon EC2 实例类型 t2.microt2.small 和其他小型实例类型上构建。

Linux/macOS

要在 Linux/macOS 上使用适用于 C++ 的 AWS SDK,您需要以下项之一:

  • GNU 编译器集合(GCC)4.9 或更高版本,或

  • Clang 3.3 或更高版本。

Windows

要在 Windows 上使用适用于 C++ 的 AWS SDK,您需要以下项之一:

  • Microsoft Visual Studio 2015 或更高版本,

  • GNU 编译器集合(GCC)4.9 或更高版本,或

  • Clang 3.3 或更高版本。

使用 vcpkg 获取 SDK

重要

可用的 vcpkg 发行版由外部贡献者支持,不是通过 AWS 提供。最新版本始终可以通过从源代码安装获得。

vcpkg 是由外部贡献者更新和维护的程序包管理器。请注意,此程序包管理器不是 AWS 提供的,可能无法反映适用于 C++ 的 AWS SDK 的最新可用版本。AWS 发布某个版本后,外部程序包管理器需要过一段时间才会提供该版本。最新版本始终可以通过从源代码安装获得。

您必须在您的系统上安装 vcpkg

  • 按照 vcpkg GitHub 自述文件中的说明下载并引导 vcpkg,在出现提示时替换以下选项:

    • 作为这些操作指南的一部分,系统会引导您输入以下内容:

      .\vcpkg\vcpkg install [packages to install]

      要安装整个 SDK,请输入 .\vcpkg\vcpkg install "aws-sdk-cpp[*]" --recurse 或仅指明要安装的 SDK 的特定服务,方法是在方括号中提供程序包名称,例如,.\vcpkg\vcpkg install "aws-sdk-cpp[s3, ec2]" --recurse

    输出会显示一条消息,包括以下内容:

    CMake projects should use: "-DCMAKE_TOOLCHAIN_FILE=C:/dev/vcpkg/vcpkg/scripts/buildsystems/vcpkg.cmake"
  • 复制完整的 -DCMAKE_TOOLCHAIN_FILE 命令以便稍后用于 CMake。vcpkg GitHub 自述文件还会说明在哪里使用它作为您的工具集。

  • 您可能还需要记下通过 vcpkg 安装的构建配置类型。控制台输出显示了构建配置和 SDK 的版本。以下示例输出表明构建配置为“x86-windows”,安装的适用于 C++ 的 AWS SDK 版本为 1.8。

    The following packages will be built and installed: aws-sdk-cpp[core,dynamodb,kinesis,s3]:x86-windows -> 1.8.126#6

安装适用于 C++ 的 AWS SDK 之后,您可以使用该 SDK 开发自己的应用程序。创建简单的应用程序中显示的示例报告了您拥有的 Amazon S3 存储桶。