Todos os produtos
Search

Este produto

    Object Storage Service:Instalação (C SDK)

    Central de documentação

    Object Storage Service:Instalação (C SDK)

    Última atualização: Jul 03, 2026

    Instale o OSS C SDK para gerenciar buckets do OSS, fazer upload e baixe de arquivos, gerencie dados e processar imagens. Este tópico descreve como instale o OSS C SDK.

    Pré-requisitos

    Instale os compiladores GCC e G++, versão 4,8 ou posterior, para oferecer suporte à sintaxe básica C99 e GNU99.

    Informações básicas

    A instalação do OSS C SDK exige também a ferramenta de build CMake e as bibliotecas de terceiros curl, apr, apr-util e minixml.

    Nome

    Descrição

    Requisitos de versão

    CMake

    Ferramenta de build.

    3.10.0 ou posterior

    curl

    Resolve problemas de rede.

    7.32.0 ou posterior

    apr-util

    Gerencia memória e questões multiplataforma.

    1.5.2 ou posterior

    minixml

    Analisa o XML retornado por uma requisição.

    Recomenda-se a versão 2,9.

    Instalação no Linux

    1. Instale o CMake.

      Red Hat/Alibaba Cloud/CentOS

      sudo yum install cmake

      Ubuntu/Debian

      sudo apt-get install cmake

      SuSE

      sudo zypper install cmake

    2. Instale as bibliotecas de terceiros.

      Red Hat/Alibaba Cloud/CentOS

      1. Instale a biblioteca curl.

        yum -y install libcurl-devel

      2. Instale a biblioteca apr.

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

      3. Instale a biblioteca minixml.

        1. Baixe a biblioteca minixml.

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

        2. Descompacte o arquivo da biblioteca minixml.

          tar zxf mxml-2.9.tar.gz

        3. Acesse a pasta.

          cd mxml-2.9

        4. Compile e instale a 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 o C SDK.

      1. Baixe o pacote de código-fonte do OSS C SDK.

        O exemplo a seguir usa a versão 3.10.0. Para obter o link de baixe, consulte GitHub.

      2. Descompacte o pacote.

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

      3. Acesse a pasta.

        cd aliyun-oss-c-sdk-3.10.0

      4. Instale o C SDK.

        cmake .
make
sudo make install

        Se as bibliotecas de terceiros curl, apr, apr-util e mxml não estiverem instaladas no caminho padrão, especifique os caminhos de instalação ao instale o 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 o projeto de exemplo.

      1. Baixe o projeto de exemplo.

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

      2. Descompacte o projeto de exemplo.

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

        Ao instale o oss-c-sdk-demo-specified-installation, especifique a pasta de instalação, como /home/your/oss/csdk. Os demais projetos de exemplo usam os caminhos de instalação padrão do OSS C SDK e de suas bibliotecas dependentes; portanto, não é necessário especifique uma pasta de instalação. Para mais informações sobre a instalação do projeto de exemplo, consulte Usar o Alibaba Cloud OSS C SDK no Linux.

      3. Compile o projeto de exemplo.

        1. Acesse a pasta do projeto (oss-c-sdk-demo-xxx).

        2. Execute make para compilar o projeto de exemplo.

          Nota

          Substitua OSS_ENDPOINT, ACCESS_KEY_ID, ACCESS_KEY_SECRET e BUCKET_NAME no código de exemplo por valores válidos. Se as bibliotecas dinâmicas do OSS C SDK e suas dependências não estiverem em um caminho de biblioteca do sistema, use LD_LIBRARY_PATH para especifique a localização ao execute o programa.

        3. Execute ./main para iniciar o programa executável.

          Para recompilar, execute make clean.

    Instalação no Windows

    1. Baixe e instale o OSS C SDK.

    2. Baixe e descompacte o projeto de exemplo.

    3. Use o Visual Studio para compilar o projeto de exemplo.

      • Ao usar o Visual Studio 2012 ou versão posterior, o sistema solicitará a atualização do projeto para usar o compilador e as bibliotecas mais recentes. Recomendamos que as versões do editor e da biblioteca correspondam à versão do seu projeto. Se o projeto for compatível com o compilador e as bibliotecas mais recentes, clique em Upgrade. Caso contrário, não atualize.

      • Antes de compilar o projeto de exemplo, substitua OSS_ENDPOINT, ACCESS_KEY_ID, ACCESS_KEY_SECRET, BUCKET_NAME, OBJECT_NAME, MULTIPART_UPLOAD_FILE_PATH e DIR_NAME no arquivo oss_config.c por valores válidos.

      • Para etapas detalhadas e perguntas frequentes (FAQ) sobre como usar o Visual Studio para execute o projeto de exemplo, consulte Compilar e usar o Alibaba Cloud OSS C SDK no Windows.