Todos los productos
Search

Este producto

    Object Storage Service:Installation (C SDK)

    Centro de documentos

    Object Storage Service:Installation (C SDK)

    Última actualización: Sep 15, 2026

    Instale el SDK de C de OSS para gestionar buckets de OSS, cargar y descargar archivos, administrar datos y procesar imágenes. En este tema se describe cómo instalar el SDK de C de OSS.

    Requisitos previos

    Instale los compiladores GCC y G++ en la versión 4.8 o posterior. Esto garantiza la compatibilidad con la sintaxis básica de C99 y GNU99.

    Contexto

    Al instalar el SDK de C de OSS, también debe instalar la herramienta de compilación CMake y las bibliotecas de terceros curl, apr, apr-util y minixml.

    Nombre

    Descripción

    Requisitos de versión

    CMake

    Herramienta de compilación.

    3.10.0 o posterior

    curl

    Resuelve problemas de red.

    7.32.0 o posterior

    apr-util

    Gestiona la memoria y resuelve problemas multiplataforma.

    1.5.2 o posterior

    minixml

    Analiza sintácticamente el XML que devuelve una solicitud.

    Se recomienda la versión 2.9.

    Instalación en Linux

    1. Instale CMake.

      Red Hat/Alibaba Cloud/CentOS

      sudo yum install cmake

      Ubuntu/Debian

      sudo apt-get install cmake

      SuSE

      sudo zypper install cmake

    2. Instale las bibliotecas de terceros.

      Red Hat/Alibaba Cloud/CentOS

      1. Instale la biblioteca curl.

        yum -y install libcurl-devel

      2. Instale la biblioteca apr.

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

      3. Instale la biblioteca minixml.

        1. Descargue la biblioteca minixml.

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

        2. Descomprima el archivo de la biblioteca minixml.

          tar zxf mxml-2.9.tar.gz

        3. Vaya a la carpeta.

          cd mxml-2.9

        4. Compile e instale la biblioteca 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. Instale el SDK de C.

      1. Descargue el paquete de código fuente del SDK de C de OSS.

        A continuación se muestra un ejemplo con la versión 3.10.0. Para obtener el enlace de descarga, consulte GitHub.

      2. Descomprima el paquete.

        tar zxf aliyun-oss-c-sdk-3.10.0.tar.gz

      3. Vaya a la carpeta.

        cd aliyun-oss-c-sdk-3.10.0

      4. Instale el SDK de C.

        cmake .
make
sudo make install

        Si las bibliotecas de terceros curl, apr, apr-util y mxml no están instaladas en la ruta predeterminada, especifique sus rutas de instalación durante la instalación del 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. Compile el proyecto de ejemplo.

      1. Descargue el proyecto de ejemplo.

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

      2. Descomprima el proyecto de ejemplo.

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

        Cuando instale oss-c-sdk-demo-specified-installation, especifique la carpeta de instalación, por ejemplo, /home/your/oss/csdk. Los demás proyectos de ejemplo usan las rutas de instalación predeterminadas del SDK de C de OSS y de sus bibliotecas dependientes, por lo que no es necesario especificar una carpeta de instalación.

      3. Compile el proyecto de ejemplo.

        1. Vaya a la carpeta del proyecto (oss-c-sdk-demo-xxx).

        2. Ejecute make para compilar el proyecto de ejemplo.

          Nota

          Reemplace OSS_ENDPOINT, ACCESS_KEY_ID, ACCESS_KEY_SECRET y BUCKET_NAME en el código de ejemplo por valores válidos. Si las bibliotecas dinámicas del SDK de C de OSS y de sus dependencias no se encuentran en una ruta de bibliotecas del sistema, use LD_LIBRARY_PATH para especificar su ubicación cuando ejecute el programa.

        3. Ejecute ./main para iniciar el programa ejecutable.

          Para volver a compilar, ejecute make clean.

    Instalación en Windows

    1. Descargue e instale el SDK de C de OSS.

    2. Descargue y descomprima el proyecto de ejemplo.

    3. Use Visual Studio para compilar el proyecto de ejemplo.

      • Si usa Visual Studio 2012 o una versión posterior, el sistema le pedirá actualizar el proyecto para usar el compilador y las bibliotecas más recientes. Se recomienda que las versiones del editor y de las bibliotecas coincidan con la versión de su proyecto. Si su proyecto es compatible con el compilador y las bibliotecas más recientes, haga clic en Upgrade. De lo contrario, no actualice.

      • Antes de compilar el proyecto de ejemplo, reemplace OSS_ENDPOINT, ACCESS_KEY_ID, ACCESS_KEY_SECRET, BUCKET_NAME, OBJECT_NAME, MULTIPART_UPLOAD_FILE_PATH y DIR_NAME en oss_config.c por valores válidos.