安装SDK工具包

安装步骤

  1. 官方网站下载SDK压缩包。

  2. 解压得到jar包。目前jar包应该包含三个文件,分别是:bos-android-sdk-1.0.X.jar、okhttp-3.x.x.jar 和 okio-1.x.x.jar。

  3. 将jar包复制到您的Android工程的lib(libs)目录下。

  4. 在Eclipse右键工程->Properties->Java Build Path->Add JARs,导入您刚才复制的jar包。

    在Android Studio右键项目->Open Module Settings->选择项目模块->Dependencies->+,选择File dependency,在lib(libs)目录下选择复制的jar包就可以完成导入。

    注意:从1.0.3版本开始,BOS android SDK将不再使用Apache HttpClient,而是采用更为轻便高效的OKHttp。具体内容可以参考官网:http://square.github.io/okhttp/

配置权限

请确保您的工程中AndroidManifest.xml文件中已经配置了如下权限,否则,SDK将无法正常运行。

<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.READ_PHONE_STATE"/>
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>

配置混淆协议

-dontwarn com.baidubce.**
-keep class com.baidubce.**{*;}
-keep interface com.baidubce.**{*;}

SDK目录结构

com.baidubce
       ├── auth                                        //BCE签名相关类
       ├── http                                        //BCE的Http通信相关类
       ├── internal                                    //SDK内部类
       ├── model                                       //BCE公用model类
       ├── services
       │       └── bos                                 //BOS服务相关类
       │           ├── model                           //BOS内部model,如Request或Response
       │           ├── BosClient.class                 //BOS客户端入口类
       │           └── BosClientConfiguration.class    //针对BOS特有的HttpClient的配置
       │       └── sts                                 //STS服务相关类
       │           └── model                           //STS的内部model
       ├── util                                        //BCE公用工具类
       ├── BceClientConfiguration.class                //对BCE的HttpClient的配置
       ├── BceClientException.class                    //BCE客户端的异常类
       ├── BceServiceException.class                   //与BCE服务端交互后的异常类
       ├── ErrorCode.class                             //BCE通用的错误码
       └── Region.class                                //BCE提供服务的区域