Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# CMake parametri per la costruzione del AWS SDK per C\$1\$1
Usa i [CMake](https://cmake.org/)parametri elencati in questa sezione per personalizzare la modalità di compilazione del tuo SDK.
*Puoi impostare queste opzioni con gli strumenti della CMake GUI o la riga di comando usando -D.* Ad esempio:
```
cmake -DENABLE_UNITY_BUILD=ON -DREGENERATE_CLIENTS=1
```
## CMake Variabili e opzioni generali
Di seguito sono riportate le **`cmake`**variabili e le opzioni generali che influiscono sul processo di compilazione del codice sorgente SDK.
**Nota**
Utilizzate questi parametri quando create il codice sorgente SDK per l'SDK for C\$1\$1 stesso.
**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\$1AVVERTENZE\$1SONO\$1ERRORI](#cmake-AWS_SDK_WARNINGS_ARE_ERRORS)
+ [AWS\$1USE\$1CRYPTO\$1SHARED\$1LIBS](#cmake-use-crypto)
+ [AWS\$1TEST\$1REGIONE](#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)
+ [GESTIONE DELLA MEMORIA PERSONALIZZATA](#cmake-custom-memory-management)
+ [IMDSV1DISABILITA\$1INTERNAL\$1 \$1CHIAMATE](#cmake-DISABLE_INTERNAL_IMDSV1_CALLS)
+ [ABILITARE\$1ADDRESS\$1SANITIZER](#cmake-ENABLE_ADDRESS_SANITIZER)
+ [ABILITARE\$1CURL\$1LOGGING](#cmake-enable-curl-logging)
+ [ABILITARE\$1HTTP\$1CLIENT\$1TESTING](#cmake-ENABLE_HTTP_CLIENT_TESTING)
+ [ABILITA\$1RTTI](#cmake-enable-rtti)
+ [ABILITARE\$1TEST](#cmake-enable-testing)
+ [ABILITA\$1UNITY\$1BUILD](#cmake-enable-unity-build)
+ [ABILITARE\$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\$1CRITTOGRAFIA](#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)
+ [USA CRT\$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
Crea qualsiasi client arbitrario in base alla definizione dell'API. Inserisci la tua definizione nella `code-generation/api-definitions` cartella, quindi passa questo argomento a. **`cmake`** La fase di **`cmake`**configurazione genera il client e lo include come sottodirectory nella build. Ciò è particolarmente utile per generare un client C\$1\$1 per l'utilizzo di uno dei servizi [API Gateway](https://aws.amazon.com/api-gateway). Esempio:
```
-DADD_CUSTOM_CLIENTS="serviceName=myCustomService,version=2015-12-21;serviceName=someOtherService,version=2015-08-15"
```
**Nota**
[Per utilizzare il `ADD_CUSTOM_CLIENTS` parametro, devi avere [Python 2.7](https://www.python.org/downloads/), Java ([JDK 1.8\$1](http://openjdk.java.net/install/)) e Maven installati e nel tuo.](https://maven.apache.org/) `PATH`
### AUTORUN\$1UNIT\$1TESTS
Se`ON`, esegui i test unitari automaticamente dopo la creazione.
Valori
*ATTIVATO* \$1 *DISATTIVATO*
Predefinita
*ACCESO*
### AWS\$1AUTORUN\$1LD\$1LIBRARY\$1PATH
Il percorso da aggiungere a LD\$1LIBRARY\$1PATH per i test unitari eseguiti automaticamente. CMake Imposta questo percorso se sono necessarie librerie di runtime personalizzate per le dipendenze sostituite.
Valori
*Stringa.*
Predefinita
*N/D*
### AWS\$1SDK\$1AVVERTENZE\$1SONO\$1ERRORI
Se`ON`, considera gli avvisi del compilatore come errori. Prova ad attivarlo `OFF` se osservi errori su un compilatore nuovo o non comune.
Valori
**ATTIVATO \$1 DISATTIVATO**
Predefinita
*ACCESO*
### AWS\$1USE\$1CRYPTO\$1SHARED\$1LIBS
Forza l'uso di una libreria crittografica FindCrypto condivisa, se trovata. Attivala invece `OFF` per usare [BUILD\$1SHARED\$1LIBS](#cmake-build-shared-libs) l'impostazione.
Valori
*ATTIVATO* \$1 *DISATTIVATO*
Predefinita
*SPENTO*
### AWS\$1TEST\$1REGIONE
Regione AWS Da usare per i test di integrazione.
Valori
*Stringa.*
Predefinita
*N/D*
### BUILD\$1BENCHMARKS
Se`ON`, crea l'eseguibile del benchmark.
Valori
**ATTIVATO \$1 DISATTIVATO**
Predefinita
*SPENTO*
### BUILD\$1DEPS
Se`ON`, crea dipendenze di terze parti.
Valori
**ATTIVATO \$1 DISATTIVATO**
Predefinita
*ACCESO*
### BUILD\$1ONLY
Crea solo i client che desideri utilizzare. Se impostato su un SDK di alto livello come *BUILD\$1ONLY* risolve tutte le `aws-cpp-sdk-transfer` dipendenze dei client di basso livello. Inoltre, crea test di integrazione e unitari relativi ai progetti selezionati, se esistono. Si tratta di un argomento a elenco, con valori separati da caratteri punto e virgola ()`;`. Esempio:
```
-DBUILD_ONLY="s3;cognito-identity"
```
**Nota**
*Il modulo SDK principale viene *sempre* creato`aws-sdk-cpp-core`, indipendentemente dal valore del parametro BUILD\$1ONLY.*
### BUILD\$1OPTEL
If`ON`, crea l'implementazione telemetrica aperta del tracciamento.
Valori
**ATTIVATO* \$1 DISATTIVATO*
Predefinita
*SPENTO*
### BUILD\$1SHARED\$1LIBS
Un'opzione integrata CMake , riesposta qui per motivi di visibilità. Se`ON`, crea librerie condivise; in caso contrario, crea solo librerie statiche.
**Nota**
Per collegarti dinamicamente all'SDK, devi definire il `USE_IMPORT_EXPORT` simbolo per tutti gli obiettivi di build utilizzando l'SDK.
Valori
**ATTIVATO \$1 DISATTIVATO**
Predefinita
*ACCESO*
### BYPASS\$1DEFAULT\$1PROXY
Se`ON`, ignora le impostazioni proxy predefinite della macchina quando usi 2. IXml HttpRequest
Valori
**ATTIVATO \$1 DISATTIVATO**
Predefinita
*ACCESO*
### CPP\$1STANDARD
Specifica uno standard C\$1\$1 personalizzato da utilizzare con le basi di codice C\$1\$1 14 e 17.
Valori
*11 \$1 14* **\$1 17**
Predefinita
*11*
### CURL\$1INCLUDE\$1DIR
Il percorso di curl include la cartella contenente le intestazioni. `libcurl`
Valori
*Percorso della stringa alla directory selezionata`include`. Ad esempio,`D:/path/to/dir/with/curl/include`.*
Predefinita
*N/D*
### CURL\$1LIBRARY
Percorso del file della libreria curl a cui collegarsi. Questa libreria può essere una libreria statica o una libreria di importazione, a seconda delle esigenze dell'applicazione.
Valori
*Percorso della stringa al file della libreria curl. Ad esempio,`D:/path/to/static/libcur/file/ie/libcurl.lib.a`.*
Predefinita
*N/D*
### GESTIONE DELLA MEMORIA PERSONALIZZATA
Per utilizzare un gestore di memoria personalizzato, imposta il valore su. `1` È possibile installare un allocatore personalizzato in modo che tutti i tipi STL utilizzino l'interfaccia di allocazione personalizzata. Se imposti il valore`0`, potresti comunque voler utilizzare i tipi di modello STL per facilitare la sicurezza delle DLL in Windows.
*Se il collegamento statico è attivo`ON`, la gestione della memoria personalizzata è predefinita su off ().* `0` Se il collegamento dinamico è attivo`ON`, la gestione della memoria personalizzata è predefinita su *on* (`1`) ed evita l'allocazione e la deallocazione tra DLL.
**Nota**
Per evitare errori di mancata corrispondenza dei linker, è necessario utilizzare lo stesso valore (o) in tutto il sistema di compilazione. `0` `1`
Per installare il proprio gestore di memoria per gestire le allocazioni effettuate dall'SDK, è necessario impostare `-DCUSTOM_MEMORY_MANAGEMENT` e definire `USE_AWS_MEMORY_MANAGEMENT` per tutti gli obiettivi di build che dipendono dall'SDK.
### IMDSV1DISABILITA\$1INTERNAL\$1 \$1CHIAMATE
[In caso contrario`ON`, non vengono effettuate chiamate interne all'API V1 dell'Instance Metadata Service.](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html) Se`OFF`, IMDSv2 le chiamate torneranno a essere utilizzate IMDSv1 se la IMDSv2 chiamata fallisce. Per ulteriori informazioni su IMDSv1 e IMDSv2, consulta [Use the Instance Metadata Service per accedere ai metadati dell'istanza](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/configuring-instance-metadata-service.html) nella *Amazon EC2* User Guide.
Valori
**ATTIVATO \$1 DISATTIVATO**
Predefinita
*SPENTO*
### ABILITARE\$1ADDRESS\$1SANITIZER
Se`ON`, attiva Address Sanitizer per gcc o clang.
Valori
**ATTIVATO \$1 DISATTIVATO**
Predefinita
*SPENTO*
### ABILITARE\$1CURL\$1LOGGING
Se`ON`, reindirizza il log interno di curl al logger SDK.
Valori
**ATTIVATO \$1 DISATTIVATO**
Predefinita
*SPENTO*
### ABILITARE\$1HTTP\$1CLIENT\$1TESTING
Se`ON`, crea ed esegui le suite di test dei client HTTP corrispondenti.
Valori
*ATTIVATO* \$1 *DISATTIVATO*
Predefinita
*SPENTO*
### ABILITA\$1RTTI
Controlla se l'SDK è progettato per abilitare le informazioni sul tipo di runtime (RTTI).
Valori
**ATTIVATO \$1 DISATTIVATO**
Predefinita
*ACCESO*
### ABILITARE\$1TEST
Controlla se i progetti di unit test e di integrazione vengono creati durante la compilazione dell'SDK.
Valori
**ATTIVATO \$1 DISATTIVATO**
Predefinita
*ACCESO*
### ABILITA\$1UNITY\$1BUILD
Se`ON`, la maggior parte delle librerie SDK sono create come un unico file generato. `.cpp` Ciò può ridurre significativamente le dimensioni della libreria statica e accelerare i tempi di compilazione.
Valori
**ATTIVATO \$1 DISATTIVATO**
Predefinita
*SPENTO*
### ABILITARE\$1VIRTUAL\$1OPERATIONS
Questo parametro di solito funziona insieme alla generazione di codice. `REGENERATE_CLIENTS`
Se `ENABLE_VIRTUAL_OPERATIONS` è `ON` ed `REGENERATE_CLIENTS` è`ON`, le funzioni relative al funzionamento nei client di servizio verranno contrassegnate come. `virtual`
Se `ENABLE_VIRTUAL_OPERATIONS` è `OFF` ed `REGENERATE_CLIENTS` è`ON`, `virtual` non verrà aggiunto alle funzioni operative e le classi client di servizio verranno contrassegnate come. `final`
In caso `ENABLE_VIRTUAL_OPERATIONS` `OFF` affermativo, l'SDK aggiungerà `-ffunction-sections` e `-fdata-sections` compilerà anche i flag per gcc e clang durante la compilazione.
[Per ulteriori informazioni, consulta Parameters on. CMake ](https://github.com/aws/aws-sdk-cpp/blob/main/docs/CMake_Parameters.md#enable_virtual_operations) GitHub
Valori
*ATTIVATO* \$1 *DISATTIVATO*
Predefinita
*ACCESO*
### ENABLE\$1ZLIB\$1REQUEST\$1COMPRESSION
Per i servizi che lo supportano, il contenuto della richiesta verrà compresso. Attiva per impostazione predefinita se la dipendenza è disponibile.
Valori
**ATTIVATO \$1 DISATTIVATO**
Predefinita
*ACCESO*
### FORCE\$1CURL
Solo per Windows. If`ON`, impone l'utilizzo del client curl anziché del provider di trasferimento dati [WinHTTP](https://msdn.microsoft.com/en-us/library/windows/desktop/aa382925%28v=vs.85%29.aspx) predefinito.
Valori
**ATTIVATO \$1 DISATTIVATO**
Predefinita
*SPENTO*
### FORCE\$1SHARED\$1CRT
Se`ON`, l'SDK si collega al runtime C in *modo dinamico*; in caso contrario, utilizza l'impostazione *BUILD\$1SHARED\$1LIBS* (a volte necessaria per la compatibilità con le versioni precedenti dell'SDK).
Valori
**ATTIVATO \$1 DISATTIVATO**
Predefinita
*ACCESO*
### G
Genera elementi di compilazione, come soluzioni Visual Studio e progetti Xcode.
Ad esempio, su Windows:
```
-G "Visual Studio 12 Win64"
```
Per ulteriori informazioni, consulta la CMake documentazione della piattaforma in uso.
### MINIMIZE\$1SIZE
[Un superset di ENABLE\$1UNITY\$1BUILD.](#cmake-enable-unity-build) Se`ON`, questa opzione attiva ENABLE\$1UNITY\$1BUILD e impostazioni aggiuntive di riduzione delle dimensioni *binarie*.
Valori
**ATTIVATO* \$1 DISATTIVATO*
Predefinita
*SPENTO*
### NO\$1CRITTOGRAFIA
If`ON`, impedisce che l'implementazione crittografica predefinita specifica della piattaforma venga incorporata nella libreria. *Attiva questa opzione per inserire la tua implementazione crittografica.*
Valori
**ATTIVATO \$1 DISATTIVATO**
Predefinita
*SPENTO*
### NO\$1HTTP\$1CLIENT
Se`ON`, impedisce che il client HTTP predefinito specifico della piattaforma venga integrato nella libreria. *Se attivo, sarà necessario fornire l'implementazione del client HTTP specifica per la piattaforma.*
Valori
**ATTIVATO \$1 DISATTIVATO**
Predefinita
*SPENTO*
### REGENERATE\$1CLIENTS
Se`ON`, questo parametro elimina tutto il codice generato e genera le directory dei client dalla cartella. `code-generation/api-definitions` Esempio:
```
-DREGENERATE_CLIENTS=1
```
**Nota**
[Per utilizzare il `REGENERATE_CLIENTS` parametro, devi avere [Python 2.7](https://www.python.org/downloads/), Java ([JDK 1.8\$1](http://openjdk.java.net/install/)) e Maven installati e nel tuo.](https://maven.apache.org/) `PATH`
### REGENERATE\$1DEFAULTS
Se`ON`, questo parametro elimina tutto il codice predefinito generato e lo genera nuovamente dalla cartella. `code-generation/defaults` Esempio:
```
-DREGENERATE_DEFAULTS=1
```
**Nota**
[Per utilizzare il `REGENERATE_DEFAULTS` parametro, devi avere [Python 2.7](https://www.python.org/downloads/), Java ([JDK 1.8\$1](http://openjdk.java.net/install/)) e Maven installati e nel tuo.](https://maven.apache.org/) `PATH`
### SIMPLE\$1INSTALL
Se`ON`, il processo di installazione non inserisce le directory intermedie specifiche della piattaforma sotto e. `bin/` `lib/` Attiva `OFF` se devi creare versioni multipiattaforma in un'unica directory di installazione.
Valori
**ATTIVATO \$1 DISATTIVATO**
Predefinita
*ACCESO*
### TARGET\$1ARCH
Per eseguire la compilazione incrociata o la creazione per una piattaforma mobile, devi specificare la piattaforma di destinazione. Per impostazione predefinita, la build rileva il sistema operativo host e crea per il sistema operativo rilevato.
**Nota**
Quando *TARGET\$1ARCH* è *ANDROID*, sono disponibili opzioni aggiuntive. Vedi [ CMake Variabili e opzioni Android](#cmake-android-variables).
Valori
*WINDOWS* \$1 *LINUX* \$1 *APPLE* \$1 *ANDROID*
### USA CRT\$1HTTP\$1CLIENT
Se`ON`, usa il client HTTP Common Runtime e i sistemi legacy come libcurl non sono WinHttp compilati o inclusi.
Valori
**ATTIVATO \$1 DISATTIVATO**
Predefinita
*SPENTO*
### USE\$1IXML\$1HTTP\$1REQUEST\$12
Solo per Windows. Se`ON`, utilizzate l'oggetto com IXml HttpRequest 2 per lo stack HTTP.
Valori
**ATTIVATO \$1 DISATTIVATO**
Predefinita
*SPENTO*
### USE\$1OPENSSL
Se`ON`, l'SDK crea utilizzando OpenSSL; in caso contrario, utilizza. [https://github.com/awslabs/aws-lc](https://github.com/awslabs/aws-lc) `AWS-LC`è una libreria crittografica generica gestita dal team di crittografia e dai relativi clienti. AWS AWS `OFF`La rotazione del parametro si installa `AWS-LC` in sostituzione di OpenSSL nella directory predefinita del sistema. Non utilizzare se nel sistema è già presente un'installazione OpenSSL.
Valori
**ATTIVATO \$1 DISATTIVATO**
Predefinita
*ACCESO*
### USE\$1TLS\$1V1\$12
Se`ON`, il client HTTP applica TLS 1.2.
Valori
**ATTIVATO \$1 DISATTIVATO**
Predefinita
*ACCESO*
### USE\$1TLS\$1V1\$13
Se`ON`, il client HTTP applica TLS 1.3.
Valori
**ATTIVATO \$1 DISATTIVATO**
Predefinita
*SPENTO*
## CMake Variabili e opzioni Android
*Utilizza le seguenti variabili quando crei una build Android dell'SDK (quando [TARGET\$1ARCH](#cmake-target-arch) è impostato su 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)
+ [NOME\$1TOOLCHAIN\$1ANDROIDE](#cmake-android-toolchain-name)
+ [DISABILITARE\$1ANDROID\$1STANDALONE\$1BUILD](#cmake-disable-android-standalone-build)
+ [NDK\$1DIR](#cmake-ndk-dir)
### ANDROID\$1ABI
Solo Android. Controlla per quale Application Binary Interface (ABI) il codice di output.
**Nota**
Al momento non tutti i valori ABI Android validi sono supportati.
Valori
*arm64* ****\$1 *armeabi-v7a* \$1 x86\$164 \$1 x86 \$1 mips64 \$1 mips****
Predefinita
*armeabi-v7a*
### ANDROID\$1BUILD\$1CURL
Solo per Android. Se`ON`, costruisci anche curl.
Valori
**ATTIVATO \$1 DISATTIVATO**
Predefinita
*ACCESO*
### ANDROID\$1BUILD\$1OPENSSL
Solo per Android. Se`ON`, crea anche OpenSSL.
Valori
**ATTIVATO \$1 DISATTIVATO**
Predefinita
*ACCESO*
### ANDROID\$1BUILD\$1ZLIB
Solo per Android. Se`ON`, crea anche Zlib.
Valori
**ATTIVATO \$1 DISATTIVATO**
Predefinita
*ACCESO*
### ANDROID\$1NATIVE\$1 API\$1LEVEL
Solo Android. Controlla il livello di API su cui si basa l'SDK. Se imposti [ANDROID\$1STL su gnustl](#cmake-android-stl)*, puoi scegliere qualsiasi livello* di API. *Se usi *libc\$1\$1*, devi usare un livello API di almeno 21.*
Predefinita
Varia in base alla scelta STL.
### ANDROID\$1STL
Solo per Android. Controlla il tipo di libreria standard C\$1\$1 utilizzato dall'SDK.
**Importante**
*Se si utilizzano le `gnustl` opzioni, possono verificarsi problemi di prestazioni all'interno dell'SDK; consigliamo vivamente di utilizzare libc\$1\$1\$1shared o *libc\$1\$1\$1static*.*
Valori
**libc\$1\$1\$1shared** **\$1* libc\$1\$1\$1static \$1 gnustl\$1shared \$1 gnustl\$1static*
Predefinita
*libc\$1\$1\$1condiviso*
### NOME\$1TOOLCHAIN\$1ANDROIDE
Solo per Android. Controlla quale compilatore viene utilizzato per creare l'SDK.
**Nota**
Poiché GCC è obsoleto da Android NDK, consigliamo di utilizzare il valore predefinito.
Predefinita
*standalone-clang*
### DISABILITARE\$1ANDROID\$1STANDALONE\$1BUILD
Solo per Android. Per impostazione predefinita, le build Android utilizzano una toolchain autonoma basata su clang costruita tramite script NDK. *Per utilizzare la tua toolchain, attiva questa opzione.*
Valori
**ATTIVATO \$1 DISATTIVATO**
Predefinita
*SPENTO*
### NDK\$1DIR
Solo per Android. Specifica un percorso di override in cui il sistema di build dovrebbe trovare l'NDK Android. Per impostazione predefinita, il sistema di compilazione controlla le variabili di ambiente (`ANDROID_NDK`) se questa variabile non è impostata.