新浪微博開放平台提供了一套相當簡便的合作模式,讓第三方 App 能滿足使用者隨時隨地分享的需求。只要呼叫平台提供的 API,就能把大量微博功能接進自己的應用裡。
本文記錄新浪微博行動 SDK 的 iOS 版本,在 iOS 5 環境下的嵌入與使用過程,包含 ARC 相容設定、必要 framework 掛载,以及如何跳過 SDK 包裝直接呼叫自訂介面。
1. 申請行動應用
到新浪微博開放平台申請一個行動應用,通過後會拿到一組 App Key 與 App Secret。
2. 下載 iOS SDK
於開放平台下載 iOS SDK,取列表中的第一個即可。
3. 建立專案
新增專案 Sina_weibo,範本選 Single View Application,並勾選使用 iOS 5 之後才有的 ARC 特性,然後把解壓後的 SDK 拖進專案。


這時直接編譯,你會看到一堆 ARC 相關錯誤——因為 SDK 本身並不是用 ARC 寫的。解法是讓這些檔案不參與 ARC 編譯:在 Build Phases 的 Compile Sources 中,為 SDK 檔案加上 -fno-objc-arc 標記。

雙擊需要標記的檔案,輸入 -fno-objc-arc 即可。

這樣 weibo SDK 的檔案就會以非 ARC 方式編譯,錯誤自然消失。
在自己的工程中加入 Security.framework。SDK 需要靠它把 OAuth 認證後取得的 token 存進 Keychain,藉此提升整體安全性。加完之後,編譯與執行都會恢復正常。
其餘流程與 SDK 內附的 Demo 相同。

// 登入
[weiBoEngine logIn];
// 登出
[weiBoEngine logOut];
// 使用 SDK 預設介面發送微博
WBSendView *sendView = [[WBSendView alloc] initWithAppKey:appKey
appSecret:appSecret
text:@"test"
image:[UIImage imageNamed:@"bg.png"]];
[sendView setDelegate:self];
[sendView show:YES];
對應的 API 是 statuses/upload,用來發送微博並上傳圖片。若要在微博上顯示地圖位置,多帶兩個參數即可:
lat(緯度,float,有效範圍 -90.0 到 +90.0,正值為北緯,預設 0.0)long(經度,float,有效範圍 -180.0 到 +180.0,正值為東經,預設 0.0)
上一節用的是 SDK 封裝好的介面,但微博 API 數量龐大,該怎麼呼叫其他功能?以取得個人資訊為例:
NSMutableDictionary *params = [NSMutableDictionary dictionaryWithCapacity:2];
[params setObject:[engine accessToken] forKey:@"access_token"];
[params setObject:[engine userID] forKey:@"uid"];
[engine loadRequestWithMethodName:@"users/show.json"
httpMethod:@"GET"
params:params
postDataType:kWBRequestPostDataTypeNone
httpHeaderFields:nil];
這裡的 params 是必要參數,執行後即可取得微博暱稱等個人資料。
換言之,只要把 loadRequestWithMethodName 的方法名替換成你要的介面、params 換成對應參數,就能呼叫幾乎所有開放介面,SDK 附的範例都有對應寫法。
也有不需要 params 的介面,例如 statuses/friends_timeline.json(取得關注對象的微博),此時 params 傳 nil 即可。
補充:本文示範的是 OAuth 認證方式;xAuth 認證需要另外申請資格審核才能使用。