SMSSDK從2.x版本升級至3.x版本指導

1、前言

本文檔旨在指導開發者如何從SMSSDK2.1.4及以前版本升級至3.0.0版。

簡而言之，SDK的導入和掛接方法以及混淆配置不變，只是註冊和初始化方法有少量變化。

完整接入流程請參考：Android 短信SDK集成文檔（for 3.0.0及以上）http://wiki.mob.com/sdk-sms-android-3-0-0/

2、升級方法

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、添加代碼 / 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方式提醒用戶。

至此，所有升級工做已經完畢。