Android SMSSDK非Gradle集成教程

1、说明

（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咱们开始集成；

2、获取SDK

请至Mob官网下载最新SDK，解压后会看到如下目录结构：

SMSSDK下存放的是短信SDK的所有内容。

3、导入SDK

1.Eclipse

Eclipse版本的SMSSDK目录下包含两个工程：

SMSSDK：短信SDK核心库（必须）

ShortMessageSDKGUI：咱们提供的开源GUI库（非必须）

若是你不想定制本身的UI，能够直接使用咱们提供的ShortMessageSDKGUI，不然，不须要导入ShortMessageSDKGUI。接下来，咱们以使用ShortMessageSDKGUI为例说明。

1.一、首先将上述两个工程导入Eclipse：

1.二、将上述两个工程挂接到你的工程上：

右键你的工程 → 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-<version>.aar：SMSSDK 核心（必须）

SMSSDKGUI-<version>.aar：SMSSDK GUI 开源库（非必须）

HowToUse.txt：使用说明

注意：若是你同时使用ShareSDK,保留一份公共库就行（公共库版本一致或兼容）。

2.一、将以上文件按需放入Android Studio项目所要使用SMSSDK的Module所在的Libs里面：

2.二、在Module的build.gradle里面将libs加入仓库（repositories）：

repositories{
    flatDir{
        dirs 'libs' //就是你放aar的目录地址
    }
}
复制代码

2.三、在Module的build.gradle里面添加依赖（dependencies ）注意：SMSSDK-<verison>，是随着版本变化的；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看起来应该像这样：

4、添加代码

1.配置AndroidManifest.xml

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.二、添加如下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.三、在Application节点下添加如下属性：

android:name="com.mob.MobApplication"
复制代码

1.四、在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-一、以可视化界面完成操做

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-二、以无界面接口完成操做

// 在尝试读取通讯录时以弹窗提示用户（可选功能）
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.一、经过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.二、经过代码配置：

若是选择经过代码配置，则不须要继承MobApplication，只要在使用SMSSDK以前，调用如下代码：

// 经过代码注册你的AppKey和AppSecret
MobSDK.init(context, "你的AppKey", "你的AppSecret");
复制代码

5、代码混淆

若是你开启了proguard混淆，须要在proguard的rules里面添加如下规则：

# SMSSDK
-dontwarn com.mob.**
-keep class com.mob.**{*;}
 
-dontwarn cn.smssdk.**
-keep class cn.smssdk.**{*;}
复制代码