全部產品
Search

搜尋本產品

    Object Storage Service：C安裝

    文件中心

    Object Storage Service：C安裝

    更新時間：Feb 28, 2024

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