Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# CMake parámetros para construir el AWS SDK para C\$1\$1
Usa los [CMake](https://cmake.org/)parámetros que se enumeran en esta sección para personalizar la forma en que se compila tu SDK.
Puede configurar estas opciones con las herramientas de la CMake interfaz gráfica de usuario o la línea de comandos mediante *-D.* Por ejemplo:
```
cmake -DENABLE_UNITY_BUILD=ON -DREGENERATE_CLIENTS=1
```
## CMake Variables y opciones generales
A continuación, se indican las variables y opciones de **`cmake`** generales que afectan al proceso de compilación del código fuente del SDK.
**nota**
Utilice estos parámetros al compilar el código fuente del SDK para el propio SDK para C\$1\$1.
**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\$1ADVERTENCIAS\$1SON\$1ERRORES](#cmake-AWS_SDK_WARNINGS_ARE_ERRORS)
+ [AWS\$1USE\$1CRYPTO\$1SHARED\$1LIBS](#cmake-use-crypto)
+ [AWS\$1TEST\$1REGIÓN](#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)
+ [DESHABILITAR\$1INTERNAL\$1 \$1LLAMADAS IMDSV1](#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
Compila un cliente de manera arbitraria en función de la definición de la API. Coloque la definición en la carpeta `code-generation/api-definitions` y, a continuación, transfiera este argumento a **`cmake`**. El paso de configuración de **`cmake`** genera el cliente y lo incluye como un subdirectorio en la compilación. Esto resulta especialmente útil para generar un cliente C\$1\$1 para usar uno de los servicios de [API Gateway](https://aws.amazon.com/api-gateway). Por ejemplo:
```
-DADD_CUSTOM_CLIENTS="serviceName=myCustomService,version=2015-12-21;serviceName=someOtherService,version=2015-08-15"
```
**nota**
Para usar el parámetro `ADD_CUSTOM_CLIENTS`, debe tener [Python 2.7](https://www.python.org/downloads/), Java ([JDK 1.8\$1](http://openjdk.java.net/install/)) y [Maven](https://maven.apache.org/) instalados y en su `PATH`.
### AUTORUN\$1UNIT\$1TESTS
Si se establece en `ON`, ejecute las pruebas unitarias automáticamente después de la compilación.
Valores
*ON* \$1 *OFF*
Predeterminado
*ACTIVADO*
### AWS\$1AUTORUN\$1LD\$1LIBRARY\$1PATH
La ruta que se añadirá a LD\$1LIBRARY\$1PATH para la ejecución automática de las pruebas unitarias. CMake Establezca esta ruta si se necesitan bibliotecas de tiempo de ejecución personalizadas para las dependencias anuladas.
Valores
*Cadena.*
Predeterminado
*N/D*
### AWS\$1SDK\$1ADVERTENCIAS\$1SON\$1ERRORES
Si se establece en `ON`, trata las advertencias del compilador como errores. Pruebe a cambiar esta opción a `OFF` si observa errores en un compilador nuevo o poco común.
Valores
*ON* \$1 *OFF*
Predeterminado
*EN*
### AWS\$1USE\$1CRYPTO\$1SHARED\$1LIBS
Obliga FindCrypto a usar una biblioteca criptográfica compartida si la encuentra. Cámbielo a `OFF` para usar la configuración de [BUILD\$1SHARED\$1LIBS](#cmake-build-shared-libs) en su lugar.
Valores
*ON* \$1 *OFF*
Predeterminado
*DESACTIVADO*
### AWS\$1TEST\$1REGIÓN
El Región de AWS que se utilizará en las pruebas de integración.
Valores
*Cadena.*
Predeterminado
*N/D*
### BUILD\$1BENCHMARKS
Si se establece en `ON`, compile el ejecutable de referencia.
Valores
*ON* \$1 *OFF*
Predeterminado
*APAGADO*
### BUILD\$1DEPS
Si se establece en `ON`, compile dependencias de terceros.
Valores
*ON* \$1 *OFF*
Predeterminado
*ENCENDIDO*
### BUILD\$1ONLY
Compile solo los clientes que quiera usar. Si se configura en un SDK de alto nivel, como `aws-cpp-sdk-transfer`, *BUILD\$1ONLY* resuelve cualquier dependencia de cliente de bajo nivel. También compila pruebas unitarias y de integración relacionadas con los proyectos que seleccione, si existen. Se trata de un argumento de lista, con valores separados por puntos y comas (`;`). Por ejemplo:
```
-DBUILD_ONLY="s3;cognito-identity"
```
**nota**
El módulo principal del SDK, `aws-sdk-cpp-core`, *siempre* se compila, independientemente del valor del parámetro *BUILD\$1ONLY*.
### BUILD\$1OPTEL
Si se establece en `ON`, crea la implementación de OpenTelemetry del rastreo.
Valores
*ON* \$1 *OFF*
Predeterminado
*APAGADO*
### BUILD\$1SHARED\$1LIBS
Una CMake opción integrada, que se vuelve a exponer aquí para mayor visibilidad. Si se establece en `ON`, compila bibliotecas compartidas; de lo contrario, solo compila bibliotecas estáticas.
**nota**
Para la vinculación dinámica con el SDK, debe definir el símbolo `USE_IMPORT_EXPORT` para todos los objetivos de compilación que utilicen el SDK.
Valores
*ON* \$1 *OFF*
Predeterminado
*ENCENDIDO*
### BYPASS\$1DEFAULT\$1PROXY
Si`ON`, omita la configuración de proxy predeterminada de la máquina cuando utilice IXml HttpRequest 2.
Valores
*ON* \$1 *OFF*
Predeterminado
*ACTIVADO*
### CPP\$1STANDARD
Especifica un estándar de C\$1\$1 personalizado para usarlo con las bases de código C\$1\$1 14 y 17.
Valores
*11* \$1 *14* \$1 *17*
Predeterminado
*11*
### CURL\$1INCLUDE\$1DIR
La ruta a curl incluye el directorio que contiene los encabezados `libcurl`.
Valores
*Ruta de la cadena al directorio `include` seleccionado. Por ejemplo,`D:/path/to/dir/with/curl/include`.*
Predeterminado
*N/D*
### CURL\$1LIBRARY
Ruta al archivo de la biblioteca de curl con el que establecer el enlace. Esta biblioteca puede ser una biblioteca estática o una biblioteca de importación, según las necesidades de la aplicación.
Valores
*Ruta de la cadena al archivo de la biblioteca de curl. Por ejemplo,`D:/path/to/static/libcur/file/ie/libcurl.lib.a`.*
Predeterminado
*N/D*
### CUSTOM\$1MEMORY\$1MANAGEMENT
Para usar un administrador de memoria personalizado, establezca el valor en `1`. Puede instalar un asignador personalizado para que todos los tipos de STL utilicen la interfaz de asignación personalizada. Si establece el valor `0`, es posible que desee seguir utilizando los tipos de plantilla STL para garantizar la seguridad de las DLL en Windows.
Si el enlace estático se establece en `ON`, la administración de memoria personalizada se establecerá de forma predeterminada en *off* (`0`). Si la vinculación dinámica se establece en `ON`, la administración de memoria personalizada se establece de forma predeterminada en *on* (`1`) y evita la asignación y desasignación entre archivos DLL.
**nota**
Para evitar errores de discordancia en los enlazadores, debe usar el mismo valor (`0` o`1`) en la totalidad del sistema de compilación.
Para instalar su propio administrador de memoria para que gestione las asignaciones realizadas por el SDK, debe configurar `-DCUSTOM_MEMORY_MANAGEMENT` y definir `USE_AWS_MEMORY_MANAGEMENT` para todos los objetivos de compilación que dependan del SDK.
### DESHABILITAR\$1INTERNAL\$1 \$1LLAMADAS IMDSV1
Si se establece en `ON`, no se realiza ninguna llamada interna a la API V1 del [servicio de metadatos de instancias.](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html) Si`OFF`, IMDSv2 las llamadas volverán a usarse si la llamada falla. IMDSv1 IMDSv2 Para obtener más información IMDSv1 y IMDSv2, consulte [Uso del servicio de metadatos de instancias para acceder a los metadatos de la instancia](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/configuring-instance-metadata-service.html) en la Guía del *usuario de Amazon EC2*.
Valores
*ON* \$1 *OFF*
Predeterminado
*DESACTIVADO*
### ENABLE\$1ADDRESS\$1SANITIZER
Si se establece en `ON`, activa Address Sanitizer para gcc o clang.
Valores
*ON* \$1 *OFF*
Predeterminado
*APAGADO*
### ENABLE\$1CURL\$1LOGGING
Si se establece en `ON`, canaliza el registro interno de curl al registrador del SDK.
Valores
*ON* \$1 *OFF*
Predeterminado
*APAGADO*
### ENABLE\$1HTTP\$1CLIENT\$1TESTING
Si se establece en `ON`, compile y ejecute los conjuntos de pruebas de clientes HTTP correspondientes.
Valores
*ON* \$1 *OFF*
Predeterminado
*APAGADO*
### ENABLE\$1RTTI
Controla si el SDK está diseñado para habilitar la información de tipos en tiempo de ejecución (RTTI).
Valores
*ON* \$1 *OFF*
Predeterminado
*ENCENDIDO*
### ENABLE\$1TESTING
Controla si los proyectos de pruebas unitarias y de integración se compilan durante la creación del SDK.
Valores
*ON* \$1 *OFF*
Predeterminado
*ENCENDIDO*
### ENABLE\$1UNITY\$1BUILD
Si está establecido en `ON`, la mayoría de las bibliotecas del SDK se crean como un único archivo `.cpp` generado. Esto puede reducir de manera considerable el tamaño de la biblioteca estática y acelerar el tiempo de compilación.
Valores
*ON* \$1 *OFF*
Predeterminado
*APAGADO*
### ENABLE\$1VIRTUAL\$1OPERATIONS
Este parámetro suele funcionar junto con `REGENERATE_CLIENTS` para generar código.
Si `ENABLE_VIRTUAL_OPERATIONS` se establece en `ON` y `REGENERATE_CLIENTS` en `ON`, las funciones relacionadas con las operaciones en los clientes de servicio se marcarán como `virtual`.
Si `ENABLE_VIRTUAL_OPERATIONS` se establece en `OFF` y `REGENERATE_CLIENTS` en `ON`, `virtual` no se añadirá a las funciones de operación y las clases de clientes de servicio se marcarán como `final`.
Si `ENABLE_VIRTUAL_OPERATIONS` se establece en `OFF`, el SDK también añadirá los indicadores de compilación `-ffunction-sections` y `-fdata-sections` para gcc y clang al compilar.
Para obtener más información, consulte [CMake Parámetros](https://github.com/aws/aws-sdk-cpp/blob/main/docs/CMake_Parameters.md#enable_virtual_operations) activados GitHub.
Valores
*ON* \$1 *OFF*
Predeterminado
*ACTIVADO*
### ENABLE\$1ZLIB\$1REQUEST\$1COMPRESSION
En los servicios que lo admitan, el contenido de la solicitud se comprimirá. Está habilitado de forma predeterminada si la dependencia está disponible.
Valores
*ON* \$1 *OFF*
Predeterminado
*ENCENDIDO*
### FORCE\$1CURL
solo Windows. Si se establece en `ON`, fuerza el uso del cliente curl en lugar del proveedor de transferencia de datos [WinHTTP](https://msdn.microsoft.com/en-us/library/windows/desktop/aa382925%28v=vs.85%29.aspx) predeterminado.
Valores
*ON* \$1 *OFF*
Predeterminado
*APAGADO*
### FORCE\$1SHARED\$1CRT
Si se establece en `ON`, el SDK se vincula al motor de ejecución de C de *forma dinámica*; de lo contrario, utiliza la configuración *BUILD\$1SHARED\$1LIBS* (que a veces es necesaria para mantener la compatibilidad con versiones anteriores del SDK).
Valores
*ON* \$1 *OFF*
Predeterminado
*ENCENDIDO*
### G
Genera artefactos de compilación, como soluciones de Visual Studio y proyectos de Xcode.
Por ejemplo, en Windows:
```
-G "Visual Studio 12 Win64"
```
Para obtener más información, consulte la CMake documentación de su plataforma.
### MINIMIZE\$1SIZE
Un superconjunto de [ENABLE\$1UNITY\$1BUILD](#cmake-enable-unity-build). Si se establece en `ON`, esta opción activa *ENABLE\$1UNITY\$1BUILD* y otros ajustes de reducción de tamaño binario.
Valores
*ON* \$1 *OFF*
Predeterminado
*DESACTIVADO*
### NO\$1ENCRYPTION
Si se establece en `ON`, impide que la implementación de criptografía predeterminada específica de la plataforma se incorpore a la biblioteca. Establézcala en *ON* para incluir propia implementación de criptografía.
Valores
*ON* \$1 *OFF*
Predeterminado
*APAGADO*
### NO\$1HTTP\$1CLIENT
Si se establece en `ON`, impide que el cliente HTTP predeterminado específico de la plataforma se integre en la biblioteca. Si se establece en *ON*, tendrá que proporcionar su propia implementación de cliente HTTP específica de la plataforma.
Valores
*ON* \$1 *OFF*
Predeterminado
*APAGADO*
### REGENERATE\$1CLIENTS
Si se establece en `ON`, este parámetro elimina todo el código generado y genera los directorios de cliente a partir de la carpeta `code-generation/api-definitions`. Por ejemplo:
```
-DREGENERATE_CLIENTS=1
```
**nota**
Para usar el parámetro `REGENERATE_CLIENTS`, debe tener [Python 2.7](https://www.python.org/downloads/), Java ([JDK 1.8\$1](http://openjdk.java.net/install/)) y [Maven](https://maven.apache.org/) instalados y en su `PATH`.
### REGENERATE\$1DEFAULTS
Si se establece en `ON`, este parámetro elimina todo el código predeterminado generado y lo vuelve a generar a partir de la carpeta `code-generation/defaults`. Por ejemplo:
```
-DREGENERATE_DEFAULTS=1
```
**nota**
Para usar el parámetro `REGENERATE_DEFAULTS`, debe tener [Python 2.7](https://www.python.org/downloads/), Java ([JDK 1.8\$1](http://openjdk.java.net/install/)) y [Maven](https://maven.apache.org/) instalados y en su `PATH`.
### SIMPLE\$1INSTALL
Si se establece en `ON`, el proceso de instalación no inserta directorios intermedios específicos de la plataforma debajo de `bin/` y `lib/`. Establézcalo en `OFF` si necesita crear versiones multiplataforma en un único directorio de instalación.
Valores
*ON* \$1 *OFF*
Predeterminado
*ENCENDIDO*
### TARGET\$1ARCH
Para realizar una compilación cruzada o una compilación para una plataforma móvil, debe especificar la plataforma de destino. De forma predeterminada, la compilación detecta el sistema operativo del host y compilaciones del sistema operativo detectado.
**nota**
Cuando *TARGET\$1ARCH* es *ANDROID*, hay opciones adicionales disponibles. Consulta [ CMake Variables y opciones de Android](#cmake-android-variables).
Valores
*WINDOWS* \$1 *LINUX* \$1 *APPLE* \$1 *ANDROID*
### USE\$1CRT\$1HTTP\$1CLIENT
Si es así`ON`, usa el cliente HTTP común en tiempo de ejecución, y los sistemas heredados, como WinHttp libcurl, no están compilados ni incluidos.
Valores
*ON* \$1 *OFF*
Predeterminado
*DESACTIVADO*
### USE\$1IXML\$1HTTP\$1REQUEST\$12
solo Windows. Si`ON`, usa el objeto com IXml HttpRequest 2 para la pila HTTP.
Valores
*ON* \$1 *OFF*
Predeterminado
*DESACTIVADO*
### USE\$1OPENSSL
Si`ON`, el SDK se compila con OpenSSL; de lo contrario, utiliza. [https://github.com/awslabs/aws-lc](https://github.com/awslabs/aws-lc) `AWS-LC`es una biblioteca criptográfica de uso general mantenida por el equipo de AWS criptografía para sus clientes y para ellos. AWS Si se establece en `OFF`, el parámetro instala `AWS-LC` como reemplazo de OpenSSL en el directorio predeterminado del sistema. No use este parámetro si ya tiene una instalación de OpenSSL en su sistema.
Valores
*ON* \$1 *OFF*
Predeterminado
*EN*
### USE\$1TLS\$1V1\$12
Si se establece en `ON`, el cliente HTTP aplica TLS 1.2.
Valores
*ON* \$1 *OFF*
Predeterminado
*ENCENDIDO*
### USE\$1TLS\$1V1\$13
Si se establece en `ON`, el cliente HTTP aplica TLS 1.3.
Valores
*ON* \$1 *OFF*
Predeterminado
*APAGADO*
## CMake Variables y opciones de Android
Utilice las siguientes variables cuando cree una compilación del SDK para Android (cuando [TARGET\$1ARCH](#cmake-target-arch) esté configurado en 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
Solo Android. Controla la interfaz binaria de aplicaciones (ABI) para la que se generará el código.
**nota**
Actualmente, no se admiten todos los valores de ABI para Android válidos.
Valores
*arm64* \$1 *armeabi-v7a* \$1 *x86\$164* \$1 *x86* \$1 *mips64* \$1 *mips*
Predeterminado
*armeabi-v7a*
### ANDROID\$1BUILD\$1CURL
Solo Android. Si se establece en `ON`, compile también curl.
Valores
*ON* \$1 *OFF*
Predeterminado
*NO*
### ANDROID\$1BUILD\$1OPENSSL
Solo Android. Si se establece en `ON`, compile también Openssl.
Valores
*ON* \$1 *OFF*
Predeterminado
*ENCENDIDO*
### ANDROID\$1BUILD\$1ZLIB
Solo Android. Si se establece en `ON`, compile también Zlib.
Valores
*ON* \$1 *OFF*
Predeterminado
*ENCENDIDO*
### ANDROID\$1NATIVE\$1 API\$1LEVEL
Solo Android. Controla el nivel de API en relación con el cual que se compila el SDK. Si configura [ANDROID\$1STL](#cmake-android-stl) como *gnustl*, puede elegir cualquier nivel de API. Si usa *libc\$1\$1*, debe usar un nivel de API de *21* como mínimo.
Predeterminado
Varía según la elección de STL.
### ANDROID\$1STL
Solo Android. Controla la versión de la biblioteca estándar de C\$1\$1 que utiliza el SDK.
**importante**
Se pueden producir problemas de rendimiento en el SDK si se utilizan las opciones de `gnustl`; se recomienda encarecidamente utilizar *libc\$1\$1\$1shared* o *libc\$1\$1\$1static*.
Valores
*libc\$1\$1\$1shared* \$1 *libc\$1\$1\$1static* \$1 *gnustl\$1shared* \$1 *gnustl\$1static*
Predeterminado
*libc\$1\$1\$1shared*
### ANDROID\$1TOOLCHAIN\$1NAME
Solo Android. Controla qué compilador se usa para compilar el SDK.
**nota**
Dado que el NDK de Android ha dejado de usar GCC, le recomendamos usar el valor predeterminado.
Predeterminado
*standalone-clang*
### DISABLE\$1ANDROID\$1STANDALONE\$1BUILD
Solo Android. De forma predeterminada, las compilaciones de Android utilizan una cadena de herramientas independiente basada en clang creada mediante scripts del NDK. Para usar su propia cadena de herramientas, establezca esta opción en *ON*.
Valores
*ON* \$1 *OFF*
Predeterminado
*DESACTIVADO*
### NDK\$1DIR
Solo Android. Especifica una ruta de anulación en la que el sistema de compilación debe encontrar el NDK de Android. De forma predeterminada, el sistema de compilación comprueba las variables de entorno (`ANDROID_NDK`) si esta variable no está configurada.