Object Storage Service:Installation (C SDK)

Prérequis

Installez les compilateurs GCC et G++ version 4.8 ou ultérieure pour prendre en charge la syntaxe de base C99 et GNU99.

Informations générales

Lors de l'installation du SDK C pour OSS, vous devez également installer l'outil de build CMake ainsi que les bibliothèques tierces curl, apr, apr-util et minixml.

Installation sous Linux

1. Installez CMake.

   Red Hat/Alibaba Cloud/CentOS

   sudo yum install cmake 

   Ubuntu/Debian

   sudo apt-get install cmake 

   SuSE

   sudo zypper install cmake 

2. Installez les bibliothèques tierces.

   Red Hat/Alibaba Cloud/CentOS

   1. Installez la bibliothèque curl.

      yum -y install libcurl-devel

   2. Installez la bibliothèque apr.

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

   3. Installez la bibliothèque minixml.

      1. Téléchargez la bibliothèque minixml.

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

      2. Décompressez le fichier de la bibliothèque minixml.

         tar zxf mxml-2.9.tar.gz

      3. Accédez au dossier.

         cd mxml-2.9

      4. Compilez et installez la bibliothèque 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. Installez le SDK C.

   1. Téléchargez le package source du SDK C pour OSS.

      L'exemple suivant utilise la version 3.10.0. Pour le lien de téléchargement, consultez GitHub.

   2. Décompressez le package.

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

   3. Accédez au dossier.

      cd aliyun-oss-c-sdk-3.10.0

   4. Installez le SDK C.

      cmake .
      make
      sudo make install

      Si les bibliothèques tierces curl, apr, apr-util et mxml ne sont pas installées dans le chemin par défaut, spécifiez leurs chemins d'installation lors de l'installation du 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. Compilez l'exemple de projet.

   1. Téléchargez l'exemple de projet.

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

   2. Décompressez l'exemple de projet.

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

      Remarque

      Pour installer oss-c-sdk-demo-specified-installation, spécifiez le dossier d'installation, par exemple /home/your/oss/csdk. Les autres exemples de projets utilisent les chemins d'installation par défaut du SDK C pour OSS et de ses bibliothèques de dépendance ; il n'est donc pas nécessaire de spécifier un dossier d'installation. Pour plus d'informations sur l'installation de l'exemple de projet, consultez Utilisation du SDK C Alibaba Cloud OSS sous Linux.

   3. Compilez l'exemple de projet.

      1. Accédez au dossier du projet (oss-c-sdk-demo-xxx).

      2. Exécutez make pour compiler l'exemple de projet.

         Remarque

         Remplacez OSS_ENDPOINT, ACCESS_KEY_ID, ACCESS_KEY_SECRET et BUCKET_NAME dans l'exemple de code par des valeurs valides. Si les bibliothèques dynamiques du SDK C pour OSS et de ses dépendances ne se trouvent pas dans un chemin de bibliothèque système, utilisez LD_LIBRARY_PATH pour spécifier leur emplacement lors de l'exécution du programme.

      3. Exécutez ./main pour lancer le programme exécutable.

         Pour recompiler, exécutez make clean.

Installation sous Windows

1. Téléchargez et installez le SDK C pour OSS.

   • Téléchargement direct

   • Téléchargement depuis GitHub

2. Téléchargez et décompressez l'exemple de projet.

   • Téléchargement direct

   • Téléchargement depuis GitHub

3. Utilisez Visual Studio pour compiler l'exemple de projet.

   • Si vous utilisez Visual Studio 2012 ou une version ultérieure, une invitation à mettre à niveau le projet pour utiliser le dernier compilateur et les dernières bibliothèques s'affiche. Nous vous recommandons d'aligner les versions de l'éditeur et des bibliothèques sur celle de votre projet. Si votre projet est compatible avec le dernier compilateur et les dernières bibliothèques, cliquez sur Upgrade. Sinon, n'effectuez pas la mise à niveau.

   • Avant de compiler l'exemple de projet, remplacez OSS_ENDPOINT, ACCESS_KEY_ID, ACCESS_KEY_SECRET, BUCKET_NAME, OBJECT_NAME, MULTIPART_UPLOAD_FILE_PATH et DIR_NAME dans oss_config.c par des valeurs valides.

   • Pour obtenir les étapes détaillées et la FAQ relative à l'utilisation de Visual Studio pour exécuter l'exemple de projet, consultez Compilation et utilisation du SDK C Alibaba Cloud OSS sous Windows.