在 Windows 上构建 适用于 C++ 的 AWS SDK

从源代码构建 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 以运行应用程序代码的发布配置。对于 Windows，SDK 安装位置通常为 \Program Files (x86)\aws-cpp-sdk-all\。命令语法：

   {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 destination}

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

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

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

     cmake "..\aws-sdk-cpp" -DCMAKE_BUILD_TYPE=Debug -DCMAKE_PREFIX_PATH="C:\Program Files (x86)\aws-cpp-sdk-all"

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

     cmake ..\aws-sdk-cpp -DCMAKE_BUILD_TYPE=Debug -DBUILD_ONLY="s3" -DCMAKE_PREFIX_PATH="C:\Program Files (x86)\aws-cpp-sdk-all"

   • 生成构建文件（使用 curl）：满足 curl 先决条件后，还需要另外三个 cmake 命令行选项才能在 SDK 中支持 curl：FORCE_CURL、CURL_INCLUDE_DIR 和 CURL_LIBRARY。例如：

     cmake ..\aws-sdk-cpp -DCMAKE_BUILD_TYPE=Debug -DFORCE_CURL=ON -DCURL_INCLUDE_DIR='C:/curl/include'
           -DCURL_LIBRARY='C:/curl/lib/libcurl.dll.a' -DCMAKE_PREFIX_PATH="C:\Program Files (x86)\aws-cpp-sdk-all"

   注意

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

6. 构建 SDK 二进制文件。如果您要构建整个 SDK，则此步骤可能需要一小时或更长时间。命令语法：

   {path to cmake if not in PATH} --build . --config=[Debug | Release]

   cmake --build . --config=Debug

   注意

   如果您遇到错误 The code execution cannot proceed ... dll not found. Reinstalling the program may fix this problem，请重试 cmake 命令。

7. 使用管理员权限打开命令提示符，将 SDK 安装在之前使用 CMAKE_PREFIX_PATH 参数指定的位置。命令语法：

   {path to cmake if not in PATH} --install . --config=[Debug | Release]

   cmake --install . --config=Debug