文档

C安装

更新时间:

如果您需要管理OSS存储空间、上传下载文件、管理数据、进行图片处理等,可以先安装OSS C SDK。本文介绍如何安装OSS C SDK。

前提条件

已安装最新版本的gcc和g++编译器。

背景信息

安装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 版本

Linux环境下的安装

  1. 安装CMake。

    RedHat/Aliyun/CentOS

    sudo yum install cmake 

    Ubuntu/Debian

    sudo apt-get install cmake 

    SuSE

    sudo zypper install cmake 
  2. 安装第三方库。

    RedHat/Aliyun/CentOS

    1. 安装curl库。

      yum -y install libcurl-devel
    2. 安装apr库。

      yum install apr-util
      yum install apr-devel
      yum install apr-util-devel
    3. 安装minixml库。

      1. 下载minixml库。

        wget "https://github.com/michaelrsweet/mxml/releases/download/release-2.9/mxml-2.9.tar.gz"
      2. 解压minixml库文件。

        tar zxf mxml-2.9.tar.gz
      3. 进入目录。

        cd mxml-2.9
      4. 编译和安装minixml库。

        ./configure
        make
        sudo make install

    Ubuntu/Debian

    sudo apt-get install libcurl4-openssl-dev libapr1-dev libaprutil1-dev libmxml-dev                                    

    SuSE

    sudo zypper install libcurl-devel libapr1-devel libapr-util1-devel mxml-devel 
  3. 安装C SDK。

    1. 下载OSS C SDK源码安装包。

      以下载的版本为3.10.0为例。下载链接,请参见GitHub

    2. 解压安装包。

      tar zxf aliyun-oss-c-sdk-3.10.0.tar.gz
    3. 进入目录。

      cd aliyun-oss-c-sdk-3.10.0
    4. 安装C SDK。

      cmake .
      make
      sudo 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                            
  4. 编译示例工程。

    1. 下载示例工程。

      wget https://docs-aliyun.cn-hangzhou.oss.aliyun-inc.com/assets/attach/32132/cn_zh/1487730555529/aliyun-oss-c-sdk-demo.tar.gz
    2. 解压示例工程。

      tar zxf aliyun-oss-c-sdk-demo.tar.gz
      说明

      安装oss-c-sdk-demo-specified-installation时需要指定安装目录**/home/your/oss/csdk**。其他示例工程基于OSS C SDK及依赖的第三方库默认安装,不需要指定安装目录。关于示例工程安装详情,请参见Linux下使用Aliyun OSS C SDK

    3. 编译示例工程。

      1. 进入工程目录(oss-c-sdk-demo-xxx)。

      2. 执行make,编译示例工程。

        说明

        将示例代码中的OSS_ENDPOINT、ACCESS_KEY_ID、ACCESS_KEY_SECRET、BUCKET_NAME更换成有效值。如果OSS C SDK及依赖库的动态库不在系统目录下,执行时请使用LD_LIBRARY_PATH指定。

      3. 执行./main运行可执行程序。

        如需重新编译,请执行make clean

Windows环境下的安装

  1. 下载SDK并安装OSS C SDK。

  2. 下载并解压示例工程。

  3. 使用Visual Studio编译示例工程。

    • 如果您使用Visual Studio 2012或以上版本时,会提示是否将项目升级成最新版的编译器和库。建议编辑器及库的版本与自身项目版本保持一致。如果项目使用了最新版本的编译器和库,则选择升级,否则选择不升级。

    • 编译示例工程时,将oss_config.c中的OSS_ENDPOINT、ACCESS_KEY_ID、ACCESS_KEY_SECRET、BUCKET_NAME、OBJECT_NAME、MULTIPART_UPLOAD_FILE_PATH和DIR_NAME替换为有效值。

    • 关于使用Visual Studio运行示例工程的详细步骤及常见问题,请参见Windows下编译使用Aliyun OSS C SDK