導語：
第三方登錄和分享是現在App的「主流功能」，不管友盟，還是ShareSDK，都有很好的集成文檔，Please feel free to check！至于寫這篇指南的初衷是剛好公司最近做Standard Module，也剛好需要集成這一塊，還得做成友盟那樣以供使用。（心累，迫于老大的淫威之下
QQ SDK官方文檔
實現QQ登錄
一、準備工作
- 在騰訊開放平臺，注冊成為開發者。
- 創建應用，申請你的appid和appkey。
!!!Ps：在準備工作的時候，可能會遇到一個坑：QQ互聯開放平臺和騰訊開放平臺是相互獨立的，所以 若已在QQ互聯創建過應用，可在創建應用時選擇關聯QQ互聯，輸入在QQ互聯創建的網頁應用APPID、APPKEY即可完成關聯。（兩個平臺做一樣的事，鵝廠真心錢多
創建應用.png
appid和appkey的用途
- appid：應用的唯一標識。在OAuth2.0認證過程中，appid的值即為oauth_consumer_key的值。
- appkey：appid對應的密鑰，訪問用戶資源時用來驗證應用的合法性。在OAuth2.0認證過程中，appkey的值即為oauth_consumer_secret的值。
二、集成SDK
下載好完整包，如圖導入工程需要的文件。
14932765373824.jpg
- TencentOpenAPI.framework打包了iOS SDK的頭文件定義和具體實現
- TencentOpenApi_iOS_Bundle.bundle 打包了iOS SDK需要的資源文件
三、配置工程
1. 添加SDK依賴的系統庫文件
Security.framework
SystemConfiguration.framework
CoreTelephony.framework
CoreGraphics.Framework
libiconv.tbd
libsqlite3.tbd
libstdc++.tbd
libz.tbd
2. 修改必要的工程配置屬性
在工程配置中的Build Settings一欄中找到Linking配置區，給Other Linker Flags配置項添加屬性值-fobjc-arc
配置屬性.jpg
3. 修改Info.plist文件
在XCode中，選中TARGETS一欄，在Info標簽欄中找到URL Types,添加一條新的URL scheme。(必須填寫
Identifier: tencentopenapi
URL Schemes: tencent + "appid"
想要實現應用間跳轉，而不是打開一個登陸網頁，在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>
四、代碼實現
1.AppDelegate
在AppDelegate中添加頭文件，并重寫AppDelegate的handleOpenURL和openURL方法
-
iOS9之前，分別重寫
handleOpenURL && openURL方法//handleOpenURL(ios10已棄用) NS_DEPRECATED_IOS(2_0, 9_0, "Please use application:openURL:options:") - (BOOL)application:(UIApplication *)application handleOpenURL:(NSURL *)url{ [TencentOAuth HandleOpenURL:url]; return YES; } //openURL(iOS10已棄用) NS_DEPRECATED_IOS(4_2, 9_0, "Please use application:openURL:options:") - (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation{ [TencentOAuth HandleOpenURL:url]; return YES; } -
iOS9之后，
handleOpenURL && openURL合成為同一個方法//handleOpenURL && openURL - (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options{ [TencentOAuth HandleOpenURL:url]; return YES; }
2.登錄控制器實現對應的代理事件
在LoginViewController添加對應的頭文件，添加QQ Login點擊事件，實現TencentSessionDelegate的對應delegate事件。
#import "LoginViewController.h"
#import <TencentOpenAPI/TencentOAuth.h>
@interface LoginViewController ()<TencentSessionDelegate>
@property (nonatomic, strong) TencentOAuth* tencentOAuth;
@end
@implementation LoginViewController
- (void)loginBtnClicked{
self.tencentOAuth = [[TencentOAuth alloc] initWithAppId:@"你申請的appID" andDelegate:self];
//在這個數組里，可以添加你想要用戶授權的信息的相關字段
//注意，若是授權太多信息， 用戶可能會拒絕授權
NSArray *permissions = [NSArray arrayWithObjects:
@"get_user_info",
@"get_simple_userinfo",
@"add_t",
nil];
//授權類型
[self.tencentOAuth setAuthShareType:AuthShareType_QQ];
//調用SDK登錄
[self.tencentOAuth authorize:permissions inSafari:false];
}
- (void)tencentDidNotNetWork{
NSLog(@"網絡連接失敗");
}
- (void)tencentDidLogin{
if (self.tencentOAuth.accessToken && 0 != [self.tencentOAuth.accessToken length]){
//accessToken有效期3個月,想要獲取用戶信息，必須調用getUserInfo
NSLog(@"記錄登錄用戶的OpenID、Token以及過期時間");
[self.tencentOAuth getUserInfo];
}else{
NSLog(@"登錄不成功 沒有獲取accesstoken");
}
}
- (void)tencentDidNotLogin:(BOOL)cancelled{
if (cancelled){
NSLog(@"用戶取消登錄");
}else{
NSLog(@"登錄失敗");
}
}
3.獲取用戶信息
當DidLogin調用getUserInfo，會有此回調返回userInfo
- (void)getUserInfoResponse:(APIResponse *)response{
if (response && response.retCode == URLREQUEST_SUCCEED) {
NSDictionary* userInfo = [response jsonResponse];
NSLog(@"%@",userInfo);
}else{
NSLog(@"QQ auth fail ,getUserInfoResponse:%d", response.detailRetCode);
}
}
4.登錄篇注意事項
?當未調起原生客戶端授權，只彈出網頁，檢查URL scheme設置 && 是否添加
LSApplicationQueriesSchemes到Info.plist-
當Xcode提示“未選擇授權類型”，可添加：
[self.tencentOAuth setAuthShareType:AuthShareType_QQ];
分割線，接下來講講QQ分享
實現QQ分享
步驟同上一、二、三
代碼實現
1.在AppDelegate中初始化OAuth
@interface AppDelegate ()<QQApiInterfaceDelegate>
@property (nonatomic, strong) TencentOAuth* tencentOAuth;
@end
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
// Override point for customization after application launch.
// 根據自己的AppID初始化OAuth
self.tencentOAuth = [[TencentOAuth alloc] initWithAppId:@"QQAppID" andDelegate:nil];
return YES;
}
2.在AppDelegate中實現回調事件
此回調事件，需要在AppDelegate里添加頭文件<TencentOpenAPI/QQApiInterface.h>，重寫handleOpenURL && openURL方法
-
添加頭文件
#import <TencentOpenAPI/QQApiInterface.h> -
重寫
handleOpenURL方法//iOS9之前，分別重寫`handleOpenURL && openURL`方法 //handleOpenURL(ios10已棄用) NS_DEPRECATED_IOS(2_0, 9_0, "Please use application:openURL:options:") - (BOOL)application:(UIApplication *)application handleOpenURL:(NSURL *)url{ if ([url.scheme isEqualToString:[NSString stringWithFormat:@"tencent%@",QQAppID]]) { return [QQApiInterface handleOpenURL:url delegate:self]; } else{ return YES; } } //iOS9之后，`handleOpenURL && openURL` 合成為同一個方法 //handleOpenURL && openURL - (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options{ if ([url.scheme isEqualToString:[NSString stringWithFormat:@"tencent%@",QQAppID]]) { return [QQApiInterface handleOpenURL:url delegate:self]; } else{ return YES; } } -
處理回調事件
@interface AppDelegate ()<QQApiInterfaceDelegate> - (void)onReq:(QQBaseReq *)req{ NSLog(@"處理來至QQ的請求"); } - (void)onResp:(QQBaseResp *)resp{ NSLog(@"處理來至QQ的響應"); NSLog(@"response") switch (resp.type) { case ESENDMESSAGETOQQRESPTYPE: { SendMessageToQQResp* sendResp = (SendMessageToQQResp*)resp; if ([sendResp.result isEqualToString:@"0"]) { UIAlertController* vc = [UIAlertController alertControllerWithTitle:@"成功" message:@"QQ分享成功" preferredStyle:UIAlertControllerStyleAlert]; [vc addAction:[UIAlertAction actionWithTitle:@"OK" style:UIAlertActionStyleCancel handler:^(UIAlertAction * _Nonnull action) { }]]; [self.window.rootViewController presentViewController:vc animated:YES completion:nil]; } else { UIAlertController* vc = [UIAlertController alertControllerWithTitle:@"失敗" message:@"QQ分享失敗" preferredStyle:UIAlertControllerStyleAlert]; [vc addAction:[UIAlertAction actionWithTitle:@"OK" style:UIAlertActionStyleCancel handler:^(UIAlertAction * _Nonnull action) { }]]; [self.window.rootViewController presentViewController:vc animated:YES completion:nil]; } break; } default: { break; } } } - (void)isOnlineResponse:(NSDictionary *)response{ NSLog(@"處理QQ在線狀態的回調"); NSLog(@"response : %@",response); }
3.在ShareViewController中導入對應的頭文件
#import <TencentOpenAPI/TencentOAuth.h>
#import <TencentOpenAPI/TencentMessageObject.h>
#import <TencentOpenAPI/TencentApiInterface.h>
#import <TencentOpenAPI/QQApiInterface.h>
#import <TencentOpenAPI/QQApiInterfaceObject.h>
4.在ShareViewController實現分享事件示例代碼
-
文本
- (void)shareText { if (![TencentOAuth iphoneQQInstalled]) { UIAlertController* vc = [UIAlertController alertControllerWithTitle:@"你還沒有安裝QQ客戶端" message:nil preferredStyle:UIAlertControllerStyleAlert]; [vc addAction:[UIAlertAction actionWithTitle:@"OK" style:UIAlertActionStyleCancel handler:^(UIAlertAction * _Nonnull action) { }]]; [self presentViewController:vc animated:YES completion:nil]; } else{ QQApiTextObject* object = [QQApiTextObject objectWithText:@"分享的內容"]; [object setShareDestType:ShareDestTypeQQ]; SendMessageToQQReq* req = [SendMessageToQQReq reqWithContent:object]; QQApiSendResultCode code = [QQApiInterface sendReq:req]; NSLog(@"result code : %d",code); } } -
圖片
- (void)shareImage { if (![TencentOAuth iphoneQQInstalled]) { UIAlertController* vc = [UIAlertController alertControllerWithTitle:@"你還沒有安裝QQ客戶端" message:nil preferredStyle:UIAlertControllerStyleAlert]; [vc addAction:[UIAlertAction actionWithTitle:@"OK" style:UIAlertActionStyleCancel handler:^(UIAlertAction * _Nonnull action) { }]]; [self presentViewController:vc animated:YES completion:nil]; } else{ NSString* filePath = [[NSBundle mainBundle] pathForResource:@"icon" ofType:@"png"]; NSData* imageData = [NSData dataWithContentsOfFile:filePath]; QQApiImageObject* obj = [QQApiImageObject objectWithData:imageData previewImageData:imageData title:@"title" description:@"github貓"]; [obj setShareDestType:ShareDestTypeQQ]; SendMessageToQQReq* req = [SendMessageToQQReq reqWithContent:obj]; QQApiSendResultCode code = [QQApiInterface sendReq:req]; NSLog(@"result code : %d",code); } } -
新聞
- (void)shareNews { if (![TencentOAuth iphoneQQInstalled]) { UIAlertController* vc = [UIAlertController alertControllerWithTitle:@"你還沒有安裝QQ客戶端" message:nil preferredStyle:UIAlertControllerStyleAlert]; [vc addAction:[UIAlertAction actionWithTitle:@"OK" style:UIAlertActionStyleCancel handler:^(UIAlertAction * _Nonnull action) { }]]; [self presentViewController:vc animated:YES completion:nil]; } else{ //分享跳轉URL，注意要經過UTF8處理 NSString *url = [@"http://xxx.xxx.xxx/" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]]; //分享圖預覽圖URL地址 NSString *previewImageUrl = @"preImageUrl.png"; QQApiNewsObject *newsObj = [QQApiNewsObject objectWithURL :[NSURL URLWithString:url] title: @"title" description :@"description" previewImageURL:[NSURL URLWithString:previewImageUrl]]; SendMessageToQQReq *req = [SendMessageToQQReq reqWithContent:newsObj]; //將內容分享到qq //QQApiSendResultCode sent = [QQApiInterface sendReq:req]; //將內容分享到qzone QQApiSendResultCode sent = [QQApiInterface SendReqToQZone:req]; } } 分享類型：
| 分享消息類型 | QQ好友 | QQ空間 | web QQ好友 | web QQ空間 |
|---|---|---|---|---|
| QQApiTextObject | ?? | ? | ? | ? |
| QQApiImageObject | ?? | ? | ? | ? |
| QQApiNewsObject | ?? | ?? | ?? | ?? |
| QQApiAudioObject | ?? | ?? | ?? | ?? |
| QQApiVideoObject | ?? | ?? | ?? | ?? |
5.分享篇注意事項
-
分享的回調無法執行，請注意實現
<QQApiInterfaceDelegate>，即[QQApiInterface handleOpenURL:url delegate:self(代理對象)]; -
當Xcode打印“result code 為 -2”時(未知的分享類型)，請注意實現
setShareDestType方法，即QQApiTextObject* object = [QQApiTextObject objectWithText:@"分享的內容"]; [object setShareDestType:ShareDestTypeQQ];
結束語
我在使用原生集成時，遇到的這些坑都由于Tencent的文檔太久沒更新導致花了一段時間。最后仔細的查看SDK接口才發現解決方式，希望能夠給看到這篇文章的人提供到一點幫助。在接下來一段時間，還會繼續寫幾篇關于 微信、微博、Facebook等等的SDK集成指南。還在研究中，共勉啦。
