您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發綜合

iOS QQ 登入整合教學:從 SDK 導入到取得 OpenID 的傻瓜式流程

編輯:iOS 開發綜合

本文以圖文並茂的方式,示範如何在 iOS 專案中整合 QQ 登入。以下依官方流程,說明從下載 SDK 到取得使用者授權的完整步驟。

一、下載 iOS SDK

請至 SDK 下載頁面取得最新版本的 QQ 登入 iOS SDK。

二、SDK 目錄結構

SDK 包內含兩個檔案:TencentOpenAPI.framework 封裝了頭檔定義與具體實作;TencentOpenApi_iOS_Bundle.bundle 則打包了所需的資源檔。

三、將 SDK 加入專案

把 TencentOpenAPI.framework 與 bundle 拖入專案,在彈出視窗中勾選「Create groups for any added folders」,並在 Add to targets 中選擇要加入的 target 後點擊 Finish。

接著加入 SDK 相依的系統庫:Security.framework、libiconv.dylib、SystemConfiguration.framework、CoreGraphics.framework、libsqlite3.dylib、CoreTelephony.framework、libstdc++.dylib、libz.dylib。開啟工程設定的 Summary 頁籤,在「Linked Frameworks and Libraries」點擊「+」逐一加入。

之後在 Build Phases 中確認配置。

在 Build Settings 的「Linking」區,為「Other Linker Flags」加上「-fobjc-arc」。

四、修改必要的程式碼

4.1 設定 URL Scheme

在專案設定的 Info 頁籤「URL type」新增一筆 URL scheme,格式為 tencent + appid(例如 tencent222222)。同時請確認 Bundle display name 屬性存在,SDK 會需要它。

4.2 重寫 AppDelegate 的 handleOpenURL 與 openURL

- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation {
    return [TencentOAuth HandleOpenURL:url];
}
- (BOOL)application:(UIApplication *)application handleOpenURL:(NSURL *)url {
    return [TencentOAuth HandleOpenURL:url];
}

4.3 實作 TencentSessionDelegate 協議

具體協議可參照 TencentOpenAPI.framework/Headers 中的 TencentOAuth.h。

4.4 初始化 TencentOAuth

// delegate 不可為空
_tencentOAuth = [[TencentOAuth alloc] initWithAppId:@"222222" andDelegate:self];
// 設定 redirectURI(建議留空)
_tencentOAuth.redirectURI = @"www.qq.com";
// 設定授權 API 列表(建議只取用真正需要的權限)
_permissions = [NSArray arrayWithObjects:@"get_user_info", @"get_simple_userinfo", @"add_t", nil];

五、呼叫 SDK 登入

登入時呼叫 authorize 方法:

[_tencentOAuth authorize:_permissions inSafari:NO];

登入完成後會回呼 TencentSessionDelegate 的相關方法,分為登入成功、非網路錯誤失敗、網路錯誤失敗三種情況,可分別處理提示。登入成功後即可取得 accessToken 與 openid:

[_tencentOAuth accessToken];
[_tencentOAuth openId];

特別提醒

1. 登入是異步過程,可能因使用者行為導致流程未走完(例如沒有任何回調被觸發),建議把登入做成異步處理,避免同步等待造成卡死。

2. accessToken 具 3 個月有效期,過期後需提示使用者重新授權。

3. 若要保存授權資訊,需保存 accessToken、openid 與 expirationDate 三個資料,下次登入時再設定回 TencentOAuth 物件即可。

4. 建議在登入成功後即呼叫 getUserInfo 取得頭像與暱稱並顯示於介面,讓使用者體驗更一致。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved