全部产品
Search
文档中心

Object Storage Service:Instalasi (C SDK)

更新时间:Nov 30, 2025

Instal OSS C SDK untuk mengelola Bucket OSS, mengunggah dan mengunduh file, mengelola data, serta memproses citra. Topik ini menjelaskan cara menginstal OSS C SDK.

Prasyarat

Instal kompilator GCC dan G++ versi 4.8 atau yang lebih baru untuk mendukung sintaks dasar C99 dan GNU99.

Informasi latar belakang

Saat menginstal OSS C SDK, Anda juga harus menginstal tool build CMake serta library pihak ketiga curl, apr, apr-util, dan minixml.

Name

Deskripsi

Version requirements

CMake

Build tool.

3.10.0 atau lebih baru

curl

Menyelesaikan masalah jaringan.

7.32.0 atau lebih baru

apr-util

Menangani manajemen memori dan isu lintas platform.

1.5.2 atau lebih baru

minixml

Mengurai XML yang dikembalikan oleh permintaan.

Versi 2.9 direkomendasikan.

Instal di Linux

  1. Instal CMake.

    Red Hat/Alibaba Cloud/CentOS

    sudo yum install cmake 

    Ubuntu/Debian

    sudo apt-get install cmake 

    SuSE

    sudo zypper install cmake 
  2. Instal pustaka pihak ketiga.

    Red Hat/Alibaba Cloud/CentOS

    1. Instal pustaka curl.

      yum -y install libcurl-devel
    2. Instal pustaka apr.

      yum install apr-util
      yum install apr-devel
      yum install apr-util-devel
    3. Instal pustaka minixml.

      1. Unduh pustaka minixml.

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

        tar zxf mxml-2.9.tar.gz
      3. Masuk ke folder tersebut.

        cd mxml-2.9
      4. Kompilasi dan instal pustaka 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. Instal C SDK.

    1. Unduh paket sumber OSS C SDK.

      Contoh berikut menggunakan versi 3.10.0. Untuk tautan unduhan, lihat GitHub.

    2. Dekompresi paket.

      tar zxf aliyun-oss-c-sdk-3.10.0.tar.gz
    3. Masuk ke folder tersebut.

      cd aliyun-oss-c-sdk-3.10.0
    4. Instal C SDK.

      cmake .
      make
      sudo make install

      Jika library pihak ketiga curl, apr, apr-util, dan mxml tidak diinstal di path default, Anda harus menentukan path instalasinya saat menginstal SDK.

      cmake -f CMakeLists.txt
      // The build type is Release. Common build types are Debug, Release, RelWithDebInfo, and MinSizeRel. The default is Debug.
      -DCMAKE_BUILD_TYPE=Release
      // Custom installation folder.
      -DCMAKE_INSTALL_PREFIX=/usr/local/
      // Specify the folders where the header files and library files of the curl, apr, apr-util, and xml third-party libraries are located.
      -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, it is because the apr-1-config file cannot be found in the default path. Add this 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, it is because the apu-1-config file cannot be found in the default path. Add this option.
      -DAPU_CONFIG_BIN=/path/to/bin/apu-1-config                            
  4. Kompilasi proyek sampel.

    1. Unduh proyek sampel.

      wget https://docs-aliyun.cn-hangzhou.oss.aliyun-inc.com/assets/attach/32132/cn_zh/1487730555529/aliyun-oss-c-sdk-demo.tar.gz
    2. Dekompresi proyek sampel.

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

      Saat menginstal oss-c-sdk-demo-specified-installation, Anda harus menentukan folder instalasi, misalnya **/home/your/oss/csdk**. Proyek contoh lainnya menggunakan path instalasi default OSS C SDK dan library dependensinya, sehingga Anda tidak perlu menentukan folder instalasi. Untuk informasi selengkapnya tentang instalasi proyek contoh, lihat Use the Alibaba Cloud OSS C SDK on Linux.

    3. Kompilasi proyek sampel.

      1. Masuk ke folder proyek (oss-c-sdk-demo-xxx).

      2. Jalankan make untuk mengompilasi proyek contoh.

        Catatan

        Ganti OSS_ENDPOINT, ACCESS_KEY_ID, ACCESS_KEY_SECRET, dan BUCKET_NAME dalam kode contoh dengan nilai yang valid. Jika library dinamis untuk OSS C SDK dan dependensinya tidak berada di path library sistem, gunakan LD_LIBRARY_PATH untuk menentukan lokasinya saat menjalankan program.

      3. Jalankan ./main untuk menjalankan program yang dapat dieksekusi.

        Untuk mengompilasi ulang, jalankan make clean.

Instal di Windows

  1. Unduh dan instal OSS C SDK.

  2. Unduh dan ekstrak proyek contoh.

  3. Gunakan Visual Studio untuk mengompilasi proyek sampel.

    • Jika Anda menggunakan Visual Studio 2012 atau versi yang lebih baru, Anda akan diminta untuk meningkatkan proyek agar menggunakan kompilator dan library terbaru. Kami menyarankan agar versi editor dan library sesuai dengan versi proyek Anda. Jika proyek Anda kompatibel dengan kompilator dan library terbaru, klik Upgrade. Jika tidak, jangan lakukan peningkatan.

    • Sebelum mengompilasi proyek contoh, ganti OSS_ENDPOINT, ACCESS_KEY_ID, ACCESS_KEY_SECRET, BUCKET_NAME, OBJECT_NAME, MULTIPART_UPLOAD_FILE_PATH, dan DIR_NAME dalam oss_config.c dengan nilai yang valid.

    • Untuk langkah-langkah detail dan pertanyaan umum (FAQ) tentang penggunaan Visual Studio untuk menjalankan proyek contoh, lihat Compile and use the Alibaba Cloud OSS C SDK on Windows.