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