765      阿裏雲

安裝__Android SDK_SDK使用手冊_消息服務-阿裏雲

直接引入jar包

當您下載了MNS Android SDK 的 zip 包後，進行以下步驟（對Android studio 或者 Eclipse 都適用）:

• 在官網下載 sdk 包
• 解壓後得到 jar 包，目前包括 aliyun-mns-sdk-android-2.2.1.jar、okhttp-3.2.0.jar 和 okio-1.6.0.jar
• 將以上 3 個 jar 包導入 libs 目錄

權限設置

以下是 MNS Android SDK 所需要的 Android 權限，請確保您的 AndroidManifest.xml 文件中已經配置了這些權限，否則，SDK 將無法正常工作。

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

混淆設置

在混淆配置中加入：

-keep class com.alibaba.sdk.android.oss.** { *; }
-dontwarn okio.**
-dontwarn org.apache.commons.codec.binary.**

對 SDK 中同步接口、異步接口的一些說明

考慮到移動端開發場景下不允許在UI線程執行網絡請求的編程規範，SDK大多數接口都提供了同步、異步兩種調用方式，同步接口調用後會阻塞等待結果返回，而異步接口需要在請求時需要傳入回調函數，請求的執行結果將在回調中處理。

同步接口不能在UI線程調用。遇到異常時，將直接拋出ClientException或者ServiceException異常，前者指本地遇到的異常如網絡異常、參數非法等；後者指MNS返回的服務異常，如鑒權失敗、服務器錯誤等。

異步請求遇到異常時，異常會在回調函數中處理。

此外，調用異步接口時，函數會直接返回一個Task，Task可以取消、等待直到完成、或者直接獲取結果。如：

MNSAsyncTask task = mns.asyncGetObejct(...);
task.cancel(); // 可以取消任務
task.waitUntilFinished(); // 等待直到任務完成
GetObjectResult result = task.getResult(); // 阻塞等待結果返回

接口支持同步和異步兩種調用方式，考慮到簡潔性，本文檔中隻有部分重要接口會同時提供同步、異步兩種調用的示例，其他接口暫時以異步調用的示例為主。

最後更新：2016-11-23 16:04:17

  上一篇： 簡介__Android SDK_SDK使用手冊_消息服務-阿裏雲

  下一篇： 初始化__Android SDK_SDK使用手冊_消息服務-阿裏雲