258 英雄联盟

Android SDK开发指南__类型5：移动加速_用户指南_CDN-阿里云

1. 安装移动加速SDK

1.1 开通移动加速服务

在使用本SDK前，您需要到阿里云官网CDN控制台页面注册开通移动加速域名。然后，您可以在控制台页面直接下载，或通过阿里云移动服务OneSDK打包平台，勾选移动加速组件进行下载。

1.2 集成SDK

通过常规的Jar包依赖配置即可集成移动加速服务。

2. 配置SDK

2.1 添加相关权限

使用移动加速Android SDK需要以下权限，请将下列权限添加到AndroidManifest.xml中。

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

2.2 移动加速初始化

使用移动加速服务，您只需要一行代码即可实现快速集成。

// context是APP的Context
MACService macService = MACServiceProvider.getService(context);

2.3 控制降级开关

您可以通过降级开关控制请求的处理路径，关闭降级的情况下请求将进入移动加速处理路径，开启降级后请求将进入Native网络库处理路径。

// 降级移动加速
macService.setDegradation(true);

MACService实例负责着应用程序生命周期内所有连接的发起、管理、回收，因此云加速中MACService只需要存在一个全局的实例并初始化一次；
MACService的实例化应当尽可能放在应用程序的初始化阶段，以便SDK能提前做好网络情况的探测和路由的规划；

2.4 预解析接口

您可以通过预解析接口进行移动加速域名的预解析与建连，提升首次访问的效率。

macService.presetMACDomains(new String[]{"macbm.ams.aliyuncs.com"});

2.5 cookie管理开关

您可以通过cookie管理开关控制移动加速sdk是否做cookie管理。

// 打开cookie管理功能
macService.setCookieEnabled(true);

3. 使用示例

完整代码示例请参考alicloud-android-demo。

4. 如何判断是否成功集成了移动加速，是否走了移动加速链路

由于移动加速本身封装了降级逻辑以提升访问成功率，用户可以通过查看日志来确认当前请求是否走在移动加速链路上，打开日志开关：

macService.setLogEnabled(true);

*请在生产环境关闭日志，避免带来的性能影响。

打开日志后如果您能搜索到如下关键字的日志信息，则说明您的请求运行在了移动加速链路上：

[readNameValueBlock] - name: :version Value:HTTP/1.1

5. 混淆配置

-keep class com.alibaba.sdk.android.**{*;}
-keep class com.ut.**{*;}
-keep class com.ta.**{*;}

6. 错误码说明

访问移动加速域名返回的异常错误码与CDN错误码体系保持一致，请参考CDN页面相关文档。

最后更新：2016-11-23 16:03:55