Android SMSSDK非Gradle集成教程
一、说明
(1)3.x与之前的旧版本互不兼容,请严格按照本文档进行3.x的首次集成或老版本的升级操作。
(2)3.x之前版本的集成,请参考:http://wiki.mob.com/android-%e7%9f%ad%e4%bf%a1sdk%e9%9b%86%e6%88%90%e6%96%87%e6%a1%a3/
–>集成之前先要申请Mob的appkey与appsecret;申请完添加短信SDK的产品;得到key我们开始集成;
二、获取SDK
请至Mob官网下载最新SDK,解压后会看到以下目录结构:
SMSSDK下存放的是短信SDK的全部内容。
三、导入SDK
1.Eclipse
Eclipse版本的SMSSDK目录下包含两个工程:
SMSSDK:短信SDK核心库(必须)
ShortMessageSDKGUI:我们提供的开源GUI库(非必须)
如果你不想定制自己的UI,可以直接使用我们提供的ShortMessageSDKGUI,否则,不需要导入ShortMessageSDKGUI。接下来,我们以使用ShortMessageSDKGUI为例说明。
1.1、首先将上述两个工程导入Eclipse:
1.2、将上述两个工程挂接到你的工程上:
右键你的工程 → Properties → Android
同时将SMSSDK挂接到ShortMessageSDKGUI上:
注意:如果你不需要使用ShortMessageSDKGUI,请直接将SMSSDK挂接到你的项目上。
2.Android Studio
从3.1.0版本开始,不再提供独立的Android Studio版本下载,推荐AS版开发者按照最新的maven集成方式进行在线下载安装。
AS版本的SMSSDK目录下包含以下内容:
MobCommons.jar:Mob 通用公共库(必须)
MobTools.jar:Mob 工具公共库(必须)
SMSSDK-.aar:SMSSDK 核心(必须)
SMSSDKGUI-.aar:SMSSDK GUI 开源库(非必须)
HowToUse.txt:使用说明
注意:如果你同时使用ShareSDK,保留一份公共库就行(公共库版本一致或兼容)。
2.1、将以上文件按需放入Android Studio项目所要使用SMSSDK的Module所在的Libs里面:
2.2、在Module的build.gradle里面将libs加入仓库(repositories):
repositories{ flatDir{ dirs 'libs' //就是你放aar的目录地址 } }
2.3、在Module的build.gradle里面添加依赖(dependencies )注意:SMSSDK-,是随着版本变化的;eg:3.0.0的版本则需要改成:compile name:’SMSSDK-3.0.0′,ext:’aar’
dependencies { ....//你的其他依赖 compile name:'SMSSDK-<version>',ext:'aar' compile name:'SMSSDKGUI-<version>',ext:'aar' }
最终,你的build.gradle看起来应该像这样:
四、添加代码
1.配置AndroidManifest.xml
1.1、添加以下权限:
<uses-permission android:name="android.permission.READ_CONTACTS" /> <uses-permission android:name="android.permission.READ_PHONE_STATE" /> <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" /> <uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.RECEIVE_SMS" /> <uses-permission android:name="android.permission.GET_TASKS" /> <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
1.2、添加以下Activity:
<activity android:name="com.mob.tools.MobUIShell" android:theme="@android:style/Theme.Translucent.NoTitleBar" android:configChanges="keyboardHidden|orientation|screenSize" android:windowSoftInputMode="stateHidden|adjustResize"/>
1.3、在Application节点下添加以下属性:
android:name="com.mob.MobApplication"
1.4、在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"/>
最终,你的AndroidManifest.xml看起来应该像这样:
2.使用SDK功能
有两种方法完成验证码短信的发送和验证:调用可视化界面和使用无界面接口
2-1、以可视化界面完成操作
public void sendCode(Context context) { RegisterPage page = new RegisterPage(); //如果使用我们的ui,没有申请模板编号的情况下需传null page.setTempCode(null); page.setRegisterCallback(new EventHandler() { public void afterEvent(int event, int result, Object data) { if (result == SMSSDK.RESULT_COMPLETE) { // 处理成功的结果 HashMap<String,Object> phoneMap = (HashMap<String, Object>) data; String country = (String) phoneMap.get("country"); // 国家代码,如“86” String phone = (String) phoneMap.get("phone"); // 手机号码,如“13800138000” // TODO 利用国家代码和手机号码进行后续的操作 } else{ // TODO 处理错误的结果 } } }); page.show(context); }
2-2、以无界面接口完成操作
// 在尝试读取通信录时以弹窗提示用户(可选功能) SMSSDK.setAskPermisionOnReadContact(true); EventHandler eventHandler = new EventHandler() { public void afterEvent(int event, int result, Object data) { // afterEvent会在子线程被调用,因此如果后续有UI相关操作,需要将数据发送到UI线程 Message msg = new Message(); msg.arg1 = event; msg.arg2 = result; msg.obj = data; new Handler(Looper.getMainLooper(), new Callback() { @Override public boolean handleMessage(Message msg) { int event = msg.arg1; int result = msg.arg2; Object data = msg.obj; if (event == SMSSDK.EVENT_GET_VERIFICATION_CODE) { if (result == SMSSDK.RESULT_COMPLETE) { // TODO 处理成功得到验证码的结果 // 请注意,此时只是完成了发送验证码的请求,验证码短信还需要几秒钟之后才送达 } else { // TODO 处理错误的结果 ((Throwable) data).printStackTrace(); } } else if (event == SMSSDK.EVENT_SUBMIT_VERIFICATION_CODE) { if (result == SMSSDK.RESULT_COMPLETE) { // TODO 处理验证码验证通过的结果 } else { // TODO 处理错误的结果 ((Throwable) data).printStackTrace(); } } // TODO 其他接口的返回结果也类似,根据event判断当前数据属于哪个接口 return false; } }).sendMessage(msg); } }; // 注册一个事件回调,用于处理SMSSDK接口请求的结果 SMSSDK.registerEventHandler(eventHandler); // 请求验证码,其中country表示国家代码,如“86”;phone表示手机号码,如“13800138000” SMSSDK.getVerificationCode(country, phone); // 提交验证码,其中的code表示验证码,如“1357” SMSSDK.submitVerificationCode(country, phone, code); // 使用完EventHandler需注销,否则可能出现内存泄漏 protected void onDestroy() { super.onDestroy(); SMSSDK.unregisterEventHandler(eventHandler); }
其中EventHandler是短信SDK的操作回调,具体说明文档请参阅:短信SDK操作回调章节。
3.关于配置AppKey和AppSecret的说明
配置AppKey和AppSecret有两种方式:
(1)通过AndroidManifest配置
(2)通过代码配置
以上方法择一即可,建议使用第一种方式进行配置。
3.1、通过AndroidManifest配置:
(1)在Application节点下添加以下属性:
android:name="com.mob.MobApplication"
注意:如果你有自己的Application类,那么也可以让你的Application类继承MobApplication即可。
(2)在Application节点下添加以下子节点:
<!-- 通过AndroidManifest配置AppKey和AppSecret,如果你选择通过代码配置,则不需要配置以下meta-data --> <meta-data android:name="Mob-AppKey" android:value="你的AppKey"/> <meta-data android:name="Mob-AppSecret" android:value="你的AppSecret"/>
3.2、通过代码配置:
如果选择通过代码配置,则不需要继承MobApplication,只要在使用SMSSDK之前,调用以下代码:
// 通过代码注册你的AppKey和AppSecret MobSDK.init(context, "你的AppKey", "你的AppSecret");
五、代码混淆
如果你开启了proguard混淆,需要在proguard的rules里面添加以下规则:
# SMSSDK -dontwarn com.mob.** -keep class com.mob.**{*;} -dontwarn cn.smssdk.** -keep class cn.smssdk.**{*;}
低调大师中文资讯倾力打造互联网数据资讯、行业资源、电子商务、移动互联网、网络营销平台。
持续更新报道IT业界、互联网、市场资讯、驱动更新,是最及时权威的产业资讯及硬件资讯报道平台。
转载内容版权归作者及来源网站所有,本站原创内容转载请注明来源。
- 上一篇
03.Android之View原理问题
目录介绍 3.0.0.1 View的绘制需要经过哪些过程?有哪些常用回调方法?View的绘制流程的详细流程是怎样的? 3.0.0.2 View绘制流程,当一个TextView的实例调用setText()方法后执行了什么?请说一下原理…… 3.0.0.3 requestLayout()、invalidate()与postInvalidate()有什么区别? 3.0.0.4 DecorView的作用是什么?DecorView中如何获取ContentView以及Activity所设置的View?ViewRootIml如何和DecorView建立联系? 3.0.0.5 getWidth()方法和getMeasureWidth()区别呢?为什么有时候用getWidth()或者getMeasureWidth()得到0? 3.0.0.6 平时写的自定义控件有哪些?如何优化自定义view?View的绘制流程说一下?自定义View的注意点? 3.0.0.7 View的wrap_content和match_parent效果一致的原因分析?getDefaultSize方法的处理逻辑? 3.0.0.8 Vie...
- 下一篇
小视频开发过程中最关注的两点关键
小视频凭借它独有的特征在互联网领域获得了属于自己的一席之地,斩获搞笑、游戏、美食等行业后,在教育、财经等方面还拥有更加可观的发展前景。那么,在小视频开发过程中应该怎样结合它的能力实现业务上的突破呢?在小视频的拍摄阶段,用户通常最关注的的还是视频的清晰度和流畅度,我们可以从这几个环节入手,进行相关的优化。1.提升预览帧率摄像头采集数据再呈现到设备屏幕,一般采用GPU驱动渲染,确保渲染的实时性,还可以在一定程度上减少延迟和丢帧的情况。再者是针对人脸特效的渲染,我们通常可以采取3buffer的CPU回调方案,减少BUFFER资源等待所造成的帧率下降。2.提升录制帧率这里所说的录制是将视频进行编码的过程,整体采用CPU来直接渲染到硬件编码Surface,可以同时保留之前的buffer方案进行软件编码的适配,将编码的延迟和丢帧缩短到最小。 3.选择最优适配在开发过程中,移动终端的机型复杂的问题是非常令人头疼的。由于市面上机型的复杂度非常高,而且每一种机型的硬件能力、屏幕分辨率、性能等方面的指标都是千差万别的,要想最大限度的保证,能够在最低端机型上所呈现出的视频质量达到标准质量,那么就需要在提升清...
相关文章
文章评论
共有0条评论来说两句吧...
文章二维码
点击排行
-
Docker使用Oracle官方镜像安装(12C,18C,19C)
- Springboot2将连接池hikari替换为druid,体验最强大的数据库连接池
- CentOS8编译安装MySQL8.0.19
- Docker快速安装Oracle11G,搭建oracle11g学习环境
- SpringBoot2配置默认Tomcat设置,开启更多高级功能
- MySQL8.0.19开启GTID主从同步CentOS8
- CentOS7,8上快速安装Gitea,搭建Git服务器
- Jdk安装(Linux,MacOS,Windows),包含三大操作系统的最全安装
- SpringBoot2编写第一个Controller,响应你的http请求并返回结果
推荐阅读
最新文章
- SpringBoot2整合Redis,开启缓存,提高访问速度
- Jdk安装(Linux,MacOS,Windows),包含三大操作系统的最全安装
- SpringBoot2配置默认Tomcat设置,开启更多高级功能
- Springboot2将连接池hikari替换为druid,体验最强大的数据库连接池
- SpringBoot2整合MyBatis,连接MySql数据库做增删改查操作
- Hadoop3单机部署,实现最简伪集群
- Docker使用Oracle官方镜像安装(12C,18C,19C)
- MySQL8.0.19开启GTID主从同步CentOS8
- SpringBoot2编写第一个Controller,响应你的http请求并返回结果
- Windows10,CentOS7,CentOS8安装MongoDB4.0.16