本文以圖文並茂的方式,示範如何在 iOS 專案中整合 QQ 登入。以下依官方流程,說明從下載 SDK 到取得使用者授權的完整步驟。
請至 SDK 下載頁面取得最新版本的 QQ 登入 iOS SDK。
SDK 包內含兩個檔案:TencentOpenAPI.framework 封裝了頭檔定義與具體實作;TencentOpenApi_iOS_Bundle.bundle 則打包了所需的資源檔。

把 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」。

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


- (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];
}
具體協議可參照 TencentOpenAPI.framework/Headers 中的 TencentOAuth.h。
// 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];
登入時呼叫 authorize 方法:
[_tencentOAuth authorize:_permissions inSafari:NO];
登入完成後會回呼 TencentSessionDelegate 的相關方法,分為登入成功、非網路錯誤失敗、網路錯誤失敗三種情況,可分別處理提示。登入成功後即可取得 accessToken 與 openid:
[_tencentOAuth accessToken]; [_tencentOAuth openId];
1. 登入是異步過程,可能因使用者行為導致流程未走完(例如沒有任何回調被觸發),建議把登入做成異步處理,避免同步等待造成卡死。
2. accessToken 具 3 個月有效期,過期後需提示使用者重新授權。
3. 若要保存授權資訊,需保存 accessToken、openid 與 expirationDate 三個資料,下次登入時再設定回 TencentOAuth 物件即可。
4. 建議在登入成功後即呼叫 getUserInfo 取得頭像與暱稱並顯示於介面,讓使用者體驗更一致。