一、前言
本文档旨在指导开发者如何从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方式提醒用户。
至此,全部升级工作已经完毕。