すべてのプロダクト
Search

このプロダクト

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

    ドキュメントセンター

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

    最終更新日:Nov 30, 2025

    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、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 で Alibaba Cloud 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 以降のバージョンを使用している場合、最新のコンパイラとライブラリを使用するようにプロジェクトをアップグレードするよう求められます。エディターとライブラリのバージョンは、ご利用のプロジェクトのバージョンと一致させることを推奨します。ご利用のプロジェクトが最新のコンパイラとライブラリに互換性がある場合は、アップグレードします。そうでない場合は、アップグレードしないでください。

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

      • Visual Studio を使用してサンプルプロジェクトを実行するための詳細な手順とよくある質問 (FAQ) については、「Windows で Alibaba Cloud OSS C SDK をコンパイルして使用する」をご参照ください。