翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # を構築するための CMake パラメータ AWS SDK for C\$1\$1 このセクションに記載された [CMake](https://cmake.org/) のパラメータを使用して、SDK のビルド方法をカスタマイズします。 これらのオプションは、CMake GUI ツールまたはコマンドラインで *-D* を使用して設定できます。例: ``` cmake -DENABLE_UNITY_BUILD=ON -DREGENERATE_CLIENTS=1 ``` ## CMake の一般的な変数とオプション SDK ソースコードのビルドプロセスに影響する **`cmake`** の一般的な変数とオプションを次に示します。 **注記** これらのパラメータは、SDK for C\$1\$1 自体の SDK ソースコードをビルドする際に使用します。 **Topics** + [ADD\$1CUSTOM\$1CLIENTS](#cmake-add-custom-clients) + [AUTORUN\$1UNIT\$1TESTS](#cmake-AUTORUN_UNIT_TESTS) + [AWS\$1AUTORUN\$1LD\$1LIBRARY\$1PATH](#cmake-AWS_AUTORUN_LD_LIBRARY_PATH) + [AWS\$1SDK\$1WARNINGS\$1ARE\$1ERRORS](#cmake-AWS_SDK_WARNINGS_ARE_ERRORS) + [AWS\$1USE\$1CRYPTO\$1SHARED\$1LIBS](#cmake-use-crypto) + [AWS\$1TEST\$1REGION](#cmake-AWS_TEST_REGION) + [BUILD\$1BENCHMARKS](#cmake-BUILD_BENCHMARKS) + [BUILD\$1DEPS](#cmake-BUILD_DEPS) + [BUILD\$1ONLY](#cmake-build-only) + [BUILD\$1OPTEL](#cmake-BUILD_OPTEL) + [BUILD\$1SHARED\$1LIBS](#cmake-build-shared-libs) + [BYPASS\$1DEFAULT\$1PROXY](#cmake-BYPASS_DEFAULT_PROXY) + [CPP\$1STANDARD](#cmake-cpp-standard) + [CURL\$1INCLUDE\$1DIR](#cmake-curl-include-dir) + [CURL\$1LIBRARY](#cmake-curl-library) + [CUSTOM\$1MEMORY\$1MANAGEMENT](#cmake-custom-memory-management) + [DISABLE\$1INTERNAL\$1IMDSV1\$1CALLS](#cmake-DISABLE_INTERNAL_IMDSV1_CALLS) + [ENABLE\$1ADDRESS\$1SANITIZER](#cmake-ENABLE_ADDRESS_SANITIZER) + [ENABLE\$1CURL\$1LOGGING](#cmake-enable-curl-logging) + [ENABLE\$1HTTP\$1CLIENT\$1TESTING](#cmake-ENABLE_HTTP_CLIENT_TESTING) + [enable\$1rtti](#cmake-enable-rtti) + [ENABLE\$1TESTING](#cmake-enable-testing) + [ENABLE\$1UNITY\$1BUILD](#cmake-enable-unity-build) + [ENABLE\$1VIRTUAL\$1OPERATIONS](#cmake-virtual-op) + [ENABLE\$1ZLIB\$1REQUEST\$1COMPRESSION](#cmake-ENABLE_ZLIB_REQUEST_COMPRESSION) + [FORCE\$1CURL](#cmake-force-curl) + [FORCE\$1SHARED\$1CRT](#cmake-force-shared-crt) + [G](#cmake-g) + [MINIMIZE\$1SIZE](#cmake-minimize-size) + [NO\$1ENCRYPTION](#cmake-no-encryption) + [NO\$1HTTP\$1CLIENT](#cmake-no-http-client) + [REGENERATE\$1CLIENTS](#cmake-regenerate-clients) + [REGENERATE\$1DEFAULTS](#cmake-regenerate-defaults) + [SIMPLE\$1INSTALL](#cmake-simple-install) + [TARGET\$1ARCH](#cmake-target-arch) + [USE\$1CRT\$1HTTP\$1CLIENT](#cmake-USE_CRT_HTTP_CLIENT) + [USE\$1IXML\$1HTTP\$1REQUEST\$12](#cmake-USE_IXML_HTTP_REQUEST_2) + [USE\$1OPENSSL](#cmake-use-openssl) + [USE\$1TLS\$1V1\$12](#cmake-USE_TLS_V1_2) + [USE\$1TLS\$1V1\$13](#cmake-USE_TLS_V1_3) ### ADD\$1CUSTOM\$1CLIENTS API 定義に基づいて任意のクライアントをビルドします。定義を `code-generation/api-definitions` フォルダに配置し、この引数を **`cmake`** に渡します。**`cmake`** の設定ステップでクライアントが生成され、ビルドのサブディレクトリとして組み込まれます。これは、[API Gateway](https://aws.amazon.com/api-gateway) サービスのいずれかを使用するための C\$1\$1 クライアントを生成する場合に特に便利です。例えば、次のようになります。 ``` -DADD_CUSTOM_CLIENTS="serviceName=myCustomService,version=2015-12-21;serviceName=someOtherService,version=2015-08-15" ``` **注記** `ADD_CUSTOM_CLIENTS` パラメータを使用するには、[Python 2.7](https://www.python.org/downloads/)、Java ([JDK 1.8 以上](http://openjdk.java.net/install/))、[Maven](https://maven.apache.org/) がインストールされており、`PATH` に含まれている必要があります。 ### AUTORUN\$1UNIT\$1TESTS `ON` の場合は、ビルド後にユニットテストを自動的に実行します。 値 *ON* \$1 *OFF* デフォルト *オン* ### AWS\$1AUTORUN\$1LD\$1LIBRARY\$1PATH CMake により自動的に実行されるユニットテスト用に LD\$1LIBRARY\$1PATH に追加するパス。オーバーライドされた依存関係にカスタムランタイムライブラリが必要な場合は、このパスを設定します。 値 *文字列。* デフォルト *該当なし* ### AWS\$1SDK\$1WARNINGS\$1ARE\$1ERRORS `ON` の場合、コンパイラの警告をエラーとして扱います。新しいコンパイラや一般的でないコンパイラでエラーが発生する場合は、これを `OFF` にしてみてください。 値 *ON* \$1 *OFF* デフォルト *オン* ### AWS\$1USE\$1CRYPTO\$1SHARED\$1LIBS 共有 crypto ライブラリが見つかった場合、FindCrypto がそのライブラリを使用するように設定します。代わりに [BUILD\$1SHARED\$1LIBS](#cmake-build-shared-libs) を使用するように設定するには、これを `OFF` にします。 値 *ON* \$1 *OFF* デフォルト *オフ* ### AWS\$1TEST\$1REGION 統合テスト AWS リージョン に使用する 。 値 *文字列。* デフォルト *該当なし* ### BUILD\$1BENCHMARKS `ON` の場合、ベンチマーク実行可能ファイルをビルドします。 値 *ON* \$1 *OFF* デフォルト *オフ* ### BUILD\$1DEPS `ON` の場合、サードパーティの依存関係をビルドします。 値 *ON* \$1 *OFF* デフォルト *オン* ### BUILD\$1ONLY 使用するクライアントのみをビルドします。`aws-cpp-sdk-transfer` などの高レベル SDK に設定すると、*BUILD\$1ONLY* では低レベルのクライアント依存関係を解決します。選択したプロジェクトに関連する統合テストやユニットテストが存在する場合は、それらもビルドされます。これはリスト引数であり、値はセミコロン (`;`) 文字で区切られます。例えば、次のようになります。 ``` -DBUILD_ONLY="s3;cognito-identity" ``` **注記** コア SDK モジュール `aws-sdk-cpp-core` は、*BUILD\$1ONLY* パラメータの値に関係なく*常に*ビルドされます。 ### BUILD\$1OPTEL `ON` の場合、OpenTelemetry に基づくトレース実装がビルドされます。 値 *ON* \$1 *OFF* デフォルト *オフ* ### BUILD\$1SHARED\$1LIBS CMake に組み込まれているオプションですが、可視性を高めるためにここで明示しています。`ON` の場合、共有ライブラリをビルドし、それ以外の場合は、静的ライブラリのみをビルドします。 **注記** SDK を動的リンクするには、すべてのビルドターゲットに対して `USE_IMPORT_EXPORT` シンボルを定義する必要があります。 値 *ON* \$1 *OFF* デフォルト *オン* ### BYPASS\$1DEFAULT\$1PROXY `ON` の場合、IXmlHttpRequest2 使用時にマシンのデフォルトプロキシ設定をバイパスします。 値 *ON* \$1 *OFF* デフォルト *オン* ### CPP\$1STANDARD C\$1\$1 14 および 17 コードベースで使用するカスタム C\$1\$1 標準を指定します。 値 *11* \$1 *14* \$1 *17* デフォルト *11* ### CURL\$1INCLUDE\$1DIR `libcurl` ヘッダーを含む curl インクルードディレクトリへのパス。 値 *選択した `include` ディレクトリへの文字列パス。たとえば、 です`D:/path/to/dir/with/curl/include`。* デフォルト *該当なし* ### CURL\$1LIBRARY リンク対象の curl ライブラリファイルへのパス。このライブラリは、アプリケーションの要件に応じて静的ライブラリまたはインポートライブラリになります。 値 *curl ライブラリファイルへの文字列パス。たとえば、 です`D:/path/to/static/libcur/file/ie/libcurl.lib.a`。* デフォルト *該当なし* ### CUSTOM\$1MEMORY\$1MANAGEMENT カスタムメモリマネージャーを使用するには、値を `1` に設定します。すべての STL 型がカスタムの割り当てインターフェイスを使用するように、独自のアロケーターを導入できます。値を `0` に設定しても、Windows での DLL の安全性を高めるために STL テンプレート型の使用を検討するとよいでしょう。 静的リンクが `ON` の場合、カスタムメモリ管理はデフォルトで *off* (`0`) になります。動的リンクが `ON` の場合、カスタムメモリ管理はデフォルトで *on* (`1`) になり、DLL 間でのメモリ割り当てと解放を回避します。 **注記** リンカーの不一致エラーを防ぐには、ビルドシステム全体で同じ値 (`0` または `1`) を使用する必要があります。 SDK によるメモリ割り当てを処理する独自のメモリマネージャーを導入するには、`-DCUSTOM_MEMORY_MANAGEMENT` を設定し、SDK に依存するすべてのビルドターゲットに `USE_AWS_MEMORY_MANAGEMENT` を定義する必要があります。 ### DISABLE\$1INTERNAL\$1IMDSV1\$1CALLS `ON` の場合、[インスタンスメタデータサービス](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html) の V1 API への内部呼び出しは行われません。`OFF` の場合、IMDSv2 呼び出しが失敗すると IMDSv1 にフォールバックされます。IMDSv1 および IMDSv2 の詳細については、「*Amazon EC2 ユーザーガイド*」の「[インスタンスメタデータを使用してインスタンスメタデータにアクセスする](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/configuring-instance-metadata-service.html)」を参照してください。 値 *ON* \$1 *OFF* デフォルト *オフ* ### ENABLE\$1ADDRESS\$1SANITIZER `ON` の場合、gcc または clang の Address Sanitizer をオンにします。 値 *ON* \$1 *OFF* デフォルト *オフ* ### ENABLE\$1CURL\$1LOGGING `ON` の場合、curl の内部ログを SDK のロガーにパイプ出力します。 値 *ON* \$1 *OFF* デフォルト *オフ* ### ENABLE\$1HTTP\$1CLIENT\$1TESTING `ON` の場合、対応する HTTP クライアントテストスイートをビルドして実行します。 値 *ON* \$1 *OFF* デフォルト *オフ* ### enable\$1rtti RTTI (実行時型情報) を有効にして SDK をビルドするかどうかを制御します。 値 *ON* \$1 *OFF* デフォルト *オン* ### ENABLE\$1TESTING SDK ビルド時にユニットテストおよび統合テストプロジェクトをビルドするかどうかを制御します。 値 *ON* \$1 *OFF* デフォルト *オン* ### ENABLE\$1UNITY\$1BUILD `ON` の場合、ほとんどの SDK ライブラリは 1 つの生成された `.cpp` ファイルとしてビルドされます。これにより、静的ライブラリのサイズを大幅に削減し、コンパイル時間を短縮できます。 値 *ON* \$1 *OFF* デフォルト *オフ* ### ENABLE\$1VIRTUAL\$1OPERATIONS このパラメータは通常、コード生成のために `REGENERATE_CLIENTS` と併用されます。 `ENABLE_VIRTUAL_OPERATIONS` が `ON` で、`REGENERATE_CLIENTS` が `ON` の場合、サービスクライアントのオペレーション関連の関数は `virtual` としてマークされます。 `ENABLE_VIRTUAL_OPERATIONS` が `OFF` で、`REGENERATE_CLIENTS` が `ON` の場合、オペレーション関連の関数には `virtual` が追加されず、サービスクライアントクラスは `final` としてマークされます。 `ENABLE_VIRTUAL_OPERATIONS` が `OFF` の場合、SDK はコンパイル時に gcc および clang の `-ffunction-sections` および `-fdata-sections` コンパイラフラグも追加します。 詳細については、GitHub の「[CMake Parameters](https://github.com/aws/aws-sdk-cpp/blob/main/docs/CMake_Parameters.md#enable_virtual_operations)」を参照してください。 値 *ON* \$1 *OFF* デフォルト *オン* ### ENABLE\$1ZLIB\$1REQUEST\$1COMPRESSION これをサポートするサービスの場合、リクエストコンテンツは圧縮されます。依存関係が使用可能な場合、デフォルトでオンになります。 値 *ON* \$1 *OFF* デフォルト *オン* ### FORCE\$1CURL Windows のみ。`ON` の場合、デフォルトの [WinHTTP](https://msdn.microsoft.com/en-us/library/windows/desktop/aa382925%28v=vs.85%29.aspx) データ転送プロバイダーの代わりに curl クライアントの使用を適用します。 値 *ON* \$1 *OFF* デフォルト *オフ* ### FORCE\$1SHARED\$1CRT `ON` の場合、SDK は C ランタイムに*動的*にリンクされます。それ以外の場合は、*BUILD\$1SHARED\$1LIBS* 設定を使用します (SDK の以前のバージョンとの下位互換性に必要な場合があります)。 値 *ON* \$1 *OFF* デフォルト *オン* ### G Visual Studio ソリューションや Xcode プロジェクトなどのビルドアーティファクトを生成します。 Windows での例 ``` -G "Visual Studio 12 Win64" ``` 詳細については、使用中のプラットフォームに対応した CMake ドキュメントを参照してください。 ### MINIMIZE\$1SIZE [ENABLE\$1UNITY\$1BUILD](#cmake-enable-unity-build) の上位互換設定。`ON` の場合、*ENABLE\$1UNITY\$1BUILD* および追加のバイナリサイズ削減設定が有効になります。 値 *ON* \$1 *OFF* デフォルト *オフ* ### NO\$1ENCRYPTION `ON` の場合、デフォルトのプラットフォーム固有の暗号化実装がライブラリに組み込まれないようにします。独自の暗号化実装を組み込む場合は、この設定を *ON* にします。 値 *ON* \$1 *OFF* デフォルト *オフ* ### NO\$1HTTP\$1CLIENT `ON` の場合、デフォルトのプラットフォーム固有の HTTP クライアントがライブラリに組み込まれないようにします。*ON* の場合、独自のプラットフォーム固有の HTTP クライアント実装を提供する必要があります。 値 *ON* \$1 *OFF* デフォルト *オフ* ### REGENERATE\$1CLIENTS `ON` の場合、このパラメータでは生成されたすべてのコードが削除され、`code-generation/api-definitions` フォルダからクライアントディレクトリが再生成されます。例えば、次のようになります。 ``` -DREGENERATE_CLIENTS=1 ``` **注記** `REGENERATE_CLIENTS` パラメータを使用するには、[Python 2.7](https://www.python.org/downloads/)、Java ([JDK 1.8 以上](http://openjdk.java.net/install/))、[Maven](https://maven.apache.org/) がインストールされており、`PATH` に含まれている必要があります。 ### REGENERATE\$1DEFAULTS `ON` の場合、このパラメータでは生成されたすべてのデフォルトコードが削除され、`code-generation/defaults` フォルダから再生成されます。例えば、次のようになります。 ``` -DREGENERATE_DEFAULTS=1 ``` **注記** `REGENERATE_DEFAULTS` パラメータを使用するには、[Python 2.7](https://www.python.org/downloads/)、Java ([JDK 1.8 以上](http://openjdk.java.net/install/))、[Maven](https://maven.apache.org/) がインストールされており、`PATH` に含まれている必要があります。 ### SIMPLE\$1INSTALL `ON` の場合、インストールプロセスでは `bin/` と `lib/` 以下にプラットフォーム固有の中間ディレクトリは挿入されません。1 つのインストールディレクトリでマルチプラットフォーム向けリリースを作成する場合は、`OFF` に設定します。 値 *ON* \$1 *OFF* デフォルト *オン* ### TARGET\$1ARCH クロスコンパイルやモバイルプラットフォーム向けにビルドを行うには、ターゲットプラットフォームを指定する必要があります。デフォルトでは、ビルドはホストオペレーティングシステムを検出し、検出されたオペレーティングシステム向けにビルドします。 **注記** *TARGET\$1ARCH* が *ANDROID* の場合、追加のオプションを使用できます。「[Android CMake の変数とオプション](#cmake-android-variables)」を参照してください。 値 *WINDOWS* \$1 *LINUX* \$1 *APPLE* \$1 *ANDROID* ### USE\$1CRT\$1HTTP\$1CLIENT `ON` の場合、共通ランタイム HTTP クライアントが使用され、WinHttp や libcurl などのレガシーシステムはビルドも組み込みもされません。 値 *ON* \$1 *OFF* デフォルト *オフ* ### USE\$1IXML\$1HTTP\$1REQUEST\$12 Windows のみ。`ON` の場合、HTTP スタックに com オブジェクト IXmlHttpRequest2 を使用します。 値 *ON* \$1 *OFF* デフォルト *オフ* ### USE\$1OPENSSL の場合`ON`、SDK は OpenSSL を使用して構築されます。それ以外の場合は、 を使用します[https://github.com/awslabs/aws-lc](https://github.com/awslabs/aws-lc)。 AWS `AWS-LC`は、Cryptography チーム AWS とその顧客によって管理される汎用暗号化ライブラリです。このパラメータを `OFF` にすると、OpenSSL の代わりに `AWS-LC` がシステムのデフォルトディレクトリにインストールされます。既に OpenSSL がシステムにインストールされている場合、このオプションは使用しないでください。 値 *ON* \$1 *OFF* デフォルト *オン* ### USE\$1TLS\$1V1\$12 `ON` の場合、HTTP クライアントは TLS 1.2 を適用します。 値 *ON* \$1 *OFF* デフォルト *オン* ### USE\$1TLS\$1V1\$13 `ON` の場合、HTTP クライアントは TLS 1.3 を適用します。 値 *ON* \$1 *OFF* デフォルト *オフ* ## Android CMake の変数とオプション SDK の Android ビルドを作成する場合 ([TARGET\$1ARCH](#cmake-target-arch) を *ANDROID* に設定している場合) は、次の変数を使用します。 **Topics** + [ANDROID\$1ABI](#cmake-android-abi) + [ANDROID\$1BUILD\$1CURL](#cmake-ANDROID_BUILD_CURL) + [ANDROID\$1BUILD\$1OPENSSL](#cmake-ANDROID_BUILD_OPENSSL) + [ANDROID\$1BUILD\$1ZLIB](#cmake-ANDROID_BUILD_ZLIB) + [ANDROID\$1NATIVE\$1API\$1LEVEL](#cmake-android-native-api-level) + [ANDROID\$1STL](#cmake-android-stl) + [ANDROID\$1TOOLCHAIN\$1NAME](#cmake-android-toolchain-name) + [DISABLE\$1ANDROID\$1STANDALONE\$1BUILD](#cmake-disable-android-standalone-build) + [NDK\$1DIR](#cmake-ndk-dir) ### ANDROID\$1ABI Android のみ。どのアプリケーションバイナリインターフェイス (ABI) 向けにコードを出力するかを制御します。 **注記** 有効なすべての Android ABI 値が現在サポートされているわけではありません。 値 *arm64* \$1 *armeabi-v7a* \$1 *x86\$164* \$1 *x86* \$1 *mips64* \$1 *mips* デフォルト *armeabi-v7a* ### ANDROID\$1BUILD\$1CURL Android のみ。`ON` の場合、curl もビルドします。 値 *ON* \$1 *OFF* デフォルト *オン* ### ANDROID\$1BUILD\$1OPENSSL Android のみ。`ON` の場合、OpenSSL もビルドします。 値 *ON* \$1 *OFF* デフォルト *オン* ### ANDROID\$1BUILD\$1ZLIB Android のみ。`ON` の場合、Zlib もビルドします。 値 *ON* \$1 *OFF* デフォルト *オン* ### ANDROID\$1NATIVE\$1API\$1LEVEL Android のみ。SDK がビルド対象とする API レベルを制御します。[ANDROID\$1STL](#cmake-android-stl) を *gnustl* に設定した場合は、任意の API レベルを選択できます。*libc\$1\$1* を使用する場合は、*21* 以上の API レベルを使用する必要があります。 デフォルト STL の選択によって異なります。 ### ANDROID\$1STL Android のみ。SDK が使用する C\$1\$1 標準ライブラリの実装 (バリエーション) を指定します。 **重要** `gnustl` オプションを使用すると、SDK 内でパフォーマンスの問題が発生する可能性があります。*libc\$1\$1\$1shared* または *libc\$1\$1\$1static* を使用することを強くお勧めします。 値 *libc\$1\$1\$1shared* \$1 *libc\$1\$1\$1static* \$1 *gnustl\$1shared* \$1 *gnustl\$1static* デフォルト *libc\$1\$1\$1shared* ### ANDROID\$1TOOLCHAIN\$1NAME Android のみ。SDK のビルドに使用されるコンパイラを制御します。 **注記** Android NDK では GCC が廃止となっているため、デフォルト値を使用することをお勧めします。 デフォルト *standalone-clang* ### DISABLE\$1ANDROID\$1STANDALONE\$1BUILD Android のみ。デフォルトでは、Android ビルドは NDK スクリプトによってコンストラクトされるスタンドアロンの clang ベースツールチェーンを使用します。独自のツールチェーンを使用するには、このオプションを *ON* にします。 値 *ON* \$1 *OFF* デフォルト *オフ* ### NDK\$1DIR Android のみ。ビルドシステムが Android NDK を検索する必要のあるオーバーライドパスを指定します。この変数を設定しない場合、ビルドシステムはデフォルトで環境変数 (`ANDROID_NDK`) を参照します。