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

QQ 與新浪微博第三方登入的 iOS 接入實戰與踩雷紀錄

編輯:iOS 開發綜合

在 App 裡放一顆「用 QQ 登入」或「用微博登入」,已經是幾乎每個新產品的標配。它大幅降低了使用者的註冊門檻,也順帶打開了分享與拉新的通路。登入成功後拿到的唯一 ID,只要後端把它綁定到自家帳號體系,效果就等同於完成註冊。

不過真正接起來會發現,兩家 SDK 的設計風格差異不小,文件品質也參差不齊。以下依序說明通用流程,再分別拆解兩邊的實作細節與我踩到的坑。

通用接入流程

  1. 確認產品需要這個功能(社群型 App 幾乎是必要項)。
  2. 前往對應的開放平台,例如 QQ 互聯。
  3. 註冊並建立應用,填完基本資料後取得 App Key,這是 App 的唯一識別碼。
  4. 下載 SDK,認真讀開發文件或範例。有些 SDK 的 demo 寫得實在難以卒睹,這一步要有心理準備。
  5. 把對應功能嵌入專案,測試通過後提交平台審核,審核通過才能正式上線。
  6. 所有功能完成後提交 App Store 審核,通常需要約一週。

一、QQ 登入授權

1. 導入 SDK 與設定 URL Scheme

依文件導入 SDK,把 App Key 寫進 URL Schemes,格式為 tencent 加上 App ID,例如 tencent1101737816。

2. 在 AppDelegate 實作回呼

以下兩個方法功能重疊,擇一實作即可,別忘了引入相關頭檔。它們負責在授權完成後把流程交還給 App:

- (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];
}

3. 註冊與授權(這裡最容易踩雷)

_tencentOAuth = [[TencentOAuth alloc] initWithAppId:kQQ_KEY andDelegate:self];

NSArray *_permissions = [NSArray arrayWithObjects:
                         kOPEN_PERMISSION_GET_INFO,
                         kOPEN_PERMISSION_GET_USER_INFO,
                         kOPEN_PERMISSION_GET_SIMPLE_USER_INFO, nil];
[_tencentOAuth authorize:_permissions inSafari:NO];

雷點:官方文件裡寫的授權碼是 @[@"get_user_info", @"add_t"] 這種寫法,但照抄之後會發現怎樣都登不進去,一律提示權限不足。正確做法是用上面那組 kOPEN_PERMISSION_* 常數,這一點文件確實有誤導性。

4. 實作登入結果回呼

讓類別遵循 TencentSessionDelegate 協議,並實作以下方法:

- (void)tencentDidLogin {
    _labelTitle.text = @"登錄完成";
    if (_tencentOAuth.accessToken && 0 != [_tencentOAuth.accessToken length]) {
        // 記錄使用者的 OpenID、Token 與過期時間
        _labelAccessToken.text = _tencentOAuth.accessToken;
    } else {
        _labelAccessToken.text = @"登錄不成功,沒有獲取 accessToken";
    }
}

- (void)tencentDidNotLogin:(BOOL)cancelled {
    if (cancelled) {
        _labelTitle.text = @"用戶取消登錄";
    } else {
        _labelTitle.text = @"登錄失敗";
    }
}

- (void)tencentDidNotNetWork {
    _labelTitle.text = @"無網絡連接,請設置網絡";
}

5. 取得使用者資料

能走到 tencentDidLogin 且拿到 accessToken,代表授權流程已完成,接著只要抓使用者資料即可。文件提供的方法如下:

[_tencentOAuth getUserInfo];

它的回傳型別是 BOOL,難怪很多人看了會一頭霧水。實際上這是「非同步觸發」的設計:呼叫成功後,結果會透過 TencentSessionDelegate 的另一個回呼方法送回:

- (void)getUserInfoResponse:(APIResponse *)response {
    // NSLog(@"respons:%@", response.jsonResponse);
    self.name.text = [response.jsonResponse objectForKey:@"nickname"];
}

這樣就拿到暱稱等資訊了。剩下的就是把這些資料拋給自家後端,並妥善保存 token,細節可參考官方文件。

二、新浪微博登入授權

1. 設定 URL Scheme

格式同樣是前綴加 App Key,例如 wb2045436852,然後依文件導入 SDK。

2. AppDelegate 中的回呼

若同時整合了 QQ 與微博,兩個判斷可以用 || 串在一起:

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

- (BOOL)application:(UIApplication *)application
            handleOpenURL:(NSURL *)url {
    return [TencentOAuth HandleOpenURL:url] || [WeiboSDK handleOpenURL:url delegate:self];
}

微博的登入結果回呼寫在類別本身,因為這裡傳入的是 self;若想在別的類別接收,把 delegate 換掉即可。

[WeiboSDK handleOpenURL:url delegate:self];

對應的協議是 WeiboSDKDelegate:

- (void)didReceiveWeiboResponse:(WBBaseResponse *)response {
    if ([response isKindOfClass:WBAuthorizeResponse.class]) {
        if ((int)response.statusCode == 0) {
            NSDictionary *dic = @{
                @"userID"      : [(WBAuthorizeResponse *)response userID],
                @"accessToken" : [(WBAuthorizeResponse *)response accessToken]
            };
        }
    }
}

拿到 userID 與 accessToken,就代表登入成功。

3. 發起登入

- (IBAction)sinaLogin:(id)sender {
    [WeiboSDK enableDebugMode:YES];
    [WeiboSDK registerApp:kSINA_KEY];

    WBAuthorizeRequest *request = [WBAuthorizeRequest request];
    request.redirectURI = kRedirectURI;
    request.scope = @"all";
    request.userInfo = @{@"myKey": @"myValue"};
    [WeiboSDK sendRequest:request];
}

這段同時完成了 SDK 註冊、開啟除錯日誌、設定回呼網址與自訂參數。若授權後能正確回呼 AppDelegate 的接收方法,微博登入就算通了。

Bundle Identifier 的坑:微博 SDK 會把 Bundle Identifier 綁進授權流程。若你的 Bundle ID 與申請 Key 時填的不一致,授權就會失敗。除錯階段的解法是暫時把 Bundle ID 改成微博官方 demo 的那一組,搭配官方 Key 測試,等自己的申請通過後再換回來。

兩家平台的使用心得

功能面兩邊都很完整,但開發體驗差異明顯:

  • QQ:整合與測試相對省事,但 demo 程式碼可讀性很低,加上文件本身有誤導,除錯成本反而偏高。優點是回呼設計集中在 AppDelegate,接起來直覺。
  • 新浪微博:demo 寫得乾淨清楚,一看就懂,這點明顯勝出。但登入回呼需要在 AppDelegate 取得,不如 QQ 靈活;Bundle Identifier 硬綁定更是讓除錯變得繁瑣。

如果不想分別維護兩套 SDK,也可以考慮用聚合型的登入服務(例如百度開發平台提供的登入 SDK),它已經封裝了 QQ、新浪微博、人人網等主流平台。

下圖為授權成功後的畫面:

後記:這篇整理的是我在實作過程中實際遇到的問題,若需要 QQ 與新浪微博授權登入的 demo 程式碼,可來信索取(mmw05@163.com)進一步交流。

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