All Products
Search
Document Center

Object Storage Service:Installation

Last Updated:Dec 12, 2023

OSS SDK for C allows you to programmatically manage resources in Object Storage Service (OSS). For example, you can manage buckets, upload objects, download objects, and process images. This topic describes how to install OSS SDK for C.

Prerequisites

GCC and G++ compilers of the latest versions are installed.

Background information

When you install OSS SDK for C on Linux, you must install CMake and the following third-party libraries: cURL, APR, APR-util, and Mini-XML.

Item

Description

Version

CMake

Manages the build process of software by using a compiler-independent method.

2.6.0 or later

curl

Resolves network issues.

7.32.0 or later

apr-util

Manages memory and portability between different platforms.

1.5.2 or later

minixml

Parses the XML data returned by a request.

2.9 (recommended)

Install OSS SDK for C on Linux

  1. Install CMake.

    RedHat/Aliyun/CentOS

    sudo yum install cmake 

    Ubuntu/Debian

    sudo apt-get install cmake 

    SuSE

    sudo zypper install cmake 
  2. Install the third-party libraries.

    RedHat/Aliyun/CentOS

    1. Install the curl library.

      yum -y install libcurl-devel
    2. Install the apr library.

      yum install apr-util
      yum install apr-devel
      yum install apr-util-devel
    3. Install the minixml library.

      1. Download the minixml library.

        wget "https://github.com/michaelrsweet/mxml/releases/download/release-2.9/mxml-2.9.tar.gz"
      2. Decompress the minixml library file.

        tar zxf mxml-2.9.tar.gz
      3. Go to the directory.

        cd mxml-2.9
      4. Compile and install the minixml library.

        ./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. Install OSS SDK for C.

    1. Download the source code package.

      The following sample code uses V3.10.0 as an example. For more information, visit GitHub.

    2. Decompress the package.

      tar zxf aliyun-oss-c-sdk-3.10.0.tar.gz
    3. Go to the directory.

      cd aliyun-oss-c-sdk-3.10.0
    4. Install OSS SDK for C.

      cmake .
      make
      sudo make install

      If you want to install third-party libraries cURL, APR, APR-util, and Mini-XML in a custom installation path, run the following commands to install OSS SDK for C:

      cmake -f CMakeLists.txt
      // Set the build type to Release. Typical build types include Debug, Release, RelWithDebInfo, and MinSizeRel. By default, Debug is used. 
      -DCMAKE_BUILD_TYPE=Release
      // Specify a path to install OSS SDK for C. 
      -DCMAKE_INSTALL_PREFIX=/usr/local/
      // Specify the path in which third-party libraries cURL, APR, APR-util, and Mini-XML are installed. 
      -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
      // If the Could not find apr-config/apr-1-config error is reported during compilation, the apr-1-config file does not exist in the default path. Add the following option: 
      -DAPR_CONFIG_BIN=/path/to/bin/apr-1-config
      // If the Could not find apu-config/apu-1-config error is reported during compilation, the apu-1-config file does not exist in the default path. Add the following option: 
      -DAPU_CONFIG_BIN=/path/to/bin/apu-1-config                            
  4. Compile the sample project.

    1. Download the sample project.

      wget https://docs-aliyun.cn-hangzhou.oss.aliyun-inc.com/assets/attach/32132/cn_zh/1487730555529/aliyun-oss-c-sdk-demo.tar.gz
    2. Decompress the sample project.

      tar zxf aliyun-oss-c-sdk-demo.tar.gz
      Note

      When you install oss-c-sdk-demo-specified-installation, you must specify the installation directory: **/home/your/oss/csdk**. You do not need to specify installation directories for other sample projects because other sample projects are automatically installed based on OSS SDK for C and other dependent third-party libraries. For more information about the Linux sample project, see Use Alibaba Cloud OSS SDK for C in Linux.

    3. Compile the sample project.

      1. Go to the project directory (oss-c-sdk-demo-xxx).

      2. Run the make command to compile the sample project.

        Note

        Replace OSS_ENDPOINT, ACCESS_KEY_ID, ACCESS_KEY_SECRET, and BUCKET_NAME in the sample project with valid values. If OSS SDK for C and the dynamic libraries of the dependent libraries are not in the system directory, use LD_LIBRARY_PATH to specify the directory of OSS SDK for C and the dynamic libraries of the dependent libraries.

      3. Run the ./main command to run executable programs.

        To recompile the sample project, run the make clean command.

Install OSS SDK for C on Windows

  1. Download and install OSS SDK for C.

  2. Download and decompress the package of the sample project.

  3. Use Visual Studio to compile the sample project.

    • If you use Visual Studio 2012 or later, you are prompted to choose whether to upgrade the project version to adapt to the latest versions of the compiler and libraries. We recommend that you use versions that match your project. If the project uses the compiler and libraries of the latest versions, upgrade the project. Otherwise, you do not need to upgrade the project.

    • When you compile the sample project, replace the following parameters in oss_config.c with valid values: OSS_ENDPOINT, ACCESS_KEY_ID, ACCESS_KEY_SECRET, BUCKET_NAME, OBJECT_NAME, MULTIPART_UPLOAD_FILE_PATH, and DIR_NAME.

    • For more information about how to use Visual Studio to run the sample project, see Use Alibaba Cloud OSS SDK for C in Windows.