すべてのプロダクト
Search

このプロダクト

    Object Storage Service:インストール (C SDK)

    ドキュメントセンター

    Object Storage Service:インストール (C SDK)

    最終更新日:Sep 12, 2026

    Object Storage Service (OSS) C SDK をインストールすることで、OSS バケットの管理、ファイルのアップロードとダウンロード、データの管理、画像の処理を行えます。このトピックでは、OSS C SDK のインストール方法について説明します。

    前提条件

    基本的な C99 および GNU99 構文をサポートするため、バージョン 4.8 以降の GCC および G++ コンパイラをインストールしてください。

    背景情報

    OSS C SDK をインストールする際は、CMake ビルドツールと、サードパーティライブラリである curl、apr、apr-util、minixml もインストールする必要があります。

    名前

    説明

    バージョン要件

    CMake

    ビルドツール。

    3.10.0 以降

    curl

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

    7.32.0 以降

    apr-util

    メモリ管理とクロスプラットフォームの問題を処理します。

    1.5.2 以降

    minixml

    リクエストで返される XML を解析します。

    バージョン 2.9 を推奨します。

    Linux へのインストール

    1. CMake をインストールします。

      Red Hat/Alibaba Cloud/CentOS

      sudo yum install cmake

      Ubuntu/Debian

      sudo apt-get install cmake

      SuSE

      sudo zypper install cmake

    2. サードパーティライブラリをインストールします。

      Red Hat/Alibaba Cloud/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、minixml のサードパーティライブラリがデフォルトパスにインストールされていない場合は、SDK をインストールする際にそれらのインストールパスを指定する必要があります。

        cmake -f CMakeLists.txt
// ビルドタイプは Release です。一般的なビルドタイプには、Debug、Release、RelWithDebInfo、MinSizeRel があります。デフォルトは Debug です。
-DCMAKE_BUILD_TYPE=Release
// カスタムインストールフォルダーの指定。
-DCMAKE_INSTALL_PREFIX=/usr/local/
// curl、apr、apr-util、minixml サードパーティライブラリのヘッダーファイルとライブラリファイルが配置されているフォルダを指定します。
-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 とその依存ライブラリのデフォルトインストールパスを使用するため、インストールフォルダを指定する必要はありません。

      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. OSS C SDK をダウンロードしてインストールします。

    2. サンプルプロジェクトをダウンロードして解凍します。

    3. Visual Studio を使用してサンプルプロジェクトをコンパイルします。

      • Visual Studio 2012 以降のバージョンを使用する場合、最新のコンパイラとライブラリを使用するようにプロジェクトをアップグレードするよう求められます。エディタとライブラリのバージョンがプロジェクトバージョンと一致することを推奨します。プロジェクトが最新のコンパイラとライブラリと互換性がある場合は、[Upgrade] をクリックしてください。それ以外の場合は、アップグレードしないでください。

      • サンプルプロジェクトをコンパイルする前に、oss_config.c 内の OSS_ENDPOINT、ACCESS_KEY_ID、ACCESS_KEY_SECRET、BUCKET_NAME、OBJECT_NAME、MULTIPART_UPLOAD_FILE_PATH、DIR_NAME を有効な値に置き換えてください。