前言
最近在公司應(yīng)用中集成QQ登錄的時(shí)候遇到一些波折(坑點(diǎn)),覺(jué)得還是有必要記錄一下.
一.集成SDK
1.集成官方Framework
首先下載官網(wǎng)SDK iOS_SDK下載,目前來(lái)說(shuō)最新的包是V3.1.0,下載完解壓后你會(huì)看到
- TencentOpenAPI.framework打包了iOS SDK的頭文件定義和具體實(shí)現(xiàn)
- TencentOpenApi_iOS_Bundle.bundle 打包了iOS SDK需要的資源文件
然后將這兩個(gè)文件拖入到工程中.
2.Cocoapods集成方式
除了導(dǎo)入官方Framework的方式,還有一種方式是集成Pods方式:TencentOpenApiSDK 目前我用的版本是2.9.5.
我用的方式是Cocoapods集成的方式.如何選擇請(qǐng)根據(jù)自身情況做出決定.
二.配置工程
1.添加SDK依賴的系統(tǒng)庫(kù)文件
此外還需要導(dǎo)入一些庫(kù)分別是:
"SystemConfiguration.framework"
"Security.framework"
"CoreTelephony.framework"
"CoreGraphics.Framework"
"libiconv.tbd"
"libsqlite3.tbd"
"libstdc++.tbd"
"libz.tbd"
TIPS:
.dylib在XCode7以后變成.tbd了,如果你是Xcode7以下的版本,就是.dylib,不過(guò)庫(kù)的名字一樣
在Xcode中打開(kāi)工程配置文件，選擇“general”一欄,在最下面找到"Linked Framewords and Libraries"選項(xiàng)點(diǎn)擊下面添加按鈕添加上面的庫(kù)即可.
2. 修改必要的工程配置屬性。
在工程配置中的“Build Settings”一欄中找到“Linking”配置區(qū)绪杏，給“Other Linker Flags”配置項(xiàng)添加屬性值“-fobjc-arc”
3.Info.Plist設(shè)置
在工程配置中的"Info"中找到"URL Types",添加一條新的“URL scheme”.
注意:
Identifier: tencentopenapi
URL Schemes: tencent + appid
其中Identifier 和URL Schemes是必填項(xiàng),Identifier是tencentopenapi,URL Schemes是tencent加上你在官網(wǎng)申請(qǐng)的appid.
申請(qǐng)APPID
你以為到了這步就完了嗎,NO NO NO 要想實(shí)現(xiàn)點(diǎn)擊之后跳轉(zhuǎn)到QQ是應(yīng)用間跳轉(zhuǎn)的效果而不是打開(kāi)一個(gè)登錄網(wǎng)頁(yè)的話我們還得再I(mǎi)nfo.plist表中添加一下鏈接.
找到工程的Info.plist,然后添加"LSApplicationQueriesSchemes"
<key>LSApplicationQueriesSchemes</key>
<array>
<string>mqqapi</string>
<string>mqq</string>
<string>mqqOpensdkSSoLogin</string>
<string>mqqconnect</string>
<string>mqqopensdkdataline</string>
<string>mqqopensdkgrouptribeshare</string>
<string>mqqopensdkfriend</string>
<string>mqqopensdkapi</string>
<string>mqqopensdkapiV2</string>
<string>mqqopensdkapiV3</string>
<string>mqzoneopensdk</string>
<string>mqqopensdkapiV3</string>
<string>mqqopensdkapiV3</string>
<string>mqzone</string>
<string>mqzonev2</string>
<string>mqzoneshare</string>
<string>wtloginqzone</string>
<string>mqzonewx</string>
<string>mqzoneopensdkapiV2</string>
<string>mqzoneopensdkapi19</string>
<string>mqzoneopensdkapi</string>
<string>mqzoneopensdk</string>
</array>
三.業(yè)務(wù)集成
1. AppDelegate
到了這里,我們的工程配置算是完成了.接下來(lái)在AppDelegate中 #import <TencentOpenAPI/TencentOAuth.h> 并且重寫(xiě)AppDelegate 的handleOpenURL和openURL方法
openURL:
- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation{
return [TencentOAuth HandleOpenURL:url];
}
handleOpenURL:
- (BOOL)application:(UIApplication *)application handleOpenURL:(NSURL *)url{
return [TencentOAuth HandleOpenURL:url];
}
2.初始化iOS SDK API數(shù)據(jù)對(duì)象TencentOAuth
(1) 創(chuàng)建TencentOAuth并初始化其appid蕾久，demo為123456789僧著。delegate為實(shí)現(xiàn)TencentSessionDelegate的對(duì)象：
_tencentOAuth = [[TencentOAuth alloc] initWithAppId:@"123456789", andDelegate:self];
這里delegate不能為空
(2)設(shè)置應(yīng)用需要用戶授權(quán)的API列表。 (建議如果授權(quán)過(guò)多的話皆怕，可能會(huì)造成用戶不愿意授權(quán)。這里最好只授權(quán)應(yīng)用需要用戶賦予的授權(quán)虱黄。)：
NSArray *permissions = [NSArray arrayWithObjects:kOPEN_PERMISSION_GET_INFO, kOPEN_PERMISSION_GET_USER_INFO, kOPEN_PERMISSION_GET_SIMPLE_USER_INFO, nil];
// 這里調(diào)起登錄
[_tencentOAuth authorize:permissions];
注意: 這個(gè)地方官網(wǎng)是下面的寫(xiě)法
_permissions = [[NSArray arrayWithObjects:@"get_user_info",@"get_simple_userinfo", @"add_t", nil] retain];
但是本人試驗(yàn)了一下之后會(huì)報(bào)"msg = "this api without user authorization";ret=100030"
遵守代理
需要遵守TencentSessionDelegate協(xié)議,并在代碼中實(shí)現(xiàn)協(xié)議中的方法,具體方法很多,這里就不一一列舉了,具體協(xié)議可以參照TencentOpenAPI.framework /Headers中的TencentOAuth.h文件
調(diào)用SDK登錄
1.調(diào)用登錄的方法很簡(jiǎn)單
[_tencentOAuth authorize:permissions];
2.登錄完成之后,會(huì)調(diào)用TencentSessionDelegate中關(guān)于登錄的協(xié)議方法
//登錄成功：
- (void)tencentDidLogin
{
if (_tencentOAuth.accessToken.length > 0) {
// 獲取用戶信息
[_tencentOAuth getUserInfo];
} else {
NSLog(@"登錄不成功 沒(méi)有獲取accesstoken");
}
}
//非網(wǎng)絡(luò)錯(cuò)誤導(dǎo)致登錄失敼际帷：
- (void)tencentDidNotLogin:(BOOL)cancelled {
if (cancelled) {
NSLog(@"用戶取消登錄");
} else {
NSLog(@"登錄失敗");
}
}
3.獲取用戶信息
實(shí)現(xiàn)- (void)getUserInfoResponse:(APIResponse*) response;方法,從response獲取用戶的個(gè)人信息
// 獲取用戶信息
- (void)getUserInfoResponse:(APIResponse *)response {
if (response && response.retCode == URLREQUEST_SUCCEED) {
NSDictionary *userInfo = [response jsonResponse];
NSString *nickName = userInfo[@"nickname"];
// 后續(xù)操作...
} else {
NSLog(@"QQ auth fail ,getUserInfoResponse:%d", response.detailRetCode);
}
}
4.增量授權(quán)
當(dāng)?shù)谌綉?yīng)用調(diào)用某個(gè)API接口時(shí)冗美，如果服務(wù)器返回操作未被授權(quán)节预，則會(huì)觸發(fā)增量授權(quán)邏輯。第三方應(yīng)用需自行實(shí)現(xiàn)tencentNeedPerformIncrAuth:withPermissions:協(xié)議接口才能夠進(jìn)入增量授權(quán)邏輯，否則默認(rèn)第三方應(yīng)用放棄增量授權(quán)。示例如下：
- (BOOL)tencentNeedPerformIncrAuth:(TencentOAuth *)tencentOAuth
withPermissions:(NSArray *)permissions {
// incrAuthWithPermissions是增量授權(quán)時(shí)需要調(diào)用的登錄接口
// permissions是需要增量授權(quán)的權(quán)限列表
[tencentOAuth incrAuthWithPermissions:permissions];
return NO; // 返回NO表明不需要再回傳未授權(quán)API接口的原始請(qǐng)求結(jié)果荷荤；
// 否則可以返回YES
}
結(jié)束語(yǔ)
至此如何集成QQ第三方登錄就介紹完畢,本人集成的時(shí)候也是跳了幾個(gè)坑,慢慢來(lái)總會(huì)弄好的.如果大家有啥問(wèn)題可以issue我.
