在 App 開發中我們經常需要在用戶登錄模塊接入 SNS 登錄組件,這樣會大大提高用戶的注冊體驗。特別當一個不是剛性需求 App 推廣的時候,這樣會很大的降低用戶體驗的成本,沒有人願意忍受輸入郵箱、手機號碼去注冊一個賬號的流程。
本文主要分享了在 React Native 中接入微博、微信、QQ 登錄的流程,以及此前登錄組件中修復的一個已知 bug 的修復。
我的源博客地址:http://blog.parryqiu.com/2016/01/27/react_native_sns_weibo_wechat_qq_login/
使用的登錄組件
這里使用的組件是 react-native-open-share,此組件從 iOS 的 SNS 通用登錄組件 OpenShare fork 出來的,添加了到 React Native 的組件映射。源作者是 Jiayao Wu,后來我在使用的過程中發現了新浪微博登錄的一個 bug,下面會說明此 bug 的原因。我 fork 出來后,修復了此 bug,修復后的項目在 react-native-open-share,等待源作者 merge 進 master 中去,目前需要使用的可以去我的項目地址中下載使用。
項目接入
項目前期具體接入的過程在項目頁面已經做了詳細的說明,如果在接入過程中遇到什么問題歡迎留言討論。
這里主要針對接入過程中可能需要注意的幾個點作一些說明。
關於新浪微博、微信、QQ 接入審核的注意點
- 三個平台都需要進行項目提交審核,一般都是一到兩個工作日審核結束。
- 新浪微博、QQ 獲取登錄權限是免費的,微信的登錄權限(以及一些其他的高級功能)需要每年繳納300元人民幣的費用。
平台對應的地址分別為:新浪微博,微信,QQ
關於項目中 key 以及認證 URL 的設置
項目中兩個地方需要設置key,分別為 Info.plist
和 AppDelegate.m
中。
需要注意的是,在 Info.plist
中,key 的前面是有前綴的,按照示例程序中的添加修改即可,一定要注意。
新浪微博需要特別注意,授權回調頁的 URL 需要和登錄組件中的 URL 完全一致,因為 App 不涉及到回調后的頁面,所以只要保證兩個 URL 一致並能訪問即可。
組件中的 URL 地址定義在文件 SocietyLoginManager.m
中的約 105 行處。
其他沒有特別需要注意的地方,按照項目接入說明接入即可。
React Native 中的使用
在 React Native 通過添加三個 SNS 的圖標,添加上對應的方法調用即可,代碼如下:
var openShare = require('react-native-open-share'); //頭部導入組件
_weiboLogin: function() {
var _this = this;
openShare.weiboLogin();
if (!_this.weiboLogin) {
_this.weiboLogin = DeviceEventEmitter.addListener(
'managerCallback', (response) => {
AlertIOS.alert(
'response',
JSON.stringify(response)
);
_this.weiboLogin.remove();
delete _this.weiboLogin;
}
);
}
},
_qqLogin: function() {
var _this = this;
openShare.qqLogin();
if (!_this.qqLogin) {
_this.qqLogin = DeviceEventEmitter.addListener(
'managerCallback', (response) => {
AlertIOS.alert(
'response',
JSON.stringify(response)
);
_this.qqLogin.remove();
delete _this.qqLogin;
}
);
}
},
_wechatLogin: function() {
var _this = this;
openShare.wechatLogin();
if (!_this.wechatLogin) {
_this.wechatLogin = DeviceEventEmitter.addListener(
'managerCallback', (response) => {
AlertIOS.alert(
'response',
JSON.stringify(response)
);
_this.wechatLogin.remove();
delete _this.wechatLogin;
}
);
}
}
接入后就可以在 alert 中看到返回的 json 數據了。
之前組件中存在的一個 bug 處理
之前的組件,在微博返回數據的時候直接使用 NSDictionary 進行返回了,但是微博的 SDK 中返回日期類型的時候會導致 React Native 解析 json 的時候報錯,錯誤如下:
*** Terminating app due to uncaught exception 'NSInvalidArgumentException',
reason: 'Invalid type in JSON write (__NSDate)'
*** First throw call stack:
...
主要的出錯代碼在文件 SocietyLoginManager.m
中的約 112 行處。
所以對返回的數據增加對應的日期格式化函數,並調用即可。
主要的處理函數,相關的調用去查看源代碼即可。
//處理 返回數據中的 expirationDate 值,因為值的格式有問題,轉換成 string 后才能符合 json 的格式要求。 ********開始********
//Commit by Parry at 2016-01-26
- (NSMutableDictionary*)change: (NSDictionary *)message {
NSMutableDictionary* data = [message mutableCopy];
if ([message objectForKey:@"expirationDate"]) {
NSDateFormatter *dateToStringFormatter = [[NSDateFormatter alloc] init];
[dateToStringFormatter setDateFormat:@"yyyy-MM-dd HH:mm:ss"];
NSDate *date= [data objectForKey:@"expirationDate"];
NSString *strDate = [dateToStringFormatter stringFromDate:date];
data = [message mutableCopy];
[data setObject:strDate forKey:@"expirationDate"];
}
return data;
}
//處理 返回數據中的expirationDate值,因為值的格式有問題,轉換成 string 后才能符合 json 的格式要求。 ********結束********
這樣,這個 React Native 下的 SNS 登錄通用組件就可以完美地使用了。
使用中有任何問題歡迎留言交流、討論。