Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# CMake parameter untuk membangun AWS SDK untuk C\$1\$1
Gunakan [CMake](https://cmake.org/)parameter yang tercantum di bagian ini untuk menyesuaikan cara pembuatan SDK Anda.
Anda dapat mengatur opsi ini dengan alat CMake GUI atau baris perintah dengan menggunakan *-D*. Sebagai contoh:
```
cmake -DENABLE_UNITY_BUILD=ON -DREGENERATE_CLIENTS=1
```
## CMake Variabel dan Opsi Umum
Berikut ini adalah **`cmake`**variabel umum dan opsi yang memengaruhi proses pembuatan kode sumber SDK.
**catatan**
Gunakan parameter ini saat membuat kode sumber SDK untuk SDK for C\$1\$1 itu sendiri.
**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\$1WILAYAH](#cmake-AWS_TEST_REGION)
+ [BUILD\$1BENCHMARK](#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\$1STANDAR](#cmake-cpp-standard)
+ [CURL\$1INCLUDE\$1DIR](#cmake-curl-include-dir)
+ [CURL\$1LIBRARY](#cmake-curl-library)
+ [CUSTOM\$1MEMORY\$1MANAGEMENT](#cmake-custom-memory-management)
+ [IMDSV1NONAKTIFKAN\$1INTERNAL\$1 \$1PANGGILAN](#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)
+ [MINIMALI\$1SIZE](#cmake-minimize-size)
+ [NO\$1ENKRIPSI](#cmake-no-encryption)
+ [NO\$1HTTP\$1KLIEN](#cmake-no-http-client)
+ [REGENERATE\$1CLIENTS](#cmake-regenerate-clients)
+ [REGENERATE\$1DEFAULTS](#cmake-regenerate-defaults)
+ [SIMPLE\$1INSTALL](#cmake-simple-install)
+ [TARGET\$1ARCH](#cmake-target-arch)
+ [GUNAKAN\$1CRT\$1HTTP\$1CLIENT](#cmake-USE_CRT_HTTP_CLIENT)
+ [GUNAKAN\$1IXML\$1HTTP\$1REQUEST\$12](#cmake-USE_IXML_HTTP_REQUEST_2)
+ [GUNAKAN\$1OPENSSL](#cmake-use-openssl)
+ [GUNAKAN\$1TLS\$1V1\$12](#cmake-USE_TLS_V1_2)
+ [GUNAKAN\$1TLS\$1V1\$13](#cmake-USE_TLS_V1_3)
### ADD\$1CUSTOM\$1CLIENTS
Membangun klien arbitrer berdasarkan definisi API. Tempatkan definisi Anda di `code-generation/api-definitions` folder, dan kemudian berikan argumen ini ke **`cmake`**. Langkah **`cmake`**konfigurasi menghasilkan klien Anda dan menyertakannya sebagai subdirektori di build Anda. Ini sangat berguna untuk menghasilkan klien C\$1\$1 untuk menggunakan salah satu layanan [API Gateway](https://aws.amazon.com/api-gateway) Anda. Contoh:
```
-DADD_CUSTOM_CLIENTS="serviceName=myCustomService,version=2015-12-21;serviceName=someOtherService,version=2015-08-15"
```
**catatan**
[Untuk menggunakan `ADD_CUSTOM_CLIENTS` parameter, Anda harus memiliki [Python 2.7](https://www.python.org/downloads/), Java ([JDK 1.8\$1](http://openjdk.java.net/install/)), dan Maven diinstal dan di.](https://maven.apache.org/) `PATH`
### AUTORUN\$1UNIT\$1TESTS
Jika`ON`, jalankan pengujian unit secara otomatis setelah membangun.
Nilai
*AKTIF* \$1 *MATI*
Default
*PADA*
### AWS\$1AUTORUN\$1LD\$1LIBRARY\$1PATH
Jalur untuk ditambahkan ke LD\$1LIBRARY\$1PATH untuk pengujian unit autorun oleh. CMake Tetapkan jalur ini jika pustaka runtime kustom diperlukan untuk dependensi yang diganti.
Nilai
*Tali.*
Default
*N/A*
### AWS\$1SDK\$1WARNINGS\$1ARE\$1ERRORS
Jika`ON`, perlakukan peringatan kompiler sebagai kesalahan. Coba putar ini `OFF` jika mengamati kesalahan pada kompiler baru atau yang tidak biasa.
Nilai
*AKTIF* \$1 *MATI*
Default
*PADA*
### AWS\$1USE\$1CRYPTO\$1SHARED\$1LIBS
FindCrypto Paksa untuk menggunakan pustaka kripto bersama jika ditemukan. Ubah ini `OFF` untuk menggunakan [BUILD\$1SHARED\$1LIBS](#cmake-build-shared-libs) pengaturan sebagai gantinya.
Nilai
*AKTIF* \$1 *MATI*
Default
*MATI*
### AWS\$1TEST\$1WILAYAH
Yang digunakan Wilayah AWS untuk tes integrasi.
Nilai
*Tali.*
Default
*N/A*
### BUILD\$1BENCHMARK
Jika`ON`, buat benchmark yang dapat dieksekusi.
Nilai
*AKTIF* \$1 *MATI*
Default
*MATI*
### BUILD\$1DEPS
Jika`ON`, buat dependensi pihak ketiga.
Nilai
*AKTIF* \$1 *MATI*
Default
*PADA*
### BUILD\$1ONLY
Membangun hanya klien yang ingin Anda gunakan. Jika disetel ke SDK tingkat tinggi seperti`aws-cpp-sdk-transfer`, *BUILD\$1ONLY* menyelesaikan dependensi klien tingkat rendah apa pun. Ini juga membangun integrasi dan pengujian unit yang terkait dengan proyek yang Anda pilih, jika ada. Ini adalah argumen daftar, dengan nilai dipisahkan oleh karakter titik koma ()`;`. Contoh:
```
-DBUILD_ONLY="s3;cognito-identity"
```
**catatan**
Modul SDK inti,`aws-sdk-cpp-core`, *selalu* dibangun, terlepas dari nilai parameter *BUILD\$1ONLY*.
### BUILD\$1OPTEL
Jika`ON`, membangun implementasi telemetri terbuka dari tracing.
Nilai
*AKTIF* \$1 *MATI*
Default
*MATI*
### BUILD\$1SHARED\$1LIBS
CMake Opsi bawaan, diekspos ulang di sini untuk visibilitas. Jika`ON`, itu membangun pustaka bersama; jika tidak, itu hanya membangun pustaka statis.
**catatan**
Untuk menautkan secara dinamis ke SDK, Anda harus menentukan `USE_IMPORT_EXPORT` simbol untuk semua target build menggunakan SDK.
Nilai
*AKTIF* \$1 *MATI*
Default
*PADA*
### BYPASS\$1DEFAULT\$1PROXY
Jika`ON`, lewati pengaturan proxy default mesin saat menggunakan IXml HttpRequest 2.
Nilai
*AKTIF* \$1 *MATI*
Default
*PADA*
### CPP\$1STANDAR
Menentukan standar C \$1\$1 kustom untuk digunakan dengan C \$1\$1 14 dan 17 basis kode.
Nilai
*11* \$1 *14* \$1 *17*
Default
*11*
### CURL\$1INCLUDE\$1DIR
Path to curl termasuk direktori yang berisi `libcurl` header.
Nilai
*Jalur string ke `include` direktori yang dipilih. Misalnya,`D:/path/to/dir/with/curl/include`.*
Default
*N/A*
### CURL\$1LIBRARY
Jalur ke curl file perpustakaan untuk ditautkan. Pustaka ini dapat berupa pustaka statis atau pustaka impor, tergantung pada kebutuhan aplikasi Anda.
Nilai
*Jalur string ke file perpustakaan curl. Misalnya,`D:/path/to/static/libcur/file/ie/libcurl.lib.a`.*
Default
*N/A*
### CUSTOM\$1MEMORY\$1MANAGEMENT
Untuk menggunakan pengelola memori khusus, atur nilainya ke`1`. Anda dapat menginstal pengalokasi khusus sehingga semua jenis STL menggunakan antarmuka alokasi kustom. Jika Anda menetapkan nilainya`0`, Anda mungkin masih ingin menggunakan jenis template STL untuk membantu keamanan DLL di Windows.
*Jika penautan statis adalah`ON`, manajemen memori kustom default ke off ().* `0` Jika penautan dinamis`ON`, manajemen memori kustom default ke *on* (`1`) dan menghindari alokasi dan deallokasi lintas-DLL.
**catatan**
Untuk mencegah kesalahan ketidakcocokan tautan, Anda harus menggunakan nilai (`0`atau`1`) yang sama di seluruh sistem build Anda.
Untuk menginstal manajer memori Anda sendiri untuk menangani alokasi yang dibuat oleh SDK, Anda harus menetapkan `-DCUSTOM_MEMORY_MANAGEMENT` dan menentukan `USE_AWS_MEMORY_MANAGEMENT` semua target build yang bergantung pada SDK.
### IMDSV1NONAKTIFKAN\$1INTERNAL\$1 \$1PANGGILAN
Jika`ON`, tidak ada panggilan internal yang dilakukan ke API V1 dari Layanan [Metadata Instance](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html). Jika`OFF`, IMDSv2 panggilan akan mundur ke penggunaan IMDSv1 jika IMDSv2 panggilan gagal. *Untuk informasi selengkapnya tentang IMDSv1 dan IMDSv2, lihat [Menggunakan Layanan Metadata Instans untuk mengakses metadata instans di Panduan Pengguna](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/configuring-instance-metadata-service.html) Amazon EC2.*
Nilai
*AKTIF* \$1 *MATI*
Default
*MATI*
### ENABLE\$1ADDRESS\$1SANITIZER
Jika`ON`, nyalakan Address Sanitizer untuk gcc atau clang.
Nilai
*AKTIF* \$1 *MATI*
Default
*MATI*
### ENABLE\$1CURL\$1LOGGING
Jika`ON`, pipa log internal untuk curl ke logger SDK.
Nilai
*AKTIF* \$1 *MATI*
Default
*MATI*
### ENABLE\$1HTTP\$1CLIENT\$1TESTING
Jika`ON`, buat dan jalankan suite pengujian klien HTTP yang sesuai.
Nilai
*AKTIF* \$1 *MATI*
Default
*MATI*
### ENABLE\$1RTTI
Mengontrol apakah SDK dibuat untuk mengaktifkan informasi tipe run-time (RTTI).
Nilai
*AKTIF* \$1 *MATI*
Default
*PADA*
### ENABLE\$1TESTING
Mengontrol apakah proyek pengujian unit dan integrasi dibangun selama pembuatan SDK.
Nilai
*AKTIF* \$1 *MATI*
Default
*PADA*
### ENABLE\$1UNITY\$1BUILD
Jika`ON`, sebagian besar pustaka SDK dibangun sebagai file tunggal yang dihasilkan`.cpp`. Ini dapat secara signifikan mengurangi ukuran perpustakaan statis dan mempercepat waktu kompilasi.
Nilai
*AKTIF* \$1 *MATI*
Default
*MATI*
### ENABLE\$1VIRTUAL\$1OPERATIONS
Parameter ini biasanya bekerja sama dengan `REGENERATE_CLIENTS` untuk pembuatan kode.
Jika `ENABLE_VIRTUAL_OPERATIONS` ada `ON` dan `REGENERATE_CLIENTS` sedang`ON`, fungsi terkait operasi di klien layanan akan ditandai sebagai. `virtual`
Jika `ENABLE_VIRTUAL_OPERATIONS` ada `OFF` dan `REGENERATE_CLIENTS` sedang`ON`, `virtual` tidak akan ditambahkan ke fungsi operasi dan kelas klien layanan akan ditandai sebagai`final`.
Jika `ENABLE_VIRTUAL_OPERATIONS` ya`OFF`, SDK juga akan menambahkan `-ffunction-sections` dan `-fdata-sections` mengkompilasi flag untuk gcc dan clang saat mengkompilasi.
Untuk informasi selengkapnya, lihat [CMake Parameter](https://github.com/aws/aws-sdk-cpp/blob/main/docs/CMake_Parameters.md#enable_virtual_operations) di GitHub.
Nilai
*AKTIF* \$1 *MATI*
Default
*PADA*
### ENABLE\$1ZLIB\$1REQUEST\$1COMPRESSION
Untuk layanan yang mendukungnya, konten permintaan akan dikompresi. Aktif secara default jika ketergantungan tersedia.
Nilai
*AKTIF* \$1 *MATI*
Default
*PADA*
### FORCE\$1CURL
Hanya Windows. Jika`ON`, memaksa penggunaan klien curl alih-alih penyedia transfer data [WinHTTP](https://msdn.microsoft.com/en-us/library/windows/desktop/aa382925%28v=vs.85%29.aspx) default.
Nilai
*AKTIF* \$1 *MATI*
Default
*MATI*
### FORCE\$1SHARED\$1CRT
Jika`ON`, SDK menautkan ke runtime C *secara dinamis*; jika tidak, SDK menggunakan pengaturan *BUILD\$1SHARED\$1LIBS* (terkadang diperlukan untuk kompatibilitas mundur dengan versi SDK sebelumnya).
Nilai
*AKTIF* \$1 *MATI*
Default
*PADA*
### G
Menghasilkan artefak build, seperti solusi Visual Studio dan proyek Xcode.
Misalnya, pada Windows:
```
-G "Visual Studio 12 Win64"
```
Untuk informasi selengkapnya, lihat CMake dokumentasi untuk platform Anda.
### MINIMALI\$1SIZE
Sebuah superset dari [ENABLE\$1UNITY\$1BUILD](#cmake-enable-unity-build). Jika`ON`, opsi ini *mengaktifkan ENABLE\$1UNITY\$1BUILD* dan pengaturan pengurangan ukuran biner tambahan.
Nilai
*AKTIF* \$1 *MATI*
Default
*MATI*
### NO\$1ENKRIPSI
Jika`ON`, mencegah implementasi kriptografi khusus platform default dibangun ke dalam perpustakaan. *Nyalakan ini untuk menyuntikkan implementasi kriptografi Anda sendiri.*
Nilai
*AKTIF* \$1 *MATI*
Default
*MATI*
### NO\$1HTTP\$1KLIEN
Jika`ON`, mencegah klien HTTP khusus platform default dibangun ke dalam perpustakaan. Jika *ON*, Anda perlu menyediakan implementasi klien HTTP khusus platform Anda sendiri.
Nilai
*AKTIF* \$1 *MATI*
Default
*MATI*
### REGENERATE\$1CLIENTS
Jika`ON`, parameter ini menghapus semua kode yang dihasilkan dan menghasilkan direktori klien dari folder. `code-generation/api-definitions` Contoh:
```
-DREGENERATE_CLIENTS=1
```
**catatan**
[Untuk menggunakan `REGENERATE_CLIENTS` parameter, Anda harus memiliki [Python 2.7](https://www.python.org/downloads/), Java ([JDK 1.8\$1](http://openjdk.java.net/install/)), dan Maven diinstal dan di.](https://maven.apache.org/) `PATH`
### REGENERATE\$1DEFAULTS
Jika`ON`, parameter ini menghapus semua kode default yang dihasilkan dan menghasilkannya lagi dari folder. `code-generation/defaults` Contoh:
```
-DREGENERATE_DEFAULTS=1
```
**catatan**
[Untuk menggunakan `REGENERATE_DEFAULTS` parameter, Anda harus memiliki [Python 2.7](https://www.python.org/downloads/), Java ([JDK 1.8\$1](http://openjdk.java.net/install/)), dan Maven diinstal dan di.](https://maven.apache.org/) `PATH`
### SIMPLE\$1INSTALL
Jika`ON`, proses instalasi tidak menyisipkan direktori perantara khusus platform di bawahnya dan. `bin/` `lib/` Putar `OFF` jika Anda perlu membuat rilis multiplatform di bawah satu direktori instalasi.
Nilai
*AKTIF* \$1 *MATI*
Default
*PADA*
### TARGET\$1ARCH
Untuk mengkompilasi silang atau membangun platform seluler, Anda harus menentukan platform target. Secara default, build mendeteksi sistem operasi host dan membangun untuk sistem operasi yang terdeteksi.
**catatan**
Ketika *TARGET\$1ARCH* adalah *ANDROID*, opsi tambahan tersedia. Lihat [ CMake Variabel dan Opsi Android](#cmake-android-variables).
Nilai
*WINDOWS* \$1 *LINUX* \$1 *APPLE* \$1 *ANDROID*
### GUNAKAN\$1CRT\$1HTTP\$1CLIENT
Jika`ON`, gunakan klien HTTP runtime umum, dan sistem lama seperti WinHttp dan libcurl tidak dibangun atau disertakan.
Nilai
*AKTIF* \$1 *MATI*
Default
*MATI*
### GUNAKAN\$1IXML\$1HTTP\$1REQUEST\$12
Hanya Windows. Jika`ON`, gunakan objek com IXml HttpRequest 2 untuk tumpukan HTTP.
Nilai
*AKTIF* \$1 *MATI*
Default
*MATI*
### GUNAKAN\$1OPENSSL
Jika`ON`, SDK dibangun menggunakan OpenSSL; jika tidak, ia menggunakan. [https://github.com/awslabs/aws-lc](https://github.com/awslabs/aws-lc) `AWS-LC`adalah perpustakaan kriptografi tujuan umum yang dikelola oleh tim AWS Kriptografi untuk AWS dan pelanggan mereka. `OFF`Mengubah parameter diinstal `AWS-LC` sebagai pengganti OpenSSL di direktori default sistem. Jangan gunakan jika Anda sudah memiliki instalasi OpenSSL di sistem Anda.
Nilai
*AKTIF* \$1 *MATI*
Default
*PADA*
### GUNAKAN\$1TLS\$1V1\$12
Jika`ON`, klien HTTP memberlakukan TLS 1.2.
Nilai
*AKTIF* \$1 *MATI*
Default
*PADA*
### GUNAKAN\$1TLS\$1V1\$13
Jika`ON`, klien HTTP memberlakukan TLS 1.3.
Nilai
*AKTIF* \$1 *MATI*
Default
*MATI*
## CMake Variabel dan Opsi Android
*Gunakan variabel berikut saat Anda membuat build Android SDK (saat [TARGET\$1ARCH](#cmake-target-arch) disetel ke 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\$1 API\$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
Hanya Android. Mengontrol Application Binary Interface (ABI) mana yang akan menampilkan kode.
**catatan**
Tidak semua nilai Android ABI yang valid saat ini didukung.
Nilai
*arm64* ****\$1 *armeabi-v7a* \$1 x86\$164 \$1 x86 \$1 mips64 \$1 mips****
Default
*armeabi-v7a*
### ANDROID\$1BUILD\$1CURL
Hanya Android. Jika`ON`, buat ikal juga.
Nilai
*AKTIF* \$1 *MATI*
Default
*PADA*
### ANDROID\$1BUILD\$1OPENSSL
Hanya Android. Jika`ON`, buat Openssl juga.
Nilai
*AKTIF* \$1 *MATI*
Default
*PADA*
### ANDROID\$1BUILD\$1ZLIB
Hanya Android. Jika`ON`, bangun Zlib juga.
Nilai
*AKTIF* \$1 *MATI*
Default
*PADA*
### ANDROID\$1NATIVE\$1 API\$1LEVEL
Hanya Android. Mengontrol level API apa yang dibuat SDK. Jika Anda menyetel [ANDROID\$1STL ke *gnustl*](#cmake-android-stl), Anda dapat memilih API level apa pun. *Jika Anda menggunakan *libc\$1\$1*, Anda harus menggunakan API level minimal 21.*
Default
Bervariasi berdasarkan pilihan STL.
### ANDROID\$1STL
Hanya Android. Mengontrol ragam apa dari pustaka standar C \$1\$1 yang digunakan SDK.
**penting**
*Masalah kinerja dapat terjadi dalam SDK jika `gnustl` opsi digunakan; kami sangat menyarankan menggunakan *libc\$1\$1\$1shared atau libc\$1\$1\$1static*.*
Nilai
****libc\$1\$1\$1shared \$1 libc\$1\$1\$1static \$1 gnustl\$1shared \$1 gnustl\$1static****
Default
*libc\$1\$1\$1dibagikan*
### ANDROID\$1TOOLCHAIN\$1NAME
Hanya Android. Mengontrol kompiler mana yang digunakan untuk membangun SDK.
**catatan**
Dengan GCC yang tidak digunakan lagi oleh Android NDK, sebaiknya gunakan nilai default.
Default
*dentang standar*
### DISABLE\$1ANDROID\$1STANDALONE\$1BUILD
Hanya Android. Secara default, build Android menggunakan toolchain berbasis clang mandiri yang dibuat melalui skrip NDK. *Untuk menggunakan toolchain Anda sendiri, aktifkan opsi ini.*
Nilai
*AKTIF* \$1 *MATI*
Default
*MATI*
### NDK\$1DIR
Hanya Android. Menentukan jalur penggantian tempat sistem build harus menemukan Android NDK. Secara default, sistem build memeriksa variabel lingkungan (`ANDROID_NDK`) jika variabel ini tidak disetel.