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 をインストールする
CMake をインストールします。
RedHat/Aliyun/CentOS
sudo yum install cmake
Ubuntu/Debian
sudo apt-get install cmake
SuSE
sudo zypper install cmake
サードパーティライブラリをインストールします。
RedHat/Aliyun/CentOS
curl ライブラリをインストールします。
yum -y install libcurl-devel
apr ライブラリをインストールします。
yum install apr-util yum install apr-devel yum install apr-util-devel
minixml ライブラリをインストールします。
minixml ライブラリをダウンロードします。
wget "https://github.com/michaelrsweet/mxml/releases/download/release-2.9/mxml-2.9.tar.gz"
minixml ライブラリファイルを解凍します。
tar zxf mxml-2.9.tar.gz
ディレクトリに移動します。
cd mxml-2.9
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
C 用 OSS SDK をインストールします。
ソースコードパッケージをダウンロードします。
次のサンプルコードでは、例として V3.10.0 を使用しています。詳細については、GitHub をご覧ください。
パッケージを解凍します。
tar zxf aliyun-oss-c-sdk-3.10.0.tar.gz
ディレクトリに移動します。
cd aliyun-oss-c-sdk-3.10.0
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
サンプルプロジェクトをコンパイルします。
サンプルプロジェクトをダウンロードします。
wget https://docs-aliyun.cn-hangzhou.oss.aliyun-inc.com/assets/attach/32132/cn_zh/1487730555529/aliyun-oss-c-sdk-demo.tar.gz
サンプルプロジェクトを解凍します。
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 を使用する」をご参照ください。
サンプルプロジェクトをコンパイルします。
プロジェクトディレクトリ (oss-c-sdk-demo-xxx) に移動します。
make
コマンドを実行して、サンプルプロジェクトをコンパイルします。説明サンプルプロジェクトの OSS_ENDPOINT、ACCESS_KEY_ID、ACCESS_KEY_SECRET、BUCKET_NAME を有効な値に置き換えます。 C 用 OSS SDK と依存ライブラリのダイナミックライブラリがシステムディレクトリにない場合は、
LD_LIBRARY_PATH
を使用して C 用 OSS SDK と依存ライブラリのダイナミックライブラリのディレクトリを指定します。./main
コマンドを実行して、実行可能プログラムを実行します。サンプルプロジェクトを再コンパイルするには、
make clean
コマンドを実行します。
Windows に C 用 OSS SDK をインストールする
C 用 OSS SDK をダウンロードしてインストールします。
サンプルプロジェクトのパッケージをダウンロードして解凍します。
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 を使用する」をご参照ください。