全部产品
Search

搜索本产品

    对象存储 OSS：C安装

    文档中心

    对象存储 OSS：C安装

    更新时间：Dec 20, 2023

    如果您需要管理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。