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

从源代码构建 SDK

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

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

3. 获取最新的源代码。

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

   从以下位置下载或克隆 SDK 源aws/aws-sdk-cpp代码 GitHub：

   • 使用 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，软件开发工具包的安装位置通常为\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 仅限构建参数，服务名称用分号分隔。以下示例仅构建 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"

   注意

   如果出现错误 “无法构建第三方库”，请 CMake 通过运行来检查您的版本cmake --version。您必须使用 CMake 最低版本 3.13。

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

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

   cmake --build . --config=Debug

   注意

   如果你遇到错误代码执行无法继续... 找不到 dll。重新安装该程序可能会解决这个问题。” ，请重试该cmake命令。

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

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

   cmake --install . --config=Debug