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方式提醒用户。

至此，所有升级工做已经完毕。