すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:インストール

最終更新日:May 22, 2025

C 用 OSS SDK を使用すると、Object Storage Service (OSS) のリソースをプログラムで管理できます。たとえば、バケットの管理、オブジェクトのアップロード、オブジェクトのダウンロード、イメージの処理などが可能です。このトピックでは、C 用 OSS SDK をインストールする方法について説明します。

前提条件

C99 および GNU99 構文のサポートを確保するために、バージョン 4.8 以降の GCC および G++ コンパイラがインストールされています。

背景情報

Linux に C 用 OSS SDK をインストールする場合は、CMake と以下のサードパーティライブラリ (cURL、APR、APR-util、Mini-XML) をインストールする必要があります。

項目

説明

バージョン

CMake

コンパイラに依存しない方法でソフトウェアのビルドプロセスを管理します。

3.10.0 以降

curl

ネットワークの問題を解決します。

7.32.0 以降

apr-util

異なるプラットフォーム間でのメモリと移植性を管理します。

1.5.2 以降

minixml

リクエストによって返された XML データを解析します。

2.9 (推奨)

Linux に C 用 OSS SDK をインストールする

  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 用 OSS SDK をインストールします。

    1. ソースコードパッケージをダウンロードします。

      次のサンプルコードでは、例として V3.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 用 OSS SDK をインストールします。

      cmake .
      make
      sudo make install

      サードパーティライブラリ cURL、APR、APR-util、Mini-XML をカスタムインストールパスにインストールする場合は、次のコマンドを実行して C 用 OSS SDK をインストールします。

      cmake -f CMakeLists.txt
      // ビルドタイプを Release に設定します。一般的なビルドタイプには、Debug、Release、RelWithDebInfo、MinSizeRel があります。デフォルトでは、Debug が使用されます。
      -DCMAKE_BUILD_TYPE=Release
      // C 用 OSS SDK をインストールするパスを指定します。
      -DCMAKE_INSTALL_PREFIX=/usr/local/
      // サードパーティライブラリ cURL、APR、APR-util、Mini-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**) を指定する必要があります。他のサンプルプロジェクトは C 用 OSS SDK とその他の依存サードパーティライブラリに基づいて自動的にインストールされるため、インストールディレクトリを指定する必要はありません。 Linux サンプルプロジェクトの詳細については、「Linux で Alibaba Cloud OSS SDK for C を使用する」をご参照ください。

    3. サンプルプロジェクトをコンパイルします。

      1. プロジェクトディレクトリ (oss-c-sdk-demo-xxx) に移動します。

      2. make コマンドを実行して、サンプルプロジェクトをコンパイルします。

        説明

        サンプルプロジェクトの OSS_ENDPOINT、ACCESS_KEY_ID、ACCESS_KEY_SECRET、BUCKET_NAME を有効な値に置き換えます。 C 用 OSS SDK と依存ライブラリのダイナミックライブラリがシステムディレクトリにない場合は、LD_LIBRARY_PATH を使用して C 用 OSS SDK と依存ライブラリのダイナミックライブラリのディレクトリを指定します。

      3. ./main コマンドを実行して、実行可能プログラムを実行します。

        サンプルプロジェクトを再コンパイルするには、make clean コマンドを実行します。

Windows に C 用 OSS SDK をインストールする

  1. C 用 OSS 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 で Alibaba Cloud OSS SDK for C を使用する」をご参照ください。