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

皮皮醬發表於2019-03-21

一、前言

本文件旨在指導開發者如何從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方式提醒使用者。

至此，全部升級工作已經完畢。







相關文章