As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá. # CMake parâmetros para construir o AWS SDK para C\$1\$1 Use os [CMake](https://cmake.org/)parâmetros listados nesta seção para personalizar a criação do SDK. Você pode definir essas opções com as ferramentas da CMake GUI ou a linha de comando usando *-D*. Por exemplo: ``` cmake -DENABLE_UNITY_BUILD=ON -DREGENERATE_CLIENTS=1 ``` ## CMake Variáveis e opções gerais Veja a seguir as variáveis e opções gerais do **`cmake`** que afetam o processo de compilação do código-fonte do SDK. **nota** Use esses parâmetros ao compilar o código-fonte do SDK para o próprio 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\$1AVISOS\$1SÃO\$1ERROS](#cmake-AWS_SDK_WARNINGS_ARE_ERRORS) + [AWS\$1USE\$1CRYPTO\$1SHARED\$1LIBS](#cmake-use-crypto) + [AWS\$1TEST\$1REGIÃO](#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) + [DESATIVAR \$1INTERNA\$1 IMDSV1 \$1CHAMADAS](#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 Cria qualquer cliente arbitrário com base na definição da API. Coloque sua definição na pasta `code-generation/api-definitions` e, depois, transmita esse argumento para **`cmake`**. A etapa de **`cmake`** gera seu cliente e o inclui como um subdiretório em sua compilação. Isso é particularmente útil para gerar um cliente C\$1\$1 para usar um dos seus serviços do [API Gateway](https://aws.amazon.com/api-gateway). Por exemplo: ``` -DADD_CUSTOM_CLIENTS="serviceName=myCustomService,version=2015-12-21;serviceName=someOtherService,version=2015-08-15" ``` **nota** Para usar o parâmetro `ADD_CUSTOM_CLIENTS`, você deve ter o [Python 2.7](https://www.python.org/downloads/), o Java ([JDK 1.8\$1](http://openjdk.java.net/install/)) e o [Maven](https://maven.apache.org/) instalados e em seu `PATH`. ### AUTORUN\$1UNIT\$1TESTS Se `ON`, execute testes de unidade automaticamente após a compilação. Valores *Ativado* \$1 *Desativado* Padrão *LIGADO* ### AWS\$1AUTORUN\$1LD\$1LIBRARY\$1PATH O caminho a ser anexado ao LD\$1LIBRARY\$1PATH para testes de unidade executados automaticamente por. CMake Defina esse caminho se bibliotecas de runtime personalizadas forem necessárias para dependências substituídas. Valores *Corda.* Padrão *N/D* ### AWS\$1SDK\$1AVISOS\$1SÃO\$1ERROS Se `ON`, trate os avisos do compilador como erros. Tente ativar isso `OFF` se observar erros em um compilador novo ou incomum. Valores *Ativado* \$1 *Desativado* Padrão *LIGADO* ### AWS\$1USE\$1CRYPTO\$1SHARED\$1LIBS Força FindCrypto o uso de uma biblioteca criptográfica compartilhada, se encontrada. Defina isso como `OFF` para usar a configuração [BUILD\$1SHARED\$1LIBS](#cmake-build-shared-libs). Valores *Ativado* \$1 *Desativado* Padrão *DESLIGADO* ### AWS\$1TEST\$1REGIÃO O Região da AWS a ser usado para testes de integração. Valores *Corda.* Padrão *N/D* ### BUILD\$1BENCHMARKS Se `ON`, compile o executável de ponto de referência. Valores *Ativado* \$1 *Desativado* Padrão *DESLIGADO* ### BUILD\$1DEPS Se `ON`, compile as dependências de terceiros. Valores *Ativado* \$1 *Desativado* Padrão *LIGADO* ### BUILD\$1ONLY Compila somente os clientes que você deseja usar. Se definido como um SDK de alto nível, como `aws-cpp-sdk-transfer`, *BUILD\$1ONLY*, resolve todas as dependências de cliente de baixo nível. Ele também compila integração e de testes de unidade relacionados aos projetos selecionados, se existirem. Esse é um argumento de lista, com valores separados por caracteres ponto-e-vírgula (`;`). Por exemplo: ``` -DBUILD_ONLY="s3;cognito-identity" ``` **nota** O módulo principal do SDK, `aws-sdk-cpp-core`, é *sempre* compilado, independentemente do valor do parâmetro *BUILD\$1ONLY*. ### BUILD\$1OPTEL Se `ON`, compila a implementação de telemetria aberta do rastreamento. Valores *Ativado* \$1 *Desativado* Padrão *DESLIGADO* ### BUILD\$1SHARED\$1LIBS Uma CMake opção integrada, reexposta aqui para maior visibilidade. Se `ON`, ele compila bibliotecas compartilhadas; caso contrário, ele cria somente bibliotecas estáticas. **nota** Para se vincular dinamicamente ao SDK, você deve definir o símbolo `USE_IMPORT_EXPORT` para todos os destinos de compilação usando o SDK. Valores *Ativado* \$1 *Desativado* Padrão *LIGADO* ### BYPASS\$1DEFAULT\$1PROXY Se`ON`, ignore as configurações de proxy padrão da máquina ao usar IXml HttpRequest 2. Valores *Ativado* \$1 *Desativado* Padrão *LIGADO* ### CPP\$1STANDARD Especifica um padrão C\$1\$1 personalizado para uso com bases de código C\$1\$1 14 e 17. Valores *11* \$1 *14* \$1 *17* Padrão *11* ### CURL\$1INCLUDE\$1DIR O caminho para curl inclui um diretório que contém cabeçalhos`libcurl`. Valores *Caminho da string do diretório `include` selecionado. Por exemplo,`D:/path/to/dir/with/curl/include`.* Padrão *N/D* ### CURL\$1LIBRARY Caminho do arquivo da biblioteca curl a ser vinculado. Essa biblioteca pode ser estática ou de importação, dependendo das necessidades da sua aplicação. Valores *Caminho da string do arquivo da biblioteca curl. Por exemplo,`D:/path/to/static/libcur/file/ie/libcurl.lib.a`.* Padrão *N/D* ### CUSTOM\$1MEMORY\$1MANAGEMENT Para usar um gerenciador de memória personalizado, defina o valor como `1`. Você pode instalar um alocador personalizado para que todos os tipos de STL usem a interface de alocação personalizada. Se você definir o valor como `0`, talvez seja conveniente usar os tipos de modelo STL para ajudar na segurança de DLL no Windows. Se a vinculação estática for `ON`, o gerenciamento de memória personalizado assumirá como padrão *desativado* (`0`). Se a vinculação dinâmica for `ON`, o gerenciamento de memória personalizado usará como padrão *ativado* (`1`) e evitará a alocação e desalocação entre DLLs. **nota** Para evitar erros de incompatibilidade do vinculador, você deve usar o mesmo valor (`0` ou `1`) em todo o sistema de compilação. Para instalar seu próprio gerenciador de memória para lidar com as alocações feitas pelo SDK, você deve definir `-DCUSTOM_MEMORY_MANAGEMENT` e `USE_AWS_MEMORY_MANAGEMENT` para todos os destinos de compilação que dependem do SDK. ### DESATIVAR \$1INTERNA\$1 IMDSV1 \$1CHAMADAS Se `ON`, nenhuma chamada interna será feita para a API V1 do [Serviço de metadados da instância](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html). Se`OFF`, IMDSv2 as chamadas voltarão a ser usadas IMDSv1 se a IMDSv2 chamada falhar. Para obter mais informações sobre IMDSv1 e IMDSv2, consulte [Usar o serviço de metadados da instância para acessar os metadados da instância no Guia](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/configuring-instance-metadata-service.html) do usuário do *Amazon EC2*. Valores *Ativado* \$1 *Desativado* Padrão *DESLIGADO* ### ENABLE\$1ADDRESS\$1SANITIZER Se `ON`, ativará o Address Sanitizer para gcc ou clang. Valores *Ativado* \$1 *Desativado* Padrão *DESLIGADO* ### ENABLE\$1CURL\$1LOGGING Se `ON`, direcione o log interno para curl para o registrador do SDK. Valores *Ativado* \$1 *Desativado* Padrão *DESLIGADO* ### ENABLE\$1HTTP\$1CLIENT\$1TESTING Se `ON`, compile e execute os conjuntos de testes de clientes HTTP correspondentes. Valores *Ativado* \$1 *Desativado* Padrão *DESLIGADO* ### ENABLE\$1RTTI Controla se o SDK foi compilado para habilitar informações de tipo de runtime (RTTI). Valores *Ativado* \$1 *Desativado* Padrão *LIGADO* ### ENABLE\$1TESTING Controla se os projetos de teste de unidade e integração são compilados durante a compilação do SDK. Valores *Ativado* \$1 *Desativado* Padrão *LIGADO* ### ENABLE\$1UNITY\$1BUILD Se `ON`, a maioria das bibliotecas do SDK será compilada como um único arquivo `.cpp` gerado. Isso pode reduzir significativamente o tamanho da biblioteca estática e acelerar o tempo de compilação. Valores *Ativado* \$1 *Desativado* Padrão *DESLIGADO* ### ENABLE\$1VIRTUAL\$1OPERATIONS Esse parâmetro geralmente funciona em conjunto com `REGENERATE_CLIENTS` para geração de código. Se `ENABLE_VIRTUAL_OPERATIONS` for `ON` e `REGENERATE_CLIENTS` for `ON`, as funções relacionadas à operação em clientes de serviço serão marcadas como `virtual`. Se `ENABLE_VIRTUAL_OPERATIONS` for `OFF` e `REGENERATE_CLIENTS` for `ON`, `virtual` não será adicionado às funções de operação e as classes do cliente de serviço serão marcadas como `final`. Se `ENABLE_VIRTUAL_OPERATIONS` estiver `OFF`, o SDK também adicionará sinalizadores de compilador `-ffunction-sections` e `-fdata-sections` para gcc e clang durante a compilação. Para obter mais informações, consulte [CMake Parâmetros](https://github.com/aws/aws-sdk-cpp/blob/main/docs/CMake_Parameters.md#enable_virtual_operations) em GitHub. Valores *Ativado* \$1 *Desativado* Padrão *LIGADO* ### ENABLE\$1ZLIB\$1REQUEST\$1COMPRESSION Para serviços que o comportam, o conteúdo da solicitação será compactado. Ativado por padrão se a dependência estiver disponível. Valores *Ativado* \$1 *Desativado* Padrão *LIGADO* ### FORCE\$1CURL Somente para Windows. Se `ON`, forçará o uso do cliente curl em vez do provedor de transferência de dados [WinHTTP](https://msdn.microsoft.com/en-us/library/windows/desktop/aa382925%28v=vs.85%29.aspx) padrão. Valores *Ativado* \$1 *Desativado* Padrão *DESLIGADO* ### FORCE\$1SHARED\$1CRT Se `ON`, o SDK se vinculará *dinamicamente* ao runtime C; caso contrário, ele usará a configuração *BUILD\$1SHARED\$1LIBS* (às vezes necessária para compatibilidade com versões anteriores do SDK). Valores *Ativado* \$1 *Desativado* Padrão *LIGADO* ### G Gera artefatos de compilação, como soluções do Visual Studio e projetos do Xcode. Por exemplo, no Windows: ``` -G "Visual Studio 12 Win64" ``` Para obter mais informações, consulte a CMake documentação da sua plataforma. ### MINIMIZE\$1SIZE Um superconjunto de [ENABLE\$1UNITY\$1BUILD](#cmake-enable-unity-build). Se `ON`, essa opção ativará *ENABLE\$1UNITY\$1BUILD* e configurações adicionais de redução de tamanho binário. Valores *Ativado* \$1 *Desativado* Padrão *DESLIGADO* ### NO\$1ENCRYPTION Se `ON`, impedirá que a implementação de criptografia específica da plataforma padrão seja incorporada à biblioteca. Defina como *Ativado* para injetar sua própria implementação de criptografia. Valores *Ativado* \$1 *Desativado* Padrão *DESLIGADO* ### NO\$1HTTP\$1CLIENT Se `ON`, impedirá que o cliente HTTP específico da plataforma padrão seja incorporado à biblioteca. Se estiver *Ativado*, você precisará fornecer sua própria implementação do cliente HTTP específico da plataforma. Valores *Ativado* \$1 *Desativado* Padrão *DESLIGADO* ### REGENERATE\$1CLIENTS Se `ON`, esse parâmetro excluirá todo o código gerado e gerará os diretórios do cliente a partir da pasta `code-generation/api-definitions`. Por exemplo: ``` -DREGENERATE_CLIENTS=1 ``` **nota** Para usar o parâmetro `REGENERATE_CLIENTS`, você deve ter o [Python 2.7](https://www.python.org/downloads/), o Java ([JDK 1.8\$1](http://openjdk.java.net/install/)) e o [Maven](https://maven.apache.org/) instalados e em seu `PATH`. ### REGENERATE\$1DEFAULTS Se `ON`, esse parâmetro excluirá todo o código padrão gerado e os gerará novamente a partir da pasta `code-generation/defaults`. Por exemplo: ``` -DREGENERATE_DEFAULTS=1 ``` **nota** Para usar o parâmetro `REGENERATE_DEFAULTS`, você deve ter o [Python 2.7](https://www.python.org/downloads/), o Java ([JDK 1.8\$1](http://openjdk.java.net/install/)) e o [Maven](https://maven.apache.org/) instalados e em seu `PATH`. ### SIMPLE\$1INSTALL Se `ON`, o processo de instalação não vai inserir diretórios intermediários específicos da plataforma abaixo de `bin/` e `lib/`. Ative `OFF` se precisar fazer lançamentos multiplataforma em um único diretório de instalação. Valores *Ativado* \$1 *Desativado* Padrão *LIGADO* ### TARGET\$1ARCH Para compilar ou criar para uma plataforma móvel, você deve especificar a plataforma de destino. Por padrão, a compilação detecta o sistema operacional host e realiza a compilação para o sistema operacional detectado. **nota** Quando *TARGET\$1ARCH* é *ANDROID*, opções adicionais estão disponíveis. Consulte [ CMake Variáveis e opções do Android](#cmake-android-variables). Valores *WINDOWS* \$1 *LINUX* \$1 *APPLE* \$1 *ANDROID* ### USE\$1CRT\$1HTTP\$1CLIENT Se`ON`, use o cliente HTTP de tempo de execução comum, e os sistemas legados, como WinHttp libcurl, não serão criados ou incluídos. Valores *Ativado* \$1 *Desativado* Padrão *DESLIGADO* ### USE\$1IXML\$1HTTP\$1REQUEST\$12 Somente para Windows. Se`ON`, use o objeto com IXml HttpRequest 2 para a pilha HTTP. Valores *Ativado* \$1 *Desativado* Padrão *DESLIGADO* ### USE\$1OPENSSL Se`ON`, o SDK é compilado usando OpenSSL; caso contrário, ele usa. [https://github.com/awslabs/aws-lc](https://github.com/awslabs/aws-lc) `AWS-LC`é uma biblioteca criptográfica de uso geral mantida pela equipe de AWS criptografia para AWS e seus clientes. A ativação do parâmetro `OFF` instala o `AWS-LC` como substituição do OpenSSL no diretório padrão do sistema. Não use se você já tiver uma instalação do OpenSSL em seu sistema. Valores *Ativado* \$1 *Desativado* Padrão *LIGADO* ### USE\$1TLS\$1V1\$12 Se `ON`, o cliente HTTP vai impor o TLS 1.2. Valores *Ativado* \$1 *Desativado* Padrão *LIGADO* ### USE\$1TLS\$1V1\$13 Se `ON`, o cliente HTTP vai impor o TLS 1.3. Valores *Ativado* \$1 *Desativado* Padrão *DESLIGADO* ## CMake Variáveis e opções do Android Use as variáveis a seguir ao criar uma compilação para Android do SDK (quando [TARGET\$1ARCH](#cmake-target-arch) estiver definido como *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\$1NATIVO\$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 Somente para Android. Controla para qual interface binária de aplicativo (ABI) gerar o código. **nota** No momento, nem todos os valores válidos da ABI do Android são aceitos. Valores *arm64* \$1 *armeabi-v7a* \$1 *x86\$164* \$1 *x86* \$1 *mips64* \$1 *mips* Padrão *armêbia-v7a* ### ANDROID\$1BUILD\$1CURL Somente para Android. Se `ON`, copile o curl também. Valores *Ativado* \$1 *Desativado* Padrão *LIGADO* ### ANDROID\$1BUILD\$1OPENSSL Somente para Android. Se `ON`, compile o Openssl também. Valores *Ativado* \$1 *Desativado* Padrão *LIGADO* ### ANDROID\$1BUILD\$1ZLIB Somente para Android. Se `ON`, compile o Zlib também. Valores *Ativado* \$1 *Desativado* Padrão *LIGADO* ### ANDROID\$1NATIVO\$1 API\$1LEVEL Somente para Android. Controla em qual nível de API o SDK se baseia. Se você definir [ANDROID\$1STL](#cmake-android-stl) como *gnustl*, poderá escolher qualquer nível de API. Se você usar *libc\$1\$1*, deverá utilizar um nível de API de pelo menos *21*. Padrão Varia de acordo com a opção de STL. ### ANDROID\$1STL Somente para Android. Controla qual tipo da biblioteca padrão C\$1\$1 o SDK usa. **Importante** Problemas de desempenho poderão ocorrer no SDK se as opções `gnustl` forem usadas; é altamente recomendável usar *libc\$1\$1\$1shared* ou *libc\$1\$1\$1static*. Valores *libc\$1\$1\$1shared* \$1 *libc\$1\$1\$1static* \$1 *gnustl\$1shared* \$1 *gnustl\$1static* Padrão *libc\$1\$1\$1shared* ### ANDROID\$1TOOLCHAIN\$1NAME Somente para Android. Controla qual compilador é usado para compilar o SDK. **nota** Como o GCC está sendo descontinuado pelo Android NDK, recomendamos usar o valor padrão. Padrão *standalone-clang* ### DISABLE\$1ANDROID\$1STANDALONE\$1BUILD Somente para Android. Por padrão, as compilações do Android usam uma cadeia de ferramentas autônoma baseada em clang criada por meio de scripts do NDK. Para usar seu próprio conjunto de ferramentas, definia essa opção como *ativada*. Valores *Ativado* \$1 *Desativado* Padrão *DESLIGADO* ### NDK\$1DIR Somente para Android. Especifica um caminho de substituição no qual o sistema de compilação deve encontrar o Android NDK. Por padrão, o sistema de compilação vai conferir as variáveis de ambiente (`ANDROID_NDK`) se essa variável não estiver definida.