安装OSS C SDK_对象存储(OSS)-阿里云帮助中心

如果您需要管理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环境下的安装

安装CMake。

RedHat/Aliyun/CentOS

sudo yum install cmake

Ubuntu/Debian

sudo apt-get install cmake

SuSE

sudo zypper install cmake

安装第三方库。

RedHat/Aliyun/CentOS

安装curl库。
```
yum -y install libcurl-devel
```

安装apr库。

yum install apr-util
yum install apr-devel
yum install apr-util-devel

安装minixml库。

下载minixml库。

wget "https://github.com/michaelrsweet/mxml/releases/download/release-2.9/mxml-2.9.tar.gz"

解压minixml库文件。
```
tar zxf mxml-2.9.tar.gz
```
进入目录。
```
cd mxml-2.9
```
编译和安装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

安装C SDK。

下载OSS C SDK源码安装包。
以下载的版本为3.10.0为例。下载链接，请参见GitHub。
解压安装包。
```
tar zxf aliyun-oss-c-sdk-3.10.0.tar.gz
```
进入目录。
```
cd aliyun-oss-c-sdk-3.10.0
```

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

编译示例工程。
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环境下的安装

下载SDK并安装OSS C SDK。
- 直接下载
- 通过GitHub下载
下载并解压示例工程。
- 直接下载
- 通过GitHub下载
使用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。