帮助与文档

> >

一、前言

本文档旨在指导开发者如何从SMSSDK2.1.4及之前版本升级至3.0.0版。

简而言之,SDK的导入和挂接方法以及混淆配置不变,只是注册和初始化方法有少许变化。

完整接入流程请参考:Android 短信SDK集成文档(for 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方式提醒用户。

至此,全部升级工作已经完毕。