All Products
Search

This Product

    Object Storage Service:Instalasi (C SDK)

    Document Center

    Object Storage Service:Instalasi (C SDK)

    Last Updated:Sep 12, 2026

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

    Prasyarat

    Instal kompilator GCC dan G++ versi 4.8 atau 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

    Description

    Version requirements

    CMake

    Build tool.

    3.10.0 atau lebih baru

    curl

    Menangani 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 library pihak ketiga.

      Red Hat/Alibaba Cloud/CentOS

      1. Instal library curl.

        yum -y install libcurl-devel

      2. Instal library apr.

        yum install apr-util
yum install apr-devel
yum install apr-util-devel

      3. Instal library minixml.

        1. Unduh library minixml.

          wget "https://github.com/michaelrsweet/mxml/releases/download/release-2.9/mxml-2.9.tar.gz"

        2. Ekstrak file library minixml.

          tar zxf mxml-2.9.tar.gz

        3. Masuk ke folder tersebut.

          cd mxml-2.9

        4. Kompilasi dan instal library 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. Ekstrak paket tersebut.

        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
// Jenis build adalah Release. Jenis build umum meliputi Debug, Release, RelWithDebInfo, dan MinSizeRel. Default-nya adalah Debug.
-DCMAKE_BUILD_TYPE=Release
// Folder instalasi kustom.
-DCMAKE_INSTALL_PREFIX=/usr/local/
// Tentukan folder tempat file header dan file library dari library pihak ketiga curl, apr, apr-util, dan xml berada.
-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
// Jika muncul error "Could not find apr-config/apr-1-config" saat kompilasi, artinya file apr-1-config tidak ditemukan di path default. Tambahkan opsi ini.
-DAPR_CONFIG_BIN=/path/to/bin/apr-1-config
// Jika muncul error "Could not find apu-config/apu-1-config" saat kompilasi, artinya file apu-1-config tidak ditemukan di path default. Tambahkan opsi ini.
-DAPU_CONFIG_BIN=/path/to/bin/apu-1-config

    4. Kompilasi proyek contoh.

      1. Unduh proyek contoh.

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

      2. Ekstrak proyek contoh.

        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.

      3. Kompilasi proyek contoh.

        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 contoh.

      • 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 nilai OSS_ENDPOINT, ACCESS_KEY_ID, ACCESS_KEY_SECRET, BUCKET_NAME, OBJECT_NAME, MULTIPART_UPLOAD_FILE_PATH, dan DIR_NAME dalam file oss_config.c dengan nilai yang valid.