在 Linux/macOS 上构建 适用于 C++ 的 AWS SDK

在基于 Debian/Ubuntu 的系统上安装程序包

• sudo apt-get install libcurl4-openssl-dev libssl-dev uuid-dev zlib1g-dev libpulse-dev

在基于 Amazon Linux/Redhat/Fedora/CentOS 的系统上安装程序包

• sudo yum install libcurl-devel openssl-devel libuuid-devel pulseaudio-libs-devel

从源代码构建 SDK

1. 安装 CMake（最低版本 3.13）和适用于您平台的相关构建工具。建议将 cmake 添加到您的 PATH。要检查您的 CMake 版本，请打开命令提示符并运行命令 cmake --version

2. 在命令提示符下，导航至希望存储 SDK 的文件夹。

3. 获取最新源代码。

   版本 1.11 使用 git 子模块来封装外部依赖项。这包括《AWS SDK 和工具参考指南》中描述的 CRT 库。

   从 GitHub 上的 aws/aws-sdk-cpp 下载或克隆 SDK 源代码：

   • 使用 Git 克隆：HTTPS

     git clone --recurse-submodules https://github.com/aws/aws-sdk-cpp

   • 使用 Git 克隆：SSH

     git clone --recurse-submodules git@github.com:aws/aws-sdk-cpp.git

4. 建议您将生成的构建文件存储在 SDK 源目录之外。创建一个用于存储构建文件的新目录并导航到该文件夹。

   mkdir sdk_build
   cd sdk_build
   

5. 通过运行 cmake 生成构建文件。在 cmake 命令行上指定是编译调试版还是发布版本。在此过程中选择 Debug 以运行应用程序代码的调试配置。在此过程中选择 Release 以运行应用程序代码的发布配置。命令语法：

   {path to cmake if not in PATH} {path to source location of aws-sdk-cpp} -DCMAKE_BUILD_TYPE=[Debug | Release] -DCMAKE_PREFIX_PATH={path to install} -DCMAKE_INSTALL_PREFIX={path to install}

   有关修改构建输出的更多方法，请参阅 CMake 参数。

   注意

   在文件系统不区分大小写的 Mac 上构建时，请在运行构建版本的目录中检查 pwd 命令的输出。确保 pwd 输出中的目录名称使用大小写混合形式，例如 /Users 和 Documents。

   要生成构建文件，请执行以下操作之一：

   • 生成构建文件（全部 AWS 服务）：要构建整个 SDK，请运行 cmake，指定是构建调试版本还是发布版本。例如：

     cmake ../aws-sdk-cpp -DCMAKE_BUILD_TYPE=Debug -DCMAKE_PREFIX_PATH=/usr/local/ -DCMAKE_INSTALL_PREFIX=/usr/local/

   • 生成构建文件（部分 AWS 服务）：要仅为 SDK 生成一个或多个特定的服务包，请添加 CMake BUILD_ONLY 参数，服务名称用分号分隔。以下示例仅构建 Amazon S3 服务包：

     cmake ../aws-sdk-cpp -DCMAKE_BUILD_TYPE=Debug -DCMAKE_PREFIX_PATH=/usr/local/ -DCMAKE_INSTALL_PREFIX=/usr/local/ -DBUILD_ONLY="s3"

   注意

   如果您遇到错误 Failed to build third-party libraries，请运行 cmake --version 检查您的 CMake 版本。您必须使用 CMake 最低版本 3.13。

6. 构建 SDK 二进制文件。如果您要构建整个 SDK，则此操作可能需要一小时或更长时间。

   cmake --build . --config=Debug

7. 安装 SDK。根据您选择的安装位置，您可能需要升级权限。

   cmake --install . --config=Debug