安装SDK工具包

运行环境

依赖开源的第三方库，包括curl、openssl、uuid、jsoncpp，其中jsoncpp可在thirdlib文件夹下编译并安装。

SDK目录结构

1├─example // 使用示例   
2├─include // 头文件  
3│  └─bcesdk   
4│      ├─auth        // BCE签名相关类  
5│      ├─bos         // SDK服务相关类  
6│      │  ├─model    // BCE公用model类  
7│      │  ├─request  // SDK请求类  
8│      │  └─response // SDK响应类  
9│      ├─common      // 日志相关和文件工具类，如文件输入输出流   
10│      ├─http        // BCE的HTTP通信相关类   
11│      ├─model       // BOS内部model，如request或response   
12│      └─util        // BCE公用工具类   
13├─msvc               // windows viusal studio相关   
14├─src                // 源码路径   
15│  ├─auth   
16│  ├─bench   
17│  ├─bos   
18│  │  ├─model   
19│  │  ├─request  
20│  │  └─response  
21│  ├─http  
22│  ├─model  
23│  └─util  
24├─thirdlib // 第三方库路径  
25│  └─json  // linux下json依赖库路径  

安装SDK

在官网下载BOS C++ SDK工具包。

Linux Centos用户安装指南

依赖公共库安装:

1sudo yum install gcc-c++
2sudo yum install autoconf
3sudo yum install automake
4sudo yum install libuuid-devel
5sudo yum install openssl-devel
6sudo yum install libcurl-devel 
7sudo yum install cmake

执行以下命令即可在thirdlib中生成jsoncpp库:

1cd thirdlib/json
2cmake ./jsoncpp-1.9.0/
3make
4make install

基于autotools环境构建

1. 执行sh autogen.sh生成configure；
2. 执行configure，添加必要的选项，比如--prefix或者CXXFLAGS等；
3. 执行make & make install，将在对应路径生成include和lib。

编译引用

1. 如果没有安装到gcc默认路径下，则在CXXFLAGS里使用-L指定lib路径，使用-I指定include路径；
2. 在LDFLAGS里指定-lbossdk。
3. cpp需要std-11及其以上环境, 可使用CC=或CXX=来指定高版本gcc或g++编译器。

如果直接写编译命令的，可也以直接指定-L -I -l。

Linux Ubuntu & Debian用户安装指南

依赖公共库安装:

1sudo apt-get -y install build-essential
2sudo apt-get install autoconf
3sudo apt-get install uuid-dev
4sudo apt-get install libssl-dev
5sudo apt-get install libcurl4-openssl-dev 
6sudo apt-get install cmake

执行以下命令即可在thirdlib中生成jsoncpp库:

1cd thirdlib/json/
2cmake ./jsoncpp-1.9.0/
3make
4make install

基于autotools环境构建

1. 执行sh autogen.sh生成configure文件；
2. 执行configure，添加必要的选项，比如--prefix或者CXXFLAGS等；
3. 执行make & make install，将在对应路径生成include和lib。

编译引用

1. 如果没有安装到gcc默认路径下，则在CXXFLAGS里使用-L指定lib路径，使用-I指定include路径；
2. 在LDFLAGS里指定-lbossdk。
3. cpp需要std-11及其以上环境, 可使用CC=或CXX=来指定高版本gcc或g++编译器。

如果直接写编译命令的，可也以直接指定-L -I -l。

Windows用户安装指南

环境准备

1. 安装Visual studio 2012或更高版本。
2. 安装CMake3.1或以上。
3. thirdlib已经包含所需要三方库（curl、jsoncpp），如需要其它版本，请到官方网站下载。

快速体验

1. 解压thirdlib目录下的windows_dependency.zip到thirdlib下。
2. 双击example\\example.sln

编译使用

1. 解压thirdlib目录下的windows_dependency.zip到thirdlib下

2. 创建build目录

   Plain Text 复制

   1mkdir build
   2cd build

3. 生成目标sln cmake -G "\\<type>" ..这里要根据所安装的Visual studio 版本和编译平台，而选择不同的\<type>。

   生成Visual Studio 2015的sln： cmake -G "Visual Studio 14 2015" .. 生成Visual Studio 2013编译目标是64位的sln： cmake -G "Visual Studio 12 2013 Win64"

   参数详见CMake帮助文档。

4. 编译： 直接使用cmake 编译 cmake --build .或手动打开bossdk.sln。

5. 结果生成： 编译结果将生成在代码根目录的output文件夹下。结构如下：

   Plain Text 复制

   1output  
   2├── include  
   3│   └── bcesdk   
   4│       ├── auth  
   5│       ├── bos  
   6│       │   ├── model  
   7│       │   ├── request  
   8│       │   └── response  
   9│       ├── common  
   10│       ├── http  
   11│       ├── model  
   12│       └── util  
   13└── lib  
   14    ├── x64  
   15    │   ├── Debug  
   16    │   └── Release  
   17    └── x86  
   18        ├── Debug  
   19        └── Release  

6. 使用SDK

   编译：把output/include添加include目录下
   链接：主动链接bossdk.lib，jsoncpp.lib，LIBCURL.LIB 执行：把LIBCURL.DLL放到目标exe同一个目录下

低于Visual studio 2012 的编译问题

1. 低于Visual studio 2005将存在大量问题，强烈不建议使用。
2. 必须使用windows SDK 7.1或以上版本。
3. 需要解决stdint.h不存在问题和替换少量的CRT函数如：strtoull，strtoll等。

卸载SDK

预期卸载SDK时，删除output路径。