Windows での AWS SDK for C++ のビルド

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 全体をビルドするには、Debug または Release バージョンを指定して cmake を実行します。例:

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

   • ビルドファイルを生成する (AWS のサービス の一部): SDK の特定のサービスまたはサービスパッケージのみをビルドするには、BUILD_ONLY パラメータでサービス名をセミコロンで区切って指定して 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 の前提条件を満たした後、curl サポートを SDK に組み込むには、追加で FORCE_CURL、CURL_INCLUDE_DIR、CURL_LIBRARY の 3 つの cmake コマンドオプションが必要です。例:

     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 の全体をビルドする場合、この処理には 1 時間以上かかることがあります。コマンド構文

   {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. 管理者権限でコマンドプロンプトを開き、先ほど CMAKE_PREFIX_PATH パラメータを使用して指定した場所に SDK をインストールします。コマンド構文

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

   cmake --install . --config=Debug