前提条件

• C++11及以上版本的编译器
• Visual Studio 2013及以上版本
• GCC 4.8及以上版本
• Clang 3.3及以上版本

下载SDK

下载SDK安装包

通过GitHub下载

安装SDK

您可以通过Linux 、Windows 、Android及Mac系统安装SDK。

• Linux系统：
  1. 安装CMake

     请安装CMake3.1及以上版本。打开SDK安装包，通过CMake编译生成所需文件。

     编译命令如下：

     cd <path/to/aliyun-oss-cpp-sdk>
     mkdir build
     cd build
     cmake ..

  2. 安装第三方库libcurl、openssl

     RedHat或Centos：

     yum –y install libcurl-devel openssl-devel

     Fedora：

     sudo dnf install libcurl-devel openssl-devel

  3. 安装SDK

     make && make install

  注意 C++ SDK默认关闭rtti属性。所以使用g++编译运行时，请添加 -std=c++11、 -fno-rtti、 -lalibabacloud-oss-cpp-sdk、 -lcurl、 -lcrypto和 -lpthread。

  示例如下：

  g++ test.cpp -std=c++11 -fno-rtti -lalibabacloud-oss-cpp-sdk -lcurl -lcrypto -lpthread -o test.bin

• Windows 系统：
  1. 安装CMake。打开cmd进入SDK文件目录，创建build文件夹，运行cmake ..生成所需文件，如下图所示：
     说明

     • 下载的SDK中不直接提供alibabacloud-oss-cpp-sdk.sln工程文件，您需要通过cmake生成所需的工程文件。
     • 如果要构建x64体系结构，可以使用命令cmake -A x64 ..来实现。
  2. 请以管理员身份运行VS开发人员命令提示符，在build目录文件下运行以下命令进行编译安装：

     msbuild ALL_BUILD.vcxproj
     msbuild INSTALL.vcxproj

     或者用Visual Studio打开alibabacloud-oss-cpp-sdk.sln生成解决方案。

• Android系统：

  Linux环境下，基于android-ndk-r16工具链构建工程。请在$ANDROID_NDK/sysroot路径下安装libcurl和libopenssl第三方库，并运行以下命令进行编译安装。

  cmake -DCMAKE_TOOLCHAIN_FILE=$ANDROID_NDK/build/cmake/android.toolchain.cmake  \
        -DANDROID_NDK=$ANDROID_NDK    \
        -DANDROID_ABI=armeabi-v7a     \
        -DANDROID_TOOLCHAIN=clang     \
        -DANDROID_PLATFORM=android-21 \
        -DANDROID_STL=c++_shared ..
  make

• Mac系统：

  在Mac系统中指定OpenSSL安装路径。

  假设OpenSSL安装在/usr/local/Cellar/openssl/1.0.2p目录中，运行以下命令进行编译安装。

  cmake -DOPENSSL_ROOT_DIR=/usr/local/Cellar/openssl/1.0.2p  \
        -DOPENSSL_LIBRARIES=/usr/local/Cellar/openssl/1.0.2p/lib  \
        -DOPENSSL_INCLUDE_DIRS=/usr/local/Cellar/openssl/1.0.2p/include/ ..
  make

编译选项

您可以根据具体的业务场景，设置不同的编译选项，编译选项格式为cmake -D${OptionName}=ON|OFF ..。

可选的编译选项如下表所示：