短信驗證是現在很流行的一種驗證身份的技術。用戶輸入手機號,短信驗證平臺發送驗證碼至用戶手機,用戶輸入正確的收到的驗證碼即可驗證手機身份。本文介紹引用第三方mob網站的sdk添加進入app實現短信驗證功能的教程。
首先在MOB網站註冊賬戶,在後臺爲你的app註冊獲得appkey和appsecret。後下載網站的短信驗證SDK,這裏是我下載的studio版本的。
通過Android開發文檔進行集成
MobCommons.jar:Mob 通用公共庫(必須)
MobTools.jar:Mob 工具公共庫(必須)
SMSSDK-.aar:SMSSDK 核心(必須)
SMSSDKGUI-.aar:SMSSDK GUI 開源庫(非必須)
1.在lib下導入jar和aar包
這裏寫圖片描述
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
權限
<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.READ_SMS" />
<uses-permission android:name="android.permission.GET_TASKS" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
添加activity
<activity
android:name="com.mob.tools.MobUIShell"
android:theme="@android:style/Theme.Translucent.NoTitleBar"
android:configChanges="keyboardHidden|orientation|screenSize"
android:windowSoftInputMode="stateHidden|adjustResize"/>
2.在Activity中註冊sdk
2.1、在你的主Activity的onCreate方法中添加以下代碼以完成sdk的註冊:
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
// 如果希望在讀取通信錄的時候提示用戶,可以添加下面的代碼,並且必須在其他代碼調用之前,否則不起作用;如果沒這個需求,可以不加這行代碼
SMSSDK.setAskPermisionOnReadContact(boolShowInDialog)
// 創建EventHandler對象
eventHandler = new EventHandler() {
public void afterEvent(int event, int result, Object data) {
if (data instanceof Throwable) {
Throwable throwable = (Throwable)data;
String msg = throwable.getMessage();
runOnUiThread(new Runnable() {
@Override
public void run() {
Toast.makeText(MainActivity.this, msg, Toast.LENGTH_SHORT).show();
}
});
} else {
if (event == SMSSDK.EVENT_GET_VERIFICATION_CODE) {
// 這裏是驗證成功的回調,可以處理驗證成功後您自己的邏輯,需要注意的是這裏不是主線程
}
}
}
};
// 註冊監聽器
SMSSDK.registerEventHandler(eventHandler);
}
其中EventHandler是短信SDK的操作回調,具體說明文檔請參閱:短信SDK操作回調章節。
2.2、SMSSDK提供了默認的界面GUI,上文有提到,如果不想寫界面可以直接調用SDK的默認界面實現註冊,代碼如下:
// 打開註冊頁面
RegisterPage registerPage = new RegisterPage();
registerPage.setRegisterCallback(new EventHandler() {
public void afterEvent(int event, int result, Object data) {
// 解析註冊結果
if (result == SMSSDK.RESULT_COMPLETE) {
@SuppressWarnings("unchecked")
HashMap<String,Object> phoneMap = (HashMap<String, Object>) data;
String country = (String) phoneMap.get("country");
String phone = (String) phoneMap.get("phone");
// 提交用戶信息
//registerUser(country, phone);
}
}
});
registerPage.show(this);
2.3、在onDestroy中註銷SDK:
protected void onDestroy() {
super.onDestroy();
SMSSDK.unregisterEventHandler(eventHandler);
}
3.關於配置AppKey和AppSecret的說明
配置AppKey和AppSecret有兩種方式:
(1)通過AndroidManifest配置
(2)通過代碼配置
以上方法擇一即可,建議使用第一種方式進行配置。
3.1、通過AndroidManifest配置:
(1)在Application節點下添加以下屬性:
注意:如果你有自己的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.**{*;}