本文介绍如何安装OSS C SDK。

Linux环境下的安装

  • 安装CMake和第三方库
    注意 在Linux环境下安装第三方库时,需确保第三方库的安装路径为英文路径,否则会出现OSS依赖的第三方库找不到对应函数的问题。

    OSS C SDK安装时,需要安装编译工具CMake和第三方库curl、apr、apr-util、minixml。

    安装环境时所需参数如下:

    名称 描述 版本要求
    CMake 编译安装工具。 2.6.0及以上版本
    curl 主要解决网络方面的问题。 7.32.0 及以上版本
    apr-util 解决内存管理以及跨平台问题。 1.5.2 及以上版本
    minixml 解析请求返回的xml。 推荐使用 v2.9 版本

    请选择对应的系统安装。

    • Ubuntu/Debian
      • 安装CMake
        sudo apt-get install cmake
                                            
      • 安装第三方库
        sudo apt-get install libcurl4-openssl-dev libapr1-dev libaprutil1-dev libmxml-dev
                                            
    • RedHat/Aliyun/CentOS
      • 安装CMake
        sudo yum install cmake
                                            
      • 安装第三方库
        sudo yum install curl-devel apr-devel apr-util-devel  mxml mxml-devel
                                            

        如果yum源中没有mxml安装包,可采用rpm安装。 请下载系统对应的rpm包:

        rpm包安装mxml:

        rpm -ivh mxml-2.9-1.x86_64.rpm
                                            
    • SuSE
      • 安装CMake
        zypper install cmake
                                            
      • 安装第三方库
        zypper install libcurl-devel libapr1-devel libapr-util1-devel mxml-devel
                                            
    • Linux
      • 安装CMake:下载地址

        常用的安装方式如下:

        ./configure
        make
        make install                                    
        说明 执行./configure时,默认安装路径为/usr/local/,如果需要指定安装路径,请使用 ./configure --prefix选项。
      • 安装libcurl:下载地址

        常用的安装方式如下:

        ./configure
        make
        make install
                                            
      • 安装apr:下载地址

        常用的安装方式如下:

        ./configure
        make
        make install
                                            
      • 安装apr-util:下载地址

        常用的安装方式如下:

        // 安装时需要指定--with-apr选项。
        ./configure --with-apr=/your/apr/install/path
        make
        make install
                                            
      • 安装minixml:下载地址
        说明 请使用2.x版本的minixml。

        常用的安装方式如下:

        ./configure
        make
        sudo make install                                    
  • 下载SDK
  • 安装SDK
    • 如果curl、apr、apr-util和mxml第三方库安装在默认路径下时,安装方式如下:
      cmake .
      make
      make install                            
    • 如果curl、apr、apr-util 和mxml第三方库不是安装在默认路径下,安装 SDK时,需要指定其安装路径,安装方式如下:
      cmake -f CMakeLists.txt
      // 编译类型为Release。常用的编译类型为:Debug、Release、RelWithDebInfo和MinSizeRel,默认使用Debug。
      -DCMAKE_BUILD_TYPE=Release
      // 自定义安装目录。
      -DCMAKE_INSTALL_PREFIX=/usr/local/
      // 指定curl、apr、apr-util和xml第三方库头文件和库文件的所在目录。
      -DCURL_INCLUDE_DIR=/usr/include/curl
      -DCURL_LIBRARY=/usr/lib64/libcurl.so
      -DAPR_INCLUDE_DIR=/usr/include/apr-1
      -DAPR_LIBRARY=/usr/lib64/libapr-1.so
      -DAPR_UTIL_INCLUDE_DIR=/usr/include/apr-1
      -DAPR_UTIL_LIBRARY=/usr/lib64/libaprutil-1.so
      -DMINIXML_INCLUDE_DIR=/usr/include
      -DMINIXML_LIBRARY=/usr/lib64/libmxml.so
      // 编译时报错Could not find apr-config/apr-1-config,原因是在默认路径里面找不到apr-1-config文件,请添加该选项。
      -DAPR_CONFIG_BIN=/path/to/bin/apr-1-config
      // 编译时报错Could not find apu-config/apu-1-config,原因是在默认路径里面找不到apu-1-config文件,请添加该选项。
      -DAPU_CONFIG_BIN=/path/to/bin/apu-1-config                            

Windows环境下的安装

  • 下载SDK
  • 安装SDK

    使用Visual Studio编译OSS C SDK的详细步骤及常见问题,请参见Windows下编译使用Aliyun OSS C SDK

    说明 如果您使用Visual Studio 2012及其以后版本打开时,会提示是否将项目升级成最新版的编译器和库,这里最好和您自己的项目保持一致。如果项目使用了最新版本的编译器和库,就选择升级,否则可以不升级。