SMSSDK從2.x版本更新至3.x版本指導

一、前言

本文檔旨在指導開發者如何從SMSSDK2.1.4及之前版本更新至3.0.0版。

簡而言之，SDK的導入和挂接方法以及混淆配置不變，隻是注冊和初始化方法有少許變化。

完整接入流程請參考：Android 短信SDK內建文檔（for 3.0.0及以上）

http://wiki.mob.com/sdk-sms-android-3-0-0/

二、更新方法

1.在Application節點下添加以下屬性：

android:name="com.mob.MobApplication"           

2.Application節點下添加以下meta-data：

<!-- 通過AndroidManifest配置AppKey和AppSecret，如果你選擇通過代碼配置，則不需要配置以下meta-data -->
<meta-data android:name="Mob-AppKey" android:value="你的AppKey"/>
<meta-data android:name="Mob-AppSecret" android:value="你的AppSecret"/>           

注意：注冊AppKey的方法有兩種，除了上述通過MobApplication和meta-data的方式注冊外，還可以使用代碼注冊，具體說明請參考Android 短信SDK內建文檔（for 3.0.0及以上）中的【三、添加代碼 / 3.關于配置AppKey和AppSecret的說明】。

3.删除舊版SDK的初始化方法：

SMSSDK.initSDK(this, "您的appkey", "您的appsecret");           

在新版SDK中，上述方法已經被廢棄，如果你選擇通過上面提到的繼承MobApplication的方式注冊AppKey，則不需要為短信SDK的初始化做其他工作，可以直接開始使用SDK的接口。如果你選擇使用代碼注冊AppKey，則需要在使用短信SDK前調用以下代碼來注冊你的AppKey：

// 通過代碼注冊你的AppKey和AppSecret
MobSDK.init(context, "你的AppKey", "你的AppSecret");           

4.新版SDK新增了以下方法：

// 如果希望在讀取通信錄的時候提示使用者，可以添加下面的代碼，并且必須在其他代碼調用之前，否則不起作用；如果沒這個需求，可以不加這行代碼
   SMSSDK.setAskPermisionOnReadContact(boolShowInDialog)           

用于控制是否在讀取通訊錄時提醒使用者以及提醒的方式（全屏或者非全屏）。

如果不需要提醒使用者，請不要調用以上代碼，SDK預設不提示。

如果需要提醒使用者，則需要調用以上方法，并且必須在其他代碼調用之前，否則不起作用。該方法的參數為True，代表使用非全屏Dialog方式提醒使用者，Fasle代表使用全屏dialog方式提醒使用者。

至此，全部更新工作已經完畢。